Query natural gas futures prices and weekly underground storage levels from the EIA API v2 natural-gas route
domain: api.eia.gov · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Get a free api_key from eia.gov/opendata.
Call routes ending in /data, e.g. api.eia.gov/v2/natural-gas/pri/fut/data for futures contract prices ($/MMBtu) and api.eia.gov/v2/natural-gas/stor/wkly/data for weekly Lower-48 storage estimates.
Filter with facets[facetname][]=value (e.g. a series facet) and select value columns via data[].
Paginate large pulls with length/offset — each call caps at 5,000 rows (300 for XML).
Discover valid facet values for a route by calling it without facets first and inspecting the metadata response.
Known gotchas
Forgetting the trailing /data on a route returns metadata only, not data rows, with no explicit error — easy to mistake for 'no data available'.
EIA doesn't publish exact throttle numbers but recommends staying under roughly 5 requests/second sustained; exceeding it can trigger a temporary key block.
API v1 series IDs don't map 1:1 to v2 routes — the v1 compatibility shim can return different row counts than the legacy series did.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?