MM Flow
FlowScripts

Perfected FlowScript

Multi EMA

Multi EMA — Perfected Edition is indexed as 081_multi_ema.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

onchart

Axis

false

Size

17.4 KB

Lines

410

Native Signal Candidates

4 source-level chart marker triggers extracted from guarded FlowScript v2 blocks.

4/4 guarded

Fast Cross Up

line 335:9

Trigger

(showCrosses) && (ema1CrossUp)

Value

ema1

Deps

ema1CrossUp:var, showCrosses:input

Fast Cross Down

line 345:9

Trigger

(showCrosses) && (ema1CrossDown)

Value

ema1

Deps

ema1CrossDown:var, showCrosses:input

Golden Cross

line 358:9

Trigger

(showGoldenDeath) && (goldenCross)

Value

ema3

Deps

goldenCross:var, showGoldenDeath:input

Death Cross

line 368:9

Trigger

(showGoldenDeath) && (deathCross)

Value

ema3

Deps

deathCross:var, showGoldenDeath:input

081_multi_ema.flowscript

source path: kscripts/perfected/081_multi_ema.flowscript · sha256:a890340144f10344b6701f511f5a8012879a767b49033f1e7d77b50687a8b10a

hash verified
//@version=2

// ============================================================================
// Multi EMA — Perfected Edition
// Author: BackQuant (@BackQuant) | Enhanced by kScript_Perfection_Engineer
// Tags: CORE, FLOW, #ema, #ribbon, #trend, #regime, #crossover
//
// Production-grade multi-EMA ribbon indicator plotting up to 8 exponential
// moving averages with user-configurable lengths, ribbon fill between adjacent
// EMAs, color-coded regime detection (trend alignment / compression), shape
// markers for crossovers, and stateful regime tracking for contextual alerts.
//
// Research papers underpinning this design:
//  1. Manasa & Reddy (2025), "Trend Analysis by Weighted and Exponential
//     Moving Average": EMA offers more stability than WMA but occasionally
//     lags in signaling trend reversals. Multi-EMA ribbon approach leverages
//     multiple lookbacks for robust trend structure analysis.
//     [Formula] EMA = Price × k + EMA(previous) × (1 − k), where k = 2/(N+1).
//
//  2. Khand et al. (2019), "The Performance of EMA, MACD, RSI and Momentum
//     Trading Rules": EMA variants showed substantial prognostic capability
//     and remained profitable after transaction costs.
//
//  3. Brock, Lakonishok & LeBaron (1992), "Simple Technical Trading Rules and
//     the Stochastic Properties of Stock Returns": moving average rules have
//     significant predictive power; crossovers flag regime shifts.
//
//  4. Guppy (1990s–2000s), "Guppy Multiple Moving Average (GMMA)": short-term
//     cluster (3–15) = trader sentiment; long-term cluster (30–60) = investor
//     behavior; ribbon separation = trend quality; compression = transition.
//
//  5. Hurst, Ooi & Pedersen (2014), "A Century of Evidence on Trend-Following
//     Investing": time-series momentum profitable since 1880 across global
//     markets; multi-EMA alignment captures trend participation.
//
//  6. Zakamulin (2023), "Optimal Trend-Following with Transaction Costs":
//     mathematical justification for MA-based trend-following rules;
//     crossover signals as optimal stopping boundaries.
// ============================================================================

define(title="Multi EMA — Perfected Edition", position="onchart", axis=false)

// ---------------------------------------------------------------------------
// 1. USER INPUTS — grouped with constraints
// ---------------------------------------------------------------------------

// --- EMA Lengths ---
var len1 = input(name="len1", type="number", defaultValue=9, label="EMA 1 Length", constraints={min: 2, max: 500, step: 1}, group="EMA Lengths")
var len2 = input(name="len2", type="number", defaultValue=21, label="EMA 2 Length", constraints={min: 2, max: 500, step: 1}, group="EMA Lengths")
var len3 = input(name="len3", type="number", defaultValue=55, label="EMA 3 Length", constraints={min: 2, max: 500, step: 1}, group="EMA Lengths")
var len4 = input(name="len4", type="number", defaultValue=100, label="EMA 4 Length", constraints={min: 2, max: 500, step: 1}, group="EMA Lengths")
var len5 = input(name="len5", type="number", defaultValue=144, label="EMA 5 Length", constraints={min: 2, max: 500, step: 1}, group="EMA Lengths")
var len6 = input(name="len6", type="number", defaultValue=200, label="EMA 6 Length", constraints={min: 2, max: 500, step: 1}, group="EMA Lengths")
var len7 = input(name="len7", type="number", defaultValue=300, label="EMA 7 Length", constraints={min: 2, max: 500, step: 1}, group="EMA Lengths")
var len8 = input(name="len8", type="number", defaultValue=400, label="EMA 8 Length", constraints={min: 2, max: 500, step: 1}, group="EMA Lengths")

// --- Visibility ---
var use1 = input(name="use1", type="boolean", defaultValue=true, label="Show EMA 1", group="Visibility")
var use2 = input(name="use2", type="boolean", defaultValue=true, label="Show EMA 2", group="Visibility")
var use3 = input(name="use3", type="boolean", defaultValue=true, label="Show EMA 3", group="Visibility")
var use4 = input(name="use4", type="boolean", defaultValue=true, label="Show EMA 4", group="Visibility")
var use5 = input(name="use5", type="boolean", defaultValue=true, label="Show EMA 5", group="Visibility")
var use6 = input(name="use6", type="boolean", defaultValue=true, label="Show EMA 6", group="Visibility")
var use7 = input(name="use7", type="boolean", defaultValue=false, label="Show EMA 7", group="Visibility")
var use8 = input(name="use8", type="boolean", defaultValue=false, label="Show EMA 8", group="Visibility")

// --- Ribbon ---
var showRibbon = input(name="showRibbon", type="boolean", defaultValue=true, label="Show Ribbon Fill", group="Ribbon")
var ribbonOpacity = input(name="ribbonOpacity", type="number", defaultValue=15, label="Ribbon Fill Opacity", constraints={min: 0, max: 80, step: 5}, group="Ribbon")

// --- Crossovers ---
var showCrosses = input(name="showCrosses", type="boolean", defaultValue=true, label="Show Crossover Shapes", group="Crossovers")
var showGoldenDeath = input(name="showGoldenDeath", type="boolean", defaultValue=true, label="Show Golden/Death Cross", group="Crossovers")

// --- Colors ---
var bullColor = input(name="bullColor", type="color", defaultValue="#26a69a", label="Bull Color", group="Colors")
var bearColor = input(name="bearColor", type="color", defaultValue="#ef5350", label="Bear Color", group="Colors")
var neutralColor = input(name="neutralColor", type="color", defaultValue="#78909c", label="Neutral Color", group="Colors")

// ---------------------------------------------------------------------------
// 2. DATA SOURCES & NaN GUARD
// ---------------------------------------------------------------------------

timeseries ohlcvData = ohlcv(symbol=currentSymbol, exchange=currentExchange)
timeseries src = ohlcvData.close

if (isnan(src[0])) {
    return
}

// ---------------------------------------------------------------------------
// 3. EMA COMPUTATION
// ---------------------------------------------------------------------------

timeseries ema1 = ema(source=src, period=len1)
timeseries ema2 = ema(source=src, period=len2)
timeseries ema3 = ema(source=src, period=len3)
timeseries ema4 = ema(source=src, period=len4)
timeseries ema5 = ema(source=src, period=len5)
timeseries ema6 = ema(source=src, period=len6)
timeseries ema7 = ema(source=src, period=len7)
timeseries ema8 = ema(source=src, period=len8)

// ---------------------------------------------------------------------------
// 4. REGIME DETECTION
// ---------------------------------------------------------------------------
// Trend alignment: all visible EMAs stacked in same direction = strong trend.
// Compression: max spread between visible EMAs below threshold = neutral/chop.

var active1 = use1 && !isnan(ema1[0])
var active2 = use2 && !isnan(ema2[0])
var active3 = use3 && !isnan(ema3[0])
var active4 = use4 && !isnan(ema4[0])
var active5 = use5 && !isnan(ema5[0])
var active6 = use6 && !isnan(ema6[0])
var active7 = use7 && !isnan(ema7[0])
var active8 = use8 && !isnan(ema8[0])

// Stack detection: price above all EMAs = bullish stack; below all = bearish stack
var aboveAll = (active1 ? src > ema1 : true) && (active2 ? src > ema2 : true) && (active3 ? src > ema3 : true) && (active4 ? src > ema4 : true) && (active5 ? src > ema5 : true) && (active6 ? src > ema6 : true) && (active7 ? src > ema7 : true) && (active8 ? src > ema8 : true)

var belowAll = (active1 ? src < ema1 : true) && (active2 ? src < ema2 : true) && (active3 ? src < ema3 : true) && (active4 ? src < ema4 : true) && (active5 ? src < ema5 : true) && (active6 ? src < ema6 : true) && (active7 ? src < ema7 : true) && (active8 ? src < ema8 : true)

// Short-term vs long-term alignment (EMA1 and EMA2 are short; EMA5-EMA8 are long)
var shortTermBull = ema1 > ema2 && ema2 > ema3
var shortTermBear = ema1 < ema2 && ema2 < ema3
var longTermBull = ema4 > ema5 && ema5 > ema6
var longTermBear = ema4 < ema5 && ema5 < ema6

// Overall regime
var regimeBull = shortTermBull && longTermBull
var regimeBear = shortTermBear && longTermBear
var regimeNeutral = !regimeBull && !regimeBear

var regimeColor = regimeBull ? bullColor : (regimeBear ? bearColor : neutralColor)

// ---------------------------------------------------------------------------
// 5. STATIC STATE TRACKING
// ---------------------------------------------------------------------------
// Tracks last crossover, regime duration, and alignment quality for context.

static lastRegime = 0
static regimeBullBars = 0
static regimeBearBars = 0
static regimeNeutralBars = 0
static lastCrossType = 0  // 1 = golden, -1 = death, 0 = none
static lastCrossPrice = 0.0

if (regimeBull) {
    regimeBullBars = regimeBullBars + 1
    regimeBearBars = 0
    regimeNeutralBars = 0
    lastRegime = 1
} else if (regimeBear) {
    regimeBearBars = regimeBearBars + 1
    regimeBullBars = 0
    regimeNeutralBars = 0
    lastRegime = -1
} else {
    regimeNeutralBars = regimeNeutralBars + 1
    regimeBullBars = 0
    regimeBearBars = 0
    if (regimeNeutralBars > 10) {
        lastRegime = 0
    }
}

// ---------------------------------------------------------------------------
// 6. CROSSOVER DETECTION
// ---------------------------------------------------------------------------
// Detect EMA crossovers for shape markers and regime-shift alerts.

// Fast vs Slow cross (EMA1 vs EMA2)
var ema1CrossUp = ema1 > ema2 && ema1[1] <= ema2[1]
var ema1CrossDown = ema1 < ema2 && ema1[1] >= ema2[1]

// Golden Cross: EMA3 crosses above EMA5 (short-term momentum vs long-term)
var goldenCross = ema3 > ema5 && ema3[1] <= ema5[1]
var deathCross = ema3 < ema5 && ema3[1] >= ema5[1]

// Update static cross tracking
if (goldenCross) {
    lastCrossType = 1
    lastCrossPrice = src[0]
}
if (deathCross) {
    lastCrossType = -1
    lastCrossPrice = src[0]
}

// ---------------------------------------------------------------------------
// 7. PLOTTING — EMA Lines
// ---------------------------------------------------------------------------

// Helper: color by slope (rising = bull, falling = bear)
var ema1Color = ema1 > ema1[1] ? bullColor : (ema1 < ema1[1] ? bearColor : neutralColor)
var ema2Color = ema2 > ema2[1] ? bullColor : (ema2 < ema2[1] ? bearColor : neutralColor)
var ema3Color = ema3 > ema3[1] ? bullColor : (ema3 < ema3[1] ? bearColor : neutralColor)
var ema4Color = ema4 > ema4[1] ? bullColor : (ema4 < ema4[1] ? bearColor : neutralColor)
var ema5Color = ema5 > ema5[1] ? bullColor : (ema5 < ema5[1] ? bearColor : neutralColor)
var ema6Color = ema6 > ema6[1] ? bullColor : (ema6 < ema6[1] ? bearColor : neutralColor)
var ema7Color = ema7 > ema7[1] ? bullColor : (ema7 < ema7[1] ? bearColor : neutralColor)
var ema8Color = ema8 > ema8[1] ? bullColor : (ema8 < ema8[1] ? bearColor : neutralColor)

if (use1) {
    plotLine(value=ema1, width=1, colors=[ema1Color], label=["EMA 1"], desc=[("EMA length " + len1)])
}
if (use2) {
    plotLine(value=ema2, width=1, colors=[ema2Color], label=["EMA 2"], desc=[("EMA length " + len2)])
}
if (use3) {
    plotLine(value=ema3, width=2, colors=[ema3Color], label=["EMA 3"], desc=[("EMA length " + len3)])
}
if (use4) {
    plotLine(value=ema4, width=1, colors=[ema4Color], label=["EMA 4"], desc=[("EMA length " + len4)])
}
if (use5) {
    plotLine(value=ema5, width=1, colors=[ema5Color], label=["EMA 5"], desc=[("EMA length " + len5)])
}
if (use6) {
    plotLine(value=ema6, width=2, colors=[ema6Color], label=["EMA 6"], desc=[("EMA length " + len6)])
}
if (use7) {
    plotLine(value=ema7, width=1, colors=[ema7Color], label=["EMA 7"], desc=[("EMA length " + len7)])
}
if (use8) {
    plotLine(value=ema8, width=1, colors=[ema8Color], label=["EMA 8"], desc=[("EMA length " + len8)])
}

// ---------------------------------------------------------------------------
// 8. RIBBON FILL BETWEEN EMAs
// ---------------------------------------------------------------------------
// Fill between adjacent EMAs with regime color; wider gaps = stronger trend.

if (showRibbon) {
    // EMA1-EMA2 fill
    if (use1 && use2) {
        var ribbon12Bull = ema1 > ema2
        plotLine(
            value=[ema1, ema2],
            width=1,
            colors=[transparency(bullColor, ribbonOpacity), transparency(bearColor, ribbonOpacity)],
            colorIndex=ribbon12Bull ? 0 : 1,
            fill=true,
            label=["Ribbon 1-2"],
            desc=["Fill between EMA 1 and EMA 2"]
        )
    }
    // EMA2-EMA3 fill
    if (use2 && use3) {
        var ribbon23Bull = ema2 > ema3
        plotLine(
            value=[ema2, ema3],
            width=1,
            colors=[transparency(bullColor, ribbonOpacity), transparency(bearColor, ribbonOpacity)],
            colorIndex=ribbon23Bull ? 0 : 1,
            fill=true,
            label=["Ribbon 2-3"],
            desc=["Fill between EMA 2 and EMA 3"]
        )
    }
    // EMA3-EMA4 fill
    if (use3 && use4) {
        var ribbon34Bull = ema3 > ema4
        plotLine(
            value=[ema3, ema4],
            width=1,
            colors=[transparency(bullColor, ribbonOpacity), transparency(bearColor, ribbonOpacity)],
            colorIndex=ribbon34Bull ? 0 : 1,
            fill=true,
            label=["Ribbon 3-4"],
            desc=["Fill between EMA 3 and EMA 4"]
        )
    }
    // EMA4-EMA5 fill
    if (use4 && use5) {
        var ribbon45Bull = ema4 > ema5
        plotLine(
            value=[ema4, ema5],
            width=1,
            colors=[transparency(bullColor, ribbonOpacity), transparency(bearColor, ribbonOpacity)],
            colorIndex=ribbon45Bull ? 0 : 1,
            fill=true,
            label=["Ribbon 4-5"],
            desc=["Fill between EMA 4 and EMA 5"]
        )
    }
    // EMA5-EMA6 fill
    if (use5 && use6) {
        var ribbon56Bull = ema5 > ema6
        plotLine(
            value=[ema5, ema6],
            width=1,
            colors=[transparency(bullColor, ribbonOpacity), transparency(bearColor, ribbonOpacity)],
            colorIndex=ribbon56Bull ? 0 : 1,
            fill=true,
            label=["Ribbon 5-6"],
            desc=["Fill between EMA 5 and EMA 6"]
        )
    }
    // EMA6-EMA7 fill
    if (use6 && use7) {
        var ribbon67Bull = ema6 > ema7
        plotLine(
            value=[ema6, ema7],
            width=1,
            colors=[transparency(bullColor, ribbonOpacity), transparency(bearColor, ribbonOpacity)],
            colorIndex=ribbon67Bull ? 0 : 1,
            fill=true,
            label=["Ribbon 6-7"],
            desc=["Fill between EMA 6 and EMA 7"]
        )
    }
    // EMA7-EMA8 fill
    if (use7 && use8) {
        var ribbon78Bull = ema7 > ema8
        plotLine(
            value=[ema7, ema8],
            width=1,
            colors=[transparency(bullColor, ribbonOpacity), transparency(bearColor, ribbonOpacity)],
            colorIndex=ribbon78Bull ? 0 : 1,
            fill=true,
            label=["Ribbon 7-8"],
            desc=["Fill between EMA 7 and EMA 8"]
        )
    }
}

// ---------------------------------------------------------------------------
// 9. SHAPE MARKERS FOR CROSSOVERS
// ---------------------------------------------------------------------------

if (showCrosses) {
    if (ema1CrossUp) {
        plotShape(
            value=ema1,
            shape="triangleup",
            colorIndex=bullColor,
            width=2,
            label=["Fast Cross Up"],
            desc=["EMA 1 crossed above EMA 2 — short-term momentum shift bullish"]
        )
    }
    if (ema1CrossDown) {
        plotShape(
            value=ema1,
            shape="triangledown",
            colorIndex=bearColor,
            width=2,
            label=["Fast Cross Down"],
            desc=["EMA 1 crossed below EMA 2 — short-term momentum shift bearish"]
        )
    }
}

if (showGoldenDeath) {
    if (goldenCross) {
        plotShape(
            value=ema3,
            shape="circle",
            colorIndex=bullColor,
            width=3,
            label=["Golden Cross"],
            desc=["Golden Cross: EMA 3 crossed above EMA 5 — trend regime shift bullish"]
        )
    }
    if (deathCross) {
        plotShape(
            value=ema3,
            shape="circle",
            colorIndex=bearColor,
            width=3,
            label=["Death Cross"],
            desc=["Death Cross: EMA 3 crossed below EMA 5 — trend regime shift bearish"]
        )
    }
}

// ---------------------------------------------------------------------------
// 10. REGIME TABLE (last bar only)
// ---------------------------------------------------------------------------
if (isLastBar) {
    var regimeText = regimeBull ? "BULLISH" : (regimeBear ? "BEARISH" : "NEUTRAL")
    var regimeTextColor = regimeBull ? bullColor : (regimeBear ? bearColor : neutralColor)
    var crossText = lastCrossType > 0 ? "Golden Cross" : (lastCrossType < 0 ? "Death Cross" : "None")
    var alignmentText = aboveAll ? "Above All" : (belowAll ? "Below All" : "Mixed")

    plotTable(
        data=[
            ["Multi EMA Pro", regimeText],
            ["Price vs EMAs", alignmentText],
            ["Short Trend", shortTermBull ? "UP" : (shortTermBear ? "DOWN" : "CHOP")],
            ["Long Trend", longTermBull ? "UP" : (longTermBear ? "DOWN" : "CHOP")],
            ["Regime Bars", lastRegime > 0 ? regimeBullBars : (lastRegime < 0 ? regimeBearBars : regimeNeutralBars)],
            ["Last Cross", crossText]
        ],
        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
    )
}