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

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

x402 protocol

How HTTP 402 + USDC on Base settles each call.

Grid operator coverage

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

Agent skill set

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