# BRAINIAC Macro Intelligence Surprise Calculator

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

Calculates economic surprise scores and z-scores for macroeconomic data releases by comparing actual values against consensus forecasts across indicators, countries, and time periods.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/macro-intelligence/surprise-calculate?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-macro-intelligence-surprise-calculator-a10ba8ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tHV6lA7swYdelwbXx_anW

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-macro-intelligence-surprise-calculator-a10ba8ce -d '<json body>'
```

Example prompt: Calculate the economic surprise score for the US CPI YoY release — the consensus was 2.9% and the actual came in at 2.8% for July 2026. I also want the z-score based on a historical standard deviation of 0.1%.

## When to prefer this

Use this endpoint when you need a pay-per-call, no-account macroeconomic surprise computation that accepts richly structured inputs (rates, debt, events, series, raw CSV/JSON/text) and returns normalized surprise scores and z-scores with transparent limitations. Prefer over building your own calculation when you need quick, standardized scoring of actual-vs-consensus macro releases without connecting to paid data vendors. Best suited for agents that already have consensus and actual data and need the statistical scoring layer.

## Known failure modes

- Missing consensus values cannot be imputed — surprise will be null or omitted
- Malformed CSV or JSON input may cause parsing errors
- Exceeding maxItems limits (500 debt, 200 rates/events) truncates input
- No historical standard deviation supplied means z-score cannot be computed
- Payment not received results in HTTP 402 response blocking execution
- Unsupported mediaType in file upload returns 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 an array of scored items each containing: indicator name, country, period, release date, actual value, consensus value, surprise (actual minus consensus), z-score, unit, and source. Also includes aggregate metadata: calculation status, standard deviation of surprises, sample count, public data sources used, and an extensive limitations disclaimer clarifying no paid data providers or invented values were used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "debt": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "amount": {
      "type": "number",
      "maximum": 1000000000000000,
      "minimum": 0
     },
     "coupon": {
      "type": "number",
      "maximum": 100,
      "minimum": 0
     },
     "source": {
      "type": "string",
      "maxLength": 160
     },
     "country": {
      "type": "string",
      "maxLength": 80
     },
     "currency": {
      "type": "string",
      "maxLength": 12
     },
     "instrument": {
      "type": "string",
      "maxLength": 160
     },
     "maturityDate": {
      "type": "string",
      "maxLength": 40
     }
    },
    "additionalProperties": false
   },
   "maxItems": 500
  },
  "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
  },
  "rates": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "asOf": {
      "type": "string",
      "maxLength": 40
     },
     "bank": {
      "type": "string",
      "maxLength": 160
     },
     "rate": {
      "type": "number",
      "maximum": 100,
      "minimum": -100
     },
     "source": {
      "type": "string",
      "maxLength": 160
     },
     "country": {
      "type": "string",
      "maxLength": 80
     },
     "previousRate": {
      "type": "number",
      "maximum": 100,
      "minimum": -100
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "events": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "date": {
      "type": "string",
      "maxLength": 40
     },
     "kind": {
      "type": "strin
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "REL-1",
    "unit": "%",
    "actual": 2.8,
    "period": "2026-07",
    "source": "",
    "zScore": -1,
    "country": "US",
    "surprise": -0.1,
    "consensus": 2.9,
    "indicator": "CPI YoY",
    "releaseDate": "2026-08-10",
    "apiKeyRequired": false,
    "zScoreSupplied": true,
    "paidProviderUsed": false,
    "surpriseSupplied": true
   },
   {
    "id": "REL-2",
    "unit": "%",
    "actual": 2.9,
    "period": "2026-08",
    "source": "",
    "zScore": 0,
    "country": "US",
    "surprise": 0,
    "consensus": 2.9,
    "indicator": "CPI YoY",
    "releaseDate": "2026-09-10",
    "apiKeyRequired": false,
    "zScoreSupplied": true,
    "paidProviderUsed": false,
    "surpriseSupplied": true
   },
   {
    "id": "REL-3",
    "unit": "%",
    "actual": 3.1,
    "period": "2026-09",
    "source": "",
    "zScore": 1,
    "country": "US",
    "surprise": 0.1,
    "consensus": 3,
    "indicator": "CPI YoY",
    "releaseDate": "2026-10-10",
    "apiKeyRequired": false,
    "zScoreSupplied": true,
    "paidProviderUsed": false,
    "surpriseSupplied": true
   }
  ],
  "status": "calculated",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "limitations": [
   "Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.",
   "No paid financial data provider is used and no API key is required.",
   "Missing consensus, previous values, FX rates, and debt amounts are not invented.",
   "Country risk labels summarize supplied indicators only and are not a credit rating.",
   "Event impact timelines link supplied events to nearby observation dates; causation is not claimed."
  ],
  "sampleCount": 3,
  "publicSources": [],
  "surpriseStdev": 0.1,
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "paidProviderUsed": false,
  "surpriseStdevSupplied": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-macro-intelligence-surprise-calculator-a10ba8ce/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)
