# BRAINIAC Solar Battery Cycle Aging Analyzer

> BRAINIAC Solar Battery Cycle Aging Analyzer 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 battery cycle aging data for solar storage assets, computing cycle life consumption, depth-of-discharge, and throughput metrics from supplied telemetry.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/solar-battery/cycle-aging-analyze?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-cycle-aging-analyzer-5dba798d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mW8xwCLmP_C8DGMK-D0zh

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-cycle-aging-analyzer-5dba798d -d '<json body>'
```

Example prompt: Analyze the cycle aging for my solar battery asset SITE-A — it has 6000 rated cycles, the latest cycle count is 520, cycle delta is 120, average depth of discharge is 77.5%, and total throughput is 15,500 kWh. How much of its cycle life has it used?

## When to prefer this

Use this endpoint when you need to compute battery cycle aging metrics — cycle life consumption percentage, depth of discharge, and throughput — from caller-supplied telemetry without requiring cloud platform credentials or third-party energy monitoring subscriptions. Ideal for agents managing solar-plus-storage assets that already have cycle count and DoD data and need a pay-per-call, no-account computation layer. Not suited for real-time inverter cloud data retrieval or warranty coverage legal determinations.

## Known failure modes

- Missing required cycle or asset data results in incomplete or zero metrics rather than an error
- Supplying mismatched asset IDs between assets and generation arrays may cause records to be skipped
- Exceeding the 200-asset or 500-panel array limits returns a validation error
- Invalid date strings in installedAt or measuredAt fields may cause records to be ignored
- Malformed base64 file content causes file parse 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

Returns a JSON object with per-asset cycle aging metrics including cycle life used percentage, latest cycle count, cycle delta, average depth-of-discharge percentage, throughput kWh, observation count, and a findings list. Also includes status, checkedAt timestamp, asset count, and a limitations array clarifying what data sources were and were not used (no cloud platform, no paid API, no warranty coverage determination).

## 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",
    "cycleDelta": 120,
    "ratedCycles": 6000,
    "averageDodPct": 77.5,
    "throughputKwh": 15500,
    "cycleLifeUsedPct": 8.6667,
    "latestCycleCount": 520,
    "observationCount": 2,
    "cloudPlatformUsed": false,
    "cycleDeltaSupplied": true,
    "ratedCyclesSupplied": true,
    "averageDodPctSupplied": true,
    "throughputKwhSupplied": true,
    "cycleLifeUsedPctSupplied": true,
    "latestCycleCountSupplied": true
   }
  ],
  "status": "analyzed",
  "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-cycle-aging-analyzer-5dba798d/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)
