# BRAINIAC Energy Price Volatility Analyzer

> BRAINIAC Energy Price Volatility 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 electricity market price volatility from caller-supplied energy data, returning standard deviation, average prices, and volatility statistics per market key

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/electricity-market/energy-price-volatility-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-energy-price-volatility-analyzer-f71d8146
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yUQnIJxEvfne8zFQj0-ue

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-energy-price-volatility-analyzer-f71d8146 -d '<json body>'
```

Example prompt: Can you analyze the price volatility in my electricity market data? I'll give you a CSV with hourly N2EX prices for the last 90 days — tell me the standard deviation and average price so I can assess our exposure.

## When to prefer this

Choose this endpoint when you have caller-supplied electricity price time-series, billing records, demand, or carbon data and need statistical volatility metrics (standard deviation, average price) computed without relying on a paid energy data provider. It is best suited for energy risk management, procurement decisions, and hedging analysis where you already hold the raw data. Prefer alternatives if you need live market data fetched on your behalf, long-term forecasting, or legal-grade billing accuracy.

## Known failure modes

- Insufficient price data supplied — no variance can be computed if fewer than 2 price observations are provided
- Malformed CSV or JSON input returns a parse error or empty items array
- Missing required fields (mediaType or fileBase64 when using file upload) triggers schema validation failure
- Feed URL inaccessible or returning non-energy data results in empty publicSources and no price enrichment
- Prices not labeled in recognized fields are silently ignored, producing lower observation counts than expected
- x402 payment failure (insufficient USDC balance) results in HTTP 402 and no analysis

## 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 where each entry contains: marketKey (string), priceStdev (float), returnStdev (float), averagePrice (float), observationCount (integer), and boolean flags (paidProviderUsed, apiKeyRequired, priceStdevSupplied, returnStdevSupplied, averagePriceSupplied). Also includes a `status` field ('analyzed'), `findings` array, `checkedAt` ISO timestamp, `limitations` list explaining data sourcing constraints, and counts for marketCount and publicSources.

## 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": [
   {
    "marketKey": "n2ex",
    "priceStdev": 1.8083,
    "returnStdev": 0.0505,
    "averagePrice": 80.2,
    "apiKeyRequired": false,
    "observationCount": 3,
    "paidProviderUsed": false,
    "priceStdevSupplied": true,
    "returnStdevSupplied": true,
    "averagePriceSupplied": true
   }
  ],
  "status": "analyzed",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "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."
  ],
  "marketCount": 1,
  "publicSources": [],
  "apiKeyRequired": false,
  "forecastInvented": false,
  "paidProviderUsed": false,
  "billingAccuracyClaimed": false
 }
}
```

## More

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