{"uid":"cap_FsZLEjv-K6HLGLO-L64Bg","slug":"brainiac-peak-demand-charge-calculator-748b87f5","name":"BRAINIAC Peak Demand Charge 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/electricity-market/peak-demand-charge-calculate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"feed":{"type":"object","properties":{"url":{"type":"string","format":"uri","maxLength":500}},"additionalProperties":false},"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},"kwh":{"type":"number","maximum":1000000000,"minimum":0},"peakKw":{"type":"number","maximum":1000000000,"minimum":0},"source":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"tariffId":{"type":"string","maxLength":80},"periodEnd":{"type":"string","maxLength":40},"billedFixed":{"type":"number","maximum":1000000000,"minimum":0},"billedTotal":{"type":"number","maximum":1000000000,"minimum":0},"periodStart":{"type":"string","maxLength":40},"billedDemand":{"type":"number","maximum":1000000000,"minimum":0},"billedEnergy":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":200},"carbon":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"index":{"type":"string","maxLength":40},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"intensity":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":1000},"demand":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"mw":{"type":"number","maximum":1000000000,"minimum":0},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false},"maxItems":1000},"prices":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"price":{"type":"number","maximum":1000000,"minimum":-1000000},"market":{"type":"string","maxLength":120},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"product":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12}},"additionalProperties":false},"maxItems":1000},"outages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"cause":{"type":"string","maxLength":200},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"status":{"type":"string","maxLength":80},"endedAt":{"type":"string","maxLength":40},"startedAt":{"type":"string","maxLength":40},"customersAffected":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":500},"tariffs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"demandUnit":{"type":"string","maxLength":40},"energyRate":{"type":"number","maximum":1000000,"minimum":0},"fixedCharge":{"type":"number","maximum":1000000000,"minimum":0},"peakDemandRate":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":100},"exposures":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"market":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"volumeMwh":{"type":"number","maximum":1000000000,"minimum":0},"hedgeRatio":{"type":"number","maximum":1,"minimum":0}},"additionalProperties":false},"maxItems":100},"worldBank":{"type":"object","properties":{"country":{"type":"string","maxLength":3,"minLength":2},"perPage":{"type":"integer","maximum":60,"minimum":1},"indicator":{"type":"string","maxLength":80,"minLength":3}},"additionalProperties":false},"generation":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"mw":{"type":"number","maximum":1000000000,"minimum":0},"fuel":{"type":"string","maxLength":80},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"isForecast":{"type":"boolean"}},"additionalProperties":false},"maxItems":1000},"carbonIntensity":{"type":"object","properties":{"fetch":{"type":"boolean"},"forecast":{"type":"boolean"},"regionId":{"type":"integer","maximum":18,"minimum":1}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"items":[{"billId":"BL-1","peakKw":95,"currency":"GBP","tariffId":"TF-1","demandUnit":"kW","apiKeyRequired":false,"peakDemandRate":8.5,"peakKwSupplied":true,"paidProviderUsed":false,"peakDemandCharge":807.5,"billingAccuracyClaimed":false,"peakDemandRateSupplied":true,"peakDemandChargeSupplied":true}],"status":"calculated","findings":[],"checkedAt":"2026-11-04T21:00:00.000Z","itemCount":1,"limitations":["Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.","No paid energy data provider is used and no API key is required.","Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.","Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.","Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."],"publicSources":[],"apiKeyRequired":false,"forecastInvented":false,"paidProviderUsed":false,"billingAccuracyClaimed":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_OE8Rr91lV9XMo-GNmmi9n","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 electricity peak demand charges from supplied bill, tariff, and demand data without requiring API keys or paid data providers","exampleAgentPrompt":"Can you calculate the peak demand charge for bill BL-1 where the peak demand was 95 kW and the tariff rate is £8.50/kW per month in GBP? I have the billing period and want to verify my utility's charge is correct.","exampleUseCases":[{"title":"Verify commercial electricity demand charge","prompt":"My business received an electricity bill with a peak demand of 120 kW and the tariff says the demand rate is $12.50/kW — can you calculate what our peak demand charge should be and check if the $1,500 we were billed is correct?"},{"title":"Audit multi-site energy bills for demand errors","prompt":"I have 5 electricity bills in JSON format for our warehouse sites — can you calculate the peak demand charge for each one using the tariff rates and kW readings included, and flag any where the billed demand charge doesn't match?"},{"title":"Analyze interval meter data for demand charge","prompt":"I've got a CSV of 15-minute interval electricity demand readings in kW for October — can you find the peak demand and calculate what the demand charge would be at a rate of $9.00/kW under our commercial tariff TF-2?"}],"resultDescription":"Returns a JSON object with an items array containing per-bill results including peakKw, peakDemandRate, peakDemandCharge, currency, tariffId, and flags like peakKwSupplied and peakDemandRateSupplied. Also includes overall status, findings, checkedAt timestamp, limitations (noting no paid providers or invented data), and boolean flags for apiKeyRequired, paidProviderUsed, and billingAccuracyClaimed.","failureModes":["Missing required tariff rate — charge cannot be calculated without a supplied rate","Missing peak kW value — if neither bill data nor interval series is supplied, peak cannot be determined","Malformed CSV or JSON input — parse errors returned","Input exceeds size limits (200,000 chars for text/csv/json, 12MB for base64 file)","Too many bills supplied (max 200) or carbon/demand rows (max 1000)","Insufficient data to compute — returns status with empty items and explanatory findings"],"whenToPreferThis":"Use this endpoint when you need to calculate or verify peak demand charges on electricity bills using caller-supplied data only, with no requirement for API keys or paid energy data subscriptions. It is ideal for auditing utility bills, validating demand charge accuracy, or computing expected charges from tariff rates and interval meter readings. Prefer this over general energy analytics platforms when you want transparent, source-traceable calculations that clearly disclose their data sources and limitations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:37:15.102Z","isFirstParty":false,"canonicalSlug":"brainiac-peak-demand-charge-calculator-748b87f5"}