{"uid":"cap_vWphgqo5ViG8xekgNSpU5","slug":"brainiac-solar-battery-round-trip-efficiency-calculator-17a4efad","name":"BRAINIAC Solar Battery Round-Trip Efficiency 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/round-trip-efficiency?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":"R1","source":"Caller-supplied meter","assetId":"SITE-A","chargeKwh":1000,"periodEnd":"2026-10-31","periodStart":"2026-10-01","dischargeKwh":920,"chargeKwhSupplied":true,"cloudPlatformUsed":false,"dischargeKwhSupplied":true,"roundTripEfficiencyPct":92,"roundTripEfficiencyPctSupplied":true}],"status":"calculated","findings":[],"checkedAt":"2026-11-04T21:00:00.000Z","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."],"periodCount":1,"apiKeyRequired":false,"paidProviderUsed":false,"cloudPlatformUsed":false,"warrantyCoverageDetermined":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eeGVGkDzUJkPAof9c7Fk2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the round-trip efficiency percentage of solar battery storage systems from caller-supplied charge and discharge meter data, without requiring cloud platform access or API keys.","exampleAgentPrompt":"Can you calculate the round-trip efficiency of our battery storage system for October 2026? We charged 1,000 kWh and discharged 920 kWh at site SITE-A — give me the efficiency percentage and any findings.","exampleUseCases":[{"title":"Monthly battery performance reporting","prompt":"For our solar site in Texas, we charged the battery with 5,000 kWh and got 4,650 kWh back out during September 2026 — can you calculate the round-trip efficiency and flag any concerns?"},{"title":"Warranty threshold compliance check","prompt":"I need to verify if our battery's round-trip efficiency is meeting the warranty benchmark — we recorded 2,400 kWh charged and 2,100 kWh discharged last quarter. Can you compute the RTE and tell me what the efficiency percentage is?"},{"title":"Fleet-level storage efficiency audit","prompt":"I have meter data for 10 battery assets across our solar farm for November 2026, with charge and discharge readings for each — can you calculate the round-trip efficiency for all of them and highlight which ones are underperforming?"}],"resultDescription":"Returns a JSON object with an items array where each entry includes the asset ID, period start/end, charge kWh, discharge kWh, calculated round-trip efficiency percentage, a status field (e.g. 'calculated'), findings list, checkedAt timestamp, period count, and boolean flags indicating whether cloud platforms or paid providers were used and whether supplied values were caller-provided or computed.","failureModes":["Missing required charge or discharge kWh values — efficiency cannot be computed without both sides of the cycle","Period timestamps absent or malformed — period cannot be bounded","Asset or reading count exceeds schema maximums (200 assets, 500 panels) — request rejected","Input CSV or JSON exceeds 200,000 character limit — truncation or rejection","Ambiguous or mismatched asset IDs between panels, generation, and assets arrays — results may be incomplete","No data supplied at all — returns empty items with limitation notices"],"whenToPreferThis":"Use this endpoint when you have caller-supplied charge and discharge meter readings for a solar battery system and need to compute round-trip efficiency without connecting to any inverter cloud platform, manufacturer API, or paid energy monitoring service. It is ideal for offline analysis, compliance reporting, or audits where data privacy matters and no third-party credentials are available. Prefer this over cloud-connected alternatives when you want a reproducible, transparent calculation that declares exactly what was supplied versus computed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:35:24.140Z","isFirstParty":false,"canonicalSlug":"brainiac-solar-battery-round-trip-efficiency-calculator-17a4efad"}