{"openapi":"3.1.0","info":{"title":"GridPulse","version":"1.0.0","description":"Pay-per-call U.S. power grid mix, retail electricity prices and Henry Hub natural gas prices. No signup or API key: agents pay per call in USDC via x402. Accepts USDC on Algorand or Base (mainnet)."},"servers":[{"url":"https://noahs-mac-mini.tail571e99.ts.net"}],"paths":{"/v1/grid-mix":{"get":{"summary":"Latest hourly U.S. power grid generation mix for a balancing authority (ISO New England, PJM, ERCOT, CAISO, MISO, NYISO, SPP and more)","description":"Latest hourly U.S. power grid generation mix for a balancing authority (ISO New England, PJM, ERCOT, CAISO, MISO, NYISO, SPP and more): MWh by fuel, % share, renewable and carbon-free share. Source: U.S. EIA.\n\nPrice: $0.01 USDC per call, paid via x402 (HTTP 402).","parameters":[{"name":"region","in":"query","required":true,"description":"Balancing authority code","schema":{"type":"string","enum":["ISNE","NYIS","PJM","MISO","ERCO","CISO","SWPP","SOCO","TVA","BPAT","FPL","DUK"]},"example":"ERCO"}],"responses":{"200":{"description":"Data","content":{"application/json":{"example":{"region":"ERCO","regionName":"ERCOT (Texas)","hourUtc":"2026-09-26T03:00Z","totalGenerationMwh":52110,"renewableSharePct":38.4,"carbonFreeSharePct":48.2,"fuels":[{"code":"NG","fuel":"Natural Gas","mwh":24100,"sharePct":46.2}],"source":"U.S. EIA Hourly Electric Grid Monitor"}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required: x402 payment requirements in the PAYMENT-REQUIRED header"},"502":{"description":"Upstream data source unavailable (not charged)"}},"x-price-usd":"$0.01"}},"/v1/retail-price":{"get":{"summary":"Latest average retail electricity price for any U.S. state (cents/kWh) by sector (residential, commercial, industrial), with year-over-year change and 12-month history. Source","description":"Latest average retail electricity price for any U.S. state (cents/kWh) by sector (residential, commercial, industrial), with year-over-year change and 12-month history. Source: U.S. EIA.\n\nPrice: $0.005 USDC per call, paid via x402 (HTTP 402).","parameters":[{"name":"state","in":"query","required":true,"description":"Two-letter U.S. state code, or US for national average","schema":{"type":"string"},"example":"CT"},{"name":"sector","in":"query","required":false,"description":"Defaults to RES","schema":{"type":"string","enum":["RES","COM","IND","ALL"]},"example":"RES"}],"responses":{"200":{"description":"Data","content":{"application/json":{"example":{"state":"CT","stateName":"Connecticut","sector":"residential","month":"2026-07","priceCentsPerKwh":24.16,"yearAgoCentsPerKwh":23.5,"yoyChangePct":2.8,"source":"U.S. EIA Electric Power Monthly (retail sales)"}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required: x402 payment requirements in the PAYMENT-REQUIRED header"},"502":{"description":"Upstream data source unavailable (not charged)"}},"x-price-usd":"$0.005"}},"/v1/henry-hub":{"get":{"summary":"Henry Hub natural gas spot price ($/MMBtu)","description":"Henry Hub natural gas spot price ($/MMBtu): latest daily price plus 30-trading-day average, min, max, % change and full history. Source: U.S. EIA.\n\nPrice: $0.005 USDC per call, paid via x402 (HTTP 402).","parameters":[],"responses":{"200":{"description":"Data","content":{"application/json":{"example":{"hub":"Henry Hub (Louisiana)","date":"2026-09-22","spotUsdPerMmbtu":2.9,"avgLast30TradingDays":2.87,"changeOverPeriodPct":4.1,"source":"U.S. EIA Natural Gas Spot Prices"}}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required: x402 payment requirements in the PAYMENT-REQUIRED header"},"502":{"description":"Upstream data source unavailable (not charged)"}},"x-price-usd":"$0.005"}}}}