---
title: "Bond Convexity"
method: POST
path: "/v1/tools/compute_convexity"
tags: ["TODO_TAGS_REVIEW"]
---

# Bond Convexity

`POST /v1/tools/compute_convexity`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/compute_convexity`
- Auth: none declared

Standard closed-form convexity for a bullet bond, annualized by compounding frequency squared. Second-order complement to modified duration for estimating bond price sensitivity to larger yield moves; optionally reports the convexity price-adjustment term for a declared yield shock. Same bond schedule builder as compute_bond_duration.

**Tool URL:** https://ainumbers.co/chaingraph/art-331-tvm-convexity.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `coupon_rate_pct` number: Percentage value
  - `face_value` number
  - `periods_per_year` number
  - `years_to_maturity` number
  - `yield_shock_bp` number
  - `ytm_pct` number: Percentage value

## Response `200`

Successful tool execution result

- object
  - `convexity` number
  - `convexity_price_adjustment_pct` string
  - `coupon_rate_pct` integer
  - `face_value` integer
  - `note` string
  - `num_periods` integer
  - `periods_per_year` integer
  - `price` number
  - `regulatory_basis` string
  - `years_to_maturity` integer
  - `ytm_pct` integer

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)