# BRAINIAC Energy Intelligence Historical API

> BRAINIAC Energy Intelligence Historical API is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-17).

Returns historical electricity grid energy data for a specified US region and date-time range

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/energy-intelligence/historical?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-energy-intelligence-historical-api-df747b3b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R0V6Lbg_CkUs2MWkdGun9

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 brainiac-energy-intelligence-historical-api-df747b3b -d '<json body>'
```

Example prompt: Pull the historical energy grid data for US region 5 from January 1, 2024 at 00:00:00Z through January 7, 2024 at 23:59:59Z so I can analyze last week's electricity trends.

## When to prefer this

Choose this endpoint when you need historical electricity grid data for specific US energy regions by time range, especially in an agentic context where pay-per-call with no account setup is preferred. It is well-suited for one-off queries or automated agent workflows that need grid energy history without committing to a subscription.

## Known failure modes

- Invalid regionId outside range 1-18 returns validation error
- Malformed or non-UTC datetime strings rejected by pattern validator
- 'from' datetime after 'to' datetime may return empty result or error
- Future date ranges may return no data or an error since only historical data is available
- Payment failure via x402 returns 402 Payment Required before data is delivered

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

JSON object containing historical energy grid metrics for the specified region and time window, likely including generation, load, or energy mix data points indexed by timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "format": "date-time",
   "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
  },
  "from": {
   "type": "string",
   "format": "date-time",
   "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
  },
  "regionId": {
   "type": "integer",
   "maximum": 18,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-11-01T23:30:00Z",
  "from": "2026-11-01T00:00:00Z",
  "region": null,
  "source": {
   "url": "https://api.carbonintensity.org.uk/intensity/2026-11-01T00:00:00Z/2026-11-01T23:30:00Z",
   "status": "OK",
   "retrievedAt": "2026-11-07T12:08:56.128Z"
  },
  "intensities": [
   {
    "to": "2026-11-01T00:00Z",
    "from": "2026-10-31T23:30Z",
    "index": "high",
    "actual": 190,
    "forecast": 197,
    "regionId": null
   },
   {
    "to": "2026-11-01T00:30Z",
    "from": "2026-11-01T00:00Z",
    "index": "high",
    "actual": 190,
    "forecast": 197,
    "regionId": null
   },
   {
    "to": "2026-11-01T01:00Z",
    "from": "2026-11-01T00:30Z",
    "index": "high",
    "actual": 183,
    "forecast": 199,
    "regionId": null
   },
   {
    "to": "2026-11-01T01:30Z",
    "from": "2026-11-01T01:00Z",
    "index": "high",
    "actual": 184,
    "forecast": 195,
    "regionId": null
   },
   {
    "to": "2026-11-01T02:00Z",
    "from": "2026-11-01T01:30Z",
    "index": "high",
    "actual": 176,
    "forecast": 187,
    "regionId": null
   },
   {
    "to": "2026-11-01T02:30Z",
    "from": "2026-11-01T02:00Z",
    "index": "high",
    "actual": 174,
    "forecast": 187,
    "regionId": null
   },
   {
    "to": "2026-11-01T03:00Z",
    "from": "2026-11-01T02:30Z",
    "index": "high",
    "actual": 173,
    "forecast": 180,
    "regionId": null
   },
   {
    "to": "2026-11-01T03:30Z",
    "from": "2026-11-01T03:00Z",
    "index": "high",
    "actual": 172,
    "forecast": 178,
    "regionId": null
   },
   {
    "to": "2026-11-01T04:00Z",
    "from": "2026-11-01T03:30Z",
    "index": "high",
    "actual": 173,
    "forecast": 177,
    "regionId": null
   },
   {
    "to": "2026-11-01T04:30Z",
    "from": "2026-11-01T04:00Z",
    "index": "high",
    "actual": 173,
    "forecast": 176,
    "regionId": null
   },
   {
    "to": "2026-11-01T05:00Z",
    "from": "2026-11-01T04:30Z",
    "index": "moderate",
    "actual": 167,
    "forecast": 176,
    "regionId": null
   },
   {
    "to": "2026-11-01T05:30Z",
    "from": "2026-11-01T05:00Z",
    "index": "moderate",
    "actual": 168,
    "forecast": 172,
    "regionId": null
   },
   {
    "to": "2026-11-01T06:00Z",
    "from": "2026-11-01T05:30Z",
    "index": "high",
    "actual": 177,
    "forecast": 172,
    "regionId": null
   },
   {
    "to": "2026-11-01T06:30Z",
    "from": "2026-11-01T06:00Z",
    "index": "high",
    "actual": 181,
    "forecast": 170,
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-energy-intelligence-historical-api-df747b3b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
