Documentation

Time your agents with Grid402

Grid402 is an HTTP API for the world's electricity grid. Every request to a paid endpoint returns 402 Payment Required until you attach a signed x402 payload. Free routes (health, schema, demo-tier mix) work without payment.

Primary product

5-minute generation mix and the carbon intensity computed from it.

Hourly mix is commoditized. Sub-hourly mix is what makes 24/7 CFE verification, hourly CBAM reporting, and DePIN slashing computationally possible — and it's what no other vendor sells per-call. Spot price is shipped alongside, but the moat is the mix.

Quickstart

Make your first paid call in 60 seconds — starts with /mix, the primary signal.

Endpoints

openapi.json

All routes — mix (primary), emissions (derived), spot price (bundled), combined.

x402 protocol

How HTTP 402 + USDC on Base settles each call.

Grid operator coverage

coverage.json

CAISO, ERCOT, NESO (GB), KPX, AEMO — Independent System Operators (not the standards body). Granularity, freshness, source URLs.

Agent skill set

skills.md · MIT

Grid402 is one skill of six. The curated catalog of skills an autonomous agent needs for programmable demand response on Base.