# BRAINIAC Energy Intelligence Forecast API

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

Returns an energy production or demand forecast for a specified grid region and time window

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/energy-intelligence/forecast?utm_source=zero.xyz
- Price: $0.03/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-forecast-api-368792ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lDw5H4VzBMSnrSw6-UtN9

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-forecast-api-368792ee -d '<json body>'
```

Example prompt: Can you get me the energy forecast for grid region 7 from tomorrow at midnight UTC through the end of the day on Friday?

## When to prefer this

Choose this endpoint when you need pay-per-call energy forecasting with no account setup, billed in USDC via x402 on Base. Ideal for AI agents that need on-demand grid intelligence for one of 18 supported regions without committing to a subscription. Prefer this over utility-specific APIs when you need a lightweight, agent-native integration with crypto micropayment support.

## Known failure modes

- Invalid regionId (outside 1–18 range) returns a validation error
- Malformed or non-UTC datetime strings rejected by schema pattern
- 'from' datetime after 'to' datetime may cause a logical error or empty result
- Payment failure via x402 returns HTTP 402 and no data
- Forecasts may not be available for far-future time windows
- Empty example response schema means actual output format is undocumented

## 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

A JSON response containing energy forecast data for the specified region and time window, likely including time-series values for predicted energy production, demand, or related grid metrics across the requested date range.

## 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-02T23:30:00Z",
  "from": "2026-11-02T00:00:00Z",
  "region": null,
  "source": {
   "url": "https://api.carbonintensity.org.uk/intensity/2026-11-02T00:00:00Z/2026-11-02T23:30:00Z",
   "status": "OK",
   "retrievedAt": "2026-11-07T12:08:56.555Z"
  },
  "forecast": [],
  "limitations": [
   "Forecast data is retrieved from the official Carbon Intensity API at api.carbonintensity.org.uk.",
   "Data is provided by National Grid ESO.",
   "Forecasts are typically available up to 48 hours ahead.",
   "Forecast accuracy decreases with time horizon.",
   "Values are in gCO2/kWh."
  ],
  "retrievedAt": "2026-11-07T12:08:56.555Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-energy-intelligence-forecast-api-368792ee/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)
