Metals Time Series API: XAU Daily JSON

Metals-API 2 min read
Metals Time Series API: XAU Daily JSON

A metals time series API returns one metal’s daily rate for a date window as JSON. On Metals-API that is GET https://metals-api.com/api/timeseries with query access_key. Official docs curl uses symbols=XAU, start_date=2023-05-01, and end_date=2023-05-25.

Copper Monthly starts at $19.99/mo (2,500 calls, 10-minute updates, 10 symbols). There is no Free Trial. Gold Monthly is $149.99. Do not mix ISO XAU with LBMA (USDLBXAUPM). Docs: metals-api.com/documentation (Time-Series).

Request: XAU window

curl "https://metals-api.com/api/timeseries?access_key=YOUR_API_KEY&start_date=2023-05-01&end_date=2023-05-25&symbols=XAU"

Do not set end_date to today if you follow the other FX-style endpoints. Shortcut in docs: type=last_day.

Response: official timeseries sample

{
"success": true,
"timeseries": true,
"start_date": "2012-05-01",
"end_date": "2012-05-03",
"base": "EUR",
"rates": {
"2023-05-01": { "USD": 1, "XAU": 0.00050331446219218 },
"2023-05-02": { "USD": 1, "XAU": 0.00049603398443199 },
"2023-05-03": { "USD": 1, "XAU": 0.00048723596263295 }
}
}

Docs print envelope dates in 2012 and rate keys in May 2023. Invert 1 / rates[date].XAU when you need ounces in the quote currency. Copy a live call for a chart.

Same key

  • GET /api/latest?symbols=XAU — spot (rates.USDXAU on latest only).
  • GET /api/fluctuation — start/end change.
  • GET /api/ohlc — one-day candles.

MCP: metals-api.com/mcp (metals.time_series, same quota as REST).

Go live

1. Register — paid plan (no free trial).

2. Copy access_key.

3. GET /api/timeseries with symbols=XAU.

4. Invert each day’s XAU for a USD/oz chart.

Chart XAU history with a Metals key →