{"uid":"cap_mW8xwCLmP_C8DGMK-D0zh","slug":"brainiac-solar-battery-cycle-aging-analyzer-5dba798d","name":"BRAINIAC Solar Battery Cycle Aging Analyzer","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/cycle-aging-analyze?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":[{"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}},"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_dbvk_A18AbRcH9Ic_56fJ","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":"Analyzes battery cycle aging data for solar storage assets, computing cycle life consumption, depth-of-discharge, and throughput metrics from supplied telemetry.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Fleet battery health dashboard","prompt":"I have 10 solar battery storage sites and I want to know the cycle life consumption percentage for each one. Here's a JSON with each asset's rated cycles, latest cycle count, cycle delta, average DoD, and throughput kWh — can you run a cycle aging analysis across all of them?"},{"title":"Warranty threshold check for aging battery","prompt":"My solar battery at the warehouse (SITE-WH1) has a 5000-cycle rating and has accumulated 480 cycles with an average depth of discharge of 85% and 12,000 kWh throughput. Run a cycle aging analysis so I can see how close we are to warranty limits."},{"title":"Post-install baseline cycle report","prompt":"We just finished commissioning a new 250 kWh battery system installed on 2024-01-15 — it's already gone through 30 cycles with an average DoD of 60% and 400 kWh throughput. Can you analyze its cycle aging and give me a baseline report as of today?"}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:59.848Z","isFirstParty":false,"canonicalSlug":"brainiac-solar-battery-cycle-aging-analyzer-5dba798d"}