MM Flow
FlowScripts

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.

7/7 guarded

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

hash verified
//@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
    )
}