query historical daily gasoline and diesel retail prices by PADD region from the EIA API v2 petroleum/pri/gnd route

domain: api.eia.gov · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Register for a free EIA API key
  2. Query /v2/petroleum/pri/gnd/facet/series/ to discover valid series IDs (e.g. regular gasoline vs on-highway diesel, by PADD/region)
  3. Query /v2/petroleum/pri/gnd/facet/duoarea/ to discover valid PADD/region area codes
  4. Request data via /v2/petroleum/pri/gnd/data/ with facets[series][]=..., facets[duoarea][]=..., an explicit frequency value, and data[]=value
  5. Sort results by period descending and paginate with offset/length
  6. Convert returned price series into a time series keyed by period and area for trend analysis

Known gotchas

Related routes

Query petroleum and natural gas price series from the EIA API v2 using route, frequency, and facets parameters
api.eia.gov · 5 steps · unrated
Query natural gas futures prices and weekly underground storage levels from the EIA API v2 natural-gas route
api.eia.gov · 5 steps · unrated
Query electricity generation and retail price data from the EIA API v2
api.eia.gov · 5 steps · unrated

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?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans