# BRAINIAC Electricity Market Price Series Normalize

> BRAINIAC Electricity Market Price Series Normalize 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).

Accepts caller-supplied electricity price, demand, carbon, tariff, billing, and generation data and normalizes it into a structured, timestamped price series without inventing missing values.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/electricity-market/price-series-normalize?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-electricity-market-price-series-normalize-0b5b8f65
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TZ_ZTmjA_cOYym3aphpQz

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-electricity-market-price-series-normalize-0b5b8f65 -d '<json body>'
```

Example prompt: I have a CSV of day-ahead electricity prices from N2EX in GBP/MWh covering November 2026 — can you normalize it into a structured price series with timestamps, market, region, currency, and unit fields so I can feed it into our analytics pipeline?

## When to prefer this

Use this endpoint when you have caller-supplied electricity market data (prices, bills, demand, carbon intensity, generation, tariffs, outages) in various raw formats (CSV, JSON, text, file, structured arrays, or a URL feed) and need a normalized, auditable, timestamped price series with no invented values and clear provenance flags. Prefer this over general-purpose data transformation tools when you specifically need electricity-domain semantics (MWh units, market/region/product metadata, carbon intensity linkage, tariff and billing alignment) and when auditability (paidProviderUsed, forecastInvented, billingAccuracyClaimed flags) is important. It is especially suitable for agents building energy analytics pipelines, compliance reporting, or multi-source energy cost comparisons.

## Known failure modes

- Malformed or unrecognized CSV/JSON input returns an error or empty items array
- Input exceeding size limits (200,000 chars for text/csv/json, 12MB for file) is rejected
- Missing required file fields (mediaType, fileBase64) cause validation errors
- Unreachable feed URL results in a fetch error and no price data from that source
- Records with out-of-range numeric values (e.g. negative kWh) are rejected by schema validation
- Ambiguous or unparseable date/time strings in periodStart/periodEnd or `at` fields cause row-level errors

## 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 of normalized price records (each containing timestamp, ID, unit, price, market, region, source, product, currency, and flags such as priceSupplied, apiKeyRequired, and paidProviderUsed), plus metadata fields: status, findings, checkedAt, pointCount, limitations, publicSources, and audit flags (forecastInvented, paidProviderUsed, billingAccuracyClaimed). Missing values are never invented.

## 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": [
   {
    "at": "2026-11-01T12:00:00.000Z",
    "id": "P1",
    "unit": "currency/MWh",
    "price": 78.5,
    "market": "N2EX",
    "region": "GB",
    "source": "Caller-supplied",
    "product": "day-ahead",
    "currency": "GBP",
    "priceSupplied": true,
    "apiKeyRequired": false,
    "paidProviderUsed": false
   },
   {
    "at": "2026-11-02T12:00:00.000Z",
    "id": "P2",
    "unit": "currency/MWh",
    "price": 82.1,
    "market": "N2EX",
    "region": "GB",
    "source": "Caller-supplied",
    "product": "day-ahead",
    "currency": "GBP",
    "priceSupplied": true,
    "apiKeyRequired": false,
    "paidProviderUsed": false
   }
  ],
  "status": "normalized",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "pointCount": 2,
  "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-electricity-market-price-series-normalize-0b5b8f65/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)
