Live market rates for gold, silver, WTI and Brent crude, natural gas and 520+ other assets. One REST call returns clean JSON you can ship in minutes.
Trusted by teams at
Core features
Query live and historical prices for 520+ commodities — precious metals, energy, agriculture, and industrial materials — through a single JSON API instead of juggling multiple data vendors.
One API key, one REST call, one JSON response. Copy-paste examples take you from signup to your first live price in under 5 minutes — no SDK required.
$ curl "https://api.commoditypriceapi.com/v3/rates/latest?symbols=XAU" \
-H "x-api-key: YOUR_API_KEY"
{ "success": true, "rates": { "XAU": 4141.4 } }Gold, silver, platinum, palladium, copper and WTI and Brent crude are refreshed every second on every plan, with bid and ask. Every other symbol updates as often as its market publishes.
Get any commodity price denominated in the currency you need with a single quote parameter. 150+ world currencies supported out of the box.
Simple monthly or annual plans with no long-term contracts. Start with an unlimited free trial for integrations, then upgrade, downgrade, or cancel whenever you like.
Fetch the latest spot rates the moment markets move, or pull the closing rate for any past date — each is a single GET request to one endpoint.
Every response is clean JSON with a unit and timestamp per symbol, ready to drop straight into dashboards, alerts, or pricing engines.
The time-series endpoint returns day-by-day rates between any two dates, ready for charting — no client-side aggregation needed.
The fluctuation endpoint computes absolute and percentage change for you, so building 24-hour, 7-day, or 30-day movers takes 1 call instead of a data pipeline.
Latest, historical, fluctuation, time-series, and symbols — 5 predictable REST endpoints cover the full workflow, all authenticated with a single x-api-key header.
Interactive documentation and a live playground let you test real requests before writing a line of code, and responses stay plain JSON on every plan.
npx -y @commoditypriceapi/mcpSet up the MCP serverDocumentation
One x-api-key header, plain JSON back, and copy-ready examples in cURL, JavaScript, Python and PHP for every endpoint.
Endpoints
1Send a request
curl "https://api.commoditypriceapi.com/v3/rates/latest?symbols=XAU,WTIOIL-FUT" \
-H "x-api-key: YOUR_API_KEY"const res = await fetch(
"https://api.commoditypriceapi.com/v3/rates/latest?symbols=XAU,WTIOIL-FUT",
{ headers: { "x-api-key": "YOUR_API_KEY" } },
);
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://api.commoditypriceapi.com/v3/rates/latest",
params={"symbols": "XAU,WTIOIL-FUT"},
headers={"x-api-key": "YOUR_API_KEY"},
)
print(res.json())<?php
$ch = curl_init("https://api.commoditypriceapi.com/v3/rates/latest?symbols=XAU,WTIOIL-FUT");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-api-key: YOUR_API_KEY"],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($data);2Get JSON back
{
"success": true,
"timestamp": 1703866777,
"rates": {
"XAU": 2066.98,
"WTIOIL-FUT": 72.29
},
"metadata": {
"XAU": {
"unit": "T.oz",
"quote": "USD"
},
"WTIOIL-FUT": {
"unit": "Bbl",
"quote": "USD"
}
}
}Each of these has its own endpoint, refreshed every second on every plan, with bid and ask on every call. Everything else in the catalogue is one request away on /rates/latest.
Looking for something else? Browse all supported symbols.
FAQ
Data sources, update intervals, plans and limits. If your question isn't here, we usually reply within a day.
Contact supportWe have over 520 commodities available on our platform. Please take a look at the full list of available in our documentation.
We get the prices from trusted organizations such as banks and other financial institutions. The prices we provide are not raw exchange prices. They are derived data — we deliver the mid-market price (the average of the bid and ask) from a regulated broker's real-time market feed, with the underlying pricing derived from exchange-traded futures (e.g., Brent → ICE Futures Europe, WTI → NYMEX). For classification purposes on your end, the data should be treated as aggregated/derived, not as a direct exchange feed.
Ten symbols are refreshed every second on every current plan: gold (XAU), silver (XAG), platinum (XPT), palladium (XPD), copper spot and futures (XCU-SPOT, XCU-FUT) and WTI and Brent crude, spot and futures (WTIOIL-SPOT, WTIOIL-FUT, BRENTOIL-SPOT, BRENTOIL-FUT). Each has its own endpoint, /v3/rates/latest/{symbol}, which returns bid and ask as well as the rate. On the legacy Lite plan they may be up to 10 minutes old.
A -SPOT symbol is a continuous cash price with no expiry date, so it moves smoothly — best for displays, conversions and alerts. A -FUT symbol follows the front-month exchange futures contract on a continuous basis — best when your numbers must match futures quotes. Neither is an exchange settlement or an official benchmark price.
You can check your usage for the month by going to the dashboard page or through the usage API.
No, we don't have any free plans. However, we do offer an unlimited free trial for integrations, and it does not require a credit card.
Yes, you can automatically extend your trial for up to three times if you choose to extend it within the trial period. Beyond the third extension, the process will require a manual review. You may submit a request to our support team, and after a thorough evaluation, we may approve an extension for your plan.
No, we don't provide refunds. However, you can cancel your subscription at any time.
No. The Basic, Standard and Advanced plans have no per-minute rate limit; only your monthly request quota applies. The legacy Lite plan is limited to 10 requests per minute.
