# GB National Electricity Demand Outturn (BMRS via Elexon)

> GB National Electricity Demand Outturn (BMRS via Elexon) is a paid API for AI agents from x402-datashop-production.up.railway.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns near-real-time 5-minute MW electricity demand outturn readings for Great Britain from the Elexon BMRS API, with configurable lookback window.

## Facts

- Endpoint: GET https://x402-datashop-production.up.railway.app/v1/gb/power-demand
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gb-national-electricity-demand-outturn-bmrs-via-elexon-a1d8286a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Nobo8lLUZ0D2Avrx1YxN1

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 gb-national-electricity-demand-outturn-bmrs-via-elexon-a1d8286a
```

Example prompt: Can you pull the last hour of Great Britain national electricity demand readings from BMRS — that's the most recent 12 five-minute MW outturn points — and tell me the latest value?

## When to prefer this

Use this endpoint when you need near-real-time or recent-historical Great Britain electricity demand data at 5-minute resolution sourced directly from the authoritative Elexon BMRS system. Prefer this over general energy APIs when you specifically need GB national grid outturn MW figures, configurable lookback (up to 500 points / ~41 hours), and a convenient 'latest' summary field in a single call.

## Known failure modes

- Upstream BMRS API unavailable — returns 5xx or stale cached data
- Invalid 'last' parameter (out of 1-500 range) — returns 400 or validation error
- Cache may be up to 5 minutes stale if upstream has not updated
- Payment not included or invalid — returns 402 Payment Required

## How this service works

Near-real-time Great Britain national electricity demand outturn from the Elexon Insights (BMRS) open API: 5-minute MW readings sorted oldest to newest (default: last 24h = 288 points), plus a 'latest' field with the most recent value. ?last=N (1-500) sets how many recent points to return, e.g. ?last=12 = last hour. Upstream updates every ~5 min; served with a 5-min cache.

## Output

A JSON object containing an array of up to 500 timestamped 5-minute MW demand outturn readings sorted oldest to newest, plus a 'latest' field with the most recent single reading. Default returns 288 points (last 24 hours); use ?last=N to limit to N points.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "last": {
       "type": "string",
       "description": "Return only the N most recent 5-min readings (1-500, optional)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gb-national-electricity-demand-outturn-bmrs-via-elexon-a1d8286a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-datashop-production.up.railway.app](https://www.zero.xyz/host/x402-datashop-production.up.railway.app/llms.txt)