# BRAINIAC Building Energy Cost Variance Detector

> BRAINIAC Building Energy Cost Variance Detector is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Analyzes building energy bills against tariff rates to detect and quantify cost variances between actual charges and expected tariff-based costs

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/building-energy/cost-variance-detect?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-building-energy-cost-variance-detector-96ae58c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YYGgwKdde-anBiNzazMGn

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-building-energy-cost-variance-detector-96ae58c0 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## 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 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).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-building-energy-cost-variance-detector-96ae58c0/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)
