STAG

Joel Greenblatt's reformulation of return-on-capital, designed to filter for businesses that earn high pre-tax returns on the tangible operating capital that actually generates EBIT. Excludes goodwill and acquired intangibles so that two firms with the same operating economics rank similarly regardless of acquisition history. Pairs with Greenblatt's Earnings Yield (EBIT/EV) to produce the famous 'Magic Formula' rank — quality stocks at value prices.

Measures how productive the actual operating capital base is, independent of capital structure. Strips out the effects of cash, leverage, and below-the-line items so you see the underlying economic engine. The benchmark is the firm's weighted-average cost of capital (WACC) — sustained ROIC above WACC creates value, sustained ROIC below WACC destroys it. The single most important profitability metric for long-term compounding.

The single best operations-quality metric. Negative CCC means the firm is funded by suppliers — the customer pays before the supplier needs to be paid (Apple, Costco, Amazon at scale). Long CCC ties up working capital and forces operating-loan dependence. Combines three sub-metrics: days inventory outstanding, days sales outstanding, days payable outstanding.

DuPont productivity measure. Combined with margin, it tells the asset-light vs. asset-heavy story: low turnover with high margin is the luxury / branded model, high turnover with thin margin is the supermarket / discount model. Very high turnover in retail can also flag stockouts (lost sales) — the metric reads best industry-relative, not absolute.

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.

The 14-period Relative Strength Index is the canonical Wilder momentum oscillator, bounded 0-100. Readings below 30 mark oversold conditions and above 70 mark overbought. This signal flags time spent at those extremes: bullish while RSI is at or below 30 (a mean-reversion bounce bias), bearish while it is at or above 70. The 30/70 thresholds are standard practice layered on top of the TA-Lib primitive.

+1 while RSI(14) is at or below the oversold threshold (default 30); -1 while it is at or above the overbought threshold (default 70); 0 in between.

+1 = oversold (bullish mean-reversion bias), -1 = overbought (bearish), 0 = RSI in its mid-range.