curatedapi

Yield to call calculator

The yield of a callable bond if the issuer redeems it on the call date at the call price, found as a proven root of the price equation.

Settlement date (when the buyer gets the bond).
The date the bond can be called.
Annual coupon rate in percent of face value.
Clean price paid per 100 of face value.
Amount paid per 100 of face value if the bond is called.
Coupons per year: 1, 2 or 4.
How days are counted for accrued interest. Options: 30/360: US (NASD) 30/360; actual/actual: actual days over the actual length of the coupon period; actual/360: actual days over a 360-day year; actual/365: actual days over a 365-day year; 30e/360: European 30/360
More options: rounding and decimals
Precision and rounding
Rounding mode applied once to each result. Default half_even.
Round results to this many digits after the decimal point.
Round results to this many significant digits.

Examples

Result: A 5% bond bought at 104, callable in five years at 102

Yield to call percent
Annual yield to the call date. Unit: percent.
4.460115 rounded
Coupons until call
Coupons from settlement to the call date.
10

Rounding: Half even, 6 decimal places. Calculator finance/yield-to-call@1.

How it is calculated

the y with PRICE(settlement, call date, coupon, y, call price, frequency, basis) = price

A callable bond can be repaid early at a set price. Yield to call is the yield the buyer earns if that happens: the rate at which the coupons up to the call date and the call price are worth today's price. It is the same equation as yield to maturity (Excel's YIELD) with the call date in place of maturity and the call price in place of the redemption value. Compare it with the yield to maturity; the lower of the two is the yield to worst.

  • The result is Excel's YIELD for the same dates with the call price as redemption, to the digits shown.
  • Coupon dates are counted back from the call date, so the call date should be a coupon date.

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Use it from your code

POST /v1/calc/finance/yield-to-callVersion 1
curl https://api.curatedapi.com/v1/calc/finance/yield-to-call \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "settlement": "2026-03-15",
    "call_date": "2031-03-15",
    "coupon_rate_percent": "5",
    "price": "104",
    "call_price": "102"
  }'
The same call in Python
import os

import requests

payload = {
    "settlement": "2026-03-15",
    "call_date": "2031-03-15",
    "coupon_rate_percent": "5",
    "price": "104",
    "call_price": "102",
}
response = requests.post(
    "https://api.curatedapi.com/v1/calc/finance/yield-to-call",
    headers={"Authorization": f"Bearer {os.environ['CURATEDAPI_KEY']}"},
    json=payload,
    timeout=10,
)
print(response.json()["result"])
The same call in JavaScript
const payload = {
    "settlement": "2026-03-15",
    "call_date": "2031-03-15",
    "coupon_rate_percent": "5",
    "price": "104",
    "call_price": "102",
};
const response = await fetch("https://api.curatedapi.com/v1/calc/finance/yield-to-call", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CURATEDAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});
console.log((await response.json()).result);

MCP tool calc_finance_yield_to_call at https://mcp.curatedapi.com. Inputs, outputs and errors in the API reference.

Put it on your website

<div data-curatedapi-widget="finance/yield-to-call" data-key="capi_public_…"></div>
<script src="https://widgets.curatedapi.com/v1/widget.js" async></script>

Use a public key registered for your site. Calculations are billed like API calls. How widgets work.

Related calculators

Add this calculator to your website

Paste two lines into your page and your visitors get this calculator. Each use counts as one call on your plan, the same as the API.

Free for up to 1,000 uses a month. 50,000 uses a month cost $9.00 on the Starter plan.