Commodities

Live prices for the macro commodities (oil WTI/Brent, gold, silver, nat-gas, copper). AUTHORITATIVE source for any numeric commodity claim — call this BEFORE quoting a price level. Per item: 'spot' (the live price — quote this, in 'unit') is the FRONT-MONTH FUTURES contract for oil, natural gas and copper and the SPOT QUOTE for gold and silver; 'spot_basis' ('front_month_future' | 'spot_fx' | 'unavailable', then 'spot_reason' says why); 'contract' (futures: contract_ticker, delivery_month, last_trade_date, dte, selection — name the contract when quoting, and near expiry say so; a contract already in its delivery month is skipped, and one that settled its final session today is replaced by the next, named in rolled_from. Otherwise, on a contract's last trade date, final_session_settled is false (no final settlement published yet), null (its settlement was not in what could be read on the call) or true (it settled and no later contract is listed), and next_contract names the contract that follows); 'spot_time' (when it traded or was quoted); 'is_stale' (spot older than 80 h); 'unit' (USD/barrel oil, USD/MMBtu gas, USD/troy ounce gold and silver, USD/pound copper). 'change_pct_1d/5d/30d' compare spot with the same contract's settlement (futures) or the daily close (metals) one session, five sessions and 30 calendar days earlier; 'changes' gives each reference price and date, or a reason when a window is not reached; 'prior' is the 1d reference; 'history_5d' the last six settlements/closes, oldest first. 'official_close' + 'official_close_as_of' + 'official_close_unit' is the dated official physical-spot price (copper: a monthly average in USD/metric ton), published days to weeks late and never scaled to today — quote it only when the user asks for that official print, with its date. 'etf_proxy_quote' is a related fund's share price, reference only. 'live_spot_estimate' equals 'spot'; 'bridge_return_pct' is always null. 'symbol=oil' returns both WTI and Brent; default 'all' returns all six.

A 200 is a JSON envelope: ok: true and this endpoint's own fields (see Macro, Rates & FX). It carries X-Request-ID, the credit headers (X-Credits-Cost, X-Credits-Remaining, X-Credits-Receipt, X-Credits-Settlement) and the rate-limit headers.

A 200 is billed even when it holds no data (an empty list, null, found: false), so check those fields. Pricing & credits explains the credit headers.

No error is billed. The body is { "ok": false, "error", "detail", "request_id" }; read the code from error.

This table lists what the spec declares for this route. Error responses lists every code FIRM sends, with when to retry.