Bond current yield calculator

The engine is pure deterministic arithmetic, so homework keys, screening spreadsheets, and API clients always agree on the same inputs.

What current yield measures and how it is computed

Current yield answers a cash-income question for a coupon bond: given the dollars the issuer pays over a year, what percent of the bond's current market price does that coupon represent. Worked example: an annual coupon of sixty dollars on a nine-hundred-fifty-dollar market quote is six point three one five eight percent, because sixty divided by nine hundred fifty equals zero point zero six three one five eight. Another example: a fifty-dollar coupon on a one-thousand-dollar par quote is five percent. Tax-free municipal comparisons are a different search and a different tool; this calculator only divides annual coupon income by current market price. The standard identity used here is current_yield_percent equals annual_coupon divided by market_price, times one hundred. The same ratio without the times-one-hundred step is current_yield_decimal, so a six point three two percent current yield is also about zero point zero six three two of the purchase price each year. When the annual coupon is strictly positive the response also includes inverse_yield, which is market_price divided by annual_coupon — the number of years of that coupon it would take to recoup the market price if the coupon never changed, the reciprocal of the decimal current yield. A zero coupon is a zero current yield and inverse_yield is omitted rather than returned as null, because optional output keys are dropped when they do not apply. Supply an optional face_value (par) and the engine also reports coupon_rate_percent, the dollar premium or discount versus par, quote_vs_par as premium, par, or discount, and yield_versus_coupon so you can see the textbook relationship: a discount quote lifts current yield above the coupon rate; a premium quote pushes it below. This page does not compute yield to maturity, yield to call, or duration: those need remaining life and a redemption assumption. It is also not taxable equivalent yield.

Inputs, validation, rounding, and what the response contains

Market price must be strictly greater than zero: a zero or negative price is undefined for yield and is rejected the same way so automation never stores Infinity. The decimal yield is rounded to min(precision plus four, fifteen) so a small yield such as ninety-four basis points still keeps extra digits after the point. Successful responses echo the two inputs, the percent current yield, the decimal current yield, the formula string, and the precision used. Both annual_coupon and market_price are required finite numbers in the same currency units. Annual coupon may be zero to model a zero-coupon bond, which produces a zero percent current yield; a negative coupon returns a typed invalid_input error that names the field, because a cash yield cannot be computed from a negative coupon in this contract. Optional aliases coupon, coupon_payment, annual_coupon_income, and c map to annual_coupon; price, current_price, bond_price, and dirty_price map to market_price so spreadsheets and form clients can reuse familiar column names. Optional face_value (aliases par, par_value, face, nominal, face_amount) must be strictly positive when sent; it is used only to compute the coupon rate versus par and to classify the quote. Failed validation is never billed; only successful API tasks consume prepaid balance at the published base rate of $0.002. Do not send CUSIP codes or live ticker symbols: this engine does not look up quotes, accrued interest, or coupon calendars, and a non-numeric identifier fails as invalid_input.

Where a bond current yield calculator earns its keep

Income investors and fixed-income screeners use a bond current yield calculator to compare coupon bonds after a price move without waiting for a terminal to refresh a current-yield column: if the annual coupon is unchanged and the market price fell, current yield rose, and the inverse-yield years-to-recoup figure shortened. If you need a tax-adjusted comparison between a municipal coupon and a taxable yield, use the separate taxable-equivalent-yield tool; if you need stock cash yield, use the dividend-yield tool. This page answers only annual coupon income over current market price, with stable, reproducible output you can trust in tests. It is not a substitute for yield to maturity when you care about pull-to-par over the remaining life of the bond. Advisors and educators walk clients through why a high headline current yield can be a falling-price artifact rather than a coupon raise, by holding annual_coupon fixed and changing only market_price, then adding face_value to show that a discount quote sits above the coupon rate. Spreadsheet users pin a sixty-on-nine-hundred-fifty result of six point three one five eight percent in continuous integration when they refactor display code, ensuring rounding and aliases keep working. Pair the free interactive page for a single-quote check with the priced endpoint for batch screens.