# Solar, Battery & Distributed Energy Intelligence API

> Detect solar generation deviations, estimate panel degradation and battery SOH, classify inverter faults from supplied logs, check warranty thresholds, calculate round-trip efficiency and self-consumption, and compare distributed energy assets—using caller-supplied telemetry only.

- Product: https://www.brainiac.software/api/solar-battery
- Docs: https://www.brainiac.software/api/solar-battery/docs
- OpenAPI: https://www.brainiac.software/api/solar-battery/openapi.json
- Contact: support@brainiac.software (https://www.brainiac.software/contact)

## Operations

- POST /api/v1/solar-battery/generation-deviation-detect — $0.04 USDC — Detect solar generation deviations: Compare supplied solar generation kWh to expected kWh and flag deviations. Missing expected values are not invented. Docs: https://www.brainiac.software/api/solar-battery/docs#solar-battery-generation-deviation-detect
- POST /api/v1/solar-battery/panel-degradation-estimate — $0.04 USDC — Estimate solar panel degradation: Estimate panel degradation from supplied nameplate/prior and measured capacity over time. Missing baselines are not invented. Docs: https://www.brainiac.software/api/solar-battery/docs#solar-battery-panel-degradation-estimate
- POST /api/v1/solar-battery/inverter-fault-classify — $0.04 USDC — Classify solar inverter faults: Classify supplied inverter log events using a caller fault map or keyword signals in supplied messages. Cloud catalogs are not queried. Docs: https://www.brainiac.software/api/solar-battery/docs#solar-battery-inverter-fault-classify
- POST /api/v1/solar-battery/cycle-aging-analyze — $0.04 USDC — Analyze battery cycle aging: Analyze supplied battery cycle counts, depth of discharge, and throughput. Rated cycle life is used only when supplied. Docs: https://www.brainiac.software/api/solar-battery/docs#solar-battery-cycle-aging-analyze
- POST /api/v1/solar-battery/state-of-health-estimate — $0.04 USDC — Estimate battery state of health: Estimate battery SOH from supplied sohPct or measured versus nameplate energy. Missing capacities are not invented. Docs: https://www.brainiac.software/api/solar-battery/docs#solar-battery-state-of-health-estimate
- POST /api/v1/solar-battery/warranty-threshold-check — $0.03 USDC — Check battery warranty thresholds: Compare supplied SOH, cycles, and calendar age to caller-supplied warranty thresholds. Legal warranty coverage is not determined. Docs: https://www.brainiac.software/api/solar-battery/docs#solar-battery-warranty-threshold-check
- POST /api/v1/solar-battery/round-trip-efficiency — $0.03 USDC — Calculate battery round-trip efficiency: Calculate round-trip efficiency from supplied charge and discharge energy for each period. Docs: https://www.brainiac.software/api/solar-battery/docs#solar-battery-round-trip-efficiency
- POST /api/v1/solar-battery/storage-self-consumption — $0.04 USDC — Calculate solar storage self-consumption: Calculate self-consumption and self-sufficiency from supplied generation, load, and optional import/export energy. Docs: https://www.brainiac.software/api/solar-battery/docs#solar-battery-storage-self-consumption
- POST /api/v1/solar-battery/asset-compare — $0.05 USDC — Compare distributed energy assets: Compare supplied solar/storage assets on generation deviation, SOH, efficiency, and self-consumption metrics derived only from caller records. Docs: https://www.brainiac.software/api/solar-battery/docs#solar-battery-asset-compare
- POST /api/v1/solar-battery/performance-report — $0.08 USDC — Build solar battery performance report: Aggregate generation deviation, degradation, inverter faults, cycle aging, SOH, warranty, efficiency, self-consumption, and asset comparison from caller-supplied records only. Docs: https://www.brainiac.software/api/solar-battery/docs#solar-battery-performance-report