# BRAINIAC Solar Battery Generation Deviation Detector

> BRAINIAC Solar Battery Generation Deviation Detector is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Analyzes solar panel and battery generation data to detect deviations between actual and expected energy output, flagging underperformance or anomalies.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/solar-battery/generation-deviation-detect?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-solar-battery-generation-deviation-detector-ec648b34
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1gFIKkIzPNTj_lnz125nU

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-solar-battery-generation-deviation-detector-ec648b34 -d '<json body>'
```

Example prompt: Check my solar site SITE-A for generation deviations — I have daily kWh readings for November 2026 alongside expected output and irradiance values; flag any days where actual generation deviated significantly from expected.

## When to prefer this

Use this endpoint when you need to computationally detect and quantify deviations between actual and expected solar generation output from caller-supplied data, without needing to integrate with inverter cloud platforms or external energy monitoring services. Ideal for agents that already have metered generation data and want deviation analysis without ongoing subscriptions or API key management.

## Known failure modes

- Missing required generation data: returns empty items or error if no generation records supplied
- Irradiance not provided: irradianceSupplied=false, irradiance-based expectations may be absent
- Expected kWh not provided: expectedKwhSupplied=false, deviation may not be computed
- Malformed CSV/JSON: parsing failure, likely 400 error
- Exceeds maxItems limits (500 panels, 200 assets): truncation or rejection
- Payment not received: 402 response, no processing

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

Returns a list of deviation items per generation record, each with actual kWh, expected kWh, deviation in kWh and percentage, irradiance, asset ID, and flags indicating which values were caller-supplied vs computed. Also includes overall status ('detected'), total deviation count, findings list, limitations, and flags for whether paid cloud platforms or API keys were used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "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
  },
  "assets": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "kind": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 160
     },
     "region": {
      "type": "string",
      "maxLength": 120
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "capacityKw": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     },
     "capacityKwh": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "installedAt": {
      "type": "string",
      "maxLength": 40
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "panels": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 160
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "assetId": {
      "type": "string",
      "maxLength": 80
     },
     "measuredAt": {
      "type": "string",
      "maxLength": 40
     },
     "measuredKw": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     },
     "installedAt": {
      "type": "string",
      "maxLength": 40
     },
     "nameplateKw": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     },
     "priorMeasuredAt": {
      "type": "string",
      "maxLength": 40
     },
     "priorMeasuredKw": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems":
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "at": "2026-11-01",
    "id": "G1",
    "kwh": 180,
    "source": "Caller-supplied meter",
    "assetId": "SITE-A",
    "irradiance": 4.2,
    "expectedKwh": 200,
    "kwhSupplied": true,
    "deviationKwh": -20,
    "deviationPct": -10,
    "cloudPlatformUsed": false,
    "irradianceSupplied": true,
    "expectedKwhSupplied": true,
    "deviationKwhSupplied": true,
    "deviationPctSupplied": true
   },
   {
    "at": "2026-11-02",
    "id": "G2",
    "kwh": 210,
    "source": "Caller-supplied meter",
    "assetId": "SITE-A",
    "irradiance": 0,
    "expectedKwh": 205,
    "kwhSupplied": true,
    "deviationKwh": 5,
    "deviationPct": 2.439,
    "cloudPlatformUsed": false,
    "irradianceSupplied": false,
    "expectedKwhSupplied": true,
    "deviationKwhSupplied": true,
    "deviationPctSupplied": true
   }
  ],
  "status": "detected",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "pointCount": 2,
  "limitations": [
   "Generation, panel, inverter, battery, warranty, efficiency, consumption, and asset records are copied only from labeled fields supplied by the caller.",
   "No inverter cloud platform or paid energy monitoring service is used and no API key is required.",
   "Degradation, SOH, efficiency, and deviation metrics use only supplied measurements. Missing values are not invented.",
   "Inverter fault labels come from caller-supplied fault maps or simple keyword signals in supplied messages. Manufacturer cloud catalogs are not queried.",
   "Warranty comparisons use only caller-supplied warranty thresholds and measured values. Legal warranty coverage is not determined."
  ],
  "apiKeyRequired": false,
  "deviationCount": 0,
  "paidProviderUsed": false,
  "cloudPlatformUsed": false,
  "warrantyCoverageDetermined": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-solar-battery-generation-deviation-detector-ec648b34/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)
