Natural Gas Intelligence
Natural gas storage intelligence provides source-timestamped storage data for gas-market workflows.
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"
| Parameter | Type | Required | Description |
|---|---|---|---|
region | string | No | Storage region where supported |
from | date | No | Start date |
to | date | No | End 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.
| Code | What it is |
|---|---|
NATURAL_GAS_USD | Henry Hub, NYMEX front-month futures quote, updated intraday. Not a spot price and not a settlement. See instrument identity |
NATURAL_GAS_HENRY_HUB_SPOT_USD | Henry Hub daily physical spot price (EIA daily series) |
NATURAL_GAS_WAHA_USD | Waha 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=futuresreturns the quote only when it is an identified front-month contract. Otherwise it returns404 NO_FUTURES_DATA.?by_code=NATURAL_GAS_USD&by_type=spot_pricestill 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.
| Code | Hub |
|---|---|
NATURAL_GAS_BASIS_HSC_USD | Houston Ship Channel |
NATURAL_GAS_BASIS_ALGONQUIN_USD | Algonquin Citygate |
NATURAL_GAS_BASIS_TRANSCO_Z6_NY_USD | Transco Zone 6-NY |
NATURAL_GAS_BASIS_TETCO_M3_USD | TETCO-M3 |
NATURAL_GAS_BASIS_CHICAGO_USD | Chicago Citygate |
NATURAL_GAS_BASIS_EL_PASO_SAN_JUAN_USD | El Paso San Juan |
NATURAL_GAS_BASIS_SOCAL_BORDER_USD | SoCal Border |
NATURAL_GAS_BASIS_PGE_CITYGATE_USD | PG&E Citygate |
NATURAL_GAS_BASIS_SUMAS_USD | Northwest Sumas |
There is no Henry Hub basis code, because its basis against itself is zero. The basis series are daily.