The short answer#
A commodity spot price is the current price to buy or sell the underlying right now: gold per ounce, crude oil per barrel, and so on. SiftingIO exposes it through the same live snapshot endpoint used for every other asset class. One authenticated request returns the latest price for a symbol like XAUUSD or WTIUSD, in the same normalized JSON shape as equities, forex, and crypto. There is no separate commodities vendor to integrate and no per-source schema to normalize. This post covers how commodities are symboled, how to read a spot price and a quote, and how the published number is formed across venues.
How commodities are symboled#
SiftingIO quotes commodities in USD-pair form, the same six-to-twelve-character uppercase format used for forex. The quote currency is USD and the symbol names the underlying:
XAUUSD, goldXAGUSD, silverWTIUSD, crude oilNATGASUSD, natural gasCORNUSD, corn
The catalog spans precious metals, industrial metals, energy benchmarks, and agricultural products. The symbol is all you pass to the price endpoints. There is no contract month or venue code to manage.
Reading a spot price#
A spot price is one request to the live snapshot endpoint. The venue segment is commodities and the last path segment is the symbol:
curl -H "X-API-Key: $SIFTING_KEY" \
"https://api.sifting.io/v1/last/trade/commodities/XAUUSD"
The response carries the last trade price, its size, and a timestamp. For the two-sided market rather than the last print, request a quote instead:
curl -H "X-API-Key: $SIFTING_KEY" \
"https://api.sifting.io/v1/last/quote/commodities/WTIUSD"
That returns the best bid, the best ask, and the spread between them, which is what a converter or a price card usually wants. Both endpoints return the same fields used for the other asset classes, so code written for one reads the others with only the symbol changed.
One price from many venues#
A commodity does not have a single canonical price. The same ounce of gold or barrel of crude is quoted across multiple independent venues at slightly different numbers, and any one of them can lag, widen, or print an outlier. A snapshot that passes one source straight through inherits whatever that source reports at that instant.
SiftingIO publishes one fair price per symbol, formed across venues rather than taken from a single feed. The value is a robust median weighted by real traded volume and by each venue's reputation, not a simple average. A median has a 50% breakdown point, so a majority of venues have to move the same wrong way before the published number follows, which bounds the effect of one stale or mispriced source. Each snapshot also carries three timestamps (source, ingest, and publish) and an explicit quality flag that reads Normal, or Degraded when the input set thins out and the value falls back to the safest available source. The output is a reference price, not an exchange-of-record print, and it is useful precisely because it does not depend on any one venue being right.
When a market is closed#
Commodities trade in sessions, and outside them the last print stops moving. If the most recent value is older than the freshness threshold, the snapshot endpoint returns a 503 with stale_snapshot, including last_t and server_now so the client can decide whether the age is acceptable. To gate a request on session state before making it, the market status endpoints under /v1/fnd/markets report which markets are currently open.
Historical bars#
For charts and backtests rather than a single value, OHLCV bars are available over the historical endpoints at intervals from one minute up. Heavy history responses require gzip, requested with Accept-Encoding: gzip; without it the endpoint returns 406. The documentation lists the exact commodity bar path and the interval parameters.
Summary#
A commodity spot price from SiftingIO is one request to the live snapshot endpoint with the venue set to commodities and a USD-pair symbol such as XAUUSD or WTIUSD, returning a last trade or a two-sided quote in the same JSON shape as every other asset class. The published number is a volume- and reputation-weighted median across venues with an explicit quality flag, not a single-source pass-through, which is what makes it dependable for a market quoted in many places at once. The documentation lists the full commodity symbol set, the snapshot and history endpoints, and the market hours calls. The free plan needs no credit card, so you can create a free account and read a live gold or oil price in a few minutes.
