Gold Price API

curl -H "Authorization: Bearer mc_live_YOUR_KEY" \
  "https://api.metalcharts.org/v1/prices"

Every tracked metal comes back in one response, so a dashboard showing several does not need several requests. The gold entry looks like this:

{
  "success": true,
  "data": {
    "XAU": {
      "symbol": "XAU",
      "price": 4380.04,
      "change24h": 2.87,
      "changePercent24h": 0.0655,
      "high24h": 4380.25,
      "low24h": 4377.84,
      "exchange": "SPOT",
      "timestamp": "2026-09-19T18:58:27.856Z"
    }
  }
}

Spot prices are on the free tier. You need an account and a key, but not a card.

Each example fetches the live gold price and prints it. There is no SDK to install: the API is plain HTTPS returning JSON, so whatever HTTP client you already use will do.

import requests

res = requests.get(
    "https://api.metalcharts.org/v1/prices",
    headers={"Authorization": "Bearer mc_live_YOUR_KEY"},
    timeout=10,
)
res.raise_for_status()

price = res.json()["data"]["XAU"]["price"]
print(f"Gold: ${price}")

const res = await fetch(
  "https://api.metalcharts.org/v1/prices",
  { headers: { Authorization: "Bearer mc_live_YOUR_KEY" } },
);

if (!res.ok) throw new Error(`HTTP ${res.status}`);

const { data } = await res.json();
console.log(`Gold: ${data.XAU.price}`);

<?php
$ch = curl_init("https://api.metalcharts.org/v1/prices");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer mc_live_YOUR_KEY"],
    CURLOPT_TIMEOUT => 10,
]);

$body = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($code !== 200) {
    throw new RuntimeException("MetalCharts API returned $code");
}

$data = json_decode($body, true);
echo "Gold: " . $data["data"]["XAU"]["price"];

req, _ := http.NewRequest(
    http.MethodGet, "https://api.metalcharts.org/v1/prices", nil,
)
req.Header.Set("Authorization", "Bearer mc_live_YOUR_KEY")

resp, err := http.DefaultClient.Do(req)
if err != nil {
    return err
}
defer resp.Body.Close()

var out struct {
    Data map[string]struct {
        Price float64 `json:"price"`
    } `json:"data"`
}
if err := json.NewDecoder(resp.Body).Decode(&out); err != nil {
    return err
}
fmt.Println("Gold:", out.Data["XAU"].Price)

Replace mc_live_YOUR_KEY with a key from the API console. The free tier needs an account but not a card.

curl -H "Authorization: Bearer mc_live_YOUR_KEY" \
  "https://api.metalcharts.org/v1/history/XAU?range=1Y&interval=1d"

14,425 daily bars are available, the oldest dated 1966-10-03. Set the window with range or explicit start and end dates, and the candle size with interval: 15m, 30m, 45m, 1h, 2h, 4h, 8h, 1d, 1w or 1M. Each point carries open, high, low, close and volume, so it drives a candlestick chart directly.

History depth is what separates the plans. Basic reaches back 1 year, Pro five, and Ultimate returns the full series.

The symbol is XAU. Passing the metal's name instead returns a 400, which is the single most common mistake on first use.

Gold is the series most people integrate first, and the one where a stale quote is most obvious to an end user. Spot is served from cache and refreshes continuously, so a dashboard polling once a minute sees the same number a trader does.

Beyond price, gold also appears in:

Rate limiting is by weight per minute, not a monthly request quota. Most endpoints cost 1 weight and history costs 2. Free is capped at 1,000 weight a month; no paid plan has a monthly ceiling.