{ "anchors": [ { "about": "EIA-reported BA code; source-reported, not a validated footprint (PD-002/009).", "format": "ba_code", "kind": "entity", "name": "balancing_authority_code", "scope": "opportunistic" } ], "capability": "power.demand", "codebooks": { "balancing_authority_code": { "codes": { "AEC": { "activation": "2015-07-01", "generation_only": false, "label": "PowerSouth Energy Cooperative", "region": "SE", "retirement": "2021-09-01" }, "AECI": { "activation": "2015-07-01", "generation_only": false, "label": "Associated Electric Cooperative, Inc.", "region": "MIDW", "retirement": null }, "AVA": { "activation": "2015-07-01", "generation_only": false, "label": "Avista Corporation", "region": "NW", "retirement": null }, "AVRN": { "activation": "2018-07-31", "generation_only": true, "label": "Avangrid Renewables, LLC", "region": "NW", "retirement": null }, "AZPS": { "activation": "2015-07-01", "generation_only": false, "label": "Arizona Public Service Company", "region": "SW", "retirement": null }, "BANC": { "activation": "2015-07-01", "generation_only": false, "label": "Balancing Authority of Northern California", "region": "CAL", "retirement": null }, "BHBA": { "activation": "2026-04-01", "generation_only": false, "label": "Black Hills Energy", "region": "NW", "retirement": null }, "BPAT": { "activation": "2015-07-01", "generation_only": false, "label": "Bonneville Power Administration", "region": "NW", "retirement": null }, "CHPD": { "activation": "2015-07-01", "generation_only": false, "label": "Public Utility District No. 1 of Chelan County", "region": "NW", "retirement": null }, "CISO": { "activation": "2015-07-01", "generation_only": false, "label": "California Independent System Operator", "region": "CAL", "retirement": null }, "CPLE": { "activation": "2015-07-01", "generation_only": false, "label": "Duke Energy Progress East", "region": "CAR", "retirement": null }, "CPLW": { "activation": "2015-07-01", "generation_only": false, "label": "Duke Energy Progress West", "region": "CAR", "retirement": null }, "DEAA": { "activation": "2015-07-01", "generation_only": true, "label": "Arlington Valley, LLC", "region": "SW", "retirement": null }, "DOPD": { "activation": "2015-07-01", "generation_only": false, "label": "PUD No. 1 of Douglas County", "region": "NW", "retirement": null }, "DUK": { "activation": "2015-07-01", "generation_only": false, "label": "Duke Energy Carolinas", "region": "CAR", "retirement": null }, "EEI": { "activation": "2015-07-01", "generation_only": true, "label": "Electric Energy, Inc.", "region": "MIDW", "retirement": "2020-02-29" }, "EPE": { "activation": "2015-07-01", "generation_only": false, "label": "El Paso Electric Company", "region": "SW", "retirement": null }, "ERCO": { "activation": "2015-07-01", "generation_only": false, "label": "Electric Reliability Council of Texas, Inc.", "region": "TEX", "retirement": null }, "FMPP": { "activation": "2015-07-01", "generation_only": false, "label": "Florida Municipal Power Pool", "region": "FLA", "retirement": null }, "FPC": { "activation": "2015-07-01", "generation_only": false, "label": "Duke Energy Florida, Inc.", "region": "FLA", "retirement": null }, "FPL": { "activation": "2015-07-01", "generation_only": false, "label": "Florida Power & Light Co.", "region": "FLA", "retirement": null }, "GCPD": { "activation": "2015-07-01", "generation_only": false, "label": "Public Utility District No. 2 of Grant County, Washington", "region": "NW", "retirement": null }, "GLHB": { "activation": "2020-02-29", "generation_only": true, "label": "GridLiance", "region": "MIDW", "retirement": "2022-09-01" }, "GRID": { "activation": "2015-07-01", "generation_only": true, "label": "Gridforce Energy Management, LLC", "region": "NW", "retirement": null }, "GRIF": { "activation": "2015-07-01", "generation_only": true, "label": "Griffith Energy, LLC", "region": "SW", "retirement": "2023-11-01" }, "GRMA": { "activation": "2015-07-01", "generation_only": true, "label": "Gila River Power, LLC", "region": "SW", "retirement": "2018-05-03" }, "GVL": { "activation": "2015-07-01", "generation_only": false, "label": "Gainesville Regional Utilities", "region": "FLA", "retirement": null }, "GWA": { "activation": "2015-07-01", "generation_only": true, "label": "NaturEner Power Watch, LLC", "region": "NW", "retirement": null }, "HGMA": { "activation": "2015-07-01", "generation_only": true, "label": "New Harquahala Generating Company, LLC", "region": "SW", "retirement": "2025-06-01" }, "HST": { "activation": "2015-07-01", "generation_only": false, "label": "City of Homestead", "region": "FLA", "retirement": null }, "IID": { "activation": "2015-07-01", "generation_only": false, "label": "Imperial Irrigation District", "region": "CAL", "retirement": null }, "IPCO": { "activation": "2015-07-01", "generation_only": false, "label": "Idaho Power Company", "region": "NW", "retirement": null }, "ISNE": { "activation": "2015-07-01", "generation_only": false, "label": "ISO New England", "region": "NE", "retirement": null }, "JEA": { "activation": "2015-07-01", "generation_only": false, "label": "JEA", "region": "FLA", "retirement": null }, "LDWP": { "activation": "2015-07-01", "generation_only": false, "label": "Los Angeles Department of Water and Power", "region": "CAL", "retirement": null }, "LGEE": { "activation": "2015-07-01", "generation_only": false, "label": "Louisville Gas and Electric Company and Kentucky Utilities Company", "region": "MIDW", "retirement": null }, "MISO": { "activation": "2015-07-01", "generation_only": false, "label": "Midcontinent Independent System Operator, Inc.", "region": "MIDW", "retirement": null }, "NEVP": { "activation": "2015-07-01", "generation_only": false, "label": "Nevada Power Company", "region": "NW", "retirement": null }, "NSB": { "activation": "2015-07-01", "generation_only": false, "label": "Utilities Commission of New Smyrna Beach", "region": "FLA", "retirement": "2020-01-08" }, "NWMT": { "activation": "2015-07-01", "generation_only": false, "label": "NorthWestern Corporation", "region": "NW", "retirement": null }, "NYIS": { "activation": "2015-07-01", "generation_only": false, "label": "New York Independent System Operator", "region": "NY", "retirement": null }, "OVEC": { "activation": "2015-07-01", "generation_only": false, "label": "Ohio Valley Electric Corporation", "region": "MIDA", "retirement": "2018-12-01" }, "PACE": { "activation": "2015-07-01", "generation_only": false, "label": "PacifiCorp East", "region": "NW", "retirement": null }, "PACW": { "activation": "2015-07-01", "generation_only": false, "label": "PacifiCorp West", "region": "NW", "retirement": null }, "PGE": { "activation": "2015-07-01", "generation_only": false, "label": "Portland General Electric Company", "region": "NW", "retirement": null }, "PJM": { "activation": "2015-07-01", "generation_only": false, "label": "PJM Interconnection, LLC", "region": "MIDA", "retirement": null }, "PNM": { "activation": "2015-07-01", "generation_only": false, "label": "Public Service Company of New Mexico", "region": "SW", "retirement": null }, "PSCO": { "activation": "2015-07-01", "generation_only": false, "label": "Public Service Company of Colorado", "region": "NW", "retirement": null }, "PSEI": { "activation": "2015-07-01", "generation_only": false, "label": "Puget Sound Energy, Inc.", "region": "NW", "retirement": null }, "SC": { "activation": "2015-07-01", "generation_only": false, "label": "South Carolina Public Service Authority", "region": "CAR", "retirement": null }, "SCEG": { "activation": "2015-07-01", "generation_only": false, "label": "Dominion Energy South Carolina, Inc.", "region": "CAR", "retirement": null }, "SCL": { "activation": "2015-07-01", "generation_only": false, "label": "Seattle City Light", "region": "NW", "retirement": null }, "SEC": { "activation": "2015-07-01", "generation_only": false, "label": "Seminole Electric Cooperative", "region": "FLA", "retirement": null }, "SEPA": { "activation": "2015-07-01", "generation_only": true, "label": "Southeastern Power Administration", "region": "SE", "retirement": null }, "SIKE": { "activation": "2025-06-01", "generation_only": true, "label": "Sikeston Board Of Municipal Utilities", "region": "MIDW", "retirement": null }, "SOCO": { "activation": "2015-07-01", "generation_only": false, "label": "Southern Company Services, Inc. - Trans", "region": "SE", "retirement": null }, "SPA": { "activation": "2015-07-01", "generation_only": false, "label": "Southwestern Power Administration", "region": "CENT", "retirement": null }, "SRP": { "activation": "2015-07-01", "generation_only": false, "label": "Salt River Project Agricultural Improvement and Power District", "region": "SW", "retirement": null }, "SWPP": { "activation": "2015-07-01", "generation_only": false, "label": "Southwest Power Pool", "region": "CENT", "retirement": null }, "SWPW": { "activation": "2026-04-01", "generation_only": false, "label": "Southwest Power Pool West Balancing Authority Area", "region": "NW", "retirement": null }, "TAL": { "activation": "2015-07-01", "generation_only": false, "label": "City of Tallahassee", "region": "FLA", "retirement": null }, "TEC": { "activation": "2015-07-01", "generation_only": false, "label": "Tampa Electric Company", "region": "FLA", "retirement": null }, "TEPC": { "activation": "2015-07-01", "generation_only": false, "label": "Tucson Electric Power", "region": "SW", "retirement": null }, "TIDC": { "activation": "2015-07-01", "generation_only": false, "label": "Turlock Irrigation District", "region": "CAL", "retirement": null }, "TPWR": { "activation": "2015-07-01", "generation_only": false, "label": "City of Tacoma, Department of Public Utilities, Light Division", "region": "NW", "retirement": null }, "TVA": { "activation": "2015-07-01", "generation_only": false, "label": "Tennessee Valley Authority", "region": "TEN", "retirement": null }, "WACM": { "activation": "2015-07-01", "generation_only": false, "label": "Western Area Power Administration - Rocky Mountain Region", "region": "NW", "retirement": "2026-04-01" }, "WALC": { "activation": "2015-07-01", "generation_only": false, "label": "Western Area Power Administration - Desert Southwest Region", "region": "SW", "retirement": null }, "WAUE": { "activation": "2015-07-01", "generation_only": false, "label": "Western Area Power Administration - Upper Great Plains East", "region": "NW", "retirement": "2015-10-01" }, "WAUW": { "activation": "2015-07-01", "generation_only": false, "label": "Western Area Power Administration - Upper Great Plains West", "region": "NW", "retirement": "2026-04-01" }, "WWA": { "activation": "2015-07-01", "generation_only": true, "label": "NaturEner Wind Watch, LLC", "region": "NW", "retirement": "2025-10-01" }, "YAD": { "activation": "2015-07-01", "generation_only": true, "label": "Alcoa Power Generating, Inc. - Yadkin Division", "region": "CAR", "retirement": null } }, "coverage": "complete_for_gated_eia930_balance_rows", "note": "EIA-930's BA code is the reporting entity itself, valid only inside its [activation, retirement) window (PD-020) \u2014 a retired BA's later months are honestly empty, never zero, and successor folds are not stitched. generation_only BAs report no demand (PD-021). A balancing authority is not a state. ERCO (ERCOT) lies wholly within Texas and covers ~90% of its load, but state=TX is the larger jurisdiction \u2014 it also includes non-ERCOT El Paso (WECC), the Panhandle (SPP), and East Texas (MISO), a material (~20%+) difference. Use balancing_authority_code for a grid and state for a jurisdiction; they are not interchangeable. When a phrase like 'the Texas grid' is ambiguous between the two, report both readings rather than guessing one (PD-009).", "semantics": "eia930_reporting_balancing_authority", "source": "EIA-930 reference table BAs sheet (the block's sha-pinned reference input)." }, "region": { "codes": { "CAL": { "label": "California" }, "CAR": { "label": "Carolinas" }, "CENT": { "label": "Central" }, "FLA": { "label": "Florida" }, "MIDA": { "label": "Mid-Atlantic" }, "MIDW": { "label": "Midwest" }, "NE": { "label": "New England" }, "NW": { "label": "Northwest" }, "NY": { "label": "New York" }, "SE": { "label": "Southeast" }, "SW": { "label": "Southwest" }, "TEN": { "label": "Tennessee" }, "TEX": { "label": "Texas" } }, "coverage": "complete_for_gated_eia930_balance_rows", "note": "EIA's 13 display regions for the lower-48 grid. A region is a display grouping of BAs, not a jurisdiction; region demand sums carry the same PD-021 non-additivity note as any other cross-BA sum.", "semantics": "eia930_reference_table_region_assignment", "source": "EIA-930 reference table BAs sheet (region assignment per BA)." } }, "data_point": { "does_not_answer": [ "plant, generator, county, or lat/lon attribution (structural \u2014 EIA-930 carries no such IDs; permanent refusal)", "state-level demand (BA footprints do not follow state lines)", "US48 or region totals as source rows (computed rollups; BA additivity is an open PD \u2014 gen-only BAs report no demand and the BA set is time-varying)", "installed capacity (EIA-860M), monthly plant generation (EIA-923), retail sales/customers (EIA-861)", "wholesale prices or transmission projects", "long-horizon demand forecasts (FERC-714, parked; the EIA-930 forecast is day-ahead only)", "reconciliation against EIA-923 or EIA-861 (different atoms by Rule 1/Rule 2; a discrepancy is a finding, never a canonical value)", "finality (the current half-year file is preliminary and continuously revisable)" ], "grain": "ba_hourly_flow", "id": "power.demand", "note": "Demand (EIA-930) and retail sales (EIA-861) are different consumption atoms, never interchangeable: demand is metered grid load \u2014 MW, hourly, balancing-authority grain \u2014 while retail sales are billed energy \u2014 MWh, annual, utility/state/sector grain. They do not reconcile (different quantity, boundary, and population), and neither is a proxy for the other. For a bare 'how much electricity does X use/consume' question with no time or grain signal, surface BOTH readings \u2014 hourly BA-grain demand (power.demand) and annual state-grain retail sales (power.retail_sales) \u2014 rather than answering with one (PD-018/PD-023).", "product_spec": "blocks/power_demand/card.md", "represented_fact": "EIA-930 reports hourly observed electricity demand (MW) by balancing authority \u2014 EIA's Adjusted series as the canonical value, with the raw series and the imputation flag preserved \u2014 plus the same row's day-ahead demand forecast, as a continuously revised hourly time series (history to 2015 H2).", "source_basis": [ "energy.eia.eia930" ], "source_decisions": [ "docs/sources/energy/eia/eia930/source-decision.md" ] }, "input": { "controls": [ "include_records", "include_evidence", "limit", "order_by", "top_n", "order", "rollup_other" ], "date_range_params": [ "data_date_from", "data_date_to" ], "date_ranges": [ "data_date" ], "field_metadata": { "is_imputed": { "answer_label": "EIA-imputed hour", "counting_definition": "A count of is_imputed=true rows counts BA-hours whose served demand is EIA-imputed, including EIA overrides of reported raw values, not just fills of missing ones.", "definition": "True where EIA's Adjusted demand came from EIA's Imputed series (fills AND overrides of reported raw values \u2014 PD-018); false where the Adjusted value passed through the reported raw value; null on forecast-only rows that carry no demand value yet. The filter accepts true, false, or {\"is_null\": true} for the forecast-only rows.", "display_name": "EIA imputation flag", "semantics": "eia930_adjusted_demand_origin_flag", "source_field": "Demand (MW) (Imputed)" } }, "filters": [ "as_of", "balancing_authority_code", "region", "data_date", "hour_number", "is_imputed" ], "group_by": [ "balancing_authority_code", "region", "data_date", "hour_number", "datetime_utc", "is_imputed" ], "ranking": { "no_ranking": "Omit order_by and top_n to return all groups in group-key order.", "order": { "default": "desc", "valid_values": [ "desc", "asc" ] }, "order_by": { "accepts": "one of output.metrics", "note": "Ranks the groups by a metric (a measure). Not a group_by dimension \u2014 rows already come back grouped by each group_by field.", "requires": [ "group_by" ], "valid_values": [ "demand_mw", "demand_forecast_mw", "source_record_count" ] }, "top_n": { "note": "Keeps the top N groups by order_by; the rest fold into one (other) remainder (additive metrics sum into it, non-additive ones are nulled) so the result still reconciles to summary.totals.", "requires": [ "group_by", "order_by" ], "type": "positive integer" } } }, "output": { "aggregate_citation_fields": [ "source_id", "publisher", "source_url", "source_file", "raw_file_sha256", "as_of", "source_rows_count", "source_rows_sample", "verify", "lineage_filter" ], "citation_fields": [ "source_id", "source_url", "source_file", "sheet", "source_row", "raw_file_sha256", "as_of" ], "detail_fields": [ "source_id", "sheet_name", "source_record_key", "report_period", "balancing_authority_code", "region", "data_date", "hour_number", "datetime_local", "datetime_utc", "demand_mw", "demand_mw_raw", "is_imputed", "demand_forecast_mw", "source_row_number", "as_of", "raw_file_sha256", "citation" ], "metric_groups": { "demand_mw": [ "demand_mw", "demand_forecast_mw" ], "records": [ "source_record_count" ] }, "metric_metadata": { "demand_forecast_mw": { "additive_across_groups": false, "aggregation": "sum", "authoritative_total_path": "summary.totals.demand_forecast_mw", "category": "demand_mw", "definition": "Sum of EIA-930 day-ahead hourly demand forecast (MW) within the current result scope.", "description": "Sum of the same source row's day-ahead demand forecast \u2014 forecast-vs-actual misses need no second query. Same PD-021 non-additivity as demand_mw.", "display_name": "Day-ahead demand forecast", "display_precision": "MW values are rounded to 6 decimal places in JSON to remove binary floating-point noise.", "grain": "balancing-authority hour", "null_handling": "Null source values are ignored by the sum; a matched group with only null source values returns null; an empty-query summary returns zero.", "rollup_behavior": "non_additive_measure", "row_metric_path": "rows[].metrics.demand_forecast_mw", "source_fields": [ "demand_forecast_mw" ], "unit": "MW" }, "demand_mw": { "additive_across_groups": false, "aggregation": "sum", "authoritative_total_path": "summary.totals.demand_mw", "category": "demand_mw", "definition": "Sum of EIA-930 hourly demand (MW, EIA's Adjusted series) within the current result scope.", "description": "Sum of EIA's Adjusted hourly demand series (PD-018). Not additive across balancing authorities (PD-021): a result summing >1 BA carries a ba_aggregation scope note, and ranking remainders omit it \u2014 group by balancing_authority_code for the source-grain series.", "display_name": "Demand (Adjusted)", "display_precision": "MW values are rounded to 6 decimal places in JSON to remove binary floating-point noise.", "grain": "balancing-authority hour", "null_handling": "Null source values are ignored by the sum (forecast-only trailing rows carry no demand value); a matched group with only null source values returns null; an empty-query summary returns zero.", "rollup_behavior": "non_additive_measure", "row_metric_path": "rows[].metrics.demand_mw", "source_fields": [ "demand_mw" ], "unit": "MW" }, "source_record_count": { "additive_across_groups": true, "aggregation": "count source records", "authoritative_total_path": "summary.totals.source_record_count", "category": "records", "definition": "Count of normalized source rows (BA-hours) contributing to the current result scope.", "description": "Number of normalized EIA-930 BALANCE source rows (BA-hours) contributing to the value.", "display_name": "Source record count", "display_precision": "Integer.", "grain": "source row", "null_handling": "Always an integer count.", "rollup_behavior": "additive_partition_metric", "row_metric_path": "rows[].metrics.source_record_count", "source_fields": [ "source_record_key" ], "unit": "count" } }, "metrics": [ "demand_mw", "demand_forecast_mw", "source_record_count" ], "summary_fields": [ "group_count", "totals" ] }, "primitive": "query_power_demand_v1", "status": "available" }