{"uid":"cap_youCbiO8l4JufyG-m9l0b","slug":"brainiac-solar-battery-state-of-health-estimate-5aa8f532","name":"BRAINIAC Solar Battery State-of-Health Estimate","description":"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.","url":"https://www.brainiac.software/api/v1/solar-battery/state-of-health-estimate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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":500},"faultMap":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":160},"category":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":500},"generation":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"kwh":{"type":"number","maximum":1000000000,"minimum":0},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"irradiance":{"type":"number","maximum":1000000,"minimum":0},"expectedKwh":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":2000},"warranties":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"maxCycles":{"type":"number","maximum":1000000000,"minimum":0},"minSohPct":{"type":"number","maximum":100,"minimum":0},"installedAt":{"type":"string","maxLength":40},"maxCalendarYears":{"type":"number","maximum":100,"minimum":0}},"additionalProperties":false},"maxItems":200},"consumption":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"loadKwh":{"type":"number","maximum":1000000000,"minimum":0},"generationKwh":{"type":"number","maximum":1000000000,"minimum":0},"gridExportKwh":{"type":"number","maximum":1000000000,"minimum":0},"gridImportKwh":{"type":"number","maximum":1000000000,"minimum":0},"batteryChargeKwh":{"type":"number","maximum":1000000000,"minimum":0},"batteryDischargeKwh":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":2000},"batteryCycles":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"cycleCount":{"type":"number","maximum":1000000000,"minimum":0},"throughputKwh":{"type":"number","maximum":1000000000,"minimum":0},"depthOfDischargePct":{"type":"number","maximum":100,"minimum":0}},"additionalProperties":false},"maxItems":1000},"batteryHealth":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"sohPct":{"type":"number","maximum":100,"minimum":0},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"cycleCount":{"type":"number","maximum":1000000000,"minimum":0},"measuredAt":{"type":"string","maxLength":40},"measuredKwh":{"type":"number","maximum":1000000000,"minimum":0},"ratedCycles":{"type":"number","maximum":1000000000,"minimum":0},"nameplateKwh":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":200},"inverterEvents":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"label":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"message":{"type":"string","maxLength":500},"severity":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":1000},"efficiencyPeriods":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"assetId":{"type":"string","maxLength":80},"chargeKwh":{"type":"number","maximum":1000000000,"minimum":0},"periodEnd":{"type":"string","maxLength":40},"periodStart":{"type":"string","maxLength":40},"dischargeKwh":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":500}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Iva5nOCnHrCsfcw6_vThD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Home solar battery health check","prompt":"My home Powerwall-style battery has a 13.5 kWh nameplate, I'm now only getting 11.2 kWh measured, and it's gone through about 800 cycles out of a rated 3000 — can you estimate its state of health and tell me what percentage of cycle life is used up?"},{"title":"Fleet SOH audit for commercial solar site","prompt":"I have 5 commercial solar batteries at our warehouse site, each 100 kWh nameplate, with cycle counts ranging from 400 to 1200 and measured capacities between 85 and 95 kWh — estimate the state of health for each one and flag any that are degrading faster than expected."},{"title":"Warranty threshold check for degraded battery","prompt":"Our solar storage battery is rated for 60 kWh but we're only measuring 48 kWh after 900 cycles against a 6000-cycle rating — estimate the SOH percentage so I can check whether it's outside the warranty performance threshold."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:56.250Z","isFirstParty":false,"canonicalSlug":"brainiac-solar-battery-state-of-health-estimate-5aa8f532"}