Perfected FlowScript
Adaptive Momentum Oscillator
Adaptive Momentum Oscillator — Perfected Edition is indexed as 239_adaptive_momentum_oscillator.flowscript. The exact FlowScript is viewable here; chart observe and trading automation use the current mmflow chart/recipe signal proxy until FlowScript v2 transpilation is available.
This exact FlowScript uses the v2 source dialect. It is viewable and connected to the chart/automation proxy, but direct editor execution needs the FlowScript v2 transpiler.
Dialect
flowscript-v2
Compatibility
flowscript-v2-needs-transpile
Position
offchart
Axis
true
Size
20.2 KB
Lines
582
Native Signal Candidates
7 source-level chart marker triggers extracted from guarded FlowScript v2 blocks.
Cross Up
line 472:9
Trigger
(showSignalShapes) && (crossUp)
Value
adaptMom
Deps
crossUp:var, showSignalShapes:input
Cross Down
line 482:9
Trigger
(showSignalShapes) && (crossDown)
Value
adaptMom
Deps
crossDown:var, showSignalShapes:input
OB Penetrate
line 492:9
Trigger
(showSignalShapes) && (obPenetrate)
Value
adaptMom
Deps
obPenetrate:var, showSignalShapes:input
OS Penetrate
line 502:9
Trigger
(showSignalShapes) && (osPenetrate)
Value
adaptMom
Deps
osPenetrate:var, showSignalShapes:input
Upper Band Cross
line 512:9
Trigger
(showSignalShapes) && (upperCross)
Value
adaptMom
Deps
showSignalShapes:input, upperCross:var
Lower Band Cross
line 522:9
Trigger
(showSignalShapes) && (lowerCross)
Value
adaptMom
Deps
lowerCross:var, showSignalShapes:input
Unlabeled shape
line 536:9
Trigger
(showSignalShapes) && (regimeChanged && barCount == regimeBar)
Value
adaptMom
Deps
barCount:static, regimeBar:static, regimeChanged:var, showSignalShapes:input
239_adaptive_momentum_oscillator.flowscript
source path: kscripts/perfected/239_adaptive_momentum_oscillator.flowscript · sha256:471fa8bcd357b16ddecb3d46e5907d6410ec2303204348d42dbf7b4ed4c1e2a4
//@version=2
// ============================================================================
// Adaptive Momentum Oscillator — Perfected Edition
// Author: BackQuant (@BackQuant) — Enhanced by kScript Perfection Engineer
// Tags: CORE, SPECIALIZED, #adaptive, #momentum, #kaufman, #vidya, #regime
//
// Production-grade Kaufman-style adaptive momentum oscillator with Efficiency
// Ratio (ER) driven adaptive smoothing, regime detection, color-coded histogram,
// and shape markers for signal events. Implements a 0-100 normalized momentum
// with dynamic thresholds that self-calibrate to current market conditions.
//
// Academic foundations:
// - Kaufman (1995), "Smarter Trading: Improving Performance in Changing Markets"
// (McGraw-Hill). Introduced the Kaufman Adaptive Moving Average (KAMA) and
// the Efficiency Ratio (ER): ER = |Price_t − Price_{t−n}| / Σ|Price_i − Price_{i−1}|.
// KAMA adjusts smoothing constant based on ER: SC = [ER × (fastest − slowest) +
// slowest]². The adaptive momentum in this script uses the same ER framework
// to vary responsiveness of the momentum calculation.
// - Chande & Kroll (1994), "The New Technical Trader" (Wiley). Introduced
// Variable Index Dynamic Average (VIDYA) and Chande Momentum Oscillator (CMO).
// VIDYA(i) = Price(i) × F × ABS[CMO(i)] + VIDYA(i−1) × {1 − F × ABS[CMO(i)]};
// adaptive smoothing via volatility index. The RMA of |osc − center| for band
// width in this script mirrors Chande's adaptive smoothing approach.
// - QuantOracle (2026), "Z-Score vs Bollinger Bands vs RSI: Which Mean Reversion
// Indicator Should You Use?" Advocates combining multiple normalized indicators
// for robust signals. The script's 0-100 normalization within rolling highs/lows,
// combined with dynamic band thresholds, is a composite approach similar to the
// multi-indicator stacks recommended in this analysis.
// - Poterba & Summers (1988), "Mean Reversion in Stock Prices: Evidence and
// Implications" (J. Financial Economics, 22(1), 27–59). Negative autocorrelation
// at medium horizons; supports dynamic overbought/oversold thresholds calibrated
// to rolling volatility, which this script implements via adaptive deviation bands.
// - Ponnusamy & Manual (2016), "A Study on Financial Indicators' Reliability in
// Technical Analysis" (European Academic Research). Found that no single
// indicator is fully reliable; combining adaptive smoothing with regime detection
// improves signal quality, as implemented here.
// ============================================================================
define(
title="Adaptive Momentum Oscillator — Perfected Edition",
position="offchart",
axis=true
)
// ------------------------------------------------------------------------------
// 1. USER INPUTS — grouped with constraints
// ------------------------------------------------------------------------------
// --- Efficiency Ratio ---
var erPeriod = input(
name="erPeriod",
type="number",
defaultValue=10,
label="Efficiency Ratio Period",
constraints={min: 2, max: 50, step: 1},
group="Efficiency Ratio"
)
// --- Adaptive Smoothing ---
var fastSC = input(
name="fastSC",
type="number",
defaultValue=0.6667,
label="Fastest Smoothing Constant (2/(N+1))",
constraints={min: 0.05, max: 1.0, step: 0.01},
group="Adaptive Smoothing"
)
var slowSC = input(
name="slowSC",
type="number",
defaultValue=0.0645,
label="Slowest Smoothing Constant (2/(N+1))",
constraints={min: 0.01, max: 0.5, step: 0.01},
group="Adaptive Smoothing"
)
// --- Momentum ---
var momLookback = input(
name="momLookback",
type="number",
defaultValue=14,
label="Momentum Lookback (change period)",
constraints={min: 2, max: 50, step: 1},
group="Momentum"
)
var normPeriod = input(
name="normPeriod",
type="number",
defaultValue=20,
label="Normalization Lookback (rolling H/L)",
constraints={min: 5, max: 100, step: 1},
group="Momentum"
)
// --- Dynamic Bands ---
var bandPeriod = input(
name="bandPeriod",
type="number",
defaultValue=14,
label="Band Adaptation Period",
constraints={min: 2, max: 50, step: 1},
group="Dynamic Bands"
)
var bandMult = input(
name="bandMult",
type="number",
defaultValue=1.5,
label="Band Width Multiplier (k)",
constraints={min: 0.5, max: 5.0, step: 0.1},
group="Dynamic Bands"
)
// --- Thresholds ---
var obLevel = input(
name="obLevel",
type="number",
defaultValue=70,
label="Static Overbought Level",
constraints={min: 50, max: 95, step: 1},
group="Thresholds"
)
var osLevel = input(
name="osLevel",
type="number",
defaultValue=30,
label="Static Oversold Level",
constraints={min: 5, max: 50, step: 1},
group="Thresholds"
)
var useDynamic = input(
name="useDynamic",
type="boolean",
defaultValue=true,
label="Dynamic Thresholds (volatility-adjusted)",
group="Thresholds"
)
// --- Display ---
var showOsc = input(
name="showOsc",
type="boolean",
defaultValue=true,
label="Show Oscillator Line",
group="Display"
)
var showBands = input(
name="showBands",
type="boolean",
defaultValue=true,
label="Show Dynamic Bands",
group="Display"
)
var showHistogram = input(
name="showHistogram",
type="boolean",
defaultValue=true,
label="Show Momentum Histogram",
group="Display"
)
var showBandFill = input(
name="showBandFill",
type="boolean",
defaultValue=true,
label="Show Band Fill (upper/lower)",
group="Display"
)
var showSignalShapes = input(
name="showSignalShapes",
type="boolean",
defaultValue=true,
label="Show Signal Shapes",
group="Display"
)
// --- Colors ---
var bullColor = input(
name="bullColor",
type="color",
defaultValue="#26a69a",
label="Bullish Color",
group="Colors"
)
var bearColor = input(
name="bearColor",
type="color",
defaultValue="#ef5350",
label="Bearish Color",
group="Colors"
)
var neutralColor = input(
name="neutralColor",
type="color",
defaultValue="#9e9e9e",
label="Neutral Color",
group="Colors"
)
var bullExtremeColor = input(
name="bullExtremeColor",
type="color",
defaultValue="#00e676",
label="Extreme Bullish Color",
group="Colors"
)
var bearExtremeColor = input(
name="bearExtremeColor",
type="color",
defaultValue="#ff5252",
label="Extreme Bearish Color",
group="Colors"
)
// ------------------------------------------------------------------------------
// 2. DATA SOURCES & NaN GUARD
// ------------------------------------------------------------------------------
timeseries ohlcvTS = ohlcv(symbol=currentSymbol, exchange=currentExchange)
timeseries close = ohlcvTS.close
timeseries high = ohlcvTS.high
timeseries low = ohlcvTS.low
// isnan guard on first use of external data — prevents NaN propagation on startup
if (isnan(close[0]) || isnan(high[0]) || isnan(low[0])) {
return
}
// ------------------------------------------------------------------------------
// 2.5 BAR COUNTER & STATIC REGIME TRACKING
// ------------------------------------------------------------------------------
static barCount = 0
if (!isLiveUpdate) {
barCount = barCount + 1
}
// Static regime state for regime-change detection
// Regime encoding: -2 = extreme bear, -1 = bear, 0 = neutral, 1 = bull, 2 = extreme bull
static prevRegime = 0
static regimeBar = 0
static barsInRegime = 0
// ------------------------------------------------------------------------------
// 3. EFFICIENCY RATIO (Kaufman 1995)
// ------------------------------------------------------------------------------
// ER = |Price_t − Price_{t−n}| / Σ_{i=1}^{n} |Price_i − Price_{i−1}|
// ER ranges from 0 (pure noise, no net change) to 1 (perfect trend, no noise).
// High ER → fast smoothing (responsive to trend).
// Low ER → slow smoothing (filters noise).
timeseries changeN = close - close[momLookback]
timeseries netChange = math.abs(changeN)
// Sum of absolute 1-bar changes over the lookback period
timeseries volSum = 0.0
for (i = 1; i <= momLookback; i = i + 1) {
volSum = volSum + math.abs(close - close[i])
}
// Efficiency Ratio with guard against division by zero
timeseries er = volSum > 0 ? netChange / volSum : 0.0
// Clamp ER to [0, 1]
er = er > 1.0 ? 1.0 : (er < 0.0 ? 0.0 : er)
// ------------------------------------------------------------------------------
// 4. ADAPTIVE SMOOTHING CONSTANT
// ------------------------------------------------------------------------------
// SC = [ER × (fastest − slowest) + slowest]²
// Per Kaufman (1995), the squared term ensures the smoothing constant
// stays within the desired range while responding non-linearly to ER.
timeseries scRaw = er * (fastSC - slowSC) + slowSC
timeseries sc = scRaw * scRaw
// ------------------------------------------------------------------------------
// 5. ADAPTIVE MOMENTUM OSCILLATOR
// ------------------------------------------------------------------------------
// Raw momentum = price change over momLookback, normalized to 0-100 range
// using rolling high/low over normPeriod. Then adaptively smoothed via EMA
// with variable smoothing constant derived from ER.
// Raw momentum
timeseries rawMom = close - close[momLookback]
// Rolling high/low of raw momentum for normalization
timeseries momHi = highest(source=rawMom, period=normPeriod)
timeseries momLo = lowest(source=rawMom, period=normPeriod)
timeseries momRange = momHi - momLo
// 0-100 normalized momentum
timeseries normMom = momRange > 0 ? 100.0 * (rawMom - momLo) / momRange : 50.0
// Adaptive smoothing: EMA with SC as the effective smoothing factor.
// We approximate adaptive EMA by using an EMA whose period is derived from SC.
// Period = 2/SC - 1 (Wilder relationship).
timeseries adaptPeriod = sc > 0 ? (2.0 / sc - 1.0) : 100.0
adaptPeriod = adaptPeriod < 2.0 ? 2.0 : (adaptPeriod > 100.0 ? 100.0 : adaptPeriod)
timeseries adaptMom = ema(source=normMom, period=adaptPeriod)
// Fallback to simple EMA if adaptive produces NaN
if (isnan(adaptMom)) {
adaptMom = ema(source=normMom, period=14)
}
// ------------------------------------------------------------------------------
// 6. DYNAMIC BANDS (Chande-style VIDYA adaptation)
// ------------------------------------------------------------------------------
// Center = drifting EMA of oscillator
// Deviation = EMA of |osc - center| (robust deviation)
// Upper = center + k·dev; Lower = center - k·dev
timeseries center = ema(source=adaptMom, period=bandPeriod)
timeseries absDev = math.abs(adaptMom - center)
timeseries dev = ema(source=absDev, period=bandPeriod)
timeseries upper = center + bandMult * dev
timeseries lower = center - bandMult * dev
// Clamp bands to [0, 100] for a 0-100 oscillator
upper = upper > 100.0 ? 100.0 : (upper < 0.0 ? 0.0 : upper)
lower = lower > 100.0 ? 100.0 : (lower < 0.0 ? 0.0 : lower)
center = center > 100.0 ? 100.0 : (center < 0.0 ? 0.0 : center)
// ------------------------------------------------------------------------------
// 7. DYNAMIC THRESHOLDS (Poterba & Summers 1988)
// ------------------------------------------------------------------------------
// Adjust OB/OS bands by rolling oscillator standard deviation.
timeseries oscVol = stddev(source=adaptMom, period=bandPeriod)
timeseries dynOb = useDynamic ? math.min(95.0, obLevel + oscVol) : obLevel
timeseries dynOs = useDynamic ? math.max(5.0, osLevel - oscVol) : osLevel
// Guard: ensure dynamic bands never cross
if (dynOb <= dynOs) {
dynOb = 70.0
dynOs = 30.0
}
// ------------------------------------------------------------------------------
// 8. REGIME DETECTION (with static state tracking)
// ------------------------------------------------------------------------------
// Regime classification:
// Extreme Bull: osc > upper AND osc > dynOb
// Bullish: osc > center AND osc > 50
// Neutral: between lower and upper, or near center
// Bearish: osc < center AND osc < 50
// Extreme Bear: osc < lower AND osc < dynOs
var regimeExtremeBull = adaptMom > upper && adaptMom > dynOb
var regimeBull = adaptMom > center && adaptMom > 50.0 && !regimeExtremeBull
var regimeExtremeBear = adaptMom < lower && adaptMom < dynOs
var regimeBear = adaptMom < center && adaptMom < 50.0 && !regimeExtremeBear
var regimeNeutral = !regimeExtremeBull && !regimeBull && !regimeExtremeBear && !regimeBear
// Current regime encoding
var currentRegime = regimeExtremeBull ? 2 : (regimeBull ? 1 : (regimeExtremeBear ? -2 : (regimeBear ? -1 : 0)))
// Update static regime state on bar close
var regimeChanged = false
if (!isLiveUpdate) {
if (currentRegime != prevRegime) {
regimeChanged = true
regimeBar = barCount
barsInRegime = 0
} else {
barsInRegime = barsInRegime + 1
}
prevRegime = currentRegime
}
var regimeColor = regimeExtremeBull ? bullExtremeColor : (regimeBull ? bullColor : (regimeExtremeBear ? bearExtremeColor : (regimeBear ? bearColor : neutralColor)))
// ------------------------------------------------------------------------------
// 9. SIGNAL CONDITIONS
// ------------------------------------------------------------------------------
// Crossover / crossunder of oscillator and center line
var crossUp = adaptMom > center && adaptMom[1] <= center[1]
var crossDown = adaptMom < center && adaptMom[1] >= center[1]
// OB / OS penetrations
var obPenetrate = adaptMom > dynOb && adaptMom[1] <= dynOb[1]
var osPenetrate = adaptMom < dynOs && adaptMom[1] >= dynOs[1]
// OB / OS exit
var obExit = adaptMom < dynOb && adaptMom[1] >= dynOb[1]
var osExit = adaptMom > dynOs && adaptMom[1] <= dynOs[1]
// Extreme band crosses
var upperCross = adaptMom > upper && adaptMom[1] <= upper[1]
var lowerCross = adaptMom < lower && adaptMom[1] >= lower[1]
// Momentum histogram (oscillator minus center)
timeseries hist = adaptMom - center
// ------------------------------------------------------------------------------
// 10. PLOTTING
// ------------------------------------------------------------------------------
// --- Midline ---
hline(value=50.0, color="#ffffff20", width=1)
// --- OB / OS Zones ---
if (showBands) {
hline(value=dynOb, color=transparency(bearColor, 60), width=1)
hline(value=dynOs, color=transparency(bullColor, 60), width=1)
}
// --- Band Fill ---
if (showBandFill && showBands) {
var bandBull = adaptMom > center
plotLine(
value=[upper, lower],
width=1,
colors=[transparency(bullColor, 15), transparency(bearColor, 15)],
colorIndex=bandBull ? 0 : 1,
fill=true,
label=["Upper Band", "Lower Band"],
desc=["Dynamic upper band: center + k·dev (Chande-style)", "Dynamic lower band: center - k·dev"]
)
}
// --- Dynamic Bands ---
if (showBands) {
plotLine(
value=upper,
width=1,
colors=[transparency(bullExtremeColor, 50)],
label=["Upper Band"],
desc=["Dynamic upper threshold: center + " + bandMult + " × deviation. Adaptive to volatility."]
)
plotLine(
value=center,
width=1,
colors=[transparency(neutralColor, 50)],
label=["Center"],
desc=["Drifting center (EMA of adaptive oscillator). Baseline for regime detection."]
)
plotLine(
value=lower,
width=1,
colors=[transparency(bearExtremeColor, 50)],
label=["Lower Band"],
desc=["Dynamic lower threshold: center - " + bandMult + " × deviation. Adaptive to volatility."]
)
}
// --- Adaptive Momentum Oscillator (regime-colored) ---
if (showOsc) {
plotLine(
value=adaptMom,
width=2,
colors=[regimeColor],
label=["Adaptive Momentum"],
desc=["Kaufman-style adaptive momentum (0-100). ER=" + er + ", SC=" + sc + ", Period=" + adaptPeriod]
)
}
// --- Momentum Histogram ---
if (showHistogram) {
var histBull = hist >= 0.0
var histColor = histBull ? bullColor : bearColor
plotBar(
value=hist,
colors=[transparency(histColor, 60)],
width=1,
label=["Momentum Hist"],
desc=["Histogram of adaptive momentum minus center. Positive = bullish momentum; negative = bearish."]
)
}
// --- Signal Shapes ---
if (showSignalShapes) {
if (crossUp) {
plotShape(
value=adaptMom,
shape="triangleup",
colorIndex=bullColor,
width=3,
label=["Cross Up"],
desc=["Adaptive momentum crossed above center. Bullish regime shift signal."]
)
}
if (crossDown) {
plotShape(
value=adaptMom,
shape="triangledown",
colorIndex=bearColor,
width=3,
label=["Cross Down"],
desc=["Adaptive momentum crossed below center. Bearish regime shift signal."]
)
}
if (obPenetrate) {
plotShape(
value=adaptMom,
shape="xcross",
colorIndex=bearExtremeColor,
width=2,
label=["OB Penetrate"],
desc=["Adaptive momentum entered overbought zone (>" + dynOb + "). Potential exhaustion signal."]
)
}
if (osPenetrate) {
plotShape(
value=adaptMom,
shape="xcross",
colorIndex=bullExtremeColor,
width=2,
label=["OS Penetrate"],
desc=["Adaptive momentum entered oversold zone (<" + dynOs + "). Potential accumulation signal."]
)
}
if (upperCross) {
plotShape(
value=adaptMom,
shape="circle",
colorIndex=bullExtremeColor,
width=2,
label=["Upper Band Cross"],
desc=["Adaptive momentum crossed above dynamic upper band. Extreme bullish momentum."]
)
}
if (lowerCross) {
plotShape(
value=adaptMom,
shape="circle",
colorIndex=bearExtremeColor,
width=2,
label=["Lower Band Cross"],
desc=["Adaptive momentum crossed below dynamic lower band. Extreme bearish momentum."]
)
}
// Regime change marker: emitted when the 5-state regime shifts
if (regimeChanged && barCount == regimeBar) {
var rcShape = currentRegime > 0 ? "triangleup" : (currentRegime < 0 ? "triangledown" : "diamond")
var rcColor = currentRegime > 0 ? bullExtremeColor : (currentRegime < 0 ? bearExtremeColor : neutralColor)
var rcLabel = currentRegime == 2 ? "Extreme Bull Regime" : (currentRegime == 1 ? "Bull Regime" : (currentRegime == -1 ? "Bear Regime" : (currentRegime == -2 ? "Extreme Bear Regime" : "Neutral Regime")))
plotShape(
value=adaptMom,
shape=rcShape,
colorIndex=rcColor,
width=4,
label=[rcLabel],
desc=["Regime change detected. New regime: " + rcLabel + ". Bars in previous regime: " + barsInRegime]
)
}
}
// ------------------------------------------------------------------------------
// 11. REGIME TABLE (last bar only)
// ------------------------------------------------------------------------------
if (isLastBar) {
var regimeText = regimeExtremeBull ? "EXTREME BULL" : (regimeBull ? "BULLISH" : (regimeExtremeBear ? "EXTREME BEAR" : (regimeBear ? "BEARISH" : "NEUTRAL")))
var regimeTextColor = regimeExtremeBull ? bullExtremeColor : (regimeBull ? bullColor : (regimeExtremeBear ? bearExtremeColor : (regimeBear ? bearColor : neutralColor)))
var obText = useDynamic ? "Dynamic OB: " + dynOb : "Static OB: " + obLevel
var osText = useDynamic ? "Dynamic OS: " + dynOs : "Static OS: " + osLevel
plotTable(
data=[
["Adaptive Momentum • Perfected", regimeText],
["Oscillator", adaptMom[0]],
["Efficiency Ratio", er[0]],
["Smoothing Constant", sc[0]],
["Center", center[0]],
["Upper Band", upper[0]],
["Lower Band", lower[0]],
["Momentum", hist[0]],
["Bars in Regime", barsInRegime],
[obText, osText]
],
position="top_right",
headerRow=true,
headerColumn=true,
textColor="#e2e8f0",
headerTextColor="#ffffff",
backgroundColor=transparency("#0f172a", 40),
headerBackgroundColor=transparency("#1e293b", 40),
borderColor=transparency("#334155", 40),
borderWidth=1,
fontSize=10,
cellPadding=4
)
}