{"uid":"cap_9w7LR7J9DhVyt0KyaHJY2","slug":"brainiac-solar-battery-storage-self-consumption-calculator-bad02cbc","name":"BRAINIAC Solar Battery Storage Self-Consumption Calculator","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/storage-self-consumption?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","loadKwh":270,"generationKwh":390,"gridExportKwh":105,"gridImportKwh":15,"loadKwhSupplied":true,"selfConsumedKwh":270,"observationCount":2,"cloudPlatformUsed":false,"selfConsumptionPct":69.2308,"selfSufficiencyPct":100,"generationKwhSupplied":true,"gridExportKwhSupplied":true,"gridImportKwhSupplied":true,"selfConsumedKwhSupplied":true,"selfConsumptionPctSupplied":true,"selfSufficiencyPctSupplied":true}],"status":"calculated","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_v49GTT3jce4D6b7EnJRwV","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":"Calculates solar self-consumption and self-sufficiency percentages for a site using supplied generation, load, battery, and grid data — no cloud platform or API key required.","exampleAgentPrompt":"I have CSV energy data for site SITE-A showing 390 kWh of solar generation, 270 kWh of load, 105 kWh exported to the grid, and 15 kWh imported — can you calculate the self-consumption and self-sufficiency percentages for this site?","exampleUseCases":[{"title":"Residential solar self-sufficiency audit","prompt":"I've got my home solar system's data for last month — 450 kWh generated, 320 kWh consumed, 180 kWh exported to grid, and 50 kWh imported. Can you calculate my self-consumption and self-sufficiency percentages so I know how well my panels and battery are performing?"},{"title":"Commercial site energy KPI reporting","prompt":"I need to generate self-consumption KPIs for our warehouse solar installation. Here's the JSON with generation and load readings for each 15-minute interval across 3 inverters — compute self-consumed kWh, self-consumption percentage, and self-sufficiency percentage for site WAREHOUSE-01 as of 2024-11-04."},{"title":"Solar battery storage optimization check","prompt":"I want to know if our battery storage system is actually helping our self-consumption. Here's the CSV with generation, battery charge/discharge, and grid import/export data for the last 30 days — calculate self-consumption and self-sufficiency so we can decide whether to expand battery capacity."}],"resultDescription":"Returns a JSON object with per-asset results including: self-consumed kWh, self-consumption percentage, self-sufficiency percentage, grid export kWh, grid import kWh, generation kWh, load kWh, observation count, and boolean flags indicating which values were actually supplied vs assumed. Also includes a status field, findings list, limitations array (disclosing what was not used, e.g. no cloud platform, no paid provider), asset count, and metadata flags like apiKeyRequired and paidProviderUsed (always false).","failureModes":["Missing or malformed generation/load data returns limited or incomplete metric calculations","Exceeding maxItems (200 assets, 500 panels) causes input rejection","Supplying data in an unsupported mediaType for file uploads results in a schema validation error","If neither generation nor load data is provided, self-consumption cannot be computed and status will reflect insufficient data","Timestamps in unrecognized formats may cause incorrect interval grouping or be ignored"],"whenToPreferThis":"Choose this endpoint when you need to compute solar self-consumption and self-sufficiency metrics purely from caller-supplied energy data, with no dependency on external inverter cloud platforms, monitoring service API keys, or paid data providers. It is ideal for privacy-conscious deployments, offline data scenarios, or when you already have raw generation/load/grid CSV or JSON data and need standardized KPI calculations. Prefer alternatives if you need real-time inverter cloud data retrieval (e.g. SolarEdge, Fronius APIs) or degradation analysis requiring manufacturer cloud access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:37:05.760Z","isFirstParty":false,"canonicalSlug":"brainiac-solar-battery-storage-self-consumption-calculator-bad02cbc"}