Dividend and Dividend Growth key parameters calculator

This API calculates parameters that are of utmost importance for investors interested in dividend in general and for Dividend Growth Investors in particular. Each parameter is calculated for the user selected security, and for a given period (when relevant). Securities parameters can be compared by calling the API multiple times. The API calculates the following parameters:

Total return

Total return is the amount of value an investor earns from a security over a specific period, when all distributions are reinvested.
calcTotReturn(symb, period):
symb is the ticker symbol of the security.
period is the duration for calculating the total return. The end time is today. The period is in years, but can be any positive real number. For example period=1.5 represents one and a half year.
The output represents the total return, assuming one dollar was invested at the beginning of the period. To obtain the total return in percent, multiply by 100.

Payout ratio

The dividend payout ratio is the ratio of the total amount of dividends paid out to shareholders relative to the net income of the company. It is the percentage of earnings paid to shareholders in dividends.Here, the trailing 12 months dividend paid is divided by the trailing 12 months GAAP net income.
calcPayoutRatio(symbol):
symbol is the ticker symbol of the security.
The output is the payout ratio. A value greater than 1 means that the dividend paid in the last 12 months exceeded the company net income. To obtain the payout ratio in percent, multiply the result by 100.

Compound Annual Growth Rate (CAGR)

This growth rate is the in cash dividends per share of common stock over a given number of years. Dividend growth is a good indicator of the financial health of a company.
calcCagr(mySymb, period):
mySymb is the ticker symbol of the security.
period is the number of years (only integer value) for calculating the CAGR. The end time is the last day of previous year.
The CAGR is provided is an absolute value. Multiply by 100 to obtain the value in percent.

AverageDividend Yield

This tool calculates the average dividend yield over a given period.
calcYield(symb, period):
period is the duration for calculating the total return. The end time is today. The period is in years, but can be any positive real number. For example period=1.5 represents one and a half year.
symb is the ticker symbol of the security.
The output gives the average yield. To obtain the yield in percent, multiply by 100.