API Access›Documentation

LiveMetalPrice API Documentation

A simple, free REST API for querying live precious metal spot prices. No SDK required — just a GET request.

Base URL

https://livemetalprice.com/api/v1

Authentication

Pass your API key as a key query parameter on every request.

GET https://livemetalprice.com/api/v1/prices?key=YOUR_KEY

Don't have a key? Get one free in seconds →

Endpoint: GET /api/v1/prices

Returns current spot prices for gold, silver, platinum, palladium, rhodium, aluminum, zinc, and nickel in USD.

Example Request

# curl
curl "https://livemetalprice.com/api/v1/prices?key=YOUR_KEY"

# JavaScript / fetch
const res = await fetch('https://livemetalprice.com/api/v1/prices?key=YOUR_KEY');
const data = await res.json();
console.log(data.data.XAU); // gold price

# Python
import requests
r = requests.get('https://livemetalprice.com/api/v1/prices', params={'key': 'YOUR_KEY'})
print(r.json()['data']['XAU'])

Example Response (200 OK)

{
  "success": true,
  "data": {
    "XAU": 4562.8,
    "XAG": 32.18,
    "XPT": 1890.28,
    "XPD": 1469.48,
    "XRH": 4850,
    "ALI": 2456.5,
    "ZNC": 2890,
    "NI": 15420
  },
  "updatedAt": "May 5, 2026, 09:30 AM ET",
  "rateLimit": {
    "limit": 100,
    "remaining": 97,
    "reset": "2026-05-06T00:00:00.000Z"
  }
}

Response Fields

Field	Type	Description
`data.XAU`	number	Gold spot price (USD/troy oz)
`data.XAG`	number	Silver spot price (USD/troy oz)
`data.XPT`	number	Platinum spot price (USD/troy oz)
`data.XPD`	number	Palladium spot price (USD/troy oz)
`data.XRH`	number \| null	Rhodium spot price (USD/troy oz)
`data.ALI`	number \| null	Aluminum futures price (USD/metric ton)
`data.ZNC`	number \| null	Zinc futures price (USD/metric ton)
`data.NI`	number \| null	Nickel futures price (USD/metric ton)
`updatedAt`	string	Human-readable timestamp (ET)
`rateLimit.limit`	number	Daily request limit
`rateLimit.remaining`	number	Requests remaining today
`rateLimit.reset`	string (ISO 8601)	When the limit resets

Error Responses

401Invalid / Missing Key

{ "success": false, "error": "Invalid API key. Get a free key at https://livemetalprice.com/api-access" }

429Rate Limited

{ "success": false, "error": "Rate limit exceeded. Free tier allows 100 requests/day.", "rateLimit": { "limit": 100, "remaining": 0, "reset": "2026-05-06T00:00:00.000Z" } }

Rate Limits

Free tier allows 100 requests per 24-hour window, rolling. Rate limit status is included in every response under rateLimit, and also in response headers:

X-RateLimit-Limit — total daily limit
X-RateLimit-Remaining — requests left today
X-RateLimit-Reset — unix timestamp when limit resets

Ready to start building?

Get Your Free API Key →