v2

latestOpenAPI 3.0.4Commercial License2026-08-0718678294.5 KB
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

status'success' required

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"
    }
  }
}