GET/v1/hist/commodities/:symbol/barsgzip required

Commodities bars

Paginated OHLCV bars for a commodity, from 1-minute through 1-hour. Each bar carries t (Unix epoch milliseconds, UTC, marking the bucket's open time), o/h/l/c as float prices, and v as the tick-count for the bucket. Commodities quote against USD on a rolling near-24/7 calendar, so all time inputs are read as UTC.

Parameters

ParameterDescription

Parameter

symbolrequiredstring · path: Commodity code, 4–12 uppercase alphanumerics. e.g. XAUUSD (gold), XAGUSD (silver), XPTUSD (platinum), XPDUSD (palladium). Case-insensitive. Symbols outside the supported set return 404.
startrequiredstring · query: Inclusive lower bound on bar time. Required on the first page; cursor overrides on subsequent pages. Accepts YYYY-MM-DD (midnight UTC) or full RFC3339 (2026-05-01T00:00:00Z).
endstring · query: Inclusive upper bound on bar time. Same shape as start. Defaults to now. Must be strictly after start.
intervalstring · query: Bar size. One of: 1m, 5m, 15m, 30m, 1h. Default 1m, honored exactly. Same enum as /hist/stocks, /hist/forex, and /hist/crypto so a single client schema works across asset classes.
limitinteger · query: Bars per page. Default 1000, max 2000.
cursorstring · query: Pagination token. Opaque. Pass back the value of meta.next_cursor from the previous response verbatim. When present, overrides start. Subsequent pages need no other parameters; the cursor encodes the next start.

Example

request · shell

1# First page, hourly gold bars2curl -H "X-API-Key: $KEY" -H "Accept-Encoding: gzip" --compressed \3  "https://api.sifting.io/v1/hist/commodities/XAUUSD/bars?start=2026-05-01&end=2026-05-02&interval=1h&limit=24"4 5# Subsequent page, drop start and pass cursor6curl -H "X-API-Key: $KEY" -H "Accept-Encoding: gzip" --compressed \7  "https://api.sifting.io/v1/hist/commodities/XAUUSD/bars?cursor=MTc4MTU2ODI0MQ&interval=1m&limit=2000"

200OKapplication/json (gzip)

1{2  "data": [3    {4      "t": 1781568000000,5      "o": 4339.35,6      "h": 4339.94,7      "l": 4338.50,8      "c": 4338.58,9      "v": 2110    }11  ],12  "meta": {13    "symbol": "XAUUSD",14    "interval": "1m",15    "as_of": "2026-06-18T11:26:51Z",16    "next_cursor": "MTc4MTU2ODI0MQ"17  }18}

Loading runner…

First load only

Reference

Per-bar fieldsDescription

Per-bar fields

t: Bar open time, Unix epoch milliseconds, UTC. The bar covers [t, t + interval).
o, h, l, c: Open, high, low, and close prices for the bucket, USD.
v: Tick-count volume: the number of price updates in the bucket.
meta.next_cursor: Present only when the page came back full and more data exists before end; absent at the tail.

Pagination patternDescription

Pagination pattern

First call: ?start=2026-05-01&interval=1m&limit=2000
Next call: If meta.next_cursor is present, call again with ?cursor=<token>. interval and limit are sticky by convention.
Tail: Repeat until meta.next_cursor is absent. A short page is the end-of-data signal.

Error responses

StatusCodeMeaning

404not_found

Symbol outside our coverage.

1{2  "error": "not_found",3  "message": "Symbol not found."4}

400invalid_parameter

Malformed symbol, interval, start, end, limit, or cursor.

1{2  "error": "invalid_parameter",3  "message": "start must be YYYY-MM-DD or RFC3339."4}

403forbidden

Key is valid but the plan lacks commodities access.

1{2  "error": "forbidden",3  "message": "Plan does not include the commodities market."4}

406gzip_required
Heavy endpoint called without Accept-Encoding: gzip.
```
{ "error": "gzip_required" }
```
503historical_unavailable
Commodities historical data is not configured on this deployment.
```
{ "error": "historical_unavailable" }
```
503upstream_rate_limited
Our aggregation pipeline hit its rate limit. Try again shortly.
```
{ "error": "upstream_rate_limited" }
```

More in Historical OHLCV

See all