UNunirateapi
Commodity

GET /api/commodities/historical/timeseries

Get commodity time series data for a date range with optional amount conversion (max 5 years, Pro subscription required). Precious metals history back to 1968 (gold/silver) and 1990 (platinum/palladium); energy, base-metal and agricultural history accrues daily from 2026-08. 19 commodities: gold, silver, platinum, palladium (troy oz); WTI and Brent crude (barrel), US Henry Hub natural gas (MMBtu); copper, aluminium, zinc, nickel, lead, tin (tonne); wheat, corn (tonne), coffee, sugar, cocoa, cotton (kg). Precious metals are blended live from LBMA and market feeds; energy, base metals and agriculturals are World Bank reference prices (CC BY 4.0, attribution: The World Bank).

Request

Query parameters

api_keystring required

API key for authentication (Pro tier required)

start_datestring required

Start date in YYYY-MM-DD format

end_datestring required

End date in YYYY-MM-DD format

amountnumber

Amount to multiply prices by (optional)

symbolsstring

Comma-separated list of commodity symbols to retrieve (optional). e.g., XAU,XAG or BRENT,WTI,NATGAS. Defaults to all 19.

format'json' | 'xml' | 'csv' | 'tsv'

The format of the response (optional).

callbackstring

The name of the JSONP callback function (optional). Only used when format is 'json'. Must be alphanumeric with underscores.

Response

Time series data retrieved successfully.

Changes

No recorded changes to this operation across all 1 revision of this API.