# U.S. Electric Grid – real-time overview & early warning > Independent public dashboard of the U.S. power grid (Lower 48) built only from free public data: EIA-930 hourly grid monitor, NOAA NWS alerts, NOAA SWPC space weather, NOAA NHC, ERCOT dashboards and DOE/ORNL ODIN outages. Data refresh automatically (server cache 2–15 min, event log every 30 min). ## Machine-readable endpoints - [/api/summary.json](/api/summary.json): full current summary (JSON, CORS *). Key fields: `us48` (demand, forecast, generation, interchange, fuel mix, renewables %, CO2 estimate), `interconnects`, `regions` (13 EIA regions), `bas` (major balancing authorities incl. PJM, ERCOT, FPL), `flows`, `ercot`, `space` (Kp, NOAA scales, solar wind), `weather` (NWS alerts Southeast + PA + major U.S. warnings), `hurricanes`, `outages` (ODIN by state), `alerts` (normalized alert list with `level`, `category`, `sms_eligible`), `focus` (risk for Destin FL and Bristol Township PA), `canada` (U.S.⇄Canada BA-level interchange, EIA-930, lags 1–2 days), `frequency`, `outage_peaks` (automatically recorded state outage episodes ≥ 100,000 customers from DOE ODIN), `outage_ranges` (24-hour and 7-day per-state peaks and sparklines from 30-minute ODIN snapshots stored in the collector’s existing KV write), `events`, `sources` (with fetch timestamps). All times are ISO 8601 UTC. - [/api/local.json](/api/local.json): visitor-localized view (approximate location from a one-time IP lookup, or `?lat=..&lon=..` / `?zip=..`): grid region, local NWS alerts, own-estimate outage risk, and `battery` (home-battery readiness: charge / prepare / normal / n/a). Locations are not stored. Rules are documented at [/data#battery-rules](/data#battery-rules). - [/api/events.json](/api/events.json): grid event log, last 14 days (NWS warnings, SWPC alerts, EIA demand anomalies, ERCOT conditions, large ODIN outages). - [/data/outage-history.json](/data/outage-history.json): Major U.S. outage history (Irma, Ian, Milton, Helene, Beryl, Uri, Michael, Sally, 2003 blackout …); every number has a source URL (EIA, DOE, NOAA, FERC, utility). - [/data](/data): plain HTML summary without JavaScript (English); [/data?lang=cs](/data?lang=cs) Czech. ## Notes - "Outage risk", "Grid Status" and home-battery guidance are own estimates from public data, not official forecasts or operator statements. - Major Outage History combines a curated file of officially sourced past events ([/data/outage-history.json](/data/outage-history.json)) with automatically recorded episodes: a scheduled collector (every 30 minutes) appends a new row when a state’s live DOE ODIN total exceeds 100,000 customers, raises the peak of an ongoing episode, and closes it when the total falls below 50,000 (a return above 100,000 within 36 hours reopens the same row). These live rows appear as `outage_peaks` in the summary. - Grid frequency: ERCOT (Texas) is official live data from ERCOT ([/api/freq.json](/api/freq.json), also `frequency.ercot` in the summary); Eastern and Western Interconnection have no free public numeric feed (N/A). PJM emergency procedures are not included (requires an API key). - EIA generation/interchange values lag demand by several hours; each value carries its own timestamp. ## Versions - / : GridRadar24 v4 (current one-screen dashboard) - /3/ : GridRadar24 v3 - /2/ and /1/ : classic v1 dashboard (same data) - Outage dashboard ranges: LIVE is current DOE/ORNL ODIN; 24H and 7D are peak customers out (and a sparkline) from the site’s own 30-minute snapshots (shown as “collecting since …” until the window is full); YEARS are precomputed from the official DOE/ORNL EAGLE-I historical county dataset ([/data/outages-years.json](/data/outages-years.json), figshare 24237376, CC BY 4.0). Years not yet processed are listed as missing and are not estimated. - Demand chart ranges: DAY is EIA-930 hourly Lower-48 demand for the last 24 hours (plus day-ahead forecast); WEEK is hourly EIA-930 US48 demand for 7 days; YEAR is daily EIA-930 US48 energy for ~12 months (Eastern time). 10 YEARS is official annual U.S. retail electricity sales from EIA Monthly Energy Review Table 7.6 (ESTCPUS, 2015–2025, TWh), published at [/data/demand-long.json](/data/demand-long.json). Week/year are cached (Cache API, no extra KV writes). The 10-year retail-sales series is not the same as EIA-930 demand. - Outage risk forecast (24–48 h, own estimate, not official): grid load is the primary factor; storms at the visitor’s location (NWS point alerts plus the 24–48 h Open-Meteo thunderstorm/gust forecast) are second; solar activity is only a small bonus and does not change the combination band. Overall level is at least the grid-load level. The two main factors combine: moderate load + moderate storm → overall HIGH (score typically 70–80); high load + moderate or high storm, or moderate load + high storm, → SEVERE (score ≥ 85). A storm Watch alone floors overall at moderate; a storm Warning alone floors it at high. Weather can raise the score above the grid-load floor but cannot lower it. Bands: low 0–34, moderate 35–64, high 65–84, severe 85–94, extreme 95–100. EXTREME requires high grid load + a storm Warning + at least one more factor (elevated Kp, ERCOT EEA, hurricane/extreme-wind warning, or ≥ 100,000 customers out in the state); high load + a storm Warning alone stays severe. A logo beacon is steady green at low or moderate risk (no flash), and flashes yellow / red / purple at high / severe / extreme. Rules: [/data#risk-rules](/data#risk-rules). - Human-readable source list: [/sources](/sources) (what each feed provides, license, update frequency and typical delay). - County risk map (toggle on the Outage Risk card): same scoring rules as the gauge; storm alerts from NWS UGC/FIPS; live outages from DOE ODIN; history from EAGLE-I when a county is in the archive. Counties without EAGLE-I coverage are labelled no data. Alaska, Hawaii, Puerto Rico and other areas without an EIA-930 regional load series have no grid-load factor.