Skip to main content

✨ fastFOREX API MCP is now Generally Available - let your agents manage your fastFOREX API ✨

Metals API · From $54/month

Gold price & metals API: spot metals from the API you already trust for FX

A gold price API and precious metals API: real-time spot prices for gold, silver, platinum, palladium and five base metals, priced in any of our 170+ currencies, twelve units of weight and any purity, sourced exclusively from Tier-1 liquidity and delivered over REST and WebSockets.

  • Full-feature access for 7 days
  • No credit card
  • Email-only signup
GET /metals/spot · Example response

Checking for humanity…

$ curl https://api.fastforex.io/metals/spot \ ?metal=XAU&currency=USD&verbose=1
{
  "bid": "4112.89",
  "ask": "4113.28",
  "mid": "4113.09",
  "spread": "0.39",
  "metal": "XAU",
  "metal_name": "Gold",
  "currency": "USD",
  "currency_name": "United States Dollar",
  "unit": "oz_t",
  "unit_name": "Troy Ounce",
  "tsp": 1791474806940,
  "dtm": "2026-10-08T15:53:26Z",
  "cross_rate": false,
  "source": "otc_aggregate",
  "source_instrument": "XAUUSD",
  "purity": "1000",
  "purity_name": "Pure Gold Spot",
  "ms": 5
}

We've got metals covered.

9

Metals (4 precious, 5 base)

43

Real-time streaming instruments

12

Pricing units, from gram to tola

  • Tier-1 liquidity, one order book

    Prices are derived exclusively from Tier-1 liquidity providers (global banks and top-tier ECNs), aggregated into a single tradable order book with best-execution top-of-book pricing.

  • Any metal, any currency, no problem

    /metals/spot returns realtime bid, ask, mid and spread for any supported metal/currency pair, converted to your unit of weight and purity in one call. 22-carat gold in Indian rupees, per gram? No problem. The instrument used is always reported, and prices crossed via USD are flagged.

  • Raw instrument quotes

    /metals/quote returns live bid/ask for up to 10 instruments exactly as the feed supplies them, with no conversion applied. Prices arrive as strings, preserving every significant figure of the source quote.

  • REST and streaming

    Fetch spot prices over the same JSON API you use for FX, or stream 43 metals instruments live over WebSockets using the same secure connection as FX pairs.

  • Fully specified metal

    Every price maps to a published specification: purity grades for precious metals (finest first, from the /metals/purities endpoint), LME contract grades for the base metals (copper, aluminium, lead, nickel and zinc). You know exactly what's being priced.

  • Units that match your market

    Quote gold per troy ounce, gram, kilogram, Hong Kong tael, Thai baht or tola, among twelve units covering Western bullion desks and Asia's physical markets alike, listed at /metals/units.

  • Ratios and crypto crosses

    Stream the gold/silver ratio directly (XAUXAG and XAGXAU), or price gold in Bitcoin with XAUBTC. No client-side maths required.

  • Over 30 years of history

    Daily prices from 1995 for most gold and silver instruments, and platinum and palladium in US dollars; base metals from 2019. Hourly and one-minute data for most instruments from 2018 and 2020. OHLC candles or closing bid/ask, up to 100 points a request.

Available on Premium and Premium + WebSockets.

Metals endpoints are tagged Premium in our API spec: REST access ships with Premium, with updates matching your plan's FX speeds. Add WebSocket streaming for the live feed. Not included on One or Extra.

Metals API FAQ.

The details developers ask about before integrating.

Which plans include metals?
Premium and Premium + WebSockets. REST access ships with Premium; add the WebSockets streaming option for the live feed. One and Extra do not include metals.
Can I price 18-carat gold, or sterling silver?
Yes. /metals/spot takes a purity parameter: any code from /metals/purities (18K, sterling, Britannia and more) or a custom fineness between 1 and 1000 parts per thousand. Base metals are always priced at their single contract grade.
What happens if my currency isn't quoted directly?
The price is crossed via USD automatically and the response flags it with cross_rate: true. This consumes one additional FX call and widens the bid/ask slightly. The source_instrument field always tells you which instrument was actually quoted.
How fast are the updates?
Update speeds match your plan's FX constraints. That means every second on Premium via REST, with streaming updates over WebSockets on the Premium + WebSockets plan.
Why do prices pause overnight and at weekends?
Metals markets aren't 24/7 like crypto. Precious metals pause for one hour nightly (anchored to 5pm New York) and close at weekends; base metals follow London Metal Exchange hours, going quiet roughly 19:00–01:00 London. Quiet periods are the market itself, not a feed outage, and the API keeps serving the last price until trading resumes. Our Metals Data Sources page has the full schedule.
Is historical data included?
Yes, on Premium plans. /metals/ohlc/time-series returns OHLC candles and /metals/quote/time-series closing bid/ask, daily, hourly or by the minute, for each metals instrument (such as XAUUSD), up to 100 points a request. Daily history starts in 1995 for most gold and silver instruments and for platinum and palladium in US dollars, over 30 years; base metals start in 2019. Hourly data starts in 2018 and one-minute data in 2020 for most instruments. /metals/instruments/historical-limits gives the earliest date for each instrument and interval.
Can AI agents use the Metals API?
Yes. The [fastFOREX MCP Server](/mcp-server) gives ChatGPT, Claude, Gemini and other MCP clients 9 metals tools, covering spot prices, realtime quotes and history, on Premium plans. Your assistant discovers them on its own.
What quality of metal do prices refer to?
Precious metals are priced to minimum fineness (gold 995, silver 999, platinum and palladium 999.5), traded for delivery. Base metals follow LME contract specifications, though the feed is not LME data. See our Metals Data Sources page for the full story.
Is there a silver price API or a base metals price API?
Yes. The same /metals/spot endpoint prices silver, platinum, palladium and the five base metals on the same key, so one integration is a silver price API and a base metals price API as well as a gold one.
Is there an XAUUSD API?
Yes. /metals/quote returns raw instrument quotes such as XAUUSD (gold in US dollars) and XAGUSD (silver), and /metals/spot reports the source instrument behind every converted price.
Why are prices returned as strings?
To preserve every significant figure of the source quote. Parse them as decimals rather than floats where precision matters. This is deliberate, and standard practice for financial data.

Still have questions?

Our support team answers 365 days a year.

More from fastFOREX API.

  • Currency API

    Live midpoint rates for 170+ world currencies, with a 4ms average server response.

  • FX Market Data

    The FX market data API for developers: a live FX rates API with bid/ask quotes on 2,300+ FX trading pairs and OHLC candles down to the minute.

  • Crypto API

    A crypto currency exchange API: real-time prices for 500+ crypto making up 750+ pairs, aggregated from the world's biggest exchanges.

  • Historical FX Data

    A historical forex data API: rates back to January 1970, daily on every plan and down to the minute on Premium.

Start building in under ten minutes.

Get your free API key with full plan access for 7 days, no credit card required.