# BRAINIAC Building Energy Consumption Analyzer

> BRAINIAC Building Energy Consumption Analyzer 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 consumption data from meter readings, bills, and tariffs to surface usage patterns, cost breakdowns, and anomalies

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/building-energy/consumption-analyze?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-consumption-analyzer-75d0a912
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RJU0--hVGvktiLVvqLyeJ

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-consumption-analyzer-75d0a912 -d '<json body>'
```

Example prompt: Can you analyze our building energy data? I'll give you meter readings and tariff info for building B-1 on electric utility — the readings cover November 1 to November 15, 2026, with meter M-1 at tariff T-1 (rate $0.155/kWh). Tell me the total consumption, daily average, and flag anything unusual.

## When to prefer this

Use this endpoint when you have structured energy data (meter readings, bills, tariff rates) for one or more buildings and need to compute consumption summaries, cost breakdowns, or detect anomalies — without setting up an account or long-term integration. Ideal for one-off audits, agent-driven energy reporting, or ad-hoc analysis in workflows that pay per call via x402/USDC on Base. Prefer this over spreadsheet tools when you need structured JSON output consumable by downstream agents.

## Known failure modes

- Missing required meter or tariff data causes incomplete cost calculation — cost fields will be absent rather than invented
- Incompatible units or periods between buildings prevent cross-building comparison
- Truncated CSV or JSON input (over 200,000 chars) may be rejected or silently truncated
- Ambiguous or missing date fields on readings/bills reduce period accuracy
- No tariff supplied for a meter results in tariffInvented=false and no cost output for that meter

## 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 array of analyzed consumption items per meter/period (total quantity, cost, day span, average per day, tariff applied), overall analysis status, any anomaly findings, bill count, the timestamp of analysis, and a list of explicit limitations (e.g. no tariff invention, no equipment control). Also includes flags indicating whether values were supplied or derived.

## 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": [
   {
    "cost": 43.6,
    "unit": "kWh",
    "daySpan": 14,
    "meterId": "M-1",
    "utility": "electric",
    "tariffId": "T-1",
    "periodEnd": "2026-11-15",
    "buildingId": "B-1",
    "periodStart": "2026-11-01",
    "costSupplied": true,
    "averagePerDay": 20,
    "intervalCount": 2,
    "totalQuantity": 280,
    "tariffInvented": false,
    "daySpanSupplied": true,
    "averagePerDaySupplied": true,
    "totalQuantitySupplied": true
   }
  ],
  "status": "analyzed",
  "findings": [],
  "billCount": 0,
  "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."
  ],
  "tariffInvented": false,
  "savingsGuaranteed": false,
  "equipmentControlled": false,
  "performanceInvented": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-building-energy-consumption-analyzer-75d0a912/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)
