Yield to Maturity
yield-to-maturityBond yield to maturity: the nominal annual yield that prices a bond at the given price, with periodic coupons and face returned at maturity. Solved numerically. Returns a percent, or null.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"price": "<price>",
"faceValue": "<faceValue>",
"couponRatePct": "<couponRatePct>",
"years": "<years>"
},
"name": "yield-to-maturity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| price | Yes | Current bond price. | |
| years | Yes | Years to maturity. | |
| faceValue | Yes | Face (par) value repaid at maturity. | |
| couponRatePct | Yes | Annual coupon rate in percent of face. | |
| periodsPerYear | No | Coupon periods per year (default 2 = semiannual). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| yieldPct | No | Nominal annual yield, percent (null if none). |