Definition
The most recent regular cash dividend per share whose ex-dividend date is on or before the evaluation date (America/New_York), split-adjusted onto today's share basis, special dividends excluded. Returns null when the asset has no regular dividend on or before that date. Each payment is one observation for TrailingSum, so TrailingSum(LastDividend(asset), 4) sums the last four payments, which is trailing-twelve-month dividends for a quarterly payer (use 12 for a monthly payer). A payment counts only once its ex-dividend date has passed.
Parameters
Asset
Output range: > 0 dollars per share, or null when the asset has never paid a regular cash dividend
Example condition
`TrailingSum(LastDividend(KO), 4) / Price(KO) > 0.03` (KO's last four regular payments are more than 3% of its price)Usage notes
Wrap it in TrailingSum for trailing-twelve-month dividends: 4 payments for a quarterly payer, 12 for a monthly payer. Wrap it in ConsecutiveIncrease with period Year to count consecutive years of dividend raises.
Use in a strategy
Add this indicator to a strategy condition, choose its supported parameters and compare the output with the threshold required by your rule. Preserve the same interval and lookback when comparing backtests.
After saving the condition, inspect its asset, interval, lookback and comparison operator against the parameters above. If no trades occur, check whether the condition ever became true and whether the requested input data exists for that period. A missing input is not a zero-valued signal. An indicator produces an input to a rule. It does not establish future returns, and data availability can differ across assets and periods.