# BRAINIAC Solar Battery Storage Self-Consumption Calculator

> BRAINIAC Solar Battery Storage Self-Consumption Calculator 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).

Calculates solar self-consumption and self-sufficiency percentages for a site using supplied generation, load, battery, and grid data — no cloud platform or API key required.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/solar-battery/storage-self-consumption?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-storage-self-consumption-calculator-bad02cbc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9w7LR7J9DhVyt0KyaHJY2

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-storage-self-consumption-calculator-bad02cbc -d '<json body>'
```

Example prompt: I have CSV energy data for site SITE-A showing 390 kWh of solar generation, 270 kWh of load, 105 kWh exported to the grid, and 15 kWh imported — can you calculate the self-consumption and self-sufficiency percentages for this site?

## When to prefer this

Choose this endpoint when you need to compute solar self-consumption and self-sufficiency metrics purely from caller-supplied energy data, with no dependency on external inverter cloud platforms, monitoring service API keys, or paid data providers. It is ideal for privacy-conscious deployments, offline data scenarios, or when you already have raw generation/load/grid CSV or JSON data and need standardized KPI calculations. Prefer alternatives if you need real-time inverter cloud data retrieval (e.g. SolarEdge, Fronius APIs) or degradation analysis requiring manufacturer cloud access.

## Known failure modes

- Missing or malformed generation/load data returns limited or incomplete metric calculations
- Exceeding maxItems (200 assets, 500 panels) causes input rejection
- Supplying data in an unsupported mediaType for file uploads results in a schema validation error
- If neither generation nor load data is provided, self-consumption cannot be computed and status will reflect insufficient data
- Timestamps in unrecognized formats may cause incorrect interval grouping or be ignored

## 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 JSON object with per-asset results including: self-consumed kWh, self-consumption percentage, self-sufficiency percentage, grid export kWh, grid import kWh, generation kWh, load kWh, observation count, and boolean flags indicating which values were actually supplied vs assumed. Also includes a status field, findings list, limitations array (disclosing what was not used, e.g. no cloud platform, no paid provider), asset count, and metadata flags like apiKeyRequired and paidProviderUsed (always false).

## 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": [
   {
    "assetId": "SITE-A",
    "loadKwh": 270,
    "generationKwh": 390,
    "gridExportKwh": 105,
    "gridImportKwh": 15,
    "loadKwhSupplied": true,
    "selfConsumedKwh": 270,
    "observationCount": 2,
    "cloudPlatformUsed": false,
    "selfConsumptionPct": 69.2308,
    "selfSufficiencyPct": 100,
    "generationKwhSupplied": true,
    "gridExportKwhSupplied": true,
    "gridImportKwhSupplied": true,
    "selfConsumedKwhSupplied": true,
    "selfConsumptionPctSupplied": true,
    "selfSufficiencyPctSupplied": true
   }
  ],
  "status": "calculated",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "assetCount": 1,
  "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,
  "paidProviderUsed": false,
  "cloudPlatformUsed": false,
  "warrantyCoverageDetermined": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-solar-battery-storage-self-consumption-calculator-bad02cbc/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)
