# GridPulse

> US energy intelligence API — electricity prices, grid status, renewable mix, natural gas, 90-day forecasts, EV charging cost analysis, and solar feasibility. All endpoints return structured JSON synthesized by Claude from live EIA and NREL data. Pay-per-query via x402 micropayments on Base mainnet.

## Endpoints

GET /api/energy/prices?state={state_code}
- Returns: retail electricity rates by sector (residential/commercial/industrial), trend vs national average, monthly bill estimate, price drivers, 90-day outlook, energy efficiency gear recommendations
- Price: $0.08

GET /api/energy/grid?region={region}
- Returns: grid demand status, capacity utilization, generation mix by fuel type, stress level, reliability note, price impact
- region values: ercot, caiso, pjm, miso, isone, nyiso, spp
- Price: $0.08

GET /api/energy/renewable?state={state_code}
- Returns: renewable generation percentage, full generation mix by fuel, carbon intensity rating, national ranking, trend, best EV charging window
- Price: $0.08

GET /api/energy/natural-gas
- Returns: Henry Hub spot price, week-over-week change, storage vs 5-year average, supply/demand balance, electricity and heating cost impact, 90-day outlook
- Price: $0.08

GET /api/energy/forecast?state={state_code}
- Returns: 90-day electricity price direction and range, demand outlook, peak risk periods, grid reliability outlook, consumer and business actions
- Price: $0.10

GET /api/energy/ev-cost?state={state_code}&miles={annual_miles}
- Returns: cost per mile, annual charging cost, gas comparison, annual savings, off-peak strategy, home charger recommendation
- miles: 1,000-100,000 (default 12,000)
- Price: $0.08

GET /api/energy/solar?zip={zip_code}&state={state_code}
- Returns: solar resource rating, NREL production estimate, system cost, IRA 30% tax credit, payback period, 25-year savings, EnergySage quote link
- Provide zip (preferred) or state
- Optional: system_kw (default 6, range 2-20)
- Price: $0.10

## Payment

All endpoints use x402 protocol. No payment header returns HTTP 402 with PAYMENT-REQUIRED header (0.08-0.10 USDC on Base mainnet).

## Data Sources

- EIA API (api.eia.gov) — official US Energy Information Administration data
- NREL PVWatts v8 (developer.nrel.gov) — solar production estimates
- Tavily — real-time energy news and market context
- Claude Sonnet — synthesis and analysis

## Disclaimer

For informational purposes only. Not financial or trading advice.