{"uid":"cap_1gFIKkIzPNTj_lnz125nU","slug":"brainiac-solar-battery-generation-deviation-detector-ec648b34","name":"BRAINIAC Solar Battery Generation Deviation Detector","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/generation-deviation-detect?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":[{"at":"2026-11-01","id":"G1","kwh":180,"source":"Caller-supplied meter","assetId":"SITE-A","irradiance":4.2,"expectedKwh":200,"kwhSupplied":true,"deviationKwh":-20,"deviationPct":-10,"cloudPlatformUsed":false,"irradianceSupplied":true,"expectedKwhSupplied":true,"deviationKwhSupplied":true,"deviationPctSupplied":true},{"at":"2026-11-02","id":"G2","kwh":210,"source":"Caller-supplied meter","assetId":"SITE-A","irradiance":0,"expectedKwh":205,"kwhSupplied":true,"deviationKwh":5,"deviationPct":2.439,"cloudPlatformUsed":false,"irradianceSupplied":false,"expectedKwhSupplied":true,"deviationKwhSupplied":true,"deviationPctSupplied":true}],"status":"detected","findings":[],"checkedAt":"2026-11-04T21:00:00.000Z","pointCount":2,"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,"deviationCount":0,"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_NNpeV5S0mIueVTSxt7b5X","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 solar panel and battery generation data to detect deviations between actual and expected energy output, flagging underperformance or anomalies.","exampleAgentPrompt":"Check my solar site SITE-A for generation deviations — I have daily kWh readings for November 2026 alongside expected output and irradiance values; flag any days where actual generation deviated significantly from expected.","exampleUseCases":[{"title":"Daily solar underperformance detection","prompt":"I have daily generation readings for my solar farm in November 2026 — actual kWh produced, expected kWh based on irradiance, and the irradiance values themselves. Can you check for any days where actual output deviated more than expected and tell me the deviation in kWh and percentage?"},{"title":"Fleet-wide panel anomaly check","prompt":"I manage 50 solar panels across 5 sites and I want to know which panels showed generation deviations last month. I'll supply the measured kW for each panel, their nameplate kW, and timestamps — please flag any anomalies."},{"title":"Solar battery system performance audit","prompt":"Can you audit my solar-plus-battery system's generation records for October? I have asset info, daily generation readings, and expected output per day. I want to know which days had significant positive or negative deviations from the expected kWh."}],"resultDescription":"Returns a list of deviation items per generation record, each with actual kWh, expected kWh, deviation in kWh and percentage, irradiance, asset ID, and flags indicating which values were caller-supplied vs computed. Also includes overall status ('detected'), total deviation count, findings list, limitations, and flags for whether paid cloud platforms or API keys were used.","failureModes":["Missing required generation data: returns empty items or error if no generation records supplied","Irradiance not provided: irradianceSupplied=false, irradiance-based expectations may be absent","Expected kWh not provided: expectedKwhSupplied=false, deviation may not be computed","Malformed CSV/JSON: parsing failure, likely 400 error","Exceeds maxItems limits (500 panels, 200 assets): truncation or rejection","Payment not received: 402 response, no processing"],"whenToPreferThis":"Use this endpoint when you need to computationally detect and quantify deviations between actual and expected solar generation output from caller-supplied data, without needing to integrate with inverter cloud platforms or external energy monitoring services. Ideal for agents that already have metered generation data and want deviation analysis without ongoing subscriptions or API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:34:50.275Z","isFirstParty":false,"canonicalSlug":"brainiac-solar-battery-generation-deviation-detector-ec648b34"}