Query verified U.S. hourly electricity demand (MW) by balancing authority from EIA-930.
Use this for "how much load" questions at the hourly balancing-authority grain:
filter or group by `balancing_authority_code`, `region`, `data_date` (or the
`data_date_from`/`data_date_to` range), `hour_number`, `datetime_utc`, or
`is_imputed`. Pass filters inside the `params` object. Returns JSON aggregates
with citations and optional row-level records when `include_records` is true.
`demand_mw` is EIA's own cleaned (Adjusted) series, with receipts: the
as-reported `demand_mw_raw` and the `is_imputed` flag ride every detail record.
`demand_forecast_mw` is the same row's day-ahead forecast, so
forecast-vs-actual misses need no second query. History runs hourly from
2015-07-01 onward and is served by default: a bare `data_date` anywhere in
that window answers from the newest promoted vintage covering it, and the
response `as_of` is that knowledge cut. A query with NO calendar window (no
`data_date`, `data_date_from`, or `data_date_to`) and no calendar-axis
`group_by` defaults to the latest day that has reported demand — not the full
history — and says so in a `default_latest_day` note; group by `data_date` or
`datetime_utc`, or pass a date range, to read a series over time. Pin `as_of`
to an earlier vintage to
reproduce exactly what was served then; one response may cite several source
files, and every citation carries its own file and vintage. An empty result
names the served coverage window in an `empty_scope` note. Demand is NOT additive across
balancing authorities: a result summing more than one BA carries a
`ba_aggregation` scope note and ranking remainders omit the demand metrics —
group by `balancing_authority_code` for the source-grain series. Does not
determine plant, generator, county, or state attribution (EIA-930 carries no
such IDs, and BA footprints do not follow state lines), US48 or regional
totals (computed rollups are refused; EIA's own published series is the named
follow-up), installed capacity (MW — use power.capacity), monthly plant
generation (use power.generation), retail sales/revenue/customers (use
power.retail_sales), wholesale prices, or long-horizon forecasts (the EIA-930
forecast is day-ahead only).
Connector