aifinhub

Savings & Investing

Bond Yield Calculator

Calculate bond yield to maturity (YTM), current yield, yield to call (YTC), Macaulay duration, modified duration, and DV01 from face value, coupon rate, market price, and time to maturity.

Bond Inputs

Enter the bond's face value, coupon rate, market price, and time to maturity to compute YTM, duration, and more.

▶ Optional: Call provisions (for callable bonds)

Bond Analysis

Yield to Maturity

5.66%

Current Yield

5.26%

Macaulay Duration

7.93 yrs

Modified Duration

7.71

DV01 ($ per 1bp)

$0.73

Total Coupon Income$500.00
Gain / Loss at Maturity$50.00
Total Return$550.00

⚠️ Bond is trading at a discount — YTM will be higher than the coupon rate.

Cumulative Present Value of Cash Flows

P1P20
Cumulative PV
$950.00

⚠️ YTM assumes all coupons are reinvested at the same rate. This is a theoretical measure — actual returns may vary. Not financial advice.

How to use it

  1. Enter face value, coupon rate, years to maturity, current price, and coupon frequency using the actual market price. Bond yield math is price-sensitive, so stale prices give misleading answers.
  2. Read current yield, yield to maturity, and duration together. If a bond trades below par, YTM will usually exceed the coupon, and duration estimates how sensitive price is to rate changes.
  3. A modified duration of 6 means the price moves about 6% for a 1% rate move before convexity effects. A higher YTM is not free if it comes with longer duration or more credit risk.
  4. Compare YTM with Treasuries, CDs, and savings alternatives on the same maturity horizon, and check yield to call before reaching for yield in callable bonds. Do not buy a premium callable bond without understanding the call scenario.
  5. Re-run when market price moves, rate expectations shift, or call risk changes. Track YTM, duration, and the premium or discount to par.

AI Integrations

Contract, discovery endpoints, and developer notes for agent use.

Always available for agents

Tool contract JSON

https://aifinhub.io/contracts/bond-yield-calculator.json

Stable input and output contract for this exact tool.

Human review

People can use the browser page to sense-check outputs and charts, but agents should still execute against the contract and discovery endpoints.

{
  "tool": "bond_yield_calculator",
  "face_value": 1000,
  "coupon_rate": 5,
  "years_to_maturity": 10,
  "current_price": 950,
  "coupon_frequency": 2
}
Expand developer notes

Agent playbook

  1. Resolve Bond Yield Calculator from /agent-tools.json and open its contract before execution.
  2. Validate inputs against the contract schema instead of scraping labels from the page UI.
  3. Open the browser page only when a person wants to review charts, assumptions, or related tools.

Agent FAQ

Should ChatGPT, Claude, or another agent click through the UI?

No. Start with /agent-tools.json, then follow the tool's contract URL. The page UI is for human review, not parameter discovery.

When do tools show Quick and Advanced?

Every tool opens in Quick Start first. Advanced Controls keeps the same scenario, reveals more assumptions or diagnostics, and every tool keeps AI integrations inline below the instructions.

When should an agent still open the browser page?

Open it when a human wants to sense-check the output, review the chart, or keep exploring related tools after the calculation finishes.

Questions people usually ask
What is yield to maturity (YTM)?

YTM is the total annualized return you'd earn if you bought the bond today and held it until maturity, assuming all coupons are reinvested at the same rate. It's the most useful single yield metric for comparing bonds.

What's the difference between current yield and YTM?

Current yield = annual coupon ÷ current price. It ignores the gain or loss at maturity. YTM accounts for the full cash flow stream including the return of face value, so it's more accurate for total return comparison.

Why is the bond trading at a discount or premium?

When market interest rates rise above a bond's coupon rate, the bond trades at a discount (below par) to compensate buyers. When rates fall below the coupon rate, the bond trades at a premium.

What is modified duration?

Modified duration estimates how much the bond's price will change for a 1% change in yield. A modified duration of 7 means the bond's price drops roughly 7% if yields rise 1%.

What is DV01?

Dollar Value of 01 (DV01) is the dollar amount your bond position changes for a 1 basis point (0.01%) move in yield. It's a key risk metric for fixed-income portfolios.

Related Resources

Learn the decision before you act

Every link here is tied directly to Bond Yield Calculator. Use the explanation, formula, examples, and benchmarks to pressure-test the calculator output from first principles.

Browse all 9 resources

Continue With Related Tools

Browse by Use Case

Planning estimates only — not financial, tax, or investment advice.