Gold and silver price API

Precious metals have their own ISO 4217 codes – XAU for gold, XAG for silver, XPT for platinum and XPD for palladium – and in the fxapi foreign exchange rates API they work exactly like currencies. That makes fxapi a compact gold and silver price API: get the price of an ounce of gold in rupees, the monthly average silver price in euros, or the value of a bullion holding in your reporting currency, with the same endpoints and API key you use for FX rates.

Metals and units

One troy ounce is 31.1034768 grams. For per-gram or per-kilogram prices, convert in your code.

Two ways to quote metals

• Metal as base – base_currency=XAU&currencies=USD,EUR returns the price of one ounce in each currency. This is the format most people expect.
• Metal as target – base_currency=USD&currencies=XAU returns how many ounces one dollar buys (a small number). Invert it to get the price.

Use type=metal to return only XAU, XAG, XPT and XPD.

PHP: gold price per gram in the visitor’s currency

<?php
$currency = "EUR";
$query = http_build_query(["base_currency" => "XAU", "currencies" => $currency]);

$ch = curl_init("https://api.fxapi.com/v1/latest?$query");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["apikey: " . getenv("FXAPI_KEY")],
    CURLOPT_TIMEOUT        => 10,
]);
$response = json_decode(curl_exec($ch), true);

$perOunce = $response["data"][$currency]["value"];
$perGram  = $perOunce / 31.1034768;

printf("Gold: %.2f %s per gram (%s)\n", $perGram, $currency, $response["meta"]["last_updated_at"]);

History, averages and change

Who uses metal prices from an FX API

• Jewelry and bullion shops – show indicative metal values in the shopper’s currency and add your own premium.
• Wealth and portfolio apps – value metal holdings next to cash and crypto.
• Accounting – revalue metal inventory at period end with historical and average prices.
• Content and dashboards – daily gold and silver widgets without a separate commodities subscription.

Metals follow your plan’s update interval – daily on Free, hourly on Basic and every 60 seconds on Professional and Enterprise. See pricing.

Frequently asked questions