GridHub Electricity Data

Endpoints (12 live)

• GET /v1/generation/US-CAISO — Historical generation time series for one electricity zone, oldest-first, max 31 days per call (start/end are Unix seconds; default last 24h; limit caps rows). Use for trends and backtests; use /v1/latest or /v1/brief for current values. Zone ids from /v1/zones. (0.01 USDC on Base)
• GET /v1/latest/US-CAISO — Most recent value of every metric one electricity zone publishes (wholesale price, demand, interchange; generation mix for GB and US-CAISO; carbon intensity for GB), each with unit and timestamp. Note European day-ahead prices can carry a timestamp up to ~36h ahead. Zone ids from /v1/zones. (0.001 USDC on Base)
• GET /v1/interchange/US-CAISO — Historical interchange time series for one electricity zone, oldest-first, max 31 days per call (start/end are Unix seconds; default last 24h; limit caps rows). Use for trends and backtests; use /v1/latest or /v1/brief for current values. Zone ids from /v1/zones. (0.01 USDC on Base)
• GET /v1/carbon-intensity/US-CAISO — Historical carbon intensity time series for one electricity zone, oldest-first, max 31 days per call (start/end are Unix seconds; default last 24h; limit caps rows). Use for trends and backtests; use /v1/latest or /v1/brief for current values. Zone ids from /v1/zones. (0.01 USDC on Base)
• GET /v1/capacity/DE-LU — Historical capacity time series for one electricity zone, oldest-first, max 31 days per call (start/end are Unix seconds; default last 24h; limit caps rows). Use for trends and backtests; use /v1/latest or /v1/brief for current values. Zone ids from /v1/zones. (0.01 USDC on Base)
• GET /v1/price/US-CAISO — Historical price time series for one electricity zone, oldest-first, max 31 days per call (start/end are Unix seconds; default last 24h; limit caps rows). Use for trends and backtests; use /v1/latest or /v1/brief for current values. Zone ids from /v1/zones. (0.01 USDC on Base)
• GET /v1/brief/US-CAISO — Interpretation-ready snapshot of one electricity zone: current wholesale price and demand (plus carbon intensity for GB) each ranked against the zone's own trailing 30-day distribution, 24h trend, and a one-sentence summary. Use for 'is power cheap or expensive in {zone} right now'. Zone ids from /v1/zones. (0.02 USDC on Base)
• GET /v1/demand/US-CAISO — Historical demand time series for one electricity zone, oldest-first, max 31 days per call (start/end are Unix seconds; default last 24h; limit caps rows). Use for trends and backtests; use /v1/latest or /v1/brief for current values. Zone ids from /v1/zones. (0.01 USDC on Base)
• GET /v1/map/snapshot — Current headline values (price, demand, and where published carbon intensity) for all 25 GridHub zones in one call. Use to compare or rank grids right now; rebuilt every 5 minutes. For one zone with context use /v1/brief/{zone}. (0.002 USDC on Base)
• GET /v1/price/:zone — Historical price time series for one electricity zone, oldest-first, max 31 days per call (start/end are Unix seconds; default last 24h; limit caps rows). Use for trends and backtests; use /v1/latest or /v1/brief for current values. Zone ids from /v1/zones. (0.01 USDC on Base)
• GET /v1/brief/:zone — Interpretation-ready snapshot of one electricity zone: current wholesale price and demand (plus carbon intensity for GB) each ranked against the zone's own trailing 30-day distribution, 24h trend, and a one-sentence summary. Use for 'is power cheap or expensive in {zone} right now'. Zone ids from /v1/zones. (0.02 USDC on Base)
• GET /v1/latest/:zone — Most recent value of every metric one electricity zone publishes (wholesale price, demand, interchange; generation mix for GB and US-CAISO; carbon intensity for GB), each with unit and timestamp. Note European day-ahead prices can carry a timestamp up to ~36h ahead. Zone ids from /v1/zones. (0.001 USDC on Base)