Changelog

/v1/lbma/fixes and the MCP server's LBMA fixes tool are withdrawn, and the endpoint now answers 410. The LBMA Gold, Silver, Platinum and Palladium Prices are benchmarks licensed by ICE Benchmark Administration. LBMA vault holdings and clearing statistics are unchanged.

Four new pages document the exchange data in the API: COMEX warehouse stocks back to 1992, CFTC Commitments of Traders positioning since 2013, Shanghai Gold Exchange prices and premiums, and Guangzhou warehouse receipts for lithium carbonate, silicon and polysilicon. Enterprise is $1,200 a month or $10,000 a year through checkout, and can carry the right to redistribute named datasets by written agreement.

Moving an API subscription to another plan or billing interval, from the pricing page or the API console, now changes the subscription you have: an upgrade charges the prorated difference straight away, and a downgrade credits the unused time to your next invoices. New Pro subscriptions include 1,000,000 weight a month, and Pro subscriptions that started before this change keep no monthly cap. Business is now Enterprise, arranged by email, with the same uptime SLA and support response.

/v1/prices, /v1/history, /v1/convert, /v1/bulk/history and /v1/ath no longer serve tin, which stays on metalcharts.org. DXY in /v1/indices is now a US dollar index MetalCharts computes from daily reference exchange rates with the standard six-currency weights: daily, from January 1999, and on an average day within 0.25% of the published index.

Cobalt joins the metals pages and the API (/v1/prices, /v1/history, /v1/convert and /v1/bulk/history): the CME cobalt metal price in US dollars per pound, with daily history from December 2020.

Clients that sign in with OAuth, such as claude.ai and ChatGPT connectors, can now add https://api.metalcharts.org/mcp with nothing but the URL: you sign in to MetalCharts and approve the app. It uses your account's API plan, free included, and shows in the API console with its own usage, where you can disconnect it.

/v1/history, /v1/bulk/history and dated /v1/convert now read a single series for each metal from the day that series starts, so no day mixes two feeds. Gold and silver still go back to 1966. Hourly and 15-minute bars for gold, silver, platinum and palladium now reach back to January 2020, and copper's and aluminum's to September 2024. Aluminum history is now the LME contract, starting September 2024, where it was the COMEX contract from 2014; COMEX traded about 2.5% above LME, so the two aren't joined. Past closes can differ slightly from the figures served before.

A new status page shows API uptime from checks made every minute, how recently each dataset updated against its publisher's schedule, and how often spot prices actually change. Pro plans gain /v1/lbma/fixes (the LBMA gold, silver, platinum and palladium benchmark prices, in any of the API's currencies) and /v1/india/ibja (the IBJA 999 gold rate in rupees per gram).

Add format=csv to any API list endpoint, such as /v1/history, to get the same rows as a CSV file. Ultimate and Business keys can download every daily bar for up to 13 metals in one file from /v1/bulk/history, back to 1966 for gold and silver. The new Business plan ($499 a month) adds a 99.9% monthly uptime SLA with service credits and a one-business-day support response to everything in Ultimate.

Claude Code, Cursor, VS Code and other MCP clients can now connect to https://api.metalcharts.org/mcp with an API key and call 13 read-only tools: live and historical prices in any currency, unit or karat, conversions, COMEX inventory and depository flows, CFTC positioning, Shanghai and India premiums, SGE and LBMA fixings and instrument search. Each tool call counts against the plan like the API request behind it. Setup is on the new MCP server page.

/v1/prices and /v1/history take currency, unit (toz, g, kg, lb, mt, tola) and, for gold, karat; history converts each day at that day's ECB reference rate, back to 1999. New /v1/convert prices a quantity of metal in a currency, or a currency in metal, live or on a past date, and /v1/currency now covers 32 currencies with a base, a date and a daily history route. Every quote now says which currency and unit it is in.

Free keys can now call /v1/history for the last 30 days of daily bars. Plans with a monthly allowance get an email at 80% and 100% of it, requests keep working to 10% past it before they are refused, and requests refused with a 429 no longer count against the month.

New /v1/comex/depositories returns each COMEX depository's registered, eligible and total metal per report date the way CME lays it out: previous stock, received, withdrawn, net change, adjustment and today's stock, with the business day the movement happened. Filter by depository name or date range; flowsAvailableFrom gives the first date with flows for each metal. The latest-day breakdown on /v1/comex/inventory?type=depositories now carries the same figures. Pro plan and above.

Starter ($9 a month, or $90 a year) sits between Free and Basic with 10,000 requests a month, 20 weight a minute, two keys, live metal prices and a year of history. Basic subscriptions started from today include 250,000 requests a month; Basic subscriptions that started earlier keep no monthly cap, and Pro and Ultimate have none.

Data from a free-tier key that is shown publicly, on a website, in an app or in a post, now needs a visible link to metalcharts.org next to it, such as "Metal prices by MetalCharts". Internal tools and paid plans need no link. Free-tier responses carry an X-Attribution header with the wording, the API console has the snippet ready to copy, and the API terms spell out the condition. Separately, /v1/usage now reports a free account as Free rather than Basic.

The free tier's monthly allowance drops from 1,000 weight to 200. Live spot prices, market status and currency conversion cost 1 weight each, so that is 200 requests a month. The limit of 10 weight a minute, the single key and the endpoints free keys can call are unchanged, and paid plans still have no monthly cap. Usage resets on the first of each month, and the X-RateLimit-Month-Limit header and /v1/usage report the new figure.

/v1/prices and /v1/metals now price aluminum and nickel from the live LME quote and zinc and lead from a live spot price. They served a once-a-day official LME price with no 24h change, and all four now return change24h and changePercent24h. Aluminum and nickel report marketType "futures", and zinc and lead report exchange "SPOT".

/v1/gfex/premium now converts GFEX prices at the stored USD/CNY rate instead of a fixed 7.2, which raises GFEX dollar prices and premiums by about 7%, and returns 503 when no rate is stored. /v1/shfe/settlement follows the contract with the most open interest each day, which brings back days that were missing and keeps the exchange's subtotal row out of type=latest, and /v1/gfex/settlement type=latest lists the most active contract first. /v1/shanghai leaves out its yuan fields when no USD/CNY rate is stored, instead of using an assumed 7.25.

/v1/bullion never names a below-spot quote as best, and its metal filter takes gold, silver, platinum and palladium as well as the codes. /v1/etfs reads one exchange listing per day for GLD, SLV, PPLT and PALL, which changes their change7d and sparklines, and /v1/etfs/{symbol}/history returns one point per timestamp. Long /v1/history windows for gold and silver keep their newest points, /v1/market-status has the 2027 COMEX holidays, and the spec describes bid and ask as indicative spreads around the mid price.

Lithium (LC) now comes back in US dollars per tonne from /v1/prices, /v1/metals (sparklines included), /v1/history and /v1/ath. The upstream quote is in yuan and we'd been passing it through as dollars, so LC drops from about 133,200 to about 19,840 and its all-time high from 159,072 to about 23,695. History and the all-time high use the current USD/CNY rate (about 6.71 when this shipped), so percentage moves don't change. If no USD/CNY rate is available, LC is left out of the response.

Aluminum, nickel, zinc, lead and tin now prefer the LME spot quote in /v1/prices and /v1/metals, so the price no longer flips between two feeds. Lead moves to the LME figure (1,929.00 against 1,919.80 on September 26) and has no 24h high or low. A 24h change is only calculated against a previous close from the same exchange. Where there isn't one, /v1/prices omits change24h, changePercent24h and open24h, and /v1/metals returns change24h as 0. Aluminum's -5.71% and zinc's +1.20% on September 26 came from comparing two different markets.

Each quote in /v1/prices has a new stale field. It's true when that quote hasn't updated for more than five days, which a normal weekend or holiday never reaches. Tin is flagged at launch: its feed last updated on April 25, 2026. The response-level isStale still reports the age of the cache as a whole, and the new field is in the OpenAPI spec.

/v1/supply no longer counts a Shanghai Gold Exchange vault figure older than 45 days. SGE last reported gold vault stock in January 2016, so gold's sgeTotal is now null and its totalOz is about 1.66 million oz lower. Silver's SGE figure is current and unchanged.

In /v1/comex/delivery-notices, mtdCumulative and ytdCumulative were 0 on every row because the stored running totals were never filled. They're now null on any day with issued or stopped contracts; add up dailyIssued or dailyStopped for month-to-date and year-to-date figures. The OpenAPI spec marks both fields nullable.

The /v1/shanghai endpoints now return VAT-stripped values alongside the prices as quoted: priceExVat, priceCNYExVat and premiumPercentExVat on the latest quotes, and shanghaiExVat and premiumPercentExVat on every history row, using the VAT rate in force on each date. vatInclusive and vatRate say which prices carry the tax: SGE and SHFE silver do, gold doesn't.

Corrected the Shanghai methodology and VAT pages. The SGE silver price includes China's 13% VAT (SGE invoice rules, 2022 revision, Article 23), so the headline silver premium has the tax built in; for the ex-VAT spread, use (1 + premium) ÷ 1.13 − 1. The data series itself is unchanged, and the gold premium carries no VAT.

Retired the /v1/futures endpoints from the developer API. Intraday history on /v1/history now returns spot prices wherever a spot series exists.

Launched the MetalCharts API at api.metalcharts.org, with Basic, Pro and Ultimate plans covering spot prices, price history, and exchange data such as COMEX inventory, LBMA vault holdings and CFTC positioning. Plans and endpoints are described on /metals-api.

Added a free API tier with one key for live spot prices, currency conversion and market status, up to a monthly request allowance. Crypto, ETF, index and commodity data moved from the Pro plan down to Basic.

Rebuilt /scrap-metal-prices around a live price board and a load calculator, with a page for each scrap metal: copper, insulated copper wire, brass, aluminum, stainless steel, lead and steel.

Embeddable price and chart widgets now cover crypto, metal ETFs and the US Dollar Index alongside metals, plus metal ratios and Shanghai and India prices. New options include display currency, theme, accent color and refresh rate, and each asset has its own page under /widgets.

Launched /bullion, which compares coin and bar prices and premiums over spot across online bullion dealers, with a page for each product.

COMEX inventory dashboard covering gold, silver, copper, platinum, and palladium: registered, eligible, and total stocks by depository, updated daily after CME publishes its report.

Launched /sources, listing the exchanges, regulators and data feeds behind the site's numbers (CME COMEX, SGE, SHFE, LBMA, ICE, MCX, GFEX, CFTC, FX rates) with refresh cadence and license terms. Methodology pages are linked from each source.

Launched /data-coverage, listing the data series we publish with their start dates, refresh cadence, and units.

Added /comex/methodology, /sge/methodology, and /lbma/methodology: explains source data, registered vs eligible (for COMEX), CNY → USD conversion (for SGE), and known data quirks for each exchange.

Guides and methodology pages now show a byline with their publish and update dates, matched by Article structured data.

Metal pages now emit Dataset structured data describing the price series, its time coverage, and what it measures.

Launched the MetalCharts Terminal: a customizable widget dashboard for active metals traders with drag-and-drop layouts, multi-chart views, exchange inventory widgets, and saved configurations.

Published /shanghai/vat-explained: deep dive on China's 13% silver VAT, why investment gold is exempt, and why we report the pre-VAT premium.

Published /shanghai/methodology: the contracts we use (Au99.99, Ag(T+D)), USD/CNY conversion approach, and update cadence behind the headline Shanghai premium.

Added long-form guides comparing gold with Bitcoin, real estate, and stocks, and on whether silver and platinum are good investments.

Added /gfex with daily Guangzhou Futures Exchange platinum and palladium settlement prices in yuan and US dollars, plus open interest.

Daily COMEX delivery notices (issuers and stoppers per delivery month) now tracked and published at /comex.

Added gold price pages in Indian rupees, euros, British pounds, Australian dollars, and Canadian dollars, and silver price pages in rupees, euros, and pounds, converted from the US dollar spot price.

Added /ratios, which charts the price ratio between a pair of metals over time, with the gold/silver ratio as the default.

Portfolio tracker for stackers and investors: track holdings across metals with their cost basis, gain or loss, and current value.