# BRAINIAC Solar Battery Round-Trip Efficiency Calculator

> BRAINIAC Solar Battery Round-Trip Efficiency Calculator is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-12).

Calculates the round-trip efficiency percentage of solar battery storage systems from caller-supplied charge and discharge meter data, without requiring cloud platform access or API keys.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/solar-battery/round-trip-efficiency?utm_source=zero.xyz
- Price: $0.03/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-round-trip-efficiency-calculator-17a4efad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vWphgqo5ViG8xekgNSpU5

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-round-trip-efficiency-calculator-17a4efad -d '<json body>'
```

Example prompt: Can you calculate the round-trip efficiency of our battery storage system for October 2026? We charged 1,000 kWh and discharged 920 kWh at site SITE-A — give me the efficiency percentage and any findings.

## When to prefer this

Use this endpoint when you have caller-supplied charge and discharge meter readings for a solar battery system and need to compute round-trip efficiency without connecting to any inverter cloud platform, manufacturer API, or paid energy monitoring service. It is ideal for offline analysis, compliance reporting, or audits where data privacy matters and no third-party credentials are available. Prefer this over cloud-connected alternatives when you want a reproducible, transparent calculation that declares exactly what was supplied versus computed.

## Known failure modes

- Missing required charge or discharge kWh values — efficiency cannot be computed without both sides of the cycle
- Period timestamps absent or malformed — period cannot be bounded
- Asset or reading count exceeds schema maximums (200 assets, 500 panels) — request rejected
- Input CSV or JSON exceeds 200,000 character limit — truncation or rejection
- Ambiguous or mismatched asset IDs between panels, generation, and assets arrays — results may be incomplete
- No data supplied at all — returns empty items with limitation notices

## 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 an items array where each entry includes the asset ID, period start/end, charge kWh, discharge kWh, calculated round-trip efficiency percentage, a status field (e.g. 'calculated'), findings list, checkedAt timestamp, period count, and boolean flags indicating whether cloud platforms or paid providers were used and whether supplied values were caller-provided or computed.

## 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": "R1",
    "source": "Caller-supplied meter",
    "assetId": "SITE-A",
    "chargeKwh": 1000,
    "periodEnd": "2026-10-31",
    "periodStart": "2026-10-01",
    "dischargeKwh": 920,
    "chargeKwhSupplied": true,
    "cloudPlatformUsed": false,
    "dischargeKwhSupplied": true,
    "roundTripEfficiencyPct": 92,
    "roundTripEfficiencyPctSupplied": true
   }
  ],
  "status": "calculated",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "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."
  ],
  "periodCount": 1,
  "apiKeyRequired": false,
  "paidProviderUsed": false,
  "cloudPlatformUsed": false,
  "warrantyCoverageDetermined": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-solar-battery-round-trip-efficiency-calculator-17a4efad/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)
