Dividend Yield

Calculate the dividend yield ratio, a valuation ratio that measures the amount of dividends distributed per share of stock relative to the stock’s price.

The dividend yield ratio is used by investors to assess the income potential of an investment in a company’s stock based on the dividends it pays out. A higher dividend yield can be attractive to income-seeking investors.

The formula is as follows:

Also known as: annual dividend yield, income yield.

No programming experience? With the Finance Toolkit MCP server, AI assistants such as Claude and ChatGPT can calculate the Dividend Yield for you. Just ask in plain English.

Calculate the Dividend Yield in Python

The Dividend Yield is available in the Ratios module of the open-source Finance Toolkit. Install it with:

pip install financetoolkit -U

Then call get_dividend_yield as shown below.

from financetoolkit import Toolkit

toolkit = Toolkit(["AAPL", "TSLA"], api_key="FINANCIAL_MODELING_PREP_KEY")

dividend_yield = toolkit.ratios.get_dividend_yield()

Which returns:

Parameters

get_dividend_yield accepts the following parameters:

• show_daily (bool, optional): Whether to show daily data. Defaults to False.
• rounding (int, optional): The number of decimals to round the results to. Defaults to 4.
• growth (bool, optional): Whether to calculate the growth of the ratios. Defaults to False.
• lag (int | str, optional): The lag to use for the growth calculation. Defaults to 1.
• standardize (bool, optional): Whether to standardize (Z-Score) the result. When combined with growth=True, standardizes the growth values instead of the raw values. Defaults to False.
• trailing (int): Defines whether to select a trailing period. E.g. when selecting 4 with quarterly data, the TTM is calculated.

Related Valuation Ratios

The Ratios module page introduces the module, and the sidebar lists all of its functions.