Storage & Inventory API

Overview

The Storage API provides access to crude oil inventory data including Cushing, Oklahoma storage levels and the Strategic Petroleum Reserve (SPR).

Endpoints

Get All Storage Data

GET /v1/storage

Returns current inventory levels across all tracked storage facilities.

Response:

{
  "status": "success",
  "data": {
    "cushing": {
      "value": 23.5,
      "unit": "million_barrels",
      "change_week": -1.2,
      "updated_at": "2025-01-15T16:00:00Z"
    },
    "spr": {
      "value": 350.2,
      "unit": "million_barrels",
      "change_week": 0,
      "updated_at": "2025-01-15T16:00:00Z"
    }
  }
}

Cushing, Oklahoma Storage

Cushing is the delivery point for WTI crude oil futures and a critical indicator of US oil supply.

Get Current Cushing Levels

GET /v1/storage/cushing

Response:

{
  "status": "success",
  "data": {
    "code": "CUSHING_STORAGE",
    "name": "Cushing, OK Crude Oil Storage",
    "value": 23.5,
    "unit": "million_barrels",
    "capacity": 76.0,
    "utilization_percent": 30.9,
    "change": {
      "week": -1.2,
      "month": -3.5,
      "year": -8.2
    },
    "updated_at": "2025-01-15T16:00:00Z",
    "source": "EIA"
  }
}

Get Cushing Historical Data

GET /v1/storage/history/CUSHING_STORAGE

Query Parameters:

ParameterTypeDescription
start_datestringStart date (YYYY-MM-DD)
end_datestringEnd date (YYYY-MM-DD)
intervalstringdaily, weekly, monthly

Example:

curl "https://api.oilpriceapi.com/v1/storage/history/CUSHING_STORAGE?start_date=2024-01-01&interval=weekly" \
  -H "Authorization: Token YOUR_API_KEY"

Strategic Petroleum Reserve (SPR)

The US Strategic Petroleum Reserve is the world's largest supply of emergency crude oil.

Get Current SPR Levels

GET /v1/storage/spr

Response:

{
  "status": "success",
  "data": {
    "code": "SPR_STORAGE",
    "name": "US Strategic Petroleum Reserve",
    "value": 350.2,
    "unit": "million_barrels",
    "capacity": 714.0,
    "utilization_percent": 49.0,
    "sites": [
      {"name": "Bryan Mound", "value": 75.5},
      {"name": "Big Hill", "value": 85.2},
      {"name": "West Hackberry", "value": 95.0},
      {"name": "Bayou Choctaw", "value": 94.5}
    ],
    "change": {
      "week": 0,
      "month": -2.5,
      "year": -15.0
    },
    "updated_at": "2025-01-15T16:00:00Z",
    "source": "DOE"
  }
}

Regional Storage

Get Regional Storage Data

GET /v1/storage/regional

Response:

{
  "status": "success",
  "data": {
    "padd1": {
      "name": "East Coast",
      "value": 12.5,
      "unit": "million_barrels"
    },
    "padd2": {
      "name": "Midwest",
      "value": 98.2,
      "unit": "million_barrels"
    },
    "padd3": {
      "name": "Gulf Coast",
      "value": 245.8,
      "unit": "million_barrels"
    },
    "padd4": {
      "name": "Rocky Mountain",
      "value": 22.1,
      "unit": "million_barrels"
    },
    "padd5": {
      "name": "West Coast",
      "value": 48.5,
      "unit": "million_barrels"
    },
    "total_us": 427.1,
    "updated_at": "2025-01-15T16:00:00Z"
  }
}

Data Sources & Updates

Data PointSourceUpdate Frequency
Cushing StorageEIAWeekly (Wednesday)
SPR LevelsDOEWeekly (Friday)
Regional (PADD)EIAWeekly (Wednesday)

Use Cases

Monitor WTI Basis

Cushing storage levels directly impact WTI futures pricing. Low inventory = higher prices.

# Python example
storage = client.get_storage_cushing()
if storage['utilization_percent'] < 30:
    print("Low inventory - bullish for WTI")

Track SPR Policy

Monitor government crude oil releases and purchases.

Regional Supply Analysis

Understand supply/demand dynamics across US regions.

Last Updated: