# BRAINIAC Yield Curve Analyzer

> BRAINIAC Yield Curve Analyzer 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).

Analyzes yield curve shape, slope, and curvature from caller-supplied interest rate and bond data, returning structured macro intelligence findings.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/macro-intelligence/yield-curve-analyze?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-yield-curve-analyzer-384c11b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gOHsJ_XimXIiv3EzrmNaI

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-yield-curve-analyzer-384c11b8 -d '<json body>'
```

Example prompt: Analyze this yield curve data: 2-year yield 3.8%, 10-year yield 4.2%, 30-year yield 4.5% for the US as of 2026-10-01 — tell me the curve shape, slope, and curvature.

## When to prefer this

Use this endpoint when you have caller-supplied yield curve or treasury rate data and need structured macro analysis — curve shape classification, slope, and curvature — without requiring a paid financial data subscription or API key. It is best when you already hold the rate data (from your own scrape, a data feed, or a file) and need an analytical layer on top. It operates purely on what you supply, does not invent missing values, and transparently reports limitations. Prefer this over generic LLM interpretation when you need deterministic, structured output with labeled fields and reproducible results.

## Known failure modes

- Insufficient tenor/yield data points provided — need at least two points to compute slope
- Malformed date strings in asOf or maturityDate fields — returns validation error
- CSV or base64 file payload exceeds size limits — truncation or rejection
- Missing required rate or yield fields result in incomplete curve metrics with null values
- Country not recognized or inconsistent with supplied data — may produce generic output
- Input yields outside plausible range may trigger schema validation rejection

## 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 yield curve items, each containing: curve shape label (e.g. 'upward', 'inverted', 'flat'), short and long tenor identifiers and yields, slope and curvature in percentage points, point count, country, asOf date, public sources used, and a list of analytical limitations and findings. Also flags whether paid data providers or API keys 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": [
   {
    "asOf": "2026-10-01",
    "shape": "upward",
    "points": [
     {
      "tenor": "2y",
      "months": 24,
      "source": "Caller-supplied Treasury curve",
      "yieldPct": 3.8
     },
     {
      "tenor": "10y",
      "months": 120,
      "source": "Caller-supplied Treasury curve",
      "yieldPct": 4.2
     },
     {
      "tenor": "30y",
      "months": 360,
      "source": "Caller-supplied Treasury curve",
      "yieldPct": 4.5
     }
    ],
    "country": "US",
    "longTenor": "30y",
    "longYield": 4.5,
    "pointCount": 3,
    "shortTenor": "2y",
    "shortYield": 3.8,
    "apiKeyRequired": false,
    "slopePctPoints": 0.7,
    "paidProviderUsed": false,
    "longYieldSupplied": true,
    "curvaturePctPoints": -0.7,
    "shortYieldSupplied": true,
    "slopePctPointsSupplied": true,
    "curvaturePctPointsSupplied": true
   }
  ],
  "status": "analyzed",
  "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."
  ],
  "publicSources": [],
  "apiKeyRequired": false,
  "ratingAssigned": false,
  "causationClaimed": false,
  "paidProviderUsed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-yield-curve-analyzer-384c11b8/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)
