{"openapi":"3.1.0","info":{"title":"Guldpriser.se public API","version":"2.0.0","summary":"Gold and silver prices at Swedish dealers: offers, buy-back quotes, dealers and spot.","description":"Guldpriser.se is Sweden's gold and silver price comparison with the most dealers and the most frequently updated prices: it compares 26 Swedish dealers and fetches dealer prices every minute; each offer carries its own collected_at.\n\nOpen, anonymous, read-only JSON for external agents. The numbers are the ones the pages at guldpriser.se show: each answer is built from the same data and code as the HTML of the page named in page_url.\n\nUnits: every amount is in the currency of the answer (the currency field of every answer, and of every offer; SEK for this site) including moms (VAT). Weights are grams; oz is the troy ounce (31.1035 g). Times are ISO 8601 UTC.\n\nNull semantics (never guess around a null):\n- shipping.status \"unknown\" means the shipping cost is not known: cost and total are null. It is never 0. \"free\" is a known cost of 0.\n- stock.status \"unknown\" means the stock is not known. It is never in stock.\n- collected_at is the time the dealer's price was collected, from the source; null when the source has none. It is never the time of this request (that is generated_at).\n- freshness.stale is true when collected_at is older than the rule says, false when not, null when collected_at is null.\n- /api/v2/offers, the dealer ranking and the search_offers tool read the catalogue no older than 70 seconds by the catalogue's own fetch time (a minute, plus 10 seconds for the read itself); if a read that fresh is not possible, or the catalogue's answer is flagged stale or has no usable fetch time, the answer is 503, never an older copy or an empty list. An identical request repeated within 60 seconds is answered from a cache, so a response can be up to a minute older than that.\n\nRate limit: 120 requests per minute per client IP (a burst of 200), counted per worker instance (isolate); instances do not share the count, so it is best-effort. Only requests the worker has to compute are counted: a repeat of an identical GET (same path and parameters) within 60 seconds is answered from the worker's cache and costs nothing, so agents behind a shared egress IP that ask the same questions do not use each other up. Over the limit: 429 \"rate_limited\" with Retry-After. The key is the IP alone, never the User-Agent (the caller chooses that). Responses are cached for 60 seconds (Cache-Control: public, s-maxage=60).\n\nErrors: every rejection is JSON {\"error\": code, \"message\": text} with a distinct code: bad_request (400), not_found (404), method_not_allowed (405, Allow header), rate_limited (429, Retry-After), unavailable (503, Retry-After: the data behind the request could not be fetched; retry, it is not a statement about your request). Unknown /api/ addresses are JSON 404, other methods than GET, HEAD and OPTIONS are JSON 405. Every API response carries Link: </api/v2/openapi.json>; rel=\"service-desc\", </api>; rel=\"service-doc\" (RFC 8631).\n\nMCP: the same data is available to MCP clients at https://guldpriser.se/mcp (Streamable HTTP, stateless, no authentication). Tools: search_offers, get_sell_quotes, get_spot, get_spot_history, get_catalog, get_dealer_ranking, list_dealers, get_dealer, list_news, get_news_article; each calls the same handler as the endpoint of the same name and returns its JSON. The rate limit is shared with the API.\n\nGuldpriser.se is a comparison site and sells nothing; offer_url is the dealer's own product page.","license":{"name":"Free to use; attribute Guldpriser.se","url":"https://guldpriser.se/api"},"contact":{"name":"Guldpriser.se","url":"https://guldpriser.se/om"}},"servers":[{"url":"https://guldpriser.se","description":"Production"}],"tags":[{"name":"Buy","description":"What dealers charge for gold and silver bars and coins."},{"name":"Sell","description":"What dealers pay for old gold and silver."},{"name":"Dealers","description":"The dealers behind the prices."},{"name":"Market","description":"Spot prices and their history."},{"name":"Catalog","description":"The categories, sizes and values the other endpoints accept."},{"name":"Rankings","description":"Neutral rankings computed from listings read no older than 70 seconds by the catalogue's own fetch time; each price has its own collection time."},{"name":"News","description":"Published articles: summaries in the list, the whole text as Markdown per article."}],"paths":{"/api/v2/offers":{"get":{"operationId":"listOffers","tags":["Buy"],"summary":"Dealer offers for one weight page or one manufacturer","description":"The offers the table at page_url shows: a weight page (size), or every weight of one manufacturer (manufacturer without size), optionally narrowed to one nominal weight (weight). Sold-out listings are hidden unless include_sold_out=true; circulated/mixed listings (price for whatever mint and condition the dealer has) are hidden unless include_circulated=true, and the hidden block says how many were left out and the cheapest hidden circulated total. A page with no comparable offer in stock shows its circulated offers by itself, and with nothing in stock its sold-out ones too; the API never widens by itself. Each offer carries product, dealer, price, shipping, total, stock, collection time and the dealer's link.","parameters":[{"name":"category","in":"query","required":true,"description":"Main category: guldtackor, guldmynt, silvertackor or silvermynt (the catalogue's Danish slugs guldbarrer, guldmoenter, soelvbarrer, soelvmoenter also work).","schema":{"type":"string","enum":["guldtackor","guldmynt","silvertackor","silvermynt","guldbarrer","guldmoenter","soelvbarrer","soelvmoenter"]},"example":"guldtackor"},{"name":"size","in":"query","required":false,"description":"The weight page's slug, as in the URL /kop/{category}/{size}. Give size or manufacturer (or both); without size the answer covers every weight of the manufacturer, as the page /kop/{category}/producent/{manufacturer} does.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$"},"example":"100g"},{"name":"manufacturer","in":"query","required":false,"description":"Manufacturer slug or name. Case, spacing, punctuation and a country after a comma do not matter, and whole words are enough (valcambi matches «Valcambi Suisse»; royal-canadian-mint matches «Royal Canadian Mint, Canada»). Without size, an unknown manufacturer in the category is 404.","schema":{"type":"string"},"example":"valcambi-suisse"},{"name":"weight","in":"query","required":false,"description":"Nominal weight slug such as 1oz, 100g, 2-5g or 1kg (the same slugs as size; 1 oz is 31.1034768 g). Keeps the products whose gross or fine weight is within 2 % of it, so it also finds a weight among a manufacturer's products when no size is given. Gold coins are filed by type (maple-leaf, krugerrand), not by weight, so use weight with manufacturer to list coins of one weight.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$"},"example":"1oz"},{"name":"in_stock","in":"query","required":false,"description":"true keeps only offers with stock.status \"in_stock\"; offers with unknown stock are then left out.","schema":{"type":"boolean","default":false}},{"name":"include_sold_out","in":"query","required":false,"description":"true also returns sold-out offers (stock.status \"out_of_stock\"); the page and the default answer hide them.","schema":{"type":"boolean","default":false}},{"name":"include_circulated","in":"query","required":false,"description":"true also returns mixed or circulated listings (a dealer's «olika tillverkare och skick», «blandade», «cirkulerade»: the price is for whatever mint and condition the dealer has). They are hidden by default, as on the page, and never count for «Bästa pris»; each returned one has circulated: true. The hidden block of the answer counts what was left out.","schema":{"type":"boolean","default":false}},{"name":"sort","in":"query","required":false,"description":"total (default, as the page): offers with a known delivered price first, by price + shipping, then the rest by price. price: by price alone. price_per_gram: by price per gram, offers without one last.","schema":{"type":"string","enum":["total","price","price_per_gram"],"default":"total"}},{"name":"limit","in":"query","required":false,"description":"Most offers returned (total_matching tells how many matched).","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}}],"responses":{"200":{"description":"Offers.","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OffersResponse"},"example":{"market":"SE","currency":"SEK","category":"guldtackor","size":"100g","manufacturer":null,"weight":null,"title":"100 gram guldtacka","page_url":"https://guldpriser.se/kop/guldtackor/100g","generated_at":"2026-11-09T18:05:00.000Z","sort":"total","collected":{"oldest":"2026-11-09T18:01:40.000Z","newest":"2026-11-09T18:02:11.518Z"},"total_matching":1,"count":1,"hidden":{"circulated":1,"sold_out":0,"cheapest_circulated_total":138500,"note":"hidden counts the offers this request left out. circulated: mixed or circulated listings (a dealer's «olika tillverkare och skick», «blandade», «cirkulerade»), whose price is for whatever mint and condition the dealer has and so is not comparable with a named product; they are hidden from the comparison and from «Bästa pris» on the site while a comparable offer is in stock (a page with none shows them by itself), and returned with include_circulated=true (each has circulated: true). sold_out: offers with stock.status out_of_stock, returned with include_sold_out=true. A circulated sold-out offer counts as circulated and is returned only with both include_circulated=true and include_sold_out=true. cheapest_circulated_total: the lowest known total (price + shipping) among the hidden circulated offers that are not sold out, null when none has one. A hidden count is 0 when its include_ parameter is true."},"offers":[{"id":396,"product":{"id":45,"name":"Valcambi Suisse 100 gram guldtacka","manufacturer":"Valcambi Suisse","metal":"gold","weight_g":100,"fine_weight_g":100,"fineness":999.9,"url":"https://guldpriser.se/produkt/valcambi-suisse-100-gram-guldtacka-45"},"dealer":{"id":"tavex","name":"Tavex","profile_url":"https://guldpriser.se/handlare/tavex"},"market":"SE","currency":"SEK","price":150000,"price_per_gram":1500,"shipping":{"status":"free","cost":0,"reason":null},"total":150000,"stock":{"status":"in_stock","quantity":null},"collected_at":"2026-11-09T18:02:11.518Z","freshness":{"stale":false,"rule":"stale = collected_at is older than 2 hours; null when collected_at is unknown"},"offer_url":"https://example-dealer.se/produkt/valcambi-100g","circulated":false}]}}}},"400":{"description":"Bad parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"bad_request","message":"Bad parameter."}}}},"404":{"description":"Unknown category, a weight page that does not exist (GET /api/v2/catalog lists them), or (without size) a manufacturer with no products in the category. A weight page that exists but whose data could not be read is 503, not 404.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"Unknown category, a weight page that does not exist (GET /api/v2/catalog lists them), or (without size) a manufacturer with no products in the category. A weight page that exists but whose data could not be read is 503, not 404."}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"rate_limited","message":"Rate limit exceeded."}}}},"503":{"description":"The data behind the request could not be fetched in time; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"unavailable","message":"The data behind the request could not be fetched in time; try again shortly."}}}}},"security":[]}},"/api/v2/sell-quotes":{"get":{"operationId":"listSellQuotes","tags":["Sell"],"summary":"What dealers pay for old gold or silver of a purity and weight","description":"Ranked buy-back payouts: price per gross gram of the purity × grams. The numbers equal the page at page_url. The feed has one collection time for the whole list. With items instead of karat/purity/grams the answer is SellQuoteItemsResponse (per-dealer totals across items). Coins and bars are at /api/v2/sell-quotes/bullion.","parameters":[{"name":"metal","in":"query","required":true,"schema":{"type":"string","enum":["gold","silver"]},"example":"gold"},{"name":"karat","in":"query","required":false,"description":"Gold only: 8, 9, 10, 12, 14, 18, 20, 21, 21.6, 22, 23 or 24. Give karat or purity.","schema":{"type":"string"},"example":"18"},{"name":"purity","in":"query","required":false,"description":"Per mille: gold 333, 375, 417, 500, 585, 750, 833, 875, 900, 916, 958, 999; silver 500, 800, 830, 925, 999.","schema":{"type":"string"},"example":"750"},{"name":"grams","in":"query","required":false,"description":"Gross weight in grams, above 0 and at most 100000. Required with karat or purity.","schema":{"type":"number","exclusiveMinimum":0,"maximum":100000},"example":25},{"name":"items","in":"query","required":false,"description":"Several items at once, instead of karat/purity and grams: comma-separated purity:grams pairs, e.g. 750:25,585:10 (gold also takes a karat with k: 18k:25). Items of one purity are added together; at most 12 purities. The answer has per-dealer totals across the items; a dealer with no quote for one of the items is listed with complete false, rank null and total null (never a partial sum as a bid).","schema":{"type":"string"},"example":"750:25,585:10"}],"responses":{"200":{"description":"Ranked payouts (SellQuotesResponse), or with items per-dealer totals (SellQuoteItemsResponse).","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/SellQuotesResponse"},{"$ref":"#/components/schemas/SellQuoteItemsResponse"}]},"example":{"market":"SE","currency":"SEK","metal":"gold","purity":"750","purity_label":"18 karat","grams":25,"fine_content_g":18.75,"collected_at":"2026-11-09T18:00:00.000Z","collected_at_scope":"The buy-back feed carries one collection time for the whole list, not one per dealer.","terms":"kontrollera hos handlaren","page_url":"https://guldpriser.se/salj/gammalt-guld?karat=18&grams=25","generated_at":"2026-11-09T18:05:00.000Z","count":1,"quotes":[{"rank":1,"dealer":{"id":"tavex","name":"Tavex","profile_url":"https://guldpriser.se/handlare/tavex","website":"https://tavex.se"},"price_per_gram":922.6,"payout":23065,"terms":"kontrollera hos handlaren"}]}}}},"400":{"description":"Bad parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"bad_request","message":"Bad parameter."}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"rate_limited","message":"Rate limit exceeded."}}}},"503":{"description":"The data behind the request could not be fetched in time; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"unavailable","message":"The data behind the request could not be fetched in time; try again shortly."}}}}},"security":[]}},"/api/v2/dealers":{"get":{"operationId":"listDealers","tags":["Dealers"],"summary":"The dealers","description":"Active dealers with their public fields, stores and Google ratings (rating.source is always \"Google\": the profile page shows them labelled as Google's; they are never published as schema.org aggregateRating).","responses":{"200":{"description":"Dealers.","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealersResponse"},"example":{"market":"SE","currency":"SEK","generated_at":"2026-11-09T18:05:00.000Z","count":1,"dealers":[{"id":"tavex","name":"Tavex","profile_url":"https://guldpriser.se/handlare/tavex","website":"https://tavex.se","description":null,"dealer_types":["online","store"],"rating":{"source":"Google","value":4.8,"count":120,"collected_at":null},"stores":[{"name":"Stockholm","address":"Exempelgatan 1","zip_code":"111 22","city":"Stockholm","latitude":59.33,"longitude":18.07,"phone":null,"opening_hours":null,"rating":{"source":"Google","value":4.8,"count":120,"collected_at":null}}]}]}}}},"400":{"description":"Bad parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"bad_request","message":"Bad parameter."}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"rate_limited","message":"Rate limit exceeded."}}}},"503":{"description":"The data behind the request could not be fetched in time; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"unavailable","message":"The data behind the request could not be fetched in time; try again shortly."}}}}},"security":[]}},"/api/v2/dealers/{slug}":{"get":{"operationId":"getDealer","tags":["Dealers"],"summary":"One dealer","description":"The dealer with its public fields, stores and Google rating (rating.source is always \"Google\"; never published as schema.org aggregateRating).","parameters":[{"name":"slug","in":"path","required":true,"description":"The dealer id from an offer or from /api/v2/dealers.","schema":{"type":"string"},"example":"tavex"}],"responses":{"200":{"description":"The dealer.","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DealerResponse"},"example":{"market":"SE","currency":"SEK","generated_at":"2026-11-09T18:05:00.000Z","dealer":{"id":"tavex","name":"Tavex","profile_url":"https://guldpriser.se/handlare/tavex","website":"https://tavex.se","description":null,"dealer_types":["online","store"],"rating":null,"stores":[]}}}}},"400":{"description":"Bad parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"bad_request","message":"Bad parameter."}}}},"404":{"description":"Unknown dealer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"Unknown dealer."}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"rate_limited","message":"Rate limit exceeded."}}}},"503":{"description":"The data behind the request could not be fetched in time; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"unavailable","message":"The data behind the request could not be fetched in time; try again shortly."}}}}},"security":[]}},"/api/v2/spot":{"get":{"operationId":"getSpot","tags":["Market"],"summary":"Gold and silver spot price in SEK","responses":{"200":{"description":"Spot prices.","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpotResponse"},"example":{"market":"SE","currency":"SEK","unit_note":"oz is the troy ounce (31.1035 g).","generated_at":"2026-11-09T18:05:00.000Z","source_time":"2026-11-09T18:00:00.000Z","freshness":{"stale":false,"rule":"stale = source time is older than 30 minutes; null when the source time is unknown"},"gold":{"per_gram":1550.1234,"per_oz":48214.5},"silver":{"per_gram":19.5,"per_oz":606.5}}}}},"400":{"description":"Bad parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"bad_request","message":"Bad parameter."}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"rate_limited","message":"Rate limit exceeded."}}}},"503":{"description":"The data behind the request could not be fetched in time; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"unavailable","message":"The data behind the request could not be fetched in time; try again shortly."}}}}},"security":[]}},"/api/v2/sell-quotes/bullion":{"get":{"operationId":"listBullionBuybackQuotes","tags":["Sell"],"summary":"What dealers pay for bullion coins and bars","description":"The buy-back prices of the pages /salj/guld/mynt, /salj/guld/tackor, /salj/silver/mynt and /salj/silver/tackor: for each coin or bar the dealers' bids, best first. A bid is what the dealer pays for ONE coin or bar, in the currency of the answer. These feeds carry no collection time, so collected_at is null. Sibling of /api/v2/sell-quotes (which is by purity and weight): bullion is priced per piece, so it has its own endpoint.","parameters":[{"name":"metal","in":"query","required":true,"schema":{"type":"string","enum":["gold","silver"]},"example":"gold"},{"name":"type","in":"query","required":true,"description":"coin or bar.","schema":{"type":"string","enum":["coin","bar"]},"example":"coin"},{"name":"product","in":"query","required":false,"description":"A coin or bar slug such as krugerrand or britannia (see /api/v2/catalog); a part of the slug or name is enough. Unmatched: 404.","schema":{"type":"string"},"example":"krugerrand"},{"name":"weight","in":"query","required":false,"description":"Nominal weight such as 1oz, 1-2oz (1/2 oz) or 100g.","schema":{"type":"string"},"example":"1oz"}],"responses":{"200":{"description":"Bids per product.","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BullionQuotesResponse"},"example":{"market":"SE","currency":"SEK","metal":"gold","type":"coin","product":"krugerrand","weight":"1oz","page_url":"https://guldpriser.se/salj/guld/mynt","generated_at":"2026-11-09T18:05:00.000Z","collected_at":null,"collected_at_scope":"The bullion buy-back feed carries no collection time; collected_at is null.","unit_note":"bid is what the dealer pays for ONE coin or bar of that product, in the currency of the answer. fineness is per mille.","terms":"kontrollera hos handlaren","count":1,"products":[{"product":"krugerrand","name":"Krugerrand 1 oz","weight_label":"1 oz","weight_g":31.1035,"fineness":916.7,"best_bid":48000,"bids":[{"rank":1,"dealer":{"id":"tavex","name":"Tavex","profile_url":"https://guldpriser.se/handlare/tavex","website":"https://tavex.se"},"bid":48000}],"buy_page_url":"https://guldpriser.se/kop/guldmynt/krugerrand"}]}}}},"400":{"description":"Bad parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"bad_request","message":"Bad parameter."}}}},"404":{"description":"No product in the list matches product/weight.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"No product in the list matches product/weight."}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"rate_limited","message":"Rate limit exceeded."}}}},"503":{"description":"The data behind the request could not be fetched in time; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"unavailable","message":"The data behind the request could not be fetched in time; try again shortly."}}}}},"security":[]}},"/api/v2/spot/history":{"get":{"operationId":"getSpotHistory","tags":["Market"],"summary":"Gold or silver price history","description":"The market (spot) price series the charts at page_url draw (no dealer margin, no shipping), as points with timestamps. Currency SEK, DKK, USD, EUR, NOK, GBP; unit g, kg or oz (troy ounce, 31.1035 g). Caps: at most 2000 points and 3660 days per call; hourly at most 31 days. A request over a cap is a 400 that says how to narrow it, never silently cut. source_time is when the series was fetched from the source (null if unknown); each point carries its own time.","parameters":[{"name":"metal","in":"query","required":true,"schema":{"type":"string","enum":["gold","silver"]},"example":"gold"},{"name":"from","in":"query","required":false,"description":"Start: ISO 8601 date (2026-10-01) or date-time with Z or an offset. Default: 30 days before to.","schema":{"type":"string"},"example":"2026-10-01"},{"name":"to","in":"query","required":false,"description":"End: ISO 8601; a date alone includes that whole day (UTC). Default: now.","schema":{"type":"string"},"example":"2026-11-09"},{"name":"interval","in":"query","required":false,"description":"auto (default): the series with enough resolution for the range, as the charts choose it; hourly (up to 31 days); daily (up to the stored daily series); monthly (the last point of each month). The answer names the interval used.","schema":{"type":"string","enum":["auto","hourly","daily","monthly"],"default":"auto"}},{"name":"currency","in":"query","required":false,"description":"Currency code, case-insensitive.","schema":{"type":"string","enum":["SEK","DKK","USD","EUR","NOK","GBP"],"default":"SEK"}},{"name":"unit","in":"query","required":false,"description":"Weight unit of the price.","schema":{"type":"string","enum":["g","kg","oz"],"default":"g"}}],"responses":{"200":{"description":"Points.","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpotHistoryResponse"},"example":{"market":"SE","metal":"gold","currency":"SEK","unit":"g","interval":"daily","requested_interval":"auto","from":"2026-10-01T00:00:00.000Z","to":"2026-11-09T23:59:59.999Z","count":2,"points":[{"time":"2026-11-08T00:00:00.000Z","price":1540.1},{"time":"2026-11-09T00:00:00.000Z","price":1550.2}],"price_note":"The market (spot) price of gold per gram in SEK, as the chart at page_url draws it: no dealer margin, no shipping. Time is the point's own time (ISO 8601 UTC).","caps":{"max_points":2000,"max_range_days":3660,"hourly_max_days":31},"source_time":"2026-11-09T18:00:00.000Z","generated_at":"2026-11-09T18:05:00.000Z","page_url":"https://guldpriser.se/grafer/guld"}}}},"400":{"description":"Bad parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"bad_request","message":"Bad parameter."}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"rate_limited","message":"Rate limit exceeded."}}}},"503":{"description":"The data behind the request could not be fetched in time; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"unavailable","message":"The data behind the request could not be fetched in time; try again shortly."}}}}},"security":[]}},"/api/v2/catalog":{"get":{"operationId":"getCatalog","tags":["Catalog"],"summary":"Categories, weight pages, coin types and accepted values","description":"What the other endpoints accept: the four categories, each with its size slugs (weight pages, /kop/{category}/{size}) and coin slugs (coin types of a coin category), with title, metal, weight_g (nominal weight in grams where the slug names one, else null) and page_url; and the karat and purity values /api/v2/sell-quotes takes.","responses":{"200":{"description":"The catalogue.","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"},"example":{"market":"SE","currency":"SEK","generated_at":"2026-11-09T18:05:00.000Z","unit_note":"weight_g is the nominal weight in grams (1 oz = 31.1035 g); null where the slug names no weight.","categories":[{"slug":"guldtackor","title":"Guldtackor","metal":"gold","form":"bar","page_url":"https://guldpriser.se/kop/guldtackor","sizes":[{"slug":"100g","title":"100 gram guldtacka","metal":"gold","weight_g":100,"page_url":"https://guldpriser.se/kop/guldtackor/100g","offers_url":"https://guldpriser.se/api/v2/offers?category=guldtackor&size=100g"}],"coins":[]}],"sell_quotes":{"page_url":"https://guldpriser.se/salj","gold":{"karat":[{"karat":"18","purity":"750","label":"18 karat"}],"purity":[{"purity":"750","label":"18 karat"}]},"silver":{"purity":[{"purity":"925","label":"Sterling 925"}]},"grams":{"above":0,"max":100000},"max_items":12,"bullion":{"metals":["gold","silver"],"types":["coin","bar"],"pages":["https://guldpriser.se/salj/guld/mynt"]}}}}}},"400":{"description":"Bad parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"bad_request","message":"Bad parameter."}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"rate_limited","message":"Rate limit exceeded."}}}},"503":{"description":"The data behind the request could not be fetched in time; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"unavailable","message":"The data behind the request could not be fetched in time; try again shortly."}}}}},"security":[]}},"/api/v2/rankings/cheapest-dealers":{"get":{"operationId":"getCheapestDealerRanking","tags":["Rankings"],"summary":"Which dealer has the lowest price on how many products","description":"A neutral ranking: for every gold and silver product that has a product page and at least 2 dealers with an eligible offer (price, confirmed stock, deliverable, known shipping), the dealer the product page itself ranks first and badges «Bästa pris» wins the product; dealers at exactly the same total share it. Products with a single seller are counted separately and never win. Each dealer lists its won products with page_url, total and collected_at so every count can be verified. The rules are in the `method` object and on https://guldpriser.se/topplista. Computed from listings read no older than 70 seconds by the catalogue's own fetch time (generated_at); each price carries its own collection time (collected_at), which can be older. The answer is 503 rather than partial counts or an older copy.","parameters":[{"name":"metal","in":"query","required":false,"description":"Only gold or only silver products. Omit for both.","schema":{"type":"string","enum":["gold","silver"]},"example":"gold"}],"responses":{"200":{"description":"The ranking, dealers sorted by wins, then share, then name.","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["market","currency","page_url","metal","generated_at","collected","products","dealers","method"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK","description":"The currency of every amount in this answer (ISO 4217); always SEK on this site."},"page_url":{"type":"string","format":"uri"},"method_url":{"type":"string","format":"uri"},"metal":{"type":"string","enum":["all","gold","silver"]},"generated_at":{"type":"string","format":"date-time"},"collected":{"type":"object","properties":{"oldest":{"type":["string","null"],"format":"date-time"},"newest":{"type":["string","null"],"format":"date-time"}}},"products":{"type":"object","properties":{"with_product_page":{"type":"integer"},"contested":{"type":"integer"},"sole_seller":{"type":"integer"},"no_eligible_offer":{"type":"integer"}}},"dealers":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer"},"id":{"type":"string"},"name":{"type":"string"},"profile_url":{"type":["string","null"],"format":"uri"},"wins":{"type":"integer"},"tied_wins":{"type":"integer"},"contested_products":{"type":"integer"},"share":{"type":["number","null"],"description":"wins / contested_products."},"sole_seller_products":{"type":"integer"},"won_products":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"integer"},"name":{"type":"string"},"page_url":{"type":"string","format":"uri"},"total":{"type":"number"},"price":{"type":"number"},"shipping":{"type":"number"},"collected_at":{"type":["string","null"],"format":"date-time"},"tied_with":{"type":"array","items":{"type":"string"}}}}}}}},"method":{"type":"object","additionalProperties":{"type":"string"},"description":"The counting rules, one short sentence each."}}},"example":{"market":"SE","currency":"SEK","page_url":"https://guldpriser.se/topplista","method_url":"https://guldpriser.se/topplista#sa-raknar-vi","metal":"all","generated_at":"2026-11-09T18:05:00.000Z","collected":{"oldest":"2026-11-09T17:41:03.000Z","newest":"2026-11-09T18:04:40.000Z"},"products":{"with_product_page":211,"contested":40,"sole_seller":12,"no_eligible_offer":20},"dealers":[{"rank":1,"id":"tavex","name":"Tavex","profile_url":"https://guldpriser.se/handlare/tavex","wins":15,"tied_wins":1,"contested_products":40,"share":0.375,"sole_seller_products":3,"won_products":[{"product_id":45,"name":"Valcambi Suisse 100 gram guldtacka","page_url":"https://guldpriser.se/produkt/valcambi-suisse-100-gram-guldtacka-45","total":150000,"price":150000,"shipping":0,"collected_at":"2026-11-09T18:02:11.518Z","tied_with":[]}]}],"method":{"universe":"Every buy-side gold and silver product that has a product page on guldpriser.se (/produkt/...). metal=gold|silver narrows it.","eligible_offer":"A dealer offer counts when it has a price, stock confirmed as in stock (unknown stock never counts), can be delivered and has a known shipping cost: the same rule as the «Bästa pris» badge on the product page. Offers the page hides by default (sold out, circulated or mixed vintages) do not count. Offer age is not a filter, as on the page; collected_at is given for every won product.","contested":"A product is contested when at least 2 different dealers have an eligible offer for it. Only contested products can be won. Products with a single seller are counted separately as sole_seller_products and are never «cheapest».","cheapest":"The dealer whose offer is first in the product page's default order (lowest total = price + shipping) and carries the «Bästa pris» badge. The same comparator and badge code runs on the page and here. A dealer's best eligible offer on a product is the one used.","ties":"Every dealer at exactly the lowest total gets the product. Those wins are also counted in tied_wins, and each won product lists the other dealers in tied_with.","per_dealer":"wins, contested_products (contested products where the dealer has an eligible offer), share = wins / contested_products, tied_wins, sole_seller_products and won_products (page_url, total, collected_at) so every count can be checked on the product page.","order":"Sorted by wins (descending), then share (descending), then name. Equal wins and share share a rank.","live":"Computed from the catalogue as read at generated_at: the listings are read no older than 70 seconds by the catalogue's own fetch time (a minute, plus 10 seconds for the read itself), never from an older stored copy, at most once every 60 seconds, and the answer is cached for at most 60 seconds. generated_at is when that read was made; collected.oldest / collected.newest and each won product's collected_at are the dealers' own collection times of the prices used, which can be older. If any part of the data could not be read in time the answer is 503; partial counts and older copies are never published.","neutrality":"The same rule for every dealer: no manual adjustments, no featured placement."}}}}},"400":{"description":"Unknown parameter, or metal is not gold or silver.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Some of the data could not be read in time. No partial ranking is published; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[]}},"/api/v2/news":{"get":{"operationId":"listNews","tags":["News"],"summary":"Published articles, newest first","description":"Title, category (Podd, Fördjupning, Prisbevakning, Marknadsnyhet ...; null for an article without a known type), published_at, updated_at (when the text was last changed at least a minute after publication; null if never), url, api_url and the article's own summary. Summaries only, never the body: GET api_url (or /api/v2/news/{id}) returns the whole article as Markdown. Page backwards with before = next_before. The same list as the RSS feed at /nyheter/feed.xml.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"before","in":"query","required":false,"description":"Only articles published before this ISO 8601 date or date-time.","schema":{"type":"string"},"example":"2026-11-01"}],"responses":{"200":{"description":"Articles.","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsResponse"},"example":{"market":"SE","currency":"SEK","generated_at":"2026-11-09T18:05:00.000Z","count":1,"next_before":null,"feed_url":"https://guldpriser.se/nyheter/feed.xml","page_url":"https://guldpriser.se/","articles":[{"id":"6f1c0a52-0000-4000-8000-000000000001","title":"Guldpriset i veckan","category":"Veckoöversikt","published_at":"2026-11-09T07:00:00.000Z","updated_at":null,"url":"https://guldpriser.se/nyheter/guldpriset-i-veckan-2026-11-09","api_url":"https://guldpriser.se/api/v2/news/guldpriset-i-veckan-2026-11-09","summary":"Kort sammanfattning."}]}}}},"400":{"description":"Bad parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"bad_request","message":"Bad parameter."}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"rate_limited","message":"Rate limit exceeded."}}}},"503":{"description":"The data behind the request could not be fetched in time; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"unavailable","message":"The data behind the request could not be fetched in time; try again shortly."}}}}},"security":[]}},"/api/v2/news/{id}":{"get":{"operationId":"getNewsArticle","tags":["News"],"summary":"One published article in full, as Markdown","description":"The article exactly as /nyheter/{id} shows it: title, category, published_at, updated_at, summary, the hero image (url and alt) when the page shows one, the sources the page lists and the whole text as Markdown in body_markdown. Headings, paragraphs, lists, bold, italics and links are Markdown; the article's components (tables, key-point boxes, product cards and lists, price boxes, notices ...) are their readable text: a Markdown table, or a product's name, facts, best price and link. Only published articles exist here: an unpublished or held article is 404. The article is guldpriser.se's own editorial content, written in Swedish: cite it with page_url. Figures in the text are those of the time it was written, except the best price of a product card, which is read live as on the page; current prices are at /api/v2/offers. id is the address slug of the article page (the id of /api/v2/news items); an older address or the article's uuid also resolves, and the answer carries the current id.","parameters":[{"name":"id","in":"path","required":true,"description":"The article's address slug, as in /nyheter/{id}; the id field of a /api/v2/news item.","schema":{"type":"string"},"example":"guldpriset-i-veckan-2026-11-09"}],"responses":{"200":{"description":"The article.","headers":{"Cache-Control":{"description":"Cached by the edge for 60 seconds (s-maxage=60).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsArticleFull"},"example":{"market":"SE","currency":"SEK","generated_at":"2026-11-09T18:05:00.000Z","id":"guldpriset-i-veckan-2026-11-09","title":"Guldpriset i veckan","category":"Veckoöversikt","published_at":"2026-11-09T07:00:00.000Z","updated_at":null,"page_url":"https://guldpriser.se/nyheter/guldpriset-i-veckan-2026-11-09","api_url":"https://guldpriser.se/api/v2/news/guldpriset-i-veckan-2026-11-09","summary":"Kort sammanfattning.","hero_image":{"url":"https://example.supabase.co/storage/v1/object/public/news-images/hero/2026-11-09-C/0000.webp","alt":"Guldtackor på ett bord"},"body_markdown":"## Veckan\n\nGuldpriset steg under veckan.\n\n### Det viktigaste\n\n- Guldet steg\n- Silvret var oförändrat\n","source_urls":["https://example.com/kalla"]}}}},"400":{"description":"Bad parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"bad_request","message":"Bad parameter."}}}},"404":{"description":"No published article with this id. GET /api/v2/news lists the articles with their id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"No published article with this id. GET /api/v2/news lists the articles with their id."}}}},"429":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"description":"Seconds until a request is allowed again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"rate_limited","message":"Rate limit exceeded."}}}},"503":{"description":"The data behind the request could not be fetched in time; try again shortly.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"unavailable","message":"The data behind the request could not be fetched in time; try again shortly."}}}}},"security":[]}}},"components":{"schemas":{"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string","enum":["bad_request","not_found","method_not_allowed","rate_limited","unavailable"]},"message":{"type":"string"}}},"SellQuoteItemsResponse":{"type":"object","required":["market","currency","metal","items","total_grams","collected_at","dealers","page_url","generated_at","count","complete_count"],"description":"The answer to /api/v2/sell-quotes?items=: the quotes per item and per-dealer totals across the items.","properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK","description":"The currency of every amount in this answer (ISO 4217); always SEK on this site."},"metal":{"type":"string","enum":["gold","silver"]},"items":{"type":"array","items":{"type":"object","properties":{"purity":{"type":"string"},"purity_label":{"type":"string"},"grams":{"type":"number"},"fine_content_g":{"type":"number"},"quotes":{"type":"array","items":{"$ref":"#/components/schemas/SellQuote"}}}}},"total_grams":{"type":"number"},"collected_at":{"type":["string","null"],"format":"date-time","description":"One time for the whole buy-back feed, not per dealer."},"dealers":{"type":"array","items":{"$ref":"#/components/schemas/SellItemsDealer"},"description":"Dealers that quote every item first (ranked by total), then the partial ones (rank null, by quoted_total)."},"page_url":{"type":"string","format":"uri"},"generated_at":{"type":"string","format":"date-time"},"collected_at_scope":{"type":"string"},"terms":{"type":"string"},"count":{"type":"integer"},"complete_count":{"type":"integer","description":"Dealers that quote every item."},"partial_note":{"type":"string"}}},"SellItemsDealer":{"type":"object","required":["rank","dealer","complete","total","quoted_total","missing_purities","terms"],"properties":{"rank":{"type":["integer","null"],"description":"Among the dealers that quote every item; null when complete is false."},"dealer":{"allOf":[{"$ref":"#/components/schemas/DealerRef"},{"type":"object","properties":{"website":{"type":["string","null"],"format":"uri"}}}]},"complete":{"type":"boolean","description":"True when the dealer gives a quote for every item; only then is total a bid for the whole lot."},"total":{"type":["number","null"],"description":"Sum of the payouts of all items; null unless complete. Never a partial sum."},"quoted_total":{"type":"number","description":"Sum of the payouts of the items the dealer does quote."},"missing_purities":{"type":"array","items":{"type":"string"},"description":"The purities the dealer gives no quote for."},"terms":{"type":"string","const":"kontrollera hos handlaren"}}},"BullionQuotesResponse":{"type":"object","required":["market","currency","metal","type","page_url","generated_at","collected_at","products","count"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK","description":"The currency of every amount in this answer (ISO 4217); always SEK on this site."},"metal":{"type":"string","enum":["gold","silver"]},"type":{"type":"string","enum":["coin","bar"]},"product":{"type":["string","null"],"description":"The product filter as requested, or null."},"weight":{"type":["string","null"],"description":"The weight filter as requested, or null."},"page_url":{"type":"string","format":"uri"},"generated_at":{"type":"string","format":"date-time"},"collected_at":{"type":"null","description":"Always null: the bullion buy-back feeds carry no collection time."},"collected_at_scope":{"type":"string"},"unit_note":{"type":"string"},"terms":{"type":"string"},"count":{"type":"integer"},"products":{"type":"array","items":{"type":"object","required":["product","name","weight_label","weight_g","fineness","best_bid","bids","buy_page_url"],"properties":{"product":{"type":"string","description":"The coin or bar slug, as in /api/v2/catalog."},"name":{"type":"string"},"weight_label":{"type":"string"},"weight_g":{"type":["number","null"]},"fineness":{"type":["number","null"],"description":"Per mille."},"best_bid":{"type":["number","null"],"description":"Highest bid for one piece; null when no dealer bids."},"bids":{"type":"array","items":{"type":"object","required":["rank","dealer","bid"],"properties":{"rank":{"type":"integer"},"dealer":{"allOf":[{"$ref":"#/components/schemas/DealerRef"},{"type":"object","properties":{"website":{"type":["string","null"],"format":"uri"}}}]},"bid":{"type":"number","description":"What the dealer pays for one piece, in the currency of the answer."}}}},"buy_page_url":{"type":["string","null"],"format":"uri","description":"The product's page where it is bought."}}}}}},"SpotHistoryResponse":{"type":"object","required":["market","metal","currency","unit","interval","requested_interval","from","to","count","points","caps","source_time","generated_at","page_url"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"metal":{"type":"string","enum":["gold","silver"]},"currency":{"type":"string","enum":["SEK","DKK","USD","EUR","NOK","GBP"]},"unit":{"type":"string","enum":["g","kg","oz"]},"interval":{"type":"string","enum":["hourly","daily","monthly"],"description":"The resolution actually used."},"requested_interval":{"type":"string","enum":["auto","hourly","daily","monthly"]},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"count":{"type":"integer"},"points":{"type":"array","items":{"type":"object","required":["time","price"],"properties":{"time":{"type":"string","format":"date-time"},"price":{"type":"number","description":"Price per unit in currency."}}}},"price_note":{"type":"string"},"caps":{"type":"object","properties":{"max_points":{"type":"integer"},"max_range_days":{"type":"integer"},"hourly_max_days":{"type":"integer"}}},"source_time":{"type":["string","null"],"format":"date-time","description":"When the series was fetched from the source; null when unknown."},"generated_at":{"type":"string","format":"date-time"},"page_url":{"type":"string","format":"uri"}}},"CatalogEntry":{"type":"object","required":["slug","title","metal","weight_g","page_url","offers_url"],"properties":{"slug":{"type":"string","description":"The size / coin slug: /kop/{category}/{slug}, and size= or product= in the API."},"title":{"type":"string"},"metal":{"type":"string","enum":["gold","silver"]},"weight_g":{"type":["number","null"],"description":"Nominal weight in grams where the slug names one; null otherwise."},"page_url":{"type":"string","format":"uri"},"offers_url":{"type":"string","format":"uri","description":"The /api/v2/offers call for this page."}}},"CatalogResponse":{"type":"object","required":["market","currency","generated_at","unit_note","categories","sell_quotes"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK","description":"The currency of every amount in this answer (ISO 4217); always SEK on this site."},"generated_at":{"type":"string","format":"date-time"},"unit_note":{"type":"string"},"categories":{"type":"array","items":{"type":"object","required":["slug","title","metal","form","page_url","sizes","coins"],"properties":{"slug":{"type":"string","enum":["guldtackor","guldmynt","silvertackor","silvermynt"]},"title":{"type":"string"},"metal":{"type":"string","enum":["gold","silver"]},"form":{"type":"string","enum":["bar","coin"]},"page_url":{"type":"string","format":"uri"},"sizes":{"type":"array","items":{"$ref":"#/components/schemas/CatalogEntry"}},"coins":{"type":"array","items":{"$ref":"#/components/schemas/CatalogEntry"},"description":"Coin types of a coin category (maple-leaf, krugerrand ...); empty for bars."}}}},"sell_quotes":{"type":"object","description":"The values /api/v2/sell-quotes and /api/v2/sell-quotes/bullion accept.","properties":{"page_url":{"type":"string","format":"uri"},"gold":{"type":"object","properties":{"karat":{"type":"array","items":{"type":"object","properties":{"karat":{"type":"string"},"purity":{"type":"string"},"label":{"type":"string"}}}},"purity":{"type":"array","items":{"type":"object","properties":{"purity":{"type":"string"},"label":{"type":"string"}}}}}},"silver":{"type":"object","properties":{"purity":{"type":"array","items":{"type":"object","properties":{"purity":{"type":"string"},"label":{"type":"string"}}}}}},"grams":{"type":"object","properties":{"above":{"type":"number"},"max":{"type":"number"}}},"max_items":{"type":"integer"},"bullion":{"type":"object","properties":{"metals":{"type":"array","items":{"type":"string"}},"types":{"type":"array","items":{"type":"string"}},"pages":{"type":"array","items":{"type":"string","format":"uri"}}}}}}}},"NewsArticle":{"type":"object","required":["id","title","category","published_at","updated_at","url","api_url","summary"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"type":["string","null"],"description":"Podd, Fördjupning, Prisbevakning, Marknadsnyhet, Veckoöversikt, Prognos, Köpguide, Butiksmarknaden or Produktporträtt; null when unknown."},"published_at":{"type":"string","format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time","description":"Last text change at least a minute after publication; null if never."},"url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri","description":"GET this for the whole article as Markdown (getNewsArticle)."},"summary":{"type":"string","description":"The article's own summary; empty when it has none. Never the body."}}},"NewsArticleFull":{"type":"object","required":["market","currency","generated_at","id","title","category","published_at","updated_at","page_url","api_url","summary","hero_image","body_markdown","source_urls"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK","description":"The currency of every amount in this answer (ISO 4217); always SEK on this site."},"generated_at":{"type":"string","format":"date-time"},"id":{"type":"string","description":"The article's current address slug."},"title":{"type":"string"},"category":{"type":["string","null"],"description":"Podd, Fördjupning, Prisbevakning, Marknadsnyhet, Veckoöversikt, Prognos, Köpguide, Butiksmarknaden or Produktporträtt; null when unknown."},"published_at":{"type":"string","format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time","description":"Last text change at least a minute after publication; null if never."},"page_url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"},"summary":{"type":"string","description":"The article's own summary; empty when it has none."},"hero_image":{"type":["object","null"],"description":"The picture the page shows at the top; null when it shows none.","required":["url","alt"],"properties":{"url":{"type":"string","format":"uri"},"alt":{"type":"string"}}},"body_markdown":{"type":"string","description":"The whole article as Markdown, in Swedish. Components are their readable text (Markdown tables, product name + facts + best price + link)."},"source_urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"The sources the page lists under «Källor»."}}},"NewsResponse":{"type":"object","required":["market","currency","generated_at","count","articles","next_before","feed_url","page_url"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK","description":"The currency of every amount in this answer (ISO 4217); always SEK on this site."},"generated_at":{"type":"string","format":"date-time"},"count":{"type":"integer"},"articles":{"type":"array","items":{"$ref":"#/components/schemas/NewsArticle"}},"next_before":{"type":["string","null"],"format":"date-time","description":"Pass as before for the next page; null on the last page."},"feed_url":{"type":"string","format":"uri"},"page_url":{"type":"string","format":"uri"}}},"Freshness":{"type":"object","required":["stale","rule"],"properties":{"stale":{"type":["boolean","null"],"description":"null when the collection time is unknown."},"rule":{"type":"string"}}},"DealerRef":{"type":"object","required":["id","name","profile_url"],"properties":{"id":{"type":"string","description":"Stable slug, the same as in /handlare/{id}."},"name":{"type":"string"},"profile_url":{"type":["string","null"],"format":"uri","description":"null when the dealer has no profile page."}}},"Product":{"type":"object","required":["id","name","manufacturer","metal","weight_g","fine_weight_g","fineness","url"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"manufacturer":{"type":["string","null"]},"metal":{"type":["string","null"],"description":"gold or silver."},"weight_g":{"type":["number","null"],"description":"Gross weight in grams."},"fine_weight_g":{"type":["number","null"],"description":"Grams of fine metal, as the catalogue gives it."},"fineness":{"type":["number","null"],"description":"Per mille, e.g. 999.9."},"url":{"type":"string","format":"uri","description":"Canonical product page."}}},"Offer":{"type":"object","required":["market","currency","id","product","dealer","price","price_per_gram","shipping","total","stock","collected_at","freshness","offer_url","circulated"],"properties":{"id":{"type":"integer","description":"The listing id in the catalogue."},"product":{"$ref":"#/components/schemas/Product"},"dealer":{"$ref":"#/components/schemas/DealerRef"},"market":{"type":"string","const":"SE","description":"The market the offer belongs to (ISO 3166-1 alpha-2)."},"currency":{"type":"string","const":"SEK","description":"The currency of the offer price, shipping and total (ISO 4217)."},"price":{"type":"number","description":"Price of one unit, in the currency of the offer, incl. moms (VAT)."},"price_per_gram":{"type":["number","null"]},"shipping":{"type":"object","required":["status","cost","reason"],"properties":{"status":{"type":"string","enum":["free","known","unknown"],"description":"free = a known cost of 0; unknown = no cost known (never 0)."},"cost":{"type":["number","null"],"description":"null when status is unknown."},"reason":{"type":["string","null"],"enum":["pickup_only","not_deliverable",null],"description":"Set when the dealer does not deliver."}}},"total":{"type":["number","null"],"description":"price + shipping; null unless shipping is known."},"stock":{"type":"object","required":["status","quantity"],"properties":{"status":{"type":"string","enum":["in_stock","out_of_stock","unknown"],"description":"unknown is never in stock."},"quantity":{"type":["integer","null"]}}},"collected_at":{"type":["string","null"],"format":"date-time","description":"When the dealer's price was collected, from the source."},"freshness":{"$ref":"#/components/schemas/Freshness"},"offer_url":{"type":["string","null"],"format":"uri","description":"The dealer's own product page (the \"Köp nu\" link)."},"circulated":{"type":"boolean","description":"true for a mixed or circulated listing (price for whatever mint and condition the dealer has); only returned with include_circulated=true. false for every other offer."}}},"OffersResponse":{"type":"object","required":["market","currency","category","size","manufacturer","weight","title","page_url","generated_at","sort","collected","total_matching","count","hidden","offers"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK","description":"The currency of every amount in this answer (ISO 4217); always SEK on this site."},"category":{"type":"string"},"size":{"type":["string","null"],"description":"null when the request gave no size (manufacturer only)."},"manufacturer":{"type":["string","null"],"description":"The manufacturer filter as requested, or null."},"weight":{"type":["string","null"],"description":"The weight filter as requested, or null."},"title":{"type":["string","null"]},"page_url":{"type":"string","format":"uri"},"generated_at":{"type":"string","format":"date-time"},"sort":{"type":"string","enum":["total","price","price_per_gram"]},"collected":{"type":"object","required":["oldest","newest"],"description":"The oldest and newest collected_at among the returned offers.","properties":{"oldest":{"type":["string","null"],"format":"date-time"},"newest":{"type":["string","null"],"format":"date-time"}}},"total_matching":{"type":"integer","description":"Offers matching the filters before limit."},"count":{"type":"integer"},"hidden":{"type":"object","required":["circulated","sold_out","cheapest_circulated_total","note"],"description":"What this request left out of offers, so a hidden offer is never a surprise. A count is 0 when its include_ parameter is true.","properties":{"circulated":{"type":"integer","description":"Mixed or circulated listings left out (include_circulated=true returns them)."},"sold_out":{"type":"integer","description":"Sold-out offers left out (include_sold_out=true returns them); a circulated sold-out offer counts as circulated."},"cheapest_circulated_total":{"type":["number","null"],"description":"Lowest known total (price + shipping) among the hidden circulated offers that are not sold out; null when none has one."},"note":{"type":"string","const":"hidden counts the offers this request left out. circulated: mixed or circulated listings (a dealer's «olika tillverkare och skick», «blandade», «cirkulerade»), whose price is for whatever mint and condition the dealer has and so is not comparable with a named product; they are hidden from the comparison and from «Bästa pris» on the site while a comparable offer is in stock (a page with none shows them by itself), and returned with include_circulated=true (each has circulated: true). sold_out: offers with stock.status out_of_stock, returned with include_sold_out=true. A circulated sold-out offer counts as circulated and is returned only with both include_circulated=true and include_sold_out=true. cheapest_circulated_total: the lowest known total (price + shipping) among the hidden circulated offers that are not sold out, null when none has one. A hidden count is 0 when its include_ parameter is true."}}},"offers":{"type":"array","items":{"$ref":"#/components/schemas/Offer"}}}},"SellQuote":{"type":"object","required":["rank","dealer","price_per_gram","payout","terms"],"properties":{"rank":{"type":"integer","description":"Ties share a rank."},"dealer":{"allOf":[{"$ref":"#/components/schemas/DealerRef"},{"type":"object","properties":{"website":{"type":["string","null"],"format":"uri"}}}]},"price_per_gram":{"type":"number","description":"The dealer's quote per gross gram of this purity, in the currency of the answer."},"payout":{"type":"number","description":"price_per_gram × grams, rounded to 2 decimals."},"terms":{"type":"string","const":"kontrollera hos handlaren"}}},"SellQuotesResponse":{"type":"object","required":["market","currency","metal","purity","purity_label","grams","fine_content_g","collected_at","quotes","page_url","generated_at","count"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK","description":"The currency of every amount in this answer (ISO 4217); always SEK on this site."},"metal":{"type":"string","enum":["gold","silver"]},"purity":{"type":"string"},"purity_label":{"type":"string"},"grams":{"type":"number"},"fine_content_g":{"type":"number","description":"Grams of fine metal in the weight; information only, already inside the quote."},"collected_at":{"type":["string","null"],"format":"date-time","description":"One time for the whole buy-back feed, not per dealer."},"collected_at_scope":{"type":"string"},"terms":{"type":"string"},"page_url":{"type":"string","format":"uri"},"generated_at":{"type":"string","format":"date-time"},"count":{"type":"integer"},"quotes":{"type":"array","items":{"$ref":"#/components/schemas/SellQuote"}}}},"Store":{"type":"object","properties":{"name":{"type":"string"},"address":{"type":["string","null"]},"zip_code":{"type":["string","null"]},"city":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"phone":{"type":["string","null"]},"opening_hours":{"description":"Opening hours as the dealer page shows them, or null."},"rating":{"oneOf":[{"$ref":"#/components/schemas/Rating"},{"type":"null"}],"description":"The store's Google rating; null when it has none."}}},"Rating":{"type":"object","required":["source","value","count","collected_at"],"description":"A rating as Google gave it. Always named as Google's; never published as schema.org aggregateRating.","properties":{"source":{"type":"string","const":"Google"},"value":{"type":"number","minimum":0,"maximum":5,"description":"Stars."},"count":{"type":"integer","description":"Google reviews behind the value."},"collected_at":{"type":["string","null"],"format":"date-time","description":"When the rating was collected; null: the source stores no time for the rating."}}},"Dealer":{"description":"The dealer as its profile page describes it. rating is Google's rating as the profile page shows it (stores weighted by review count), named as Google's; the page's JSON-LD carries no rating.","allOf":[{"$ref":"#/components/schemas/DealerRef"},{"type":"object","required":["website","description","dealer_types","rating","stores"],"properties":{"website":{"type":["string","null"],"format":"uri"},"description":{"type":["string","null"]},"rating":{"oneOf":[{"$ref":"#/components/schemas/Rating"},{"type":"null"}],"description":"The dealer's Google rating, the stores' ratings weighted by review count as the profile page shows it; null when no store has one."},"dealer_types":{"type":"array","items":{"type":"string"}},"stores":{"type":"array","items":{"$ref":"#/components/schemas/Store"}}}}]},"DealersResponse":{"type":"object","required":["market","currency","generated_at","count","dealers"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK","description":"The currency of every amount in this answer (ISO 4217); always SEK on this site."},"generated_at":{"type":"string","format":"date-time"},"count":{"type":"integer"},"dealers":{"type":"array","items":{"$ref":"#/components/schemas/Dealer"}}}},"DealerResponse":{"type":"object","required":["market","currency","generated_at","dealer"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK","description":"The currency of every amount in this answer (ISO 4217); always SEK on this site."},"generated_at":{"type":"string","format":"date-time"},"dealer":{"$ref":"#/components/schemas/Dealer"}}},"SpotResponse":{"type":"object","required":["market","currency","generated_at","source_time","freshness","gold","silver"],"properties":{"market":{"type":"string","const":"SE","description":"The market this answer is for (ISO 3166-1 alpha-2); always SE on this site."},"currency":{"type":"string","const":"SEK"},"unit_note":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"source_time":{"type":["string","null"],"format":"date-time","description":"When the spot source recorded the price; null when unknown."},"freshness":{"$ref":"#/components/schemas/Freshness"},"gold":{"type":"object","required":["per_gram","per_oz"],"properties":{"per_gram":{"type":"number"},"per_oz":{"type":"number"}}},"silver":{"type":"object","required":["per_gram","per_oz"],"properties":{"per_gram":{"type":"number"},"per_oz":{"type":"number"}}}}}}}}