Cushing Oil Storage Intelligence API

Overview

Real-time Cushing, Oklahoma oil storage data with advanced analytics. Cushing is the delivery point for WTI crude oil futures and the largest oil storage hub in North America, making it a critical indicator of U.S. oil market dynamics.

Access Level: Premium (Reservoir Mastery tier and above)

Endpoint

GET /v1/storage/cushing

Authentication

Requires API key authentication with premium access:

curl -X GET "https://api.oilpriceapi.com/v1/storage/cushing" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Accept: application/json"

Response Format

{
  "current": {
    "value": 38.5,
    "units": "million_barrels",
    "capacity_utilization": 50.7,
    "week_over_week_change": -2.3,
    "data_date": "2025-09-18",
    "created_at": "2025-09-20T10:35:00.000Z",
    "updated_at": "2025-09-20T10:35:00.000Z"
  },
  "analytics": {
    "market_signal": "bearish",
    "trading_implication": "Inventory draw suggests tightening supply",
    "historical_average": 42.1,
    "week_52_high": 58.3,
    "week_52_low": 28.7,
    "trend": "declining"
  },
  "metadata": {
    "source": "EIA",
    "update_frequency": "Weekly (Wednesdays 10:30 AM ET)",
    "operational_capacity": 61,
    "total_capacity": 76
  }
}

Response Fields

Current Data

Field	Type	Description
`value`	float	Current storage level in million barrels
`capacity_utilization`	float	Percentage of operational capacity used
`week_over_week_change`	float	Change from previous week in million barrels
`data_date`	string	Date of the data (not publication date)
`created_at`	datetime	When the data was recorded in our system
`updated_at`	datetime	Last update timestamp

Analytics

Field	Type	Description
`market_signal`	string	Market interpretation: `bullish`, `bearish`, or `neutral`
`trading_implication`	string	Trading strategy suggestion based on current levels
`historical_average`	float	52-week average storage level
`week_52_high`	float	Highest level in past 52 weeks
`week_52_low`	float	Lowest level in past 52 weeks
`trend`	string	Current trend: `rising`, `declining`, or `stable`

Metadata

Field	Type	Description
`source`	string	Data source (typically "EIA")
`update_frequency`	string	When new data is published
`operational_capacity`	integer	Usable storage capacity in million barrels
`total_capacity`	integer	Total physical capacity in million barrels

Market Interpretation

Storage Levels and Market Signals

Capacity Utilization	Market Signal	Typical Price Impact
< 30%	Very Bearish	Downward pressure on WTI
30-45%	Bearish	Slight downward pressure
45-55%	Neutral	Balanced market
55-70%	Bullish	Upward price support
> 70%	Very Bullish	Strong upward pressure

Trading Implications

Inventory Builds (Positive Change):

Indicates oversupply
Bearish for oil prices
Consider short positions or put options

Inventory Draws (Negative Change):

Indicates tightening supply
Bullish for oil prices
Consider long positions or call options

Update Schedule

New data is released every Wednesday at 10:30 AM ET by the EIA (U.S. Energy Information Administration). Our API updates within minutes of the official release.

Historical Data

To get historical Cushing storage data:

GET /v1/storage/history/CUSHING_STORAGE?period=52w

Rate Limits

Requests: 1000 per minute for premium users
Cache: Data cached for 5 minutes

Example Usage

JavaScript

const response = await fetch('https://api.oilpriceapi.com/v1/storage/cushing', {
  headers: {
    'Authorization': 'Token YOUR_API_KEY',
    'Accept': 'application/json'
  }
});
const data = await response.json();

// Trading decision based on storage levels
if (data.current.capacity_utilization < 40) {
  console.log('Low storage levels - potentially bullish for WTI');
}

Python

import requests

response = requests.get(
    'https://api.oilpriceapi.com/v1/storage/cushing',
    headers={
        'Authorization': 'Token YOUR_API_KEY',
        'Accept': 'application/json'
    }
)
data = response.json()

# Analyze week-over-week change
if data['current']['week_over_week_change'] < -2:
    print(f"Significant draw of {abs(data['current']['week_over_week_change'])}M barrels")

/v1/storage/spr - Strategic Petroleum Reserve levels
/v1/storage/regional - Regional storage data across the U.S.
/v1/prices/latest?code=WTI_USD - Current WTI crude oil price

Error Responses

Status Code	Description
401	Unauthorized - Invalid or missing API key
403	Forbidden - Requires premium access
404	Not Found - Data temporarily unavailable
429	Too Many Requests - Rate limit exceeded
503	Service Unavailable - Data source temporarily offline

Notes

Cushing storage is a key fundamental indicator for WTI crude oil prices
Low storage levels (< 20 million barrels) can cause significant price volatility
Data is most impactful immediately after the weekly release
Consider combining with WTI futures positions for hedging strategies