Commodity Catalog
Use the live catalog for current commodity codes and metadata. The catalog changes as sources and datasets change, so this page does not maintain a second fixed list or a universal refresh promise.
Get the current catalog
curl "https://api.oilpriceapi.com/v1/commodities" \
-H "Authorization: Token YOUR_API_KEY"
The response lists the account-visible codes and their available metadata. Dataset access can vary by plan and entitlement. Use the exact code returned by the catalog in price requests:
curl "https://api.oilpriceapi.com/v1/prices/latest?by_code=BRENT_CRUDE_USD" \
-H "Authorization: Token YOUR_API_KEY"
For response fields and examples, see List Commodities API.
Freshness and publication timing
Daily-frequency observations are not necessarily published every day. Inspect the source timestamps returned with each value and use the publication schedules page for series-specific collection timing and expected gaps.
Use these fields according to the endpoint contract:
observed_atidentifies the source observation or trading date when supplied.created_atidentifies when OilPriceAPI collected or stored the record.- freshness or status metadata describes the latest known state; it is not a promise that every source refreshes on one fixed interval.