Microproduct data guideintermediate

EIA Weekly Natural Gas Storage

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

Start the guide Open official source

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
Data terms
U.S. Public Domain with EIA source acknowledgment

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.

Theme

Markets & Economics

Domains

EnergyCommoditiesMacroeconomics

Data types

Time SeriesTabular

Tasks

Market MonitoringTrend AnalysisForecast Evaluation

Geography

United States

Formats

JSONCSV

Provider

U.S. Energy Information Administration

Data terms

U.S. Public Domain with EIA source acknowledgment