BALL

Divides the trailing P/E by the year-over-year EPS growth rate (in percentage points). Below 1.0 is conventionally read as 'cheap relative to growth'; above 2 implies the multiple is well ahead of recent growth. Sensitive to which growth window you choose and unstable when earnings cross zero — flips sign or explodes when prior EPS is negative.

Peter Lynch's adjustment to PEG: adds the dividend yield to the growth rate in the denominator so that mature dividend payers don't get unfairly punished by a low growth rate alone. Sweet spot is 1.0 (P/E equals growth plus yield); below 0.5 often signals a broken growth assumption rather than genuine value; above 2 is over-paying.

CCI measures how far the current typical price ((H+L+C)/3) sits from its rolling SMA, normalized by the mean absolute deviation. Originally built for commodity cycles by Donald Lambert; widely used as a generic momentum / overbought-oversold gauge on any asset. CCI is unbounded but ±100 is the conventional 'normal range' edge — readings beyond that are interpreted as strong directional thrusts or stretched extremes depending on context.

+1 while CCI is below -100 (oversold); -1 while CCI is above +100 (overbought); 0 inside the ±100 band.

+1 = oversold (stretched below the typical-price mean, mean-reversion buy bias), -1 = overbought (stretched above), 0 = inside the ±100 band.

Designed to buy oversold pullbacks within an established uptrend (price above the regime moving average). Uses a 2-period RSI rather than the standard 14 to make it hyper-responsive to short-term swings. The default exit_method is RSI-threshold based: hold while RSI(2) is below the configured exit threshold and exit when RSI(2) crosses above exit. The book-style SMA exit is also supported by setting exit_method=sma with exit_ma.

+1 when price is above regime_ma and RSI(2) drops below oversold; held while inside the trade; back to 0 when the configured exit_method fires.

+1 = pullback-buy state active, -1 = pullback-short state active (symmetric rule in a down regime), 0 = flat.

The Coppock Curve is a weighted moving average of the sum of two rate-of-change measures, originally designed as a long-horizon, buy-only bottom indicator for equity indices. This screener applies it to daily bars and adds a bearish state for symmetry: a cross up through zero is the classic long-term buy tell, a cross down through zero flags a bearish momentum cycle.

+1 while the Coppock Curve is above zero; -1 while it is below zero; 0 only at exactly zero.

+1 = bullish zero-line cross (classic long-term buy), -1 = bearish zero-line cross.

Compares price pivots against the MACD histogram (MACD line minus signal line) at those same bars. Bullish divergence: price makes a lower low, histogram makes a higher low — momentum is improving beneath the surface. Bearish divergence: price makes a higher high, histogram makes a lower high. Slower than the MACD signal cross but a richer confirmatory tell — the histogram captures momentum acceleration, not just direction.

+1 at the right-hand pivot of bullish divergence; -1 at right-hand pivot of bearish divergence; 0 otherwise.

+1 = bullish divergence, -1 = bearish divergence.

Fires on the bar where the MACD line (EMA12 minus EMA26) crosses through the signal line (EMA9 of MACD). Bullish when MACD crosses up through signal, bearish when it crosses down. Far more commonly used as a trade trigger than divergence — see macd_divergence for the slower confirmatory tell. Whipsaws in chop; cleanest when combined with a trend-regime filter.

+1 on bullish cross (MACD crosses up through signal); -1 on bearish cross (MACD crosses down through signal); 0 otherwise.

+1 = bullish MACD-signal cross, -1 = bearish MACD-signal cross.

MFI is essentially RSI computed on (typical price × volume) instead of close alone, so high-volume bars push the oscillator harder than low-volume bars. It's 0-100 bounded and uses the same 20/80 OB-OS convention as a slower RSI. Because it folds in volume, MFI can flag distribution / accumulation underneath a flat price tape that RSI would miss.

+1 while MFI is below 20 (oversold); -1 while MFI is above 80 (overbought); 0 in between.

+1 = oversold (bullish, volume-weighted), -1 = overbought (bearish), 0 = mid-range.

When price prints a lower low while RSI prints a higher low at those same pivot bars, momentum is improving even though price is still falling — a classic bullish divergence that often precedes a reversal up. The bearish mirror fires when price makes a higher high but RSI prints a lower high, telegraphing exhausted upside. Divergences are confirmation tells rather than precise timing signals — best used as a 'something is changing under the surface' alert, not a trade trigger on their own.

+1 at the right-hand pivot of a (lower-low price, higher-low RSI) pair; -1 at the right-hand pivot of a (higher-high price, lower-high RSI) pair; 0 otherwise.

+1 = bullish divergence, -1 = bearish divergence, 0 = no divergence at this bar.