{"openapi":"3.0.3","info":{"title":"MetalCharts API","description":"Real-time and historical precious metals, commodities, crypto, and market data.","version":"1.0.0"},"servers":[{"url":"https://api.metalcharts.org","description":"Production"},{"url":"http://localhost:4000","description":"Local development"}],"tags":[{"name":"Prices","description":"Real-time spot prices for all supported assets"},{"name":"History","description":"Historical price data and candles"},{"name":"Metals","description":"Precious and base metals data"},{"name":"Futures","description":"Futures contracts and settlement data"},{"name":"Regional","description":"Regional exchange data (COMEX, LBMA, Shanghai, India, GFEX)"},{"name":"Commodities","description":"Energy, agriculture, and industrial commodities"},{"name":"Crypto","description":"Cryptocurrency prices and history"},{"name":"ETFs","description":"Exchange-traded fund prices and history"},{"name":"Markets","description":"Market indices and 24/7 markets"},{"name":"News","description":"Market news, sentiment, and summaries"},{"name":"Analytics","description":"COT positioning, supply, ATH, currency rates, and economic calendar"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Pass your API key as: Authorization: Bearer mc_live_..."}},"schemas":{}},"paths":{"/v1/prices/":{"get":{"description":"Latest spot prices for all supported assets (precious and base metals plus key benchmarks) in a single call, keyed by symbol.","tags":["Prices"],"parameters":[{"name":"symbols","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Prices"}},"/v1/history/{symbol}":{"get":{"description":"Historical price series for a metal. Symbols are the metal codes, not names: XAU (gold), XAG (silver), XPT (platinum), XPD (palladium), HG (copper), plus ALI, NI, ZN, PB, SN, JBP, LC and UXA. `GOLD` is not valid here; it belongs to /v1/markets. Use the range parameter (for example 1M, 6M, 1Y) or explicit start and end dates to set the window, and interval to pick the candle size. Supported intervals are 15m, 30m, 45m, 1h, 2h, 4h, 8h, 1d, 1w and 1M; intraday intervals read the interval candle tables and 1w/1M are aggregated from daily candles.","tags":["History"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["XAU"],"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string"}},{"name":"start","in":"query","required":false,"schema":{"type":"string"}},{"name":"end","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1HistoryBySymbol"}},"/v1/futures/":{"get":{"description":"Latest futures quotes across supported exchanges including COMEX, LME, SHFE, and GFEX.","tags":["Futures"],"parameters":[{"name":"symbols","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Futures"}},"/v1/metals/":{"get":{"description":"Reference list of supported metals with their names, categories, and units.","tags":["Prices"],"parameters":[{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Metals"}},"/v1/market-status/":{"get":{"description":"Current open or closed status and trading hours for supported exchanges.","tags":["Markets"],"parameters":[{"name":"exchange","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Market-status"}},"/v1/currency/":{"get":{"description":"Latest foreign exchange rates against a base currency (USD by default).","tags":["Analytics"],"operationId":"getV1Currency"}},"/v1/health/":{"get":{"tags":["Markets"],"operationId":"getV1Health"}},"/v1/shanghai/":{"get":{"description":"Latest Shanghai Gold Exchange spot prices and premium to Western pricing.","tags":["Regional"],"parameters":[{"name":"symbols","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"series","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Shanghai"}},"/v1/shanghai/history":{"get":{"description":"Historical Shanghai premium series versus Western pricing. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"series","in":"query","required":false,"schema":{"type":"string"}},{"name":"start","in":"query","required":false,"schema":{"type":"string"}},{"name":"end","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1ShanghaiHistory"}},"/v1/shanghai/gold/history":{"get":{"description":"Historical Shanghai gold price series. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"series","in":"query","required":false,"schema":{"type":"string"}},{"name":"start","in":"query","required":false,"schema":{"type":"string"}},{"name":"end","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1ShanghaiGoldHistory"}},"/v1/india/":{"get":{"description":"Latest MCX India spot prices and premium to Western pricing.","tags":["Regional"],"parameters":[{"name":"symbols","in":"query","required":false,"schema":{"type":"string"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1India"}},"/v1/india/history":{"get":{"description":"Historical MCX India premium series versus Western pricing. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"symbol","in":"query","required":false,"schema":{"type":"string"}},{"name":"start","in":"query","required":false,"schema":{"type":"string"}},{"name":"end","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1IndiaHistory"}},"/v1/shfe/settlement":{"get":{"description":"Shanghai Futures Exchange settlement price history for a metal. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1ShfeSettlement"}},"/v1/shfe/inventory":{"get":{"description":"Shanghai Futures Exchange warehouse inventory history for a metal. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1ShfeInventory"}},"/v1/comex/inventory":{"get":{"description":"COMEX warehouse inventory history for a metal symbol. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1ComexInventory"}},"/v1/comex/volume-oi":{"get":{"description":"COMEX volume and open interest for a metal symbol. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1ComexVolume-oi"}},"/v1/comex/delivery-notices":{"get":{"description":"COMEX delivery notice history for a metal symbol. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"symbol","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"year","in":"query","required":false,"schema":{"type":"string"}},{"name":"date","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1ComexDelivery-notices"}},"/v1/sge/trading":{"get":{"description":"Shanghai Gold Exchange contract trading history. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"contract","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1SgeTrading"}},"/v1/sge/benchmark":{"get":{"description":"Shanghai Gold Exchange benchmark price history for gold or silver. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"metal","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1SgeBenchmark"}},"/v1/sge/inventory":{"get":{"description":"Shanghai Gold Exchange vault inventory history. Every response carries asOf, ageDays and a stale flag, so you can tell current inventory from an archived series without inspecting the array. Coverage is uneven and worth knowing before you build on it: silver vault stock updates normally, but the exchange feed has only ever produced ten gold vault-stock observations and the most recent is from January 2016, so metal=gold returns an archive rather than a current series. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"metal","in":"query","required":false,"schema":{"examples":["silver"],"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"examples":["1Y"],"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"examples":["latest"],"type":"string"}}],"operationId":"getV1SgeInventory"}},"/v1/gfex/settlement":{"get":{"description":"GFEX settlement price history for platinum or palladium. Requires the Ultimate plan.","tags":["Regional"],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1GfexSettlement"}},"/v1/gfex/premium":{"get":{"description":"GFEX platinum and palladium premium history versus Western pricing. Requires the Ultimate plan.","tags":["Regional"],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1GfexPremium"}},"/v1/gfex/receipts":{"get":{"description":"GFEX registered warehouse receipts, per warehouse and per day. Covers lithium carbonate (LC), industrial silicon (SI) and polysilicon (PS), which is Chinese battery and solar supply-chain inventory published only in Chinese, plus platinum (XPT) and palladium (XPD). The default response is the per-warehouse breakdown for the most recent date, or an explicit date. Pass type=totals for the exchange-wide daily series instead. Warehouse names are the exchange's own and are passed through unaltered, because they are identifiers you match against exchange notices. Requires the Ultimate plan.","tags":["Regional"],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"examples":["LC"],"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"examples":["totals"],"type":"string"}},{"name":"date","in":"query","required":false,"schema":{"examples":["2026-09-17"],"type":"string"}},{"name":"start","in":"query","required":false,"schema":{"examples":["2026-01-01"],"type":"string"}},{"name":"end","in":"query","required":false,"schema":{"examples":["2026-09-17"],"type":"string"}}],"operationId":"getV1GfexReceipts"}},"/v1/gfex/receipts/coverage":{"get":{"description":"Which symbols the GFEX receipts dataset covers, how many warehouses each spans, and the date range held. Requires the Ultimate plan.","tags":["Regional"],"operationId":"getV1GfexReceiptsCoverage"}},"/v1/lbma/vault":{"get":{"description":"LBMA vault holdings history for gold or silver. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"metal","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1LbmaVault"}},"/v1/lbma/clearing":{"get":{"description":"LBMA clearing statistics for gold or silver. Requires the Pro plan or higher.","tags":["Regional"],"parameters":[{"name":"metal","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1LbmaClearing"}},"/v1/news/":{"get":{"description":"Latest market news articles.","tags":["News"],"operationId":"getV1News"}},"/v1/news/feed":{"get":{"description":"Paginated market news feed.","tags":["News"],"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"symbols","in":"query","required":false,"schema":{"type":"string"}},{"name":"sources","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string"}},{"name":"since","in":"query","required":false,"schema":{"type":"string"}},{"name":"timePeriod","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"impact","in":"query","required":false,"schema":{"type":"string"}},{"name":"sourceTypes","in":"query","required":false,"schema":{"type":"string"}},{"name":"excludeSourceTypes","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1NewsFeed"}},"/v1/news/search":{"get":{"description":"Search news articles by keyword. Costs 3 weight per request.","tags":["News"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1NewsSearch"}},"/v1/news/filters":{"get":{"tags":["News"],"operationId":"getV1NewsFilters"}},"/v1/news/categories":{"get":{"tags":["News"],"operationId":"getV1NewsCategories"}},"/v1/news/sentiment/candles/{symbol}":{"get":{"tags":["News"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["XAU"],"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1NewsSentimentCandlesBySymbol"}},"/v1/news/sentiment/{symbol}":{"get":{"tags":["News"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["XAU"],"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1NewsSentimentBySymbol"}},"/v1/news/{symbol}":{"get":{"description":"Latest news articles filtered to a specific asset symbol.","tags":["News"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["XAU"],"type":"string"}},{"name":"includeTwitter","in":"query","required":false,"schema":{"type":"string"}},{"name":"sourceTypes","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1NewsBySymbol"}},"/v1/commodities/":{"get":{"description":"Latest prices for energy, agriculture, and industrial commodities. Symbols are contract codes such as CL1 (crude), CO1 (Brent), W_1 (wheat) and KC1 (coffee); call this endpoint to list them all. Requires the Basic plan or higher.","tags":["Commodities"],"parameters":[{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Commodities"}},"/v1/commodities/{symbol}/history":{"get":{"description":"Historical price series for a single commodity. Requires the Basic plan or higher.","tags":["Commodities"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["CL1"],"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1CommoditiesBySymbolHistory"}},"/v1/crypto/":{"get":{"description":"Latest cryptocurrency prices. Requires the Basic plan or higher.","tags":["Crypto"],"parameters":[{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Crypto"}},"/v1/crypto/{symbol}/history":{"get":{"description":"Historical price series for a single cryptocurrency. Requires the Basic plan or higher.","tags":["Crypto"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["BTC"],"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1CryptoBySymbolHistory"}},"/v1/etfs/":{"get":{"description":"Latest prices for tracked ETFs such as GLD and SLV. Requires the Basic plan or higher.","tags":["ETFs"],"parameters":[{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Etfs"}},"/v1/etfs/{symbol}/history":{"get":{"description":"Historical price series for a single ETF. Requires the Basic plan or higher.","tags":["ETFs"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["GLD"],"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1EtfsBySymbolHistory"}},"/v1/markets/":{"get":{"description":"Latest prices for 24/7 markets.","tags":["Markets"],"parameters":[{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Markets"}},"/v1/markets/{symbol}/history":{"get":{"description":"Historical series for a single 24/7 market. These symbols are plain names such as GOLD, SILVER, BTC and AAPL, unlike /v1/history which uses metal codes like XAU.","tags":["Markets"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["GOLD"],"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1MarketsBySymbolHistory"}},"/v1/indices/":{"get":{"description":"Latest values for market indices such as DXY, SPX, and DJI. Requires the Basic plan or higher.","tags":["Markets"],"parameters":[{"name":"symbols","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Indices"}},"/v1/indices/history/{symbol}":{"get":{"description":"Historical series for a single market index. Requires the Basic plan or higher.","tags":["Markets"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["DXY"],"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1IndicesHistoryBySymbol"}},"/v1/futures/history/{symbol}":{"get":{"description":"Historical daily price series for a single futures contract.","tags":["Futures"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["XAU"],"type":"string"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1FuturesHistoryBySymbol"}},"/v1/cot/":{"get":{"description":"COT (Commitments of Traders) positioning history for a metal. Requires the Pro plan or higher.","tags":["Analytics"],"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"metal","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Cot"}},"/v1/supply/":{"get":{"description":"Visible supply and inventory history for a metal. Requires the Ultimate plan.","tags":["Analytics"],"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"metal","in":"query","required":false,"schema":{"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Supply"}},"/v1/ath/{symbol}":{"get":{"description":"All time high price and the date it was recorded. Symbols are metal codes such as XAU, XAG, XPT, XPD and HG, not names like GOLD.","tags":["Analytics"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["XAU"],"type":"string"}}],"operationId":"getV1AthBySymbol"},"post":{"tags":["Analytics"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["XAU"],"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["price"],"properties":{"price":{"type":"number"}}}},"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["price"],"properties":{"price":{"type":"number"}}}},"multipart/form-data":{"schema":{"type":"object","required":["price"],"properties":{"price":{"type":"number"}}}}}},"operationId":"postV1AthBySymbol"},"delete":{"tags":["Analytics"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["XAU"],"type":"string"}}],"operationId":"deleteV1AthBySymbol"}},"/v1/economic-calendar/":{"get":{"description":"Upcoming and recent macroeconomic calendar events. Requires the Pro plan or higher.","tags":["Analytics"],"parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string"}},{"name":"impact","in":"query","required":false,"schema":{"type":"string"}},{"name":"days","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"getV1Economic-calendar"}},"/v1/instruments/":{"get":{"description":"Every instrument the platform tracks, with the exchange and asset class it belongs to. Use this to discover the symbol a given endpoint expects: symbol spaces differ per route, so gold is XAU on /v1/history but GOLD on /v1/markets, and commodities are contract codes such as CL1. Filter with asset_class (commodity, crypto, equity, etf, fx, index, bond), exchange, or a case-insensitive search across symbol and name. Available on every plan including Free.","tags":["Markets"],"parameters":[{"name":"asset_class","in":"query","required":false,"schema":{"examples":["commodity"],"type":"string"}},{"name":"exchange","in":"query","required":false,"schema":{"examples":["COMEX"],"type":"string"}},{"name":"search","in":"query","required":false,"schema":{"examples":["gold"],"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"examples":["100"],"type":"string"}}],"operationId":"getV1Instruments"}},"/v1/instruments/summary":{"get":{"description":"Instrument counts per asset class, with the exchanges each covers. A cheap way to see the shape of the catalogue before paging through it. Available on every plan including Free.","tags":["Markets"],"operationId":"getV1InstrumentsSummary"}},"/v1/funding/":{"get":{"description":"Latest perpetual funding rate for every symbol, optionally scoped to one venue. Funding is the periodic payment between longs and shorts that holds a perpetual near spot: a positive rate means longs pay shorts, so the sign and size read directly as crowd positioning. Rates are per-interval decimals, so 0.0000125 is 0.00125%. Coverage includes GOLD and SILVER perps alongside crypto and tokenised equities. Requires the Pro plan or higher.","tags":["Analytics"],"parameters":[{"name":"exchange","in":"query","required":false,"schema":{"examples":["HYPERLIQUID"],"type":"string"}}],"operationId":"getV1Funding"}},"/v1/funding/venues":{"get":{"description":"Venues currently publishing funding data, with how many symbols each covers and when it last printed. Requires the Pro plan or higher.","tags":["Analytics"],"operationId":"getV1FundingVenues"}},"/v1/funding/{symbol}/history":{"get":{"description":"Funding rate history for one perpetual, oldest first. Symbols are the venue's own tickers such as BTC, ETH, GOLD, SILVER, NVDA; call /v1/funding for the full list. Set the window with range (1D, 1W, 1M, 3M, 6M, 1Y, ALL) or explicit start and end dates. Requires the Pro plan or higher.","tags":["Analytics"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"examples":["BTC"],"type":"string"}},{"name":"exchange","in":"query","required":false,"schema":{"examples":["HYPERLIQUID"],"type":"string"}},{"name":"range","in":"query","required":false,"schema":{"examples":["1M"],"type":"string"}},{"name":"start","in":"query","required":false,"schema":{"examples":["2026-01-01"],"type":"string"}},{"name":"end","in":"query","required":false,"schema":{"examples":["2026-09-01"],"type":"string"}}],"operationId":"getV1FundingBySymbolHistory"}},"/v1/bullion/":{"get":{"description":"Retail bullion prices across competing dealers, with each quote's premium over spot. Every product is normalised to its fine-ounce content so premiums are comparable across coins, bars and junk silver. `best` is the cheapest in-stock quote, falling back to the cheapest overall. Premium is the figure recorded at scrape time and travels with its own scrapedAt, so price and premium always agree. Filter by metal (gold, silver, platinum, palladium). Quotes older than 7 days are excluded by default and never chosen as `best`, because individual dealer scrapers fail silently and a stale row would otherwise be presented as today's cheapest price; widen or narrow that with max_age_days, and read `asOf`, `ageDays` and `staleQuotesExcluded` to judge freshness yourself. Requires the Pro plan or higher.","tags":["Markets"],"parameters":[{"name":"metal","in":"query","required":false,"schema":{"examples":["gold"],"type":"string"}},{"name":"max_age_days","in":"query","required":false,"schema":{"examples":["7"],"type":"string"}}],"operationId":"getV1Bullion"}},"/v1/bullion/{productId}":{"get":{"description":"Every dealer quote for one bullion product. Product ids are slugs such as 1-oz-american-gold-eagle; call /v1/bullion for the full list. Quotes older than 7 days are excluded by default; widen with max_age_days. Requires the Pro plan or higher.","tags":["Markets"],"parameters":[{"name":"productId","in":"path","required":true,"schema":{"examples":["1-oz-american-gold-eagle"],"type":"string"}},{"name":"max_age_days","in":"query","required":false,"schema":{"examples":["7"],"type":"string"}}],"operationId":"getV1BullionByProductId"}}}}