Electricity — U.S. (EIA)

Catalog

Browse and search all available datasets.

• Catalog — browse all datasets
• GET /api/catalog — catalog in JSON
• GET /api/catalog?q=… — search the catalog

Dataset API

Endpoints for this dataset — schema, filter values, preview, and querying.

• GET /api/datasets/eia_elec — schema, filters, and pricing
• Sample preview (table) · GET /api/datasets/eia_elec/sample — free sample (up to 100 rows)
• GET /api/datasets/eia_elec/members/{col} — valid values for a filterable column
• GET /api/datasets/eia_elec/query — query with filters (API key required)

Purchase

Add balance or buy access to start querying.

• POST /api/checkout/x402 — agents: add balance via x402 (USDC)
• Sign in at /account — humans: add balance via Stripe (card, Apple Pay, bank transfer)
• POST /api/ap2/intent → /api/ap2/purchase — agents: AP2 mandate-based payment

Source

Name

U.S. Energy Information Administration - Electricity

URL

https://www.eia.gov/opendata/

License

Public Domain (U.S. Government)

Size and Format

Rows

41,702,190

Columns

8

Size (bytes)

90,250,027

Formats

parquet, csv

Pricing

Per query (USD)

0.0100 USD

Max rows per query

1000

Free

No

Free sample

Yes

Temporal Coverage

end

2026

start

2001

frequency

monthly

Geographic Coverage

level

plant

coding

EIA plant ID / state code

region

usa

Query Filters

Columns you can use as query params in GET /api/datasets/eia_elec/query.

• series_id Members (JSON)
• geography Members (JSON)
• year Members (JSON)
• period Members (JSON)

Schema (Columns)