OilPriceAPI Docs
Quick Start
API Reference
  • SDKs and languages
  • Tutorials
  • Articles
  • Documentation directory
  • Quick reference
  • API explorer
  • FAQ
  • Changelog
  • Status
  • Dashboard
GitHub
Quick Start
API Reference
  • SDKs and languages
  • Tutorials
  • Articles
  • Documentation directory
  • Quick reference
  • API explorer
  • FAQ
  • Changelog
  • Status
  • Dashboard
GitHub
  • Interactive Explorer

    • Interactive API Explorer
  • Price Data

    • API Reference
    • Get Latest Prices
    • Historical Prices
    • Batch Prices
    • Excel Latest Price Gateway
    • Price Widget Endpoints
    • Price Utility Endpoints
    • Demo API (No Authentication)
    • Natural Gas Intelligence
    • Energy News Feed
  • Commodities

    • List Commodities
    • Get Commodity Details
    • Denmark diesel list prices (OK Danmark)
    • Data Publication & Collection Schedules
  • AI Agents (MCP)

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

    • Marine Fuel API
    • List Marine Fuel Ports
    • Get Port Details with Prices
    • Bunker Fuels
    • Maritime Fuels
  • Fuel Surcharges

    • Fuel Surcharge API
  • Premium Endpoints

    • All Prices API - One Call, All Commodities
    • Cushing Oil Storage Intelligence API
    • Drilling Intelligence API
    • Marine Fuels API
    • ICE Brent Futures API
    • Aviation Fuel Pilot
  • Spreads & Margins

    • Spreads & Margins
    • Crack Spreads
    • European Gasoil Crack
    • Basis Spreads
    • Refining Margins
    • Curve Structure
    • Physical Premiums
  • Market Indicators

    • Market Indicators
    • Fuel Switching
    • Price Context
    • Storage Analytics
    • CFTC Positioning
    • Market Annotations
  • Futures

    • Futures API
    • ICE Brent Futures
    • WTI Futures
    • Continuous Futures (Brent, WTI)
    • ICE Gas Oil Futures
    • NYMEX Natural Gas Futures
    • ICE EUA Carbon Futures
    • EU Carbon Futures
    • TTF Gas Futures
    • LNG JKM Futures
    • UK Carbon Futures
  • Dark Data (Premium)

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

    • Well Production Data
    • Well Production API Reference
  • Analytics

    • Analytics API
  • Webhooks API

    • Webhooks API Reference
    • Webhook Endpoint Reference
  • Alerts

    • Price Alerts API
  • Scheduled Deliveries

    • Scheduled Deliveries API
  • Account & Billing

    • Account API
    • API Keys
    • Subscriptions
    • Organizations

Natural Gas Intelligence

Natural gas storage intelligence provides source-timestamped storage data for gas-market workflows.

GET/v1/natural-gas/storage

Scope

This page documents /v1/natural-gas/storage only. Do not use /v1/natural-gas/weather-demand or /v1/natural-gas/pipeline-flows until the backend entitlement bug referenced in the sprint issues is fixed.

Request

curl "https://api.oilpriceapi.com/v1/natural-gas/storage?region=us" \
  -H "Authorization: Token YOUR_API_KEY"
ParameterTypeRequiredDescription
regionstringNoStorage region where supported
fromdateNoStart date
todateNoEnd date

Response

{
  "status": "success",
  "data": {
    "region": "us",
    "working_gas_bcf": 3200,
    "weekly_change_bcf": 45,
    "source": "EIA WNGSR",
    "period": "2026-07-10",
    "updated_at": "2026-07-16T14:35:00.000Z"
  }
}

Cadence

US natural gas storage is published weekly by the EIA Weekly Natural Gas Storage Report, normally Thursday at 10:30 AM Eastern. Always use the response period and source timestamp in downstream dashboards.

Access

This endpoint is premium Energy Intelligence access. Handle 403 as an entitlement issue and 402 as a plan/quota issue.

Henry Hub and regional basis codes

These are price codes, read with /v1/prices/latest and /v1/prices/historical, not part of the storage endpoint above.

CodeWhat it is
NATURAL_GAS_USDHenry Hub, NYMEX front-month futures quote, updated intraday. Not a spot price and not a settlement. See instrument identity
NATURAL_GAS_HENRY_HUB_SPOT_USDHenry Hub daily physical spot price (EIA daily series)
NATURAL_GAS_WAHA_USDWaha hub (West Texas / Permian) daily spot. NATURAL_GAS_WAHA is the legacy spelling of the same series

NATURAL_GAS_USD instrument identity

A NATURAL_GAS_USD quote that we can identify as the NYMEX front-month contract returns "type": "futures", its contract_month, and an instrument_disclosure object:

{
  "instrument_disclosure": {
    "instrument": "front_month_futures",
    "display_name": "NYMEX Henry Hub Natural Gas front-month futures",
    "contract_reference": "NYMEX NG",
    "spot_counterpart": "NATURAL_GAS_HENRY_HUB_SPOT_USD",
    "type_note": "The legacy by_type=spot_price filter remains the lookup key for this futures quote. For physical spot, use the code in spot_counterpart.",
    "contract_month": "2026-12"
  }
}

The contract_month value above is an example. Older rows whose contract month is unknown, including historical EIA spot observations, are not relabelled as futures.

On /v1/prices/latest, both filters select this quote:

  • ?by_code=NATURAL_GAS_USD&by_type=futures returns the quote only when it is an identified front-month contract. Otherwise it returns 404 NO_FUTURES_DATA.
  • ?by_code=NATURAL_GAS_USD&by_type=spot_price still works for compatibility. It is a lookup key, not a statement that the quote is physical spot.

by_type=futures also works for a single dated futures code such as WTI_FUTURES_2026_11. For a spot-only code it returns 400 INVALID_TYPE.

Waha

NATURAL_GAS_WAHA_USD is the public spelling; rows are stored under NATURAL_GAS_WAHA. Either spelling returns the same series from aggregated history (/v1/prices and /v1/prices/past_week with interval, and /v1/prices/past_year?interval=1m), and completeness metadata counts the rows under the code you requested. Returned rows carry "code": "NATURAL_GAS_WAHA". Requesting both spellings in one call returns each bucket once. When a monthly window has no Waha observations, the response is 404 NO_DATA instead of an empty result.

The Waha basis to Henry Hub is served as pair=WAHA_HH on /v1/spreads/basis. It is not one of the basis codes below.

Nine Lower 48 hubs are published as basis to Henry Hub: the hub price minus Henry Hub, in USD/MMBtu, negative when the hub trades below Henry Hub. Adding a basis to a Henry Hub futures curve gives a forward curve for that hub.

CodeHub
NATURAL_GAS_BASIS_HSC_USDHouston Ship Channel
NATURAL_GAS_BASIS_ALGONQUIN_USDAlgonquin Citygate
NATURAL_GAS_BASIS_TRANSCO_Z6_NY_USDTransco Zone 6-NY
NATURAL_GAS_BASIS_TETCO_M3_USDTETCO-M3
NATURAL_GAS_BASIS_CHICAGO_USDChicago Citygate
NATURAL_GAS_BASIS_EL_PASO_SAN_JUAN_USDEl Paso San Juan
NATURAL_GAS_BASIS_SOCAL_BORDER_USDSoCal Border
NATURAL_GAS_BASIS_PGE_CITYGATE_USDPG&E Citygate
NATURAL_GAS_BASIS_SUMAS_USDNorthwest Sumas

There is no Henry Hub basis code, because its basis against itself is zero. The basis series are daily.

Related

  • Futures: Natural Gas
  • TTF Gas Futures
  • LNG JKM Futures
  • Data Freshness
Last Updated: 11/15/26, 8:08 PM
Prev
Demo API (No Authentication)
Next
Energy News Feed