Send your key in the X-API-Key header. Base URL: https://noahs-mac-mini.tail571e99.ts.net/api/v2
| Endpoint | Plan | Returns |
|---|---|---|
GET /carbon-intensity?region=ERCO | All | Latest hourly gCO₂/kWh for a grid region |
GET /carbon-intensity/history?region=PJM&start=2026-09-01&end=2026-09-07 | Pro+ | Hourly series; add &format=csv for CSV |
GET /reports/scope2?region=CISO&month=2026-08 | Business | Monthly location-based factor and hourly distribution |
GET /grid-mix?region=ISNE | All | Generation by fuel, renewable and carbon-free share |
GET /retail-price?state=CT§or=COM | All | Retail electricity price, YoY, 12-month history |
GET /henry-hub | All | Henry Hub natural gas spot price and 30-day stats |
GET /account | All | Your plan and today's usage |
Regions: ISNE ISO New England, NYIS New York ISO, PJM PJM Interconnection, MISO Midcontinent ISO, ERCO ERCOT (Texas), CISO California ISO, SWPP Southwest Power Pool, SOCO Southern Company, TVA Tennessee Valley Authority, BPAT Bonneville Power Administration, FPL Florida Power & Light, DUK Duke Energy Carolinas.
curl -H "X-API-Key: YOUR_KEY" "https://noahs-mac-mini.tail571e99.ts.net/api/v2/carbon-intensity?region=ERCO"
Location-based estimate: generation-weighted average of EIA 2023 CO2 factors (coal 1048, natural gas 435, petroleum 1116 gCO2/kWh; nuclear and renewables 0; other/unknown at the gas factor), applied to the EIA hourly fuel mix for the balancing authority. Excludes storage discharge and imports. For internal analysis and screening; not a certified emissions factor.
EIA hourly data is typically published with a lag of several hours; "latest" means the most recent complete hour EIA has released.
Data: U.S. Energy Information Administration (public domain). Carbon estimates use EIA emission factors; see methodology. Payments by Stripe.