Dark Data API

Premium intelligence data from official government and industry sources. The Dark Data API provides access to fundamental oil & gas market data that drives professional trading and analysis.

Tier Required: Reservoir Mastery ($129/mo)

Data Categories

Category	Source	Release Schedule	Endpoints
Rig Counts	Baker Hughes	Every Friday 1 PM ET	6
Oil Inventories	EIA WPSR	Every Wednesday 10:30 AM ET	7
OPEC Production	OPEC MOMR	~15th of month	6
Drilling Productivity	EIA DPR	~15th of month	7
Forecasts	EIA STEO	1st Tuesday of month	6

Authentication

All Dark Data endpoints require Reservoir Mastery tier:

curl "https://api.oilpriceapi.com/v1/dark_data/rig_counts/latest" \
  -H "Authorization: Token YOUR_API_KEY"

Insufficient Tier Response

{
  "error": "This endpoint requires Reservoir Mastery tier",
  "upgrade_url": "https://oilpriceapi.com/pricing"
}

Common Response Format

All endpoints return consistent metadata:

{
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 10,
    "total_count": 100,
    "total_pages": 10,
    "api_version": "v1",
    "tier_required": "reservoir_mastery",
    "cache_ttl": 3600
  }
}

Quick Examples

Get Latest Rig Count

import requests

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

print(f"US Rig Count: {data['data']['us_total']}")
print(f"Permian: {data['data']['basins']['permian']}")

Get Cushing Inventory Levels

response = requests.get(
    "https://api.oilpriceapi.com/v1/dark_data/oil_inventories/cushing",
    headers={"Authorization": "Token YOUR_API_KEY"},
    params={"weeks": 52}
)
cushing = response.json()

print(f"Cushing: {cushing['data']['latest']['volume']} MMbbl")

Get OPEC Top Producers

response = requests.get(
    "https://api.oilpriceapi.com/v1/dark_data/opec_productions/top_producers",
    headers={"Authorization": "Token YOUR_API_KEY"},
    params={"limit": 5}
)
producers = response.json()

for p in producers['data']['producers']:
    print(f"{p['rank']}. {p['name']}: {p['production_mbpd']} mb/d")

Data Sources

Source	Official Name	URL
Baker Hughes	Weekly Rig Count	bakerhughes.com
EIA WPSR	Weekly Petroleum Status Report	eia.gov
OPEC MOMR	Monthly Oil Market Report	opec.org
EIA DPR	Drilling Productivity Report	eia.gov
EIA STEO	Short-Term Energy Outlook	eia.gov

Use Cases

Trading Signals: Rig count trends precede production changes
Inventory Analysis: Cushing levels affect WTI basis
Supply Forecasting: OPEC production vs quotas
Basin Analytics: DUC wells and drilling efficiency
Price Forecasting: EIA official projections

Analytics API - Statistical analysis tools
Futures API - Real-time futures data
Prices API - Spot price data