# BRAINIAC Sovereign Debt Maturity Analyzer

> BRAINIAC Sovereign Debt Maturity 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 a sovereign debt portfolio by bucketing instruments into maturity ranges and surfacing rollover risk, nearest maturities, and macro-context findings.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/macro-intelligence/sovereign-debt-maturity-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-sovereign-debt-maturity-analyzer-6e00acb9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-8npJcBpeR8EmZbR2whUd

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-sovereign-debt-maturity-analyzer-6e00acb9 -d '<json body>'
```

Example prompt: Analyze the maturity profile of this US government debt portfolio as of October 1 2026 — the instruments include a $100B bond maturing December 2026, a $250B note maturing in 3 years, and a $400B bond maturing in 15 years — and bucket them into 0–12 months, 1–5 years, 5–10 years, and 10+ years.

## When to prefer this

Use this endpoint when you need structured maturity-bucket analysis of sovereign or government debt instruments without requiring a paid financial data subscription or account setup. It is ideal for agents that already hold the debt schedule data and need fast, deterministic bucketing with macro context — not for sourcing the underlying debt data itself. Prefer this over generic LLM analysis when you need reproducible bucket figures, explicit sourcing limitations, and a clear findings list.

## Known failure modes

- Debt array exceeds 500 items — request will be rejected
- maturityDate fields missing or unparseable — bucket placement will be skipped for those instruments
- Amounts or coupons out of allowed numeric range — validation error
- File base64 payload exceeds 12MB limit — request rejected
- No debt data provided in any input channel — empty or trivial result
- Currency or country fields blank — grouping may be incomplete

## 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 per-country maturity bucket breakdowns (0–12 months, 1–5 years, 5–10 years, 10+ years), total amounts, nearest maturity date, instrument count, overall analysis status, findings list, and an explicit list of limitations (no paid data providers, no invented values, no credit ratings assigned).

## 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",
    "buckets": [
     {
      "amount": 100,
      "bucket": "0_12m",
      "amountSupplied": true
     },
     {
      "amount": 250,
      "bucket": "1_5y",
      "amountSupplied": true
     },
     {
      "amount": 0,
      "bucket": "5_10y",
      "amountSupplied": true
     },
     {
      "amount": 400,
      "bucket": "10y_plus",
      "amountSupplied": true
     }
    ],
    "country": "US",
    "currency": "USD",
    "totalAmount": 750,
    "apiKeyRequired": false,
    "instrumentCount": 3,
    "nearestMaturity": "2026-12-15",
    "paidProviderUsed": false,
    "totalAmountSupplied": 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-sovereign-debt-maturity-analyzer-6e00acb9/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)
