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 Production

Monthly OPEC production data from the Official OPEC Monthly Oil Market Report (MOMR).

Source: OPEC Monthly Oil Market Report Release: Around the 15th of each month Plan Required: Scale (see pricing)

Production volumes, not the basket price

This is the OPEC MOMR production dataset — monthly crude production volumes by OPEC member country, published in the OPEC Monthly Oil Market Report.

It is not the OPEC Reference Basket price. If you want the daily basket price, use the OPEC_BASKET_USD commodity code against /v1/prices/latest — see OPEC Basket (OPEC_BASKET_USD).

You wantUsePlan
Daily OPEC Reference Basket price/v1/prices/latest?by_code=OPEC_BASKET_USDAny paid plan
Monthly OPEC production volumes/v1/ei/opec_productions/* (this page)Scale

Endpoints

MethodEndpointDescription
GET/v1/ei/opec_productionsList paginated reports
GET/v1/ei/opec_productions/latestLatest report
GET/v1/ei/opec_productions/totalOPEC total production trend
GET/v1/ei/opec_productions/by_countryFilter by country
GET/v1/ei/opec_productions/historicalHistorical data
GET/v1/ei/opec_productions/top_producersRanked producers list
GET/v1/ei/opec_productions/:idSpecific report by ID

List Reports

GET /v1/ei/opec_productions

Parameters

ParameterTypeDefaultDescription
pageinteger1Page number
per_pageinteger10Results per page (max 50)

Latest Report

GET /v1/ei/opec_productions/latest

Response

{
  "data": {
    "report_month": "2024-12",
    "opec_total_mbpd": 27.84,
    "month_over_month": -0.15,
    "headline": "OPEC production decreased by 150,000 b/d in December",
    "countries": [
      {
        "country": "saudi_arabia",
        "name": "Saudi Arabia",
        "production_mbpd": 9.13,
        "quota_mbpd": 9.0,
        "compliance_pct": 98.6
      }
    ]
  }
}

Total Production Trend

GET /v1/ei/opec_productions/total

Parameters

ParameterTypeDefaultDescription
monthsinteger12Months of history (max 60)

Response

{
  "data": {
    "latest": {
      "report_month": "2024-12",
      "production_mbpd": 27.84,
      "month_over_month": -0.15
    },
    "history": [
      {
        "report_month": "2024-12",
        "production_mbpd": 27.84
      },
      {
        "report_month": "2024-11",
        "production_mbpd": 27.99
      }
    ],
    "trend": {
      "direction": "decreasing",
      "change_mbpd": -0.65,
      "change_pct": -2.3
    }
  }
}

By Country

GET /v1/ei/opec_productions/by_country

Parameters

ParameterTypeRequiredDescription
countrystringNoCountry code (snake_case)
monthstringNoFormat: YYYY-MM

OPEC Countries

CodeCountry
algeriaAlgeria
angolaAngola
congoCongo
equatorial_guineaEquatorial Guinea
gabonGabon
iranIran
iraqIraq
kuwaitKuwait
libyaLibya
nigeriaNigeria
saudi_arabiaSaudi Arabia
uaeUnited Arab Emirates
venezuelaVenezuela

OPEC+ Countries (Additional)

CodeCountry
azerbaijanAzerbaijan
bahrainBahrain
bruneiBrunei
kazakhstanKazakhstan
malaysiaMalaysia
mexicoMexico
omanOman
russiaRussia
south_sudanSouth Sudan
sudanSudan

Response

{
  "data": {
    "report_month": "2024-12",
    "country": "saudi_arabia",
    "name": "Saudi Arabia",
    "production_mbpd": 9.13,
    "quota_mbpd": 9.0,
    "compliance_pct": 98.6,
    "spare_capacity_mbpd": 3.0,
    "month_over_month": 0.05
  }
}

Top Producers

GET /v1/ei/opec_productions/top_producers

Parameters

ParameterTypeDefaultDescription
limitinteger10Number of producers (max 20)
monthstringlatestFormat: YYYY-MM

Response

{
  "data": {
    "report_month": "2024-12",
    "producers": [
      {
        "rank": 1,
        "country": "saudi_arabia",
        "name": "Saudi Arabia",
        "production_mbpd": 9.13,
        "month_over_month": 0.05,
        "share_of_opec": 32.8
      },
      {
        "rank": 2,
        "country": "iraq",
        "name": "Iraq",
        "production_mbpd": 4.25,
        "month_over_month": -0.1,
        "share_of_opec": 15.3
      }
    ],
    "opec_total": 27.84
  }
}

Historical

GET /v1/ei/opec_productions/historical

Parameters

ParameterTypeDefaultDescription
countrystringopec_totalCountry code or opec_total
monthsinteger24Months of data (max 120)

Response

{
  "data": {
    "country": "saudi_arabia",
    "data_points": [
      {
        "report_month": "2024-12",
        "production_mbpd": 9.13,
        "quota_mbpd": 9.0
      }
    ]
  }
}

Code Examples

Python - Compliance Tracking

import requests

response = requests.get(
    "https://api.oilpriceapi.com/v1/ei/opec_productions/latest",
    headers={"Authorization": "Token YOUR_API_KEY"}
)
data = response.json()

print(f"OPEC Total: {data['data']['opec_total_mbpd']} mb/d")

for country in data['data']['countries']:
    if country.get('compliance_pct'):
        status = "OK" if country['compliance_pct'] >= 100 else "OVER"
        print(f"{country['name']}: {country['compliance_pct']}% compliance [{status}]")

JavaScript - Production Trend

const response = await fetch(
  "https://api.oilpriceapi.com/v1/ei/opec_productions/total?months=6",
  { headers: { Authorization: "Token YOUR_API_KEY" } },
);
const data = await response.json();

const trend = data.data.trend;
console.log(`OPEC Trend: ${trend.direction}`);
console.log(`Change: ${trend.change_mbpd} mb/d (${trend.change_pct}%)`);

Why OPEC Production Matters

  • Supply Control: OPEC+ controls ~40% of global oil supply
  • Quota Compliance: Actual vs target production affects prices
  • Spare Capacity: Saudi spare capacity is market safety valve
  • Geopolitics: Sanctions, conflicts affect production

Related

  • Rig Counts - US drilling activity
  • Forecasts - EIA supply/demand forecasts
  • Oil Inventories - Storage levels
Last Updated: 7/13/26, 10:11 AM
Prev
Oil Inventories
Next
Drilling Productivity