Skip to main content

Dividend Leg

The dividend leg is a membership gate — it filters to stocks that have maintained a dividend streak for a minimum number of years and/or grown their dividend at a minimum CAGR.

dividend leg shape
"dividend": {
  "min_streak_years": 5,
  "min_cagr": 0.05
}

Both fields are optional — omit either to not gate on it.

:::info Combine with at least one other leg The dividend leg on its own is a membership filter. For a pure dividend screen ranked by yield or growth, use GET /v1/stocks/dividends instead. The dividend leg here is designed to be combined with ta or fundamental to find, e.g., "reliable dividend payers that are also technically breaking out." :::

Fields​

FieldTypeDescription
min_streak_yearsnumberMinimum consecutive years without a dividend cut. Range: 1–10. Capped at 10 (e.g. 10 = Dividend Aristocrat-level reliability).
min_cagrnumberMinimum 5-year dividend CAGR as a decimal. 0.05 = 5% annual growth. 0.0 = any growing dividend.

What counts as a "streak year"​

A streak year is a calendar year in which the company did not cut its dividend compared to the prior year. A zero-growth year (dividend held flat) does not break the streak. A cut — even a small one — resets the streak to zero.

The streak clock also resets to zero if the company suspended or eliminated its dividend entirely.

Examples​

5-year streak + growing dividend + above 200-day MA
{
  "ta": [{ "anchor": [{ "pattern": "above", "a": "close", "b": "ema200" }] }],
  "dividend": { "min_streak_years": 5, "min_cagr": 0.05 }
}
Dividend aristocrat-level (10 years) + low PE
{
  "fundamental": [{ "concept": "pe", "pattern": "below", "threshold": 20 }],
  "dividend": { "min_streak_years": 10 }
}
Any dividend payer in oversold territory
{
  "ta": [{ "anchor": [{ "pattern": "oversold", "a": "rsi14" }] }],
  "dividend": { "min_streak_years": 1 }
}
US consumer staples — reliable dividend + positive FCF
{
  "universe": { "include": [{ "country": ["US"], "gics": "30" }] },
  "fundamental": [{ "concept": "fcf", "pattern": "is_positive" }],
  "dividend": { "min_streak_years": 7, "min_cagr": 0.04 }
}
Asian dividend payers with bullish TA momentum
{
  "universe": { "include": [{ "country": ["JP","AU","SG","TW"] }] },
  "ta": [{
    "anchor": [{ "pattern": "crossover_up", "a": "ema50", "b": "ema200" }]
  }],
  "dividend": { "min_streak_years": 3, "min_cagr": 0.03 }
}
  • GET /v1/stocks/dividends — Pure dividend screen ranked by yield, streak, or CAGR
  • Fundamental Leg → — Add dividend_yield above 0.03 as a fundamental condition for a yield floor