# BRAINIAC Solar Battery State-of-Health Estimate

> BRAINIAC Solar Battery State-of-Health Estimate 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).

Estimates battery state-of-health (SOH) percentage and cycle life consumed for solar storage assets using caller-supplied BMS data, cycle counts, and capacity measurements.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/solar-battery/state-of-health-estimate?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-state-of-health-estimate-5aa8f532
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_youCbiO8l4JufyG-m9l0b

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-state-of-health-estimate-5aa8f532 -d '<json body>'
```

Example prompt: Estimate the state of health for our solar battery — it's a 60 kWh nameplate unit labeled 'Battery A', installed at site SITE-A, currently measuring 54 kWh at 520 charge cycles with a rated cycle life of 6000; give me the SOH percentage and how much cycle life has been used as of today.

## When to prefer this

Choose this endpoint when you have caller-supplied BMS data, nameplate kWh, measured kWh, and/or cycle counts for solar storage batteries and need an SOH estimate without connecting to any third-party inverter cloud platform or paying for an external energy monitoring API. It is ideal for privacy-sensitive deployments, air-gapped sites, or situations where the agent already has the raw battery telemetry and needs a computed health percentage and cycle-life assessment on demand for a fixed $0.04 USDC cost.

## Known failure modes

- Missing required battery capacity or cycle data results in incomplete or absent SOH estimates
- Truncated or malformed CSV/JSON input may cause parsing failures
- Supplying cycle counts without rated cycles prevents cycle-life percentage computation
- Exceeding maxItems (200 assets) or maxLength limits on input fields returns a validation error
- Ambiguous or mismatched asset IDs between assets and battery arrays may produce unlinked estimates

## 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 containing an array of battery items each with SOH percentage, cycle life used percentage, cycle count, measured and nameplate kWh, measurement timestamp, and flags indicating whether values were caller-supplied or computed. Also includes overall status, findings list, asset count, and a limitations section clarifying that no external cloud platforms or paid provider APIs were used — only the caller-supplied data.

## 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": [
   {
    "id": "H1",
    "name": "Battery A",
    "sohPct": 90,
    "source": "Caller-supplied BMS",
    "assetId": "SITE-A",
    "cycleCount": 520,
    "measuredAt": "2026-11-01",
    "measuredKwh": 54,
    "ratedCycles": 6000,
    "nameplateKwh": 60,
    "sohPctSupplied": true,
    "cycleLifeUsedPct": 8.6667,
    "cloudPlatformUsed": false,
    "cycleCountSupplied": true,
    "measuredKwhSupplied": true,
    "ratedCyclesSupplied": true,
    "nameplateKwhSupplied": true,
    "cycleLifeUsedPctSupplied": true
   }
  ],
  "status": "estimated",
  "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-state-of-health-estimate-5aa8f532/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)
