Microproduct Data GuideIntermediate

EIA Weekly Natural Gas Storage

Weekly U.S. working-gas in storage for building inventory monitors and energy-market dashboards.

Report a Problem

At a Glance

Difficulty
Intermediate — some data preparation helps
Size
Medium · ≤1 GB
Formats
JSON, CSV
Access
API or Download
API Key
Required
Provider
U.S. Energy Information Administration
Updates
Weekly
Last Verified
Aug 18, 2026
Source Type
Government Source
  • Python Syntax Checked

From Source to Product Signal

Test a Product Idea in Four Steps

EIA's weekly underground storage route returns working-gas inventories. Start with the Lower 48 total and a short length. These are storage statistics, not Henry Hub spot prices, and weekly values can be revised.

1

Check the Setup

  • Python 3.10 or newer
  • A notebook environment such as Jupyter or Google Colab
  • A free EIA API key saved in the EIA_API_KEY environment variable
2

Access the Data

  1. 1.Register for a free key on the EIA Open Data site, or reuse EIA_API_KEY.
  2. 2.Confirm the natural-gas weekly storage route.
  3. 3.Request a bounded Lower 48 working-gas sample.
Open Official Source
3

Run the Python Example

Install the packages, then run the notebook cell.

python -m pip install pandas requests

import os
import pandas as pd
import requests

response = requests.get(
    "https://api.eia.gov/v2/natural-gas/stor/wkly/data/",
    params={
        "api_key": os.environ["EIA_API_KEY"],
        "frequency": "weekly",
        "data[0]": "value",
        "facets[duoarea][]": "NUS",
        "length": 20,
    },
    timeout=30,
)
response.raise_for_status()
storage = pd.DataFrame(response.json()["response"]["data"])
storage["period"] = pd.to_datetime(storage["period"])
storage["value"] = pd.to_numeric(storage["value"], errors="coerce")
storage["retrieved_at_utc"] = pd.Timestamp.now(tz="UTC")
print(storage[["period", "duoarea", "value", "units"]].head())
4

Test a Useful Signal

Track Lower 48 Weekly Gas Storage

Test whether a short storage window can power an inventory-change alert.

  1. 01Sort by period and compute week-to-week storage changes.
  2. 02Flag the largest injections and withdrawals in the extract.
  3. 03Explain that weekly storage is not a spot price and that EIA can revise previously published weeks.

Dataset Details

U.S. Energy Information Administration is a government source. Last verified 2026-08-18. Temporal coverage: weekly natural-gas storage series with history varying by region.

Geography

Formats

Provider

U.S. Energy Information Administration

Data Terms

U.S. Public Domain with EIA source acknowledgment

Send Feedback