Available Endpoints

Base URL and common parameters

All endpoints are GET requests under https://metalapi.com/api/v1 and require an API key (see Authentication). Most of them accept the same optional parameters:

• base: the currency prices are expressed in. Defaults to USD; any supported symbol works.
• currencies, or its alias symbols: a comma-separated list of symbols to return, such as XAU,XAG,EUR. Omit it to get every symbol.
• unit: the mass unit for metal prices. One of troy_oz (default), gram, kilogram, ounce, pound, metric_ton or short_ton.

Dates use the YYYY-MM-DD format and are interpreted in UTC.

Latest rates: /latest

Current prices at your plan’s update interval, from daily on Free to every 5 seconds on Enterprise. On the Standard plan and above, add symbols like XAU-BID and XAU-ASK to currencies to receive bid and ask prices.

GET https://metalapi.com/api/v1/latest?api_key=YOUR_API_KEY&base=USD&currencies=XAU,XAG,EUR

Historical rates: /{date}

Closing prices of a past day. Three forms are accepted: the date as the path, /historical?date=, or /yesterday.

GET /api/v1/2026-10-01?api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/historical?date=2026-10-01&api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/yesterday?api_key=YOUR_API_KEY&currencies=XAU,XAG

Convert: /convert

Converts amount of from into to, for example dollars into ounces of gold or silver into euros. Add date to convert at a historical closing price, and unit to convert grams or kilograms of a metal.

GET /api/v1/convert?api_key=YOUR_API_KEY&from=USD&to=XAU&amount=1000

# 500 grams of silver in euros at the close of 1 October 2026
GET /api/v1/convert?api_key=YOUR_API_KEY&from=XAG&to=EUR&amount=500&unit=gram&date=2026-10-01

Timeframe: /timeframe

Daily closing prices for every day between start_date and end_date. One request can span up to 30 days on the Free plan and 365 days on paid plans. Longer ranges return error 207. /timeseries is an alias kept for compatibility.

GET /api/v1/timeframe?api_key=YOUR_API_KEY&start_date=2026-09-01&end_date=2026-09-30&currencies=XAU

Change: /change

The start rate, end rate, absolute change and percentage change between two dates for each symbol. Useful for “gold is up 3.6% this month” displays. The range limits are the same as for /timeframe.

GET /api/v1/change?api_key=YOUR_API_KEY&start_date=2026-09-30&end_date=2026-10-23&currencies=XAU,XAG

OHLC: /ohlc

Open, high, low and close for a single day. Omit date, or pass latest, to get today’s bar so far.

GET /api/v1/ohlc?api_key=YOUR_API_KEY&date=2026-10-22&currencies=XAU,XAG

Gold by karat: /carat

Gold prices at jewellery purities from 24K down to 8K, in any currency and unit. Pass carat=24 (the default), a single karat such as 18, or carat=all. Supported karats are 24, 23, 22, 21, 20, 18, 16, 14, 12, 10, 9 and 8. Add date for historical karat prices.

This endpoint is available on paid plans. Free keys receive error 106.

GET /api/v1/carat?api_key=YOUR_API_KEY&carat=all&base=EUR&unit=gram

Symbols: /symbols

The list of supported symbols and their names. Add details=1 to include each symbol’s category and unit. This endpoint does not count towards your monthly quota.

GET /api/v1/symbols?api_key=YOUR_API_KEY&details=1

Usage: /usage

Requests used and remaining in the current billing month. It is also free, so you can call it from monitoring without spending quota.

GET /api/v1/usage?api_key=YOUR_API_KEY

Realtime stream: /stream

A Server-Sent Events stream that pushes price updates as they happen, so you don't have to poll /latest. Available on the Pro plan and above. The streaming documentation describes the event format.

curl -N "https://metalapi.com/api/v1/stream" \
  -H "Authorization: Bearer YOUR_API_KEY"