Gold price API

Get silver per gram in a local currency with keyless GET /v1/convert?from=XAG&to=INR&amount=1&unit=gram, replacing INR with a supported currency. Get silver dealer sell and buyback prices with premiums over spot for countries listed by GET /v1/physical?metal=silver using GET /v1/physical/{country}?metal=silver on Basic or above.

Reference

Base URL: https://api.goldprice.dev/v1
First request: No API key required
Authentication: Bearer token or X-API-Key
Response format: JSON

Quickstart API reference Get a free API key

curl "https://api.goldprice.dev/v1/prices?symbol=XAU-USD-SPOT"

const res = await fetch('https://api.goldprice.dev/v1/prices?symbol=XAU-USD-SPOT')console.log(await res.json())

import requestsres = requests.get('https://api.goldprice.dev/v1/prices?symbol=XAU-USD-SPOT')print(res.json())

package mainimport (  "fmt"  "io"  "net/http")func main() {  req, _ := http.NewRequest("GET", "https://api.goldprice.dev/v1/prices?symbol=XAU-USD-SPOT", nil)  res, err := http.DefaultClient.Do(req)  if err != nil {    panic(err)  }  defer res.Body.Close()  body, _ := io.ReadAll(res.Body)  fmt.Println(string(body))}

Response 200

{
  "symbols": [
    {
      "symbol": "XAU",
      "quote_currency": "USD",
      "unit": "troy_ounce",
      "contract_type": "spot",
      "price": "4012.75",
      "is_stale": false,
      "computed_at": "2026-10-23T07:00:18.221118+00:00"
    }
  ]
}

Choose how to connect

All plansREST APIGold spot prices in 31 currencies, silver and copper in USD, historical bars and dealer prices (Basic and above).Plus and ProWebSocketStream prices over WebSocket or SSE.All plansMCP serverQuery prices through MCP. ?include=sources shows which source served the price; each price carries its time. Dealer prices include premium over spot.

An endpoint for each job

REST + WebSocketLive pricesCurrent gold, silver, and copper prices, plus a persistent real-time stream.RESTHistorical pricesOHLCV bars with cursor pagination and settlement status on each bar.RESTPhysical pricesDealer sell and buyback quotes by country, with premium over spot.MCPMCP serverUse the same price and history tools from an MCP-compatible client.

Metal data for the apps you build

Bullion price monitoringCompare physical dealer prices by country and their premiums over spot.Jewelry calculatorsCalculate metal values by weight and karat from spot prices in 35 currencies.Portfolio trackersTrack gold, silver and copper values with spot prices and historical bars.Website gold widgetAdd the official gold price widget to your website.

Practical guides

Methodology: how prices are sourced, checked, and labeled Karat prices: per-gram prices for common karats and currencies Gold prices in Google Sheets Stream prices over WebSocket

Frequently asked questions

Is the gold price API free?

Yes. Keyless XAU spot is 15 minutes late, limited to 10 requests/minute and 100/hour per IP. Free includes 5,000 calls/month at 10 requests/minute, XAU, XAG and HG spot, 30 days of daily history, and all nine MCP tools listed. get_physical_price needs Basic or above; get_forward_view is for legacy plans only. No credit card required. Free permits commercial use.

Good API for commodity price data?

Yes. Every plan includes gold, silver, and copper spot (XAU, XAG, HG), with gold prices and conversions in 31 currencies. Each price carries its time; ?include=sources shows which source served it. Basic at $19/mo adds live prices and dealer quotes.

Which sources feed the API?

Spot prices (XAU + XAG + HG) pass through from one licensed primary source with a licensed backup, and non-USD gold uses USD spot × live exchangerate.dev FX. With ?include=sources, sources[] shows which source served the price. Each price carries its time.

Commercial use?

Every current plan permits commercial use. The intact official gold price widget is free with visible attribution. Redistribution or reselling the data itself requires a separate deal: hello@goldprice.dev.