{"uid":"cap_YYGgwKdde-anBiNzazMGn","slug":"brainiac-building-energy-cost-variance-detector-96ae58c0","name":"BRAINIAC Building Energy Cost Variance 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/building-energy/cost-variance-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},"bills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"cost":{"type":"number","maximum":1000000000,"minimum":0},"unit":{"type":"string","maxLength":40},"utility":{"type":"string","maxLength":80},"quantity":{"type":"number","maximum":1000000000,"minimum":0},"periodEnd":{"type":"string","maxLength":40},"buildingId":{"type":"string","maxLength":80},"periodStart":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":200},"meters":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"unit":{"type":"string","maxLength":40},"utility":{"type":"string","maxLength":80},"buildingId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":200},"tariffs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","maximum":1000000,"minimum":0},"unit":{"type":"string","maxLength":40},"utility":{"type":"string","maxLength":80},"fixedCharge":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":100},"readings":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"value":{"type":"number","maximum":1000000000,"minimum":0},"meterId":{"type":"string","maxLength":80},"buildingId":{"type":"string","maxLength":80},"cumulative":{"type":"boolean"}},"additionalProperties":false},"maxItems":1000},"buildings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"number","maximum":1000000000,"minimum":0},"name":{"type":"string","maxLength":200},"areaUnit":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":100},"equipment":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"type":{"type":"string","maxLength":80},"setpoint":{"type":"number","maximum":200,"minimum":-100},"buildingId":{"type":"string","maxLength":80},"efficiency":{"type":"number","maximum":1000000,"minimum":0},"faultCount":{"type":"number","maximum":1000000,"minimum":0},"returnTemp":{"type":"number","maximum":200,"minimum":-100},"supplyTemp":{"type":"number","maximum":200,"minimum":-100},"installedAt":{"type":"string","maxLength":40},"capacityUnit":{"type":"string","maxLength":40},"runtimeHours":{"type":"number","maximum":1000000000,"minimum":0},"lastServiceAt":{"type":"string","maxLength":40},"ratedCapacity":{"type":"number","maximum":1000000000,"minimum":0},"nextServiceDue":{"type":"string","maxLength":40},"ratedEfficiency":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":200},"occupancy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"occupants":{"type":"number","maximum":1000000,"minimum":0},"periodEnd":{"type":"string","maxLength":40},"buildingId":{"type":"string","maxLength":80},"periodStart":{"type":"string","maxLength":40},"hoursOccupied":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":200}}},"responseSchema":{"type":"json","example":{"items":[{"unit":"kWh","billId":"BILL-1","utility":"electric","quantity":1000,"tariffId":"T-1","variance":30,"periodEnd":"2026-10-31","actualCost":150,"buildingId":"B-1","tariffRate":0.1,"periodStart":"2026-10-01","variancePct":0.25,"expectedCost":120,"tariffInvented":false,"quantitySupplied":true,"varianceSupplied":true,"savingsGuaranteed":false,"actualCostSupplied":true,"tariffRateSupplied":true,"variancePctSupplied":true,"expectedCostSupplied":true},{"unit":"kWh","billId":"BILL-2","utility":"electric","quantity":900,"tariffId":"T-1","variance":0,"periodEnd":"2026-09-30","actualCost":110,"buildingId":"B-1","tariffRate":0.1,"periodStart":"2026-09-01","variancePct":0,"expectedCost":110,"tariffInvented":false,"quantitySupplied":true,"varianceSupplied":true,"savingsGuaranteed":false,"actualCostSupplied":true,"tariffRateSupplied":true,"variancePctSupplied":true,"expectedCostSupplied":true}],"status":"detected","findings":[{"code":"cost_variance","kind":"observation","detail":"Billed cost differs from tariff-based expected cost by 25%.","subject":"BILL-1"}],"checkedAt":"2026-11-04T21:00:00.000Z","limitations":["Meter readings, bills, tariffs, equipment records, and occupancy rows are copied only from labeled fields supplied by the caller.","Consumption and cost use supplied units and tariffs only. Missing tariffs are not invented.","Unusual usage is compared against a baseline calculated from supplied readings for the same meter or utility.","Buildings are compared only when measurement periods and units are compatible.","Equipment performance and savings are never invented. HVAC and connected equipment are never controlled."],"varianceCount":1,"tariffInvented":false,"savingsGuaranteed":false,"equipmentControlled":false,"performanceInvented":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_qanA68mAwH1z4-7TuN8dR","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 building energy bills against tariff rates to detect and quantify cost variances between actual charges and expected tariff-based costs","exampleAgentPrompt":"Check whether the energy bills for building B-1 match our electric tariff rate of $0.10 per kWh — here are the bills for October and September 2026 showing 1,000 kWh at $150 and 900 kWh at $110. Flag any months where the actual cost differs significantly from what the tariff predicts.","exampleUseCases":[{"title":"Monthly utility bill audit for office campus","prompt":"I have three months of electricity bills for our downtown office building — can you check whether what we were actually charged matches our tariff rate of $0.12 per kWh and tell me which months have variances over 10%?"},{"title":"Detecting overcharges across multiple meters","prompt":"We have meter readings and bills for five different meters across our warehouse complex using our electric utility tariff at $0.09/kWh. Can you check each bill against the tariff and tell me where we might be getting overcharged?"},{"title":"Energy cost compliance report for property manager","prompt":"I need to verify that all the utility bills for building portfolio B-200 during Q3 2026 are consistent with our contracted tariff rates before I submit the compliance report — here are the bills and tariff schedules, please flag any cost discrepancies."}],"resultDescription":"Returns a list of line items for each bill analyzed, each including actual cost, expected tariff-based cost, variance amount, variance percentage, and whether those values were supplied or computed. Also returns a findings array with coded observations (e.g. cost_variance), a status field, a count of variances detected, and limitation disclosures. Explicitly indicates whether tariff rates were invented, savings were guaranteed, or equipment was controlled (all false by design).","failureModes":["Missing tariff data causes expected cost to be uncomputable — tariff is not invented so variance may be null","Incompatible units between bills and tariffs prevent cost comparison","Missing billing period fields cause period-level analysis to fail","Truncated CSV or JSON input may result in partial analysis","Bills referencing unknown building IDs are processed without cross-building comparison","Exceeding 200 bills or 200 meters per request causes validation error"],"whenToPreferThis":"Use this endpoint when you need to audit whether energy bills match contracted tariff rates and want a structured variance report with explicit computation transparency. Prefer this over manual spreadsheet analysis when dealing with multiple buildings or meters. This endpoint explicitly refuses to invent tariff rates or guarantee savings, making it appropriate for compliance and audit workflows where accuracy attestation matters. It is not suitable for real-time meter monitoring, equipment control, or energy forecasting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:55.763Z","isFirstParty":false,"canonicalSlug":"brainiac-building-energy-cost-variance-detector-96ae58c0"}