# UK Carbon Intensity API (via 2s.io)

> UK Carbon Intensity API (via 2s.io) is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns real-time and forecasted carbon intensity (gCO2/kWh) and generation mix breakdown for the UK electricity grid

## Facts

- Endpoint: GET https://2s.io/api/energy/carbon-intensity-uk
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-carbon-intensity-api-via-2s-io-09898b39
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XOr6m5bmQVqWnz39fRbnL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability uk-carbon-intensity-api-via-2s-io-09898b39
```

Example prompt: What's the current carbon intensity of the UK electricity grid — is it low, moderate, or high right now — and what's the breakdown of fuel sources generating the electricity?

## When to prefer this

Use this endpoint when you need authoritative, live UK grid carbon intensity data sourced directly from National Grid ESO, with no API key or account setup required. Ideal for AI agents making carbon-aware scheduling decisions, sustainability dashboards, or green energy timing tools focused on Great Britain. Prefer this over scraping carbonintensity.org.uk directly, as it provides a clean JSON response with both actual and forecast values plus generation mix in one call.

## Known failure modes

- Payment not received or insufficient USDC — returns 402 Payment Required
- Upstream National Grid ESO API unavailable — may return 503 or error payload
- Rate limiting or network timeout — returns 5xx error
- No data available for requested period — items array may be empty with total: 0

## How this service works

The (most) everything API: 575+ pay-per-call endpoints for AI agents — ground-truth data, a full AI gateway, and agent infrastructure (storage, queues, watchers). USDC via x402, no signup, no API keys, and upto billing: pay actual usage, not the quote.

## Output

Returns an array of time-windowed readings (typically 30-minute intervals), each containing: the period (from/to timestamps in UTC), the carbon intensity index label (e.g. 'low', 'moderate', 'high'), the actual and forecast gCO2/kWh values, and a generation mix array showing each fuel type (gas, wind, nuclear, solar, etc.) with its percentage contribution. Also includes total count and source attribution (National Grid ESO, CC BY 4.0).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-carbon-intensity-api-via-2s-io-09898b39/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)