Dividend yield calculator

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

What dividend yield measures and how it is computed

Dividend yield answers a simple income question: given the cash a company declares per share over a year, what percent of the current share price does that cash represent. Worked example: an annual dividend of two dollars and forty cents on an eighty-dollar share is three percent, because two point four divided by eighty equals zero point zero three. Another example: one dollar and eighty-six cents of annual dividend on a sixty-two-dollar-forty share is about two point nine eight percent. Price appreciation, buybacks, and special one-off distributions are outside the cash-yield identity. Taxable equivalent yield for municipal bonds is a different search and a different tool; this calculator only divides stock dividend per share by share price. The standard identity used here is dividend_yield_percent equals annual_dividend divided by share_price, times one hundred. The same ratio without the times-one-hundred step is dividend_yield_decimal, so a three percent yield is also zero point zero three of the purchase price each year. When the annual dividend is strictly positive the response also includes inverse_yield, which is share_price divided by annual_dividend — the number of years of that dividend it would take to recoup the share price if the payout never changed, the reciprocal of the decimal yield. A twenty-dollar dividend on a one-hundred-dollar share is a twenty percent yield and an inverse yield of five years; a zero dividend is a zero yield and inverse_yield is omitted rather than returned as null, because optional output keys are dropped when they do not apply. This page does not decide whether your dividend figure is trailing twelve months, last declared annualized, or a forward estimate: that choice belongs to the caller, and two different annual numbers on the same price will correctly produce two different yields. It is also not total return.

Inputs, validation, rounding, and what the response contains

Share 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 yield, the decimal yield, the formula string, and the precision used. Both annual_dividend and share_price are required finite numbers in the same currency units. Annual dividend may be zero to model a non-paying stock, which produces a zero percent yield; a negative dividend returns a typed invalid_input error that names the field, because a cash yield cannot be computed from a negative payout in this contract. Optional aliases dividend, dps, annual_dps, and dividend_per_share map to annual_dividend; price, current_price, and stock_price map to share_price so spreadsheets and form clients can reuse familiar column names. Failed validation is never billed; only successful API tasks consume prepaid balance at the published base rate of $0.002. Do not send live ticker symbols: this engine does not look up quotes, ex-dividend dates, or payout calendars, and a non-numeric ticker fails as invalid_input.

Where a dividend yield calculator earns its keep

Income investors and dividend-growth screeners use a dividend yield calculator to compare names after a price move without waiting for a terminal to refresh a trailing-yield column: if the annual dividend is unchanged and the share price fell, the yield rose, and the inverse-yield years-to-recoup figure shortened. If you need a tax-adjusted comparison between a municipal bond and a taxable coupon, use the separate taxable-equivalent-yield tool; this page answers only annual dividend per share over current share price, with stable, reproducible output you can trust in tests. Advisors and educators walk clients through why a high headline yield can be a falling-price artifact rather than a raise, by holding annual_dividend fixed and changing only share_price. Spreadsheet users pin a two-point-four-on-eighty result of three percent in continuous integration when they refactor display code, ensuring rounding and aliases keep working. Pair the free interactive page for a single-name check with the priced endpoint for batch screens.