okama.AssetList.get_dividend_mean_yield

AssetList.get_dividend_mean_yield(period=5)

Calculate the arithmetic mean for annual dividend yield (LTM) over a specified period.

Dividend yield is taken for full calendar annual dividends.

Parameters:

periodint, default 5

Mean dividend yield trailing period in years. Period should be a positive integer and not exceed the available data period_length.

Returns:

Series

Mean dividend yield value for each asset.

See also

dividend_yield

Dividend yield time series.

dividend_yield_annual

Calendar year dividend yield time series.

dividends_annual

Calendar year dividends.

get_dividend_mean_growth_rate

Geometric mean of annual dividends growth rate.

dividend_paying_years

Number of years of consecutive dividend payments.

dividend_growing_years

Number of years when the annual dividend was growing.

Examples

>>> al = ok.AssetList(["SBERP.MOEX", "LKOH.MOEX"], ccy='RUB', first_date='2005-01', last_date='2023-12')
>>> al.get_dividend_mean_yield(period=3)
SBERP.MOEX    0.052987
LKOH.MOEX     0.156526
dtype: float64