MM Flow
FlowScripts

Perfected FlowScript

Moving Average Convergence Divergence (MACD)

Moving Average Convergence Divergence (MACD) — Perfected Edition is indexed as 046_moving_average_convergence_divergence_macd.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

15.9 KB

Lines

531

Native Signal Candidates

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

10/10 guarded

Sig Cross Up

line 395:9

Trigger

(showShapes) && (sigCrossUp)

Value

sigLine

Deps

showShapes:input, sigCrossUp:var

Sig Cross Down

line 405:9

Trigger

(showShapes) && (sigCrossDown)

Value

sigLine

Deps

showShapes:input, sigCrossDown:var

Zero Cross Up

line 415:9

Trigger

(showShapes) && (zeroCrossUp)

Value

0

Deps

showShapes:input, zeroCrossUp:var

Zero Cross Down

line 425:9

Trigger

(showShapes) && (zeroCrossDown)

Value

0

Deps

showShapes:input, zeroCrossDown:var

Upper Extreme

line 435:9

Trigger

(showShapes) && (upperPenetrate)

Value

dynUpper

Deps

showShapes:input, upperPenetrate:var

Lower Extreme

line 445:9

Trigger

(showShapes) && (lowerPenetrate)

Value

dynLower

Deps

lowerPenetrate:var, showShapes:input

Bull Div

line 459:9

Trigger

(showDivShapes && enableDiv) && (bullDiv)

Value

macdLine

Deps

bullDiv:var, enableDiv:input, showDivShapes:input

Bear Div

line 469:9

Trigger

(showDivShapes && enableDiv) && (bearDiv)

Value

macdLine

Deps

bearDiv:var, enableDiv:input, showDivShapes:input

Hidden Bull

line 479:9

Trigger

(showDivShapes && enableDiv) && (showHidden && hiddenBullDiv)

Value

macdLine

Deps

enableDiv:input, hiddenBullDiv:var, showDivShapes:input, showHidden:input

Hidden Bear

line 489:9

Trigger

(showDivShapes && enableDiv) && (showHidden && hiddenBearDiv)

Value

macdLine

Deps

enableDiv:input, hiddenBearDiv:var, showDivShapes:input, showHidden:input

046_moving_average_convergence_divergence_macd.flowscript

source path: kscripts/perfected/046_moving_average_convergence_divergence_macd.flowscript · sha256:dfa31e559eacf0b1d300801c17023abd0d7e4e4f7f85d20d5914cf1ba14e8d6f

hash verified
//@version=2
// ============================================================================
// Moving Average Convergence Divergence (MACD) — Perfected Edition
// Author: BackQuant (@BackQuant) | Enhanced by kScript_Perfection_Engineer
// Tags: CORE, #macd, #divergence, #momentum, #trend, #regime
//
// Production-quality canonical MACD with configurable periods, histogram color
// coding by growth/shrink, full stateful divergence detection, dynamic
// thresholds, fill visualization, shape markers for zero-line and signal
// crossovers, and comprehensive academic grounding.
//
// Research papers underpinning this design:
//  1. Porselvi R. & Dr. Meenakshi A. (2024), "A Study On The Effectiveness Of
//     Moving Average Convergence And Divergence (MACD)". Documents Gerald
//     Appel's original formulation and validates Centreline vs. Signal Line
//     Crossover strategies.
//     Formula: MACD = EMA(12) − EMA(26); Signal = EMA(9) of MACD;
//     Histogram = MACD − Signal.
//  2. Hutabarat, Sadalia & Irawati (2025), "Technical Analysis of MACD,
//     Stochastic Oscillator, RSI, and Money Flow Index". Found MACD the only
//     statistically effective indicator (89% accuracy) on IDX30 during the
//     2024 election period.
//  3. Brock, Lakonishok & LeBaron (1992), "Simple Technical Trading Rules and
//     the Stochastic Properties of Stock Returns". Seminal 90-year DJIA study
//     validating moving-average crossover rules as significantly outperforming
//     buy-and-hold benchmarks.
//  4. Manasa & Reddy (2025), "Trend Analysis by Weighted and Exponential
//     Moving Average". Comparative study showing EMA outperforms SMA in
//     responsiveness for trend-momentum signals; supports the script's default
//     EMA construction with optional SMA signal toggle.
// ============================================================================

define(
    title="Moving Average Convergence Divergence (MACD) — Perfected Edition",
    position="offchart",
    axis=true
)

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

// --- MACD Settings ---
var fastLen = input(
    name="fastLen",
    type="number",
    defaultValue=12,
    label="Fast EMA Length",
    constraints={min: 2, max: 50, step: 1},
    group="MACD Settings"
)
var slowLen = input(
    name="slowLen",
    type="number",
    defaultValue=26,
    label="Slow EMA Length",
    constraints={min: 2, max: 100, step: 1},
    group="MACD Settings"
)
var sigLen = input(
    name="sigLen",
    type="number",
    defaultValue=9,
    label="Signal Length",
    constraints={min: 2, max: 50, step: 1},
    group="MACD Settings"
)
var useSignalSma = input(
    name="useSignalSma",
    type="boolean",
    defaultValue=false,
    label="Signal = SMA (off = EMA)",
    group="MACD Settings"
)

// --- Divergence ---
var enableDiv = input(
    name="enableDiv",
    type="boolean",
    defaultValue=true,
    label="Enable Divergence Detection",
    group="Divergence"
)
var divLookback = input(
    name="divLookback",
    type="number",
    defaultValue=10,
    label="Divergence Lookback (pivot bars)",
    constraints={min: 5, max: 50, step: 1},
    group="Divergence"
)
var showHidden = input(
    name="showHidden",
    type="boolean",
    defaultValue=true,
    label="Show Hidden Divergence",
    group="Divergence"
)

// --- Thresholds ---
var useDynamic = input(
    name="useDynamic",
    type="boolean",
    defaultValue=false,
    label="Dynamic Thresholds (volatility-adjusted)",
    group="Thresholds"
)
var volLookback = input(
    name="volLookback",
    type="number",
    defaultValue=20,
    label="Volatility Lookback",
    constraints={min: 5, max: 100, step: 1},
    group="Thresholds"
)
var volMultiplier = input(
    name="volMultiplier",
    type="number",
    defaultValue=1.5,
    label="Volatility Multiplier",
    constraints={min: 0.5, max: 5.0, step: 0.1},
    group="Thresholds"
)

// --- Display ---
var showHist = input(
    name="showHist",
    type="boolean",
    defaultValue=true,
    label="Show Histogram",
    group="Display"
)
var showFill = input(
    name="showFill",
    type="boolean",
    defaultValue=true,
    label="Fill MACD vs Signal",
    group="Display"
)
var showShapes = input(
    name="showShapes",
    type="boolean",
    defaultValue=true,
    label="Show Crossover Shapes",
    group="Display"
)
var showDivShapes = input(
    name="showDivShapes",
    type="boolean",
    defaultValue=true,
    label="Show Divergence Shapes",
    group="Display"
)

// --- Colors ---
var macdColor = input(
    name="macdColor",
    type="color",
    defaultValue="#2196f3",
    label="MACD Line Color",
    group="Display"
)
var sigColor = input(
    name="sigColor",
    type="color",
    defaultValue="#ff9800",
    label="Signal Line Color",
    group="Display"
)
var upColor = input(
    name="upColor",
    type="color",
    defaultValue="#26a69a",
    label="Histogram Growing (Bull) Color",
    group="Display"
)
var dnColor = input(
    name="dnColor",
    type="color",
    defaultValue="#ef5350",
    label="Histogram Shrinking (Bear) Color",
    group="Display"
)
var divBullColor = input(
    name="divBullColor",
    type="color",
    defaultValue="#00e676",
    label="Bullish Divergence Color",
    group="Display"
)
var divBearColor = input(
    name="divBearColor",
    type="color",
    defaultValue="#ff5252",
    label="Bearish Divergence Color",
    group="Display"
)

// -----------------------------------------------------------------------------
// 2. DATA SOURCES & NaN GUARD
// -----------------------------------------------------------------------------
timeseries bars = ohlcv(symbol=currentSymbol, exchange=currentExchange)
timeseries c = bars.close
timeseries h = bars.high
timeseries l = bars.low

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

// -----------------------------------------------------------------------------
// 3. CANONICAL MACD
// -----------------------------------------------------------------------------
// Per Appel (1970s): MACD = EMA(fast) − EMA(slow); Signal = avg(MACD, sig)
// Histogram = MACD − Signal (early-warning component)

timeseries macdLine = ema(c, fastLen) - ema(c, slowLen)
timeseries sigLine = useSignalSma ? sma(macdLine, sigLen) : ema(macdLine, sigLen)
timeseries hist = macdLine - sigLine

// Histogram color coding: green = growing, red = shrinking
// Growing positive = accelerating bullish; growing negative = accelerating bearish
// Shrinking positive = bullish momentum fading; shrinking negative = bearish fading
var histBullGrow = hist >= 0 && hist >= hist[1]
var histBullShrink = hist >= 0 && hist < hist[1]
var histBearGrow = hist < 0 && hist <= hist[1]
var histBearShrink = hist < 0 && hist > hist[1]

// -----------------------------------------------------------------------------
// 4. REGIME DETECTION
// -----------------------------------------------------------------------------
// Bullish: MACD > 0 and MACD > Signal (positive momentum, accelerating)
// Bearish: MACD < 0 and MACD < Signal (negative momentum, accelerating)
// Neutral: everything else (chop / transition)

var regimeBull = macdLine > 0 && macdLine > sigLine
var regimeBear = macdLine < 0 && macdLine < sigLine
var regimeNeutral = !regimeBull && !regimeBear

var regimeColor = regimeBull ? upColor : (regimeBear ? dnColor : "#9e9e9e")

// -----------------------------------------------------------------------------
// 5. DYNAMIC THRESHOLDS
// -----------------------------------------------------------------------------
// Volatility-adjusted MACD bands based on rolling std dev of MACD line

var macdVol = stddev(source=macdLine, period=volLookback)
var dynUpper = useDynamic ? macdVol * volMultiplier : 0
var dynLower = useDynamic ? -macdVol * volMultiplier : 0

// -----------------------------------------------------------------------------
// 6. DIVERGENCE DETECTION (stateful via static variables)
// -----------------------------------------------------------------------------
// Regular divergence: price makes higher high / lower low, MACD disagrees.
// Hidden divergence: price makes higher low / lower high, MACD disagrees.

static prevPxHigh = -1.0
static prevMacdHigh = -1.0
static prevPxLow = -1.0
static prevMacdLow = -1.0

var bearDiv = false
var bullDiv = false
var hiddenBearDiv = false
var hiddenBullDiv = false

// Initialize on first real bar after NaN guard
if (prevPxHigh < 0) {
    prevPxHigh = h[0]
    prevMacdHigh = macdLine[0]
    prevPxLow = l[0]
    prevMacdLow = macdLine[0]
}

if (!isLiveUpdate && enableDiv) {
    // --- Regular Bearish Divergence ---
    // Price makes higher high; MACD makes lower high
    if (h[0] > prevPxHigh) {
        if (macdLine[0] < prevMacdHigh) {
            bearDiv = true
        }
        prevPxHigh = h[0]
        prevMacdHigh = macdLine[0]
    }

    // --- Regular Bullish Divergence ---
    // Price makes lower low; MACD makes higher low
    if (l[0] < prevPxLow) {
        if (macdLine[0] > prevMacdLow) {
            bullDiv = true
        }
        prevPxLow = l[0]
        prevMacdLow = macdLine[0]
    }

    // --- Hidden Divergence ---
    if (showHidden) {
        // Hidden bullish: price makes higher low, MACD makes lower low
        if (l[0] > prevPxLow && h[0] < prevPxHigh) {
            if (macdLine[0] < prevMacdLow) {
                hiddenBullDiv = true
            }
        }
        // Hidden bearish: price makes lower high, MACD makes higher high
        if (h[0] < prevPxHigh && l[0] > prevPxLow) {
            if (macdLine[0] > prevMacdHigh) {
                hiddenBearDiv = true
            }
        }
    }
}

// -----------------------------------------------------------------------------
// 7. ALERT CONDITIONS
// -----------------------------------------------------------------------------
// Signal-line crossovers
var sigCrossUp = macdLine > sigLine && macdLine[1] <= sigLine[1]
var sigCrossDown = macdLine < sigLine && macdLine[1] >= sigLine[1]

// Zero-line crossovers
var zeroCrossUp = macdLine > 0 && macdLine[1] <= 0
var zeroCrossDown = macdLine < 0 && macdLine[1] >= 0

// Dynamic threshold penetrations (only when enabled)
var upperPenetrate = useDynamic && macdLine > dynUpper && macdLine[1] <= dynUpper
var lowerPenetrate = useDynamic && macdLine < dynLower && macdLine[1] >= dynLower

// -----------------------------------------------------------------------------
// 8. PLOTTING
// -----------------------------------------------------------------------------

// --- Zero line ---
hline(value=0, color="#ffffff30", width=1)

// --- Dynamic thresholds ---
if (useDynamic) {
    hline(value=dynUpper, color=transparency(dnColor, 70), width=1)
    hline(value=dynLower, color=transparency(upColor, 70), width=1)
}

// --- Histogram with color coding: green=growing, red=shrinking ---
// Four-color histogram: bull-grow, bull-shrink, bear-grow, bear-shrink
if (showHist) {
    var histColorIdx = histBullGrow ? 0 : (histBullShrink ? 1 : (histBearGrow ? 2 : 3))
    plotBar(
        value=hist,
        colors=[
            transparency(upColor, 40),
            transparency(upColor, 70),
            transparency(dnColor, 40),
            transparency(dnColor, 70)
        ],
        colorIndex=histColorIdx,
        width=2,
        label=["Histogram"],
        desc=["MACD − Signal; 4-tone: bull-grow, bull-shrink, bear-grow, bear-shrink"]
    )
}

// --- MACD line (regime-colored) ---
plotLine(
    value=macdLine,
    width=2,
    colors=[regimeColor],
    label=["MACD"],
    desc=["EMA(" + fastLen + ") − EMA(" + slowLen + "); regime-colored"]
)

// --- Signal line ---
plotLine(
    value=sigLine,
    width=2,
    colors=[sigColor],
    label=["Signal"],
    desc=[(useSignalSma ? "SMA" : "EMA") + " of MACD line (" + sigLen + ")"]
)

// --- Fill between MACD and Signal ---
if (showFill) {
    var fillBull = macdLine > sigLine
    plotLine(
        value=[macdLine, sigLine],
        width=1,
        colors=[transparency(upColor, 20), transparency(dnColor, 20)],
        colorIndex=fillBull ? 0 : 1,
        fill=true,
        label=["MACD", "Signal"],
        desc=["Fill between MACD line and signal line"]
    )
}

// --- Crossover shapes (signal + zero-line) ---
if (showShapes) {
    if (sigCrossUp) {
        plotShape(
            value=sigLine,
            shape="triangleup",
            colorIndex=upColor,
            width=2,
            label=["Sig Cross Up"],
            desc=["MACD crossed above signal line"]
        )
    }
    if (sigCrossDown) {
        plotShape(
            value=sigLine,
            shape="triangledown",
            colorIndex=dnColor,
            width=2,
            label=["Sig Cross Down"],
            desc=["MACD crossed below signal line"]
        )
    }
    if (zeroCrossUp) {
        plotShape(
            value=0,
            shape="circle",
            colorIndex=upColor,
            width=2,
            label=["Zero Cross Up"],
            desc=["MACD crossed above zero line"]
        )
    }
    if (zeroCrossDown) {
        plotShape(
            value=0,
            shape="circle",
            colorIndex=dnColor,
            width=2,
            label=["Zero Cross Down"],
            desc=["MACD crossed below zero line"]
        )
    }
    if (upperPenetrate) {
        plotShape(
            value=dynUpper,
            shape="xcross",
            colorIndex=dnColor,
            width=2,
            label=["Upper Extreme"],
            desc=["MACD penetrated upper dynamic threshold"]
        )
    }
    if (lowerPenetrate) {
        plotShape(
            value=dynLower,
            shape="xcross",
            colorIndex=upColor,
            width=2,
            label=["Lower Extreme"],
            desc=["MACD penetrated lower dynamic threshold"]
        )
    }
}

// --- Divergence shapes ---
if (showDivShapes && enableDiv) {
    if (bullDiv) {
        plotShape(
            value=macdLine,
            shape="triangleup",
            colorIndex=divBullColor,
            width=2,
            label=["Bull Div"],
            desc=["Bullish divergence: price lower low, MACD higher low"]
        )
    }
    if (bearDiv) {
        plotShape(
            value=macdLine,
            shape="triangledown",
            colorIndex=divBearColor,
            width=2,
            label=["Bear Div"],
            desc=["Bearish divergence: price higher high, MACD lower high"]
        )
    }
    if (showHidden && hiddenBullDiv) {
        plotShape(
            value=macdLine,
            shape="arrowup",
            colorIndex=divBullColor,
            width=1,
            label=["Hidden Bull"],
            desc=["Hidden bullish divergence: price higher low, MACD lower low"]
        )
    }
    if (showHidden && hiddenBearDiv) {
        plotShape(
            value=macdLine,
            shape="arrowdown",
            colorIndex=divBearColor,
            width=1,
            label=["Hidden Bear"],
            desc=["Hidden bearish divergence: price lower high, MACD higher high"]
        )
    }
}

// -----------------------------------------------------------------------------
// 9. REGIME TABLE (last bar only)
// -----------------------------------------------------------------------------
if (isLastBar) {
    var regimeText = regimeBull ? "BULLISH" : (regimeBear ? "BEARISH" : "NEUTRAL")
    var regimeTextColor = regimeBull ? upColor : (regimeBear ? dnColor : "#9e9e9e")
    var signalType = useSignalSma ? "SMA" : "EMA"

    plotTable(
        data=[
            ["MACD — Perfected", regimeText],
            ["MACD", macdLine[0]],
            ["Signal", sigLine[0]],
            ["Histogram", hist[0]],
            ["Fast EMA", fastLen],
            ["Slow EMA", slowLen],
            ["Signal " + signalType, sigLen]
        ],
        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
    )
}