# GridPulse Carbon Intensity API

> GridPulse Carbon Intensity API is a paid API for AI agents from gridpulse.theaslangroupllc.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns live grid carbon intensity (gCO2/kWh) plus a 48-hour forward curve and cleanest/dirtiest time slots for European electricity grids (GB, DE, FR, NL, BE, AT, ES, IT, NO)

## Facts

- Endpoint: GET https://gridpulse.theaslangroupllc.com/api/energy/carbon-intensity
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gridpulse-carbon-intensity-api-e55de826
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PGTKjkgv3V72dhSETsFwd

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 gridpulse-carbon-intensity-api-e55de826
```

Example prompt: What's the current carbon intensity of the German grid in gCO2 per kWh, and when is the cleanest hour to run a heavy compute job over the next 48 hours?

## When to prefer this

Use this endpoint when you need real-time or near-future grid carbon intensity data for European electricity grids, especially for green scheduling, sustainability reporting, or carbon-aware compute workloads. Prefer this over generic energy APIs when you need GB DNO regional granularity or Fraunhofer ISE-sourced European data with a 48-hour forward curve and explicit cleanest/dirtiest slot identification. Pair with /api/energy/compute-window for full job scheduling optimization.

## Known failure modes

- Unsupported country or region code returns 400 with list of valid regions
- Data source temporarily unavailable for a region returns partial data or 503
- Stale data if upstream NESO or energy-charts feeds are delayed
- Rate limit or payment failure returns 402 payment required

## How this service works

Live grid carbon intensity, deterministic. Answers "how clean is the grid right now", "gCO2 per kWh in Germany", "cleanest hour to run a job today". Current intensity + forward curve (to 48h) + cleanest and dirtiest slots, from NESO (GB national + 14 DNO regions) and energy-charts/Fraunhofer ISE (DE FR NL BE AT ES IT NO). No LLM, no key. Pair with /api/energy/compute-window for full job scheduling.

## Output

Returns current grid carbon intensity in gCO2/kWh for the requested country or region, a 48-hour forward curve of intensity values, and identified cleanest and dirtiest time slots — sourced deterministically from NESO (GB national grid + 14 DNO regions) or Fraunhofer ISE energy-charts (DE, FR, NL, BE, AT, ES, IT, NO). No LLM inference involved.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "hours": {
   "type": "string",
   "description": "Forward window in hours, 1-48. Default 24."
  },
  "region": {
   "type": "string",
   "description": "UK (default) | a GB DNO region (london, north-scotland, …) | DE FR NL BE AT ES IT NO"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "now": {
   "start": "2026-07-14T15:30:00.000Z",
   "gco2_per_kwh": 96
  },
  "region": "UK",
  "next_hours": {
   "cleanest": {
    "start": "2026-07-15T02:30:00.000Z",
    "gco2_per_kwh": 41
   },
   "avg_gco2_per_kwh": 103
  },
  "deterministic": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gridpulse-carbon-intensity-api-e55de826/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gridpulse.theaslangroupllc.com](https://www.zero.xyz/host/gridpulse.theaslangroupllc.com/llms.txt)
