AINumbers.co Bond Ladder API
The bond_ladder API from AINumbers.co — 1 operation(s) for bond_ladder.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/ainumbers-co:ainumbers-co-bond-ladder-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: AINumbers.co Fintech Intelligence Suite Bond Ladder API
version: 1.0.0
description: '**1255 fintech intelligence tools** covering ISO 20022, A2A payments, CFPB §1033, EU AI Act, DORA, MiCA, AML/KYC, BaaS, DLT/tokenization, ESG/climate finance, agentic payments (AP2, ACP, x402, Visa TAP, Mastercard Agent Pay), PQC migration, sanctions screening, and OpenChainGraph v0.4 computation chains.
## Transport
> **The live transport is MCP JSON-RPC 2.0 at `https://mcp.ainumbers.co/mcp` — not REST.**
>
> This OpenAPI file is a **descriptive data-room artifact** — a machine-readable index of all tools and their input/output schemas. The REST paths (`POST /v1/tools/{name}`) described here are a projection; they become functional only if the optional REST shim (Area 2 Path B) is deployed.
>
> To call tools today, connect via the official MCP client SDKs. TypeScript: `@modelcontextprotocol/sdk`. Python: `mcp`.
## Architecture
All tools run **entirely client-side** (browser JavaScript). Zero PII. Zero server calls after page load. Deterministic, reproducible outputs. Licensed CC BY 4.0.
OpenChainGraph v0.4 compute-binding nodes additionally run **server-side on the MCP Worker** and emit verifiable artifacts with `execution_hash` (WebCrypto SHA-256 over RFC 8785 canonical JSON).'
contact:
name: Post Oak Labs
url: https://postoaklabs.com
email: tim@postoaklabs.com
license:
name: CC BY 4.0
url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://ainumbers.co
description: Static browser-based tool host (DreamHost). Tools run client-side — no REST gateway is active on this origin. See x-mcp for the live MCP endpoint.
tags:
- name: bond_ladder
paths:
/v1/tools/build_bond_ladder:
post:
operationId: build_bond_ladder
summary: Bond Ladder Builder
description: 'Builds a target-weight bond ladder from a total notional split across maturity rungs and reports rung-by-rung and portfolio risk analytics: each rung''s price, Macaulay and modified duration, DV01 and convexity, plus the target_weight-weighted portfolio aggregates. Every reinvestment assumption is named in plain sentences in the output, and rung target weights must sum to 1 within 1e-9 or the tool refuses, naming the sum.
**Tool URL:** https://ainumbers.co/chaingraph/art-705-bond-ladder-builder.html
**AP2/Policy Mandate export:** yes'
tags:
- bond_ladder
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- notional
- rungs
properties:
notional:
type: number
description: Total ladder notional, split across rungs pro rata to target_weight.
rungs:
type: array
description: 'One object per rung: { maturity_years, coupon_rate_pct, yield_pct, target_weight }. Target weights must sum to 1 within 1e-9.'
items:
type: object
properties:
maturity_years:
type: number
coupon_rate_pct:
type: number
yield_pct:
type: number
target_weight:
type: number
periods_per_year:
type: number
description: Coupon periods per year for every rung (default 2).
reinvestment_assumption:
type: string
enum:
- hold_to_maturity
- roll_to_longest_rung
description: 'Named in the output assumptions[]: hold coupons and maturing principal as cash at 0%, or reinvest them at the longest rung''s yield.'
responses:
'200':
description: Successful tool execution result
content:
application/json:
schema:
type: object
properties:
assumptions:
type: array
items:
type: string
detail:
type: string
domain_errors:
type: array
items:
type: object
properties:
code:
type: string
enum:
- REINVESTMENT_ASSUMPTION_INVALID
- WEIGHTS_SUM_NOT_ONE
text:
type: string
required:
- code
- text
additionalProperties: false
error:
type: string
enum:
- reinvestment_assumption_invalid
- weights_sum_not_one
ladder:
type:
- array
- 'null'
note:
type: string
notional:
type: number
num_rungs:
type: number
periods_per_year:
type: number
portfolio:
type:
- object
- 'null'
regulatory_basis:
type: string
reinvestment_assumption:
type: string
enum:
- hold_to_maturity
- roll_to_longest_rung
required:
- assumptions
- ladder
- portfolio
additionalProperties: false
x-derived-from: fixture
x-mcp-tool-name: build_bond_ladder
x-tool-url: https://ainumbers.co/chaingraph/art-705-bond-ladder-builder.html
x-source: manifest
x-ap2-export: true
x-mcp:
transport: MCP JSON-RPC 2.0 (streamable HTTP)
endpoint: https://mcp.ainumbers.co/mcp
protocol_version: '2025-11-25'
authentication: none
registry: co.ainumbers/tools (official MCP registry)
note: Connect any MCP-compatible client (Claude, ChatGPT, custom agent) directly to this endpoint. The REST paths in this file are descriptive only — they do not exist on the live server unless the REST shim is deployed.