Commodities
Get commodity details by code
Retrieve detailed information about a specific commodity including current pricing if available
get/v1/commodities/{code}
Path parameters
codestring required
Example:BRENT_CRUDE_USD
Commodity code
Response
Commodity details
Example response
{
"data": {
"code": "BRENT_CRUDE_USD",
"name": "Brent Crude Oil",
"currency": "USD",
"category": "oil",
"description": "North Sea Brent Crude Oil",
"unit": "barrel",
"unit_description": "Price per barrel",
"multiplier": 100,
"validation": {
"max": 200
},
"price_change_threshold": 10,
"sources": [
{
"label": "EIA",
"role": "official_spot",
"publication": {
"cadence": "weekly_batch",
"observation_frequency": "weekday",
"schedule": "Published by EIA in weekly batches, typically Wednesdays, covering trading days through the prior Monday.",
"typical_lag_days": {
"min": 2,
"max": 8
}
},
"collection": {
"frequency": "daily at 21:00 UTC",
"ingestion_latency": "typically within 24 hours of source publication"
}
}
],
"links": {
"docs": "https://docs.oilpriceapi.com/api-reference/commodities/details",
"publication_schedule": "https://docs.oilpriceapi.com/data/publication-schedules#jet_fuel_usd",
"openapi": "https://api.oilpriceapi.com/.well-known/openapi.json",
"latest": "https://api.oilpriceapi.com/v1/prices/latest?by_code=JET_FUEL_USD",
"historical": "https://api.oilpriceapi.com/v1/prices/historical?by_code=JET_FUEL_USD"
},
"your_access": {
"history_available_from": "2025-07-21",
"note": "Your plan includes 1 year of price history (from 2025-07-21). Upgrade for the full archive."
},
"current_price": {
"value": 75.42,
"formatted": "$75.42",
"currency": "USD",
"last_updated": "2025-01-20T10:30:00.000Z"
}
}
}