OilPriceAPI Docs
GitHub
GitHub
  • Interactive Explorer

    • Interactive API Explorer
  • Price Data

    • API Reference
    • Get Latest Prices
    • Historical Prices
  • Commodities

    • List Commodities
    • Get Commodity Details
  • AI Agents (MCP)

    • Get Market Brief
    • Subscriptions / Watches
    • Agent Subscriptions with MCP
  • Marine Fuels

    • List Marine Fuel Ports
    • Get Port Details with Prices
  • Premium Endpoints

    • All Prices API - One Call, All Commodities
    • Cushing Oil Storage Intelligence API
    • Drilling Intelligence API
    • Marine Fuels API
    • ICE Brent Futures API
  • Futures

    • Futures API
    • ICE Brent Futures
    • ICE WTI Futures
    • ICE Gas Oil Futures
    • NYMEX Natural Gas Futures
    • ICE EUA Carbon Futures
  • Dark Data (Premium)

    • Energy Intelligence API
    • Rig Counts
    • Well Permits
    • Oil Inventories
    • OPEC Production
    • Drilling Productivity
    • Forecasts (STEO)
  • Well Production (Beta)

    • Well Production Data
    • Well Production API Reference
  • Analytics

    • Analytics API
  • Account & Billing

    • Account API

OPEC Basket (OPEC_BASKET_USD)

Status: Available | Daily weekdays | Official OPEC source

The OPEC Reference Basket is the official daily USD/barrel basket price published by OPEC. OilPriceAPI sources this series from OPEC's official XML archive and preserves the OPEC reference date in observed_at and source_date.


Quick Reference

PropertyValue
Commodity CodeOPEC_BASKET_USD
NameOPEC Basket
CategoryOil
CurrencyUSD
UnitUSD/barrel
Update FrequencyDaily weekdays
SourceOfficial OPEC Basket XML archive
Historical DataDaily records back to 2003
AccessLatest price on authenticated API access; historical endpoints on paid plans

Get Latest Price

GET/v1/prices/latest?by_code=OPEC_BASKET_USD
curl "https://api.oilpriceapi.com/v1/prices/latest?by_code=OPEC_BASKET_USD" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Accept: application/json"

Example response:

{
  "status": "success",
  "data": {
    "price": 69.33,
    "formatted": "$69.33",
    "currency": "USD",
    "code": "OPEC_BASKET_USD",
    "created_at": "2026-07-02T12:00:00.000Z",
    "observed_at": "2026-07-02T12:00:00.000Z",
    "source_date": "2026-07-02",
    "type": "spot_price",
    "unit": "barrel",
    "source": "opec.org",
    "metadata": {
      "source": "opec.org",
      "source_description": "OPEC official Basket XML"
    }
  }
}

source_date is the OPEC reference date for the basket value. It is not a page-render timestamp.


Get Historical Data

Paid plans can use the standard historical endpoints with by_code=OPEC_BASKET_USD.

# Past year of daily OPEC Basket values
curl "https://api.oilpriceapi.com/v1/prices/past_year?by_code=OPEC_BASKET_USD&interval=daily" \
  -H "Authorization: Token YOUR_API_KEY"

# Date range on the full historical endpoint
curl "https://api.oilpriceapi.com/v1/prices/historical?by_code=OPEC_BASKET_USD&start_date=2003-01-01&interval=daily" \
  -H "Authorization: Token YOUR_API_KEY"

Historical depth follows your plan's historical-data entitlement. Professional and Scale plans have full historical access; Developer and Starter have their plan windows.


Notes

  • OPEC publishes the basket on a business-day cadence, so weekends and holidays retain the most recent OPEC reference date.
  • This commodity is the OPEC Reference Basket price, not the OPEC Monthly Oil Market Report production dataset.
  • The source is the official OPEC XML archive at https://www.opec.org/basket/basketDayArchives.xml.

Related Endpoints

  • Latest Prices
  • Historical Prices
  • OPEC Production
  • Commodities List
Last Updated: 7/4/26, 12:16 PM