# BRAINIAC Peak Demand Charge Calculator

> BRAINIAC Peak Demand Charge Calculator is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-12).

Calculates electricity peak demand charges from supplied bill, tariff, and demand data without requiring API keys or paid data providers

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/electricity-market/peak-demand-charge-calculate?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-peak-demand-charge-calculator-748b87f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FsZLEjv-K6HLGLO-L64Bg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-peak-demand-charge-calculator-748b87f5 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
     },
     "re
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-peak-demand-charge-calculator-748b87f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
