# BRAINIAC Renewable Generation Forecast

> BRAINIAC Renewable Generation Forecast 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-12).

Accepts caller-supplied renewable energy generation data (historical and forecast) and returns structured, validated generation records with metadata about data sources, forecast status, and analytical findings.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/electricity-market/renewable-generation-forecast?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-renewable-generation-forecast-6ea7056c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QNYF2_-GNGM5ejfDa5cPs

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-renewable-generation-forecast-6ea7056c -d '<json body>'
```

Example prompt: Take this CSV of wind and solar generation readings for the GB region through November 2026 — including both historical actuals and an operator forecast row for November 5 — and give me back structured generation records showing MW by fuel type, which rows are forecasts, and where the data came from.

## When to prefer this

Use this endpoint when you have caller-supplied renewable energy generation data (historical, forecast, or mixed) that needs to be structured, validated, and annotated with source attribution and forecast metadata. It is particularly well-suited for ESG reporting, grid compliance audits, and dashboard ingestion pipelines where you need transparent data provenance and explicit flags on invented vs. real forecast values. It does not use paid energy data providers, making it appropriate when you want deterministic, auditable output based solely on supplied or free public data.

## Known failure modes

- Caller supplies no generation data — endpoint returns empty items array with limitations noting missing data
- Feed URL is unreachable or returns non-energy data — feed ignored, limitations noted
- Malformed CSV or JSON input — parsing error returned in findings
- MW values exceed schema maximums (1,000,000,000) — validation rejection
- Missing required file fields (mediaType or fileBase64) when using file input — schema validation error
- asOf timestamp in unrecognized format — may be ignored or cause parsing failure

## 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 object containing an array of generation items (each with timestamp, ID, MW, fuel type, region, source, and forecast/historical flags), overall status, findings list, checkedAt timestamp, limitations array, forecast and historical counts, historical average MW, and boolean flags for whether a paid provider or API key was used and whether any forecast values were invented.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "feed": {
   "type": "object",
   "properties": {
    "url": {
     "type": "string",
     "format": "uri",
     "maxLength": 500
    }
   },
   "additionalProperties": false
  },
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "bills": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "kwh": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "peakKw": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "currency": {
      "type": "string",
      "maxLength": 12
     },
     "tariffId": {
      "type": "string",
      "maxLength": 80
     },
     "periodEnd": {
      "type": "string",
      "maxLength": 40
     },
     "billedFixed": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "billedTotal": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "periodStart": {
      "type": "string",
      "maxLength": 40
     },
     "billedDemand": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "billedEnergy": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "carbon": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "at": {
      "type": "string",
      "maxLength": 40
     },
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "unit": {
      "type": "string",
      "maxLength": 40
     },
     "index": {
      "type": "string",
      "maxLength": 40
     },
     "re
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "at": "2026-11-01T12:00:00.000Z",
    "id": "G1",
    "mw": 8200,
    "fuel": "wind",
    "region": "GB",
    "source": "Caller-supplied",
    "isForecast": false,
    "mwSupplied": true,
    "apiKeyRequired": false,
    "forecastInvented": false,
    "paidProviderUsed": false
   },
   {
    "at": "2026-11-01T12:00:00.000Z",
    "id": "G3",
    "mw": 2100,
    "fuel": "solar",
    "region": "GB",
    "source": "Caller-supplied",
    "isForecast": false,
    "mwSupplied": true,
    "apiKeyRequired": false,
    "forecastInvented": false,
    "paidProviderUsed": false
   },
   {
    "at": "2026-11-05T12:00:00.000Z",
    "id": "G2",
    "mw": 9100,
    "fuel": "wind",
    "region": "GB",
    "source": "Caller-supplied operator forecast",
    "isForecast": true,
    "mwSupplied": true,
    "apiKeyRequired": false,
    "forecastInvented": false,
    "paidProviderUsed": false
   }
  ],
  "status": "reported",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "limitations": [
   "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
   "No paid energy data provider is used and no API key is required.",
   "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
   "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
   "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ],
  "forecastCount": 1,
  "publicSources": [],
  "apiKeyRequired": false,
  "historicalCount": 2,
  "forecastInvented": false,
  "paidProviderUsed": false,
  "historicalAverageMw": 5150,
  "billingAccuracyClaimed": false,
  "historicalAverageMwSupplied": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-renewable-generation-forecast-6ea7056c/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)
