MM Flow
FlowScripts

Perfected FlowScript

Commodity Channel Index

CCI Pro — Perfected Edition is indexed as 177_commodity_channel_index.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

18.3 KB

Lines

630

Native Signal Candidates

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

12/12 guarded

Bull Div

line 472:9

Trigger

(showAlerts && enableDiv) && (bullDiv)

Value

cci

Deps

bullDiv:var, enableDiv:input, showAlerts:input

Bear Div

line 482:9

Trigger

(showAlerts && enableDiv) && (bearDiv)

Value

cci

Deps

bearDiv:var, enableDiv:input, showAlerts:input

Hidden Bull

line 492:9

Trigger

(showAlerts && enableDiv) && (showHidden && hiddenBullDiv)

Value

cci

Deps

enableDiv:input, hiddenBullDiv:var, showAlerts:input, showHidden:input

Hidden Bear

line 502:9

Trigger

(showAlerts && enableDiv) && (showHidden && hiddenBearDiv)

Value

cci

Deps

enableDiv:input, hiddenBearDiv:var, showAlerts:input, showHidden:input

Cross Up

line 516:9

Trigger

(showAlerts) && (crossUp)

Value

cciSignal

Deps

crossUp:var, showAlerts:input

Cross Down

line 526:9

Trigger

(showAlerts) && (crossDown)

Value

cciSignal

Deps

crossDown:var, showAlerts:input

OB Penetrate

line 536:9

Trigger

(showAlerts) && (obPenetrate)

Value

dynOb

Deps

obPenetrate:var, showAlerts:input

OS Penetrate

line 546:9

Trigger

(showAlerts) && (osPenetrate)

Value

dynOs

Deps

osPenetrate:var, showAlerts:input

Extreme Up

line 556:9

Trigger

(showAlerts) && (extUp)

Value

dynExt

Deps

extUp:var, showAlerts:input

Extreme Down

line 566:9

Trigger

(showAlerts) && (extDown)

Value

dynExtNeg

Deps

extDown:var, showAlerts:input

Zero Up

line 576:9

Trigger

(showAlerts) && (zeroCrossUp)

Value

0

Deps

showAlerts:input, zeroCrossUp:var

Zero Down

line 586:9

Trigger

(showAlerts) && (zeroCrossDown)

Value

0

Deps

showAlerts:input, zeroCrossDown:var

177_commodity_channel_index.flowscript

source path: kscripts/perfected/177_commodity_channel_index.flowscript · sha256:a5d1885b45c0080053790161f46bf700a03f3b5ee46756f64c9909e74d997fc1

hash verified
//@version=2
// ============================================================================
// Commodity Channel Index (CCI) Pro — Perfected Edition
// Author: BackQuant (@BackQuant) | Enhanced by kScript Perfection Engineer
// Tags: CORE, #cci, #divergence, #trend, #momentum, #regime
//
// Production-quality academically-grounded CCI momentum oscillator with full
// stateful divergence detection, dynamic volatility-adjusted thresholds,
// multi-regime color coding, signal-line crossovers, and comprehensive
// fill / shape / histogram visualization.
//
// Research papers underpinning this design:
//  1. Lambert (1980), "Commodity Channel Index" — Commodities magazine.
//     Original formula: CCI = [TP − SMA(TP)] / (0.015 × MAD).
//     Designed to identify cyclical turns in commodities.
//  2. Martens et al. (2010), "Machine-Learning Approaches for Technical Analysis
//     of Financial Markets": modern interpretation uses ±100 as overbought/
//     oversold reversal signals rather than trend-start triggers.
//  3. Wilder (1978), "New Concepts in Technical Trading Systems": bounded
//     oscillator design paradigm enabling cross-symbol comparison.
//  4. Murphy (1999), "Technical Analysis of the Financial Markets": divergence
//     as a leading reversal signal — price/indicator disagreement at extremes
//     precedes regime shifts.
//  5. Poterba & Summers (1988), "Mean Reversion in Stock Prices": negative
//     autocorrelation at medium horizons; supports dynamic thresholds
//     calibrated to rolling volatility.
// ============================================================================

define(
    title="CCI Pro — Perfected Edition",
    position="offchart",
    axis=true
)

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

// --- CCI Settings ---
var cciLen = input(
    name="cciLen",
    type="number",
    defaultValue=20,
    label="CCI Length",
    constraints={min: 5, max: 100, step: 1},
    group="CCI Settings"
)
var signalLen = input(
    name="signalLen",
    type="number",
    defaultValue=9,
    label="Signal MA Length",
    constraints={min: 2, max: 50, step: 1},
    group="CCI Settings"
)
var maType = input(
    name="maType",
    type="select",
    defaultValue="SMA",
    label="Signal MA Type",
    options=["SMA", "EMA", "WMA"],
    group="CCI Settings"
)

// --- Thresholds ---
var obLevel = input(
    name="obLevel",
    type="number",
    defaultValue=100,
    label="Overbought Level",
    constraints={min: 50, max: 300, step: 1},
    group="Thresholds"
)
var osLevel = input(
    name="osLevel",
    type="number",
    defaultValue=-100,
    label="Oversold Level",
    constraints={min: -300, max: -50, step: 1},
    group="Thresholds"
)
var extLevel = input(
    name="extLevel",
    type="number",
    defaultValue=200,
    label="Extreme Level",
    constraints={min: 100, max: 500, step: 1},
    group="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.0,
    label="Volatility Multiplier",
    constraints={min: 0.5, max: 5.0, step: 0.1},
    group="Thresholds"
)

// --- 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"
)

// --- Display ---
var showSignal = input(
    name="showSignal",
    type="boolean",
    defaultValue=true,
    label="Show Signal Line",
    group="Display"
)
var showFill = input(
    name="showFill",
    type="boolean",
    defaultValue=true,
    label="Show CCI/Signal Fill",
    group="Display"
)
var showObOs = input(
    name="showObOs",
    type="boolean",
    defaultValue=true,
    label="Show OB/OS Zones",
    group="Display"
)
var showHistogram = input(
    name="showHistogram",
    type="boolean",
    defaultValue=true,
    label="Show Momentum Histogram",
    group="Display"
)
var showAlerts = input(
    name="showAlerts",
    type="boolean",
    defaultValue=true,
    label="Show Alert Shapes",
    group="Display"
)

// --- 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 signalColor = input(
    name="signalColor",
    type="color",
    defaultValue="#ffa726",
    label="Signal Line Color",
    group="Colors"
)
var divBullColor = input(
    name="divBullColor",
    type="color",
    defaultValue="#00e676",
    label="Bullish Divergence Color",
    group="Colors"
)
var divBearColor = input(
    name="divBearColor",
    type="color",
    defaultValue="#ff5252",
    label="Bearish Divergence Color",
    group="Colors"
)

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

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

// -----------------------------------------------------------------------------
// 3. CANONICAL CCI — Lambert (1980)
// -----------------------------------------------------------------------------
// CCI = [Typical Price − SMA(TP)] / (0.015 × Mean Absolute Deviation)
// Typical Price = (High + Low + Close) / 3

timeseries tp = (high + low + px) / 3.0
timeseries tpSma = sma(source=tp, period=cciLen)
timeseries dev = math.abs(tp - tpSma)
timeseries mad = sma(source=dev, period=cciLen)

// Guard against zero division
timeseries cci = (tp - tpSma) / math.max(0.015 * mad, 0.0001)

// -----------------------------------------------------------------------------
// 4. SIGNAL LINE
// -----------------------------------------------------------------------------
timeseries cciSignal = (maType == "SMA") ? sma(source=cci, period=signalLen)
    : (maType == "EMA") ? ema(source=cci, period=signalLen)
    : wma(source=cci, period=signalLen)

// Momentum histogram (CCI minus signal)
timeseries hist = cci - cciSignal

// -----------------------------------------------------------------------------
// 5. REGIME DETECTION
// -----------------------------------------------------------------------------
// Regime classification:
//   Bullish: CCI > signal AND CCI > 0
//   Bearish: CCI < signal AND CCI < 0
//   Neutral: everything else (chop zone)

var regimeBull = cci > cciSignal && cci > 0
var regimeBear = cci < cciSignal && cci < 0
var regimeNeutral = !regimeBull && !regimeBear

var regimeColor = regimeBull ? bullColor : (regimeBear ? bearColor : "#9e9e9e")

// -----------------------------------------------------------------------------
// 6. DYNAMIC THRESHOLDS
// -----------------------------------------------------------------------------
// Per Poterba & Summers (1988), mean-reversion intensity varies with volatility.
// We adjust OB/OS bands by rolling CCI standard deviation.

var cciVol = stddev(source=cci, period=volLookback)
var dynOb = useDynamic ? math.min(300, obLevel + cciVol * volMultiplier) : obLevel
var dynOs = useDynamic ? math.max(-300, osLevel - cciVol * volMultiplier) : osLevel

// Guard: ensure dynamic bands never cross
if (dynOb <= dynOs) {
    dynOb = 100
    dynOs = -100
}

var dynExt = useDynamic ? math.min(500, extLevel + cciVol * volMultiplier * 2.0) : extLevel
var dynExtNeg = -dynExt

// -----------------------------------------------------------------------------
// 7. DIVERGENCE DETECTION (stateful via static variables)
// -----------------------------------------------------------------------------
// Regular divergence: price makes higher high / lower low, CCI disagrees.
// Hidden divergence: price makes higher low / lower high, CCI disagrees.
// We track pivot high/low state across bars using static variables.

static prevPxHigh = -1.0
static prevCciHigh = -1.0
static prevPxLow = -1.0
static prevCciLow = -1.0
static prevPxHighLow = -1.0
static prevCciHighLow = -1.0
static prevPxLowHigh = -1.0
static prevCciLowHigh = -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 = high[0]
    prevCciHigh = cci[0]
    prevPxLow = low[0]
    prevCciLow = cci[0]
    prevPxHighLow = high[0]
    prevCciHighLow = cci[0]
    prevPxLowHigh = low[0]
    prevCciLowHigh = cci[0]
}

if (!isLiveUpdate && enableDiv) {
    // --- Regular Bearish Divergence ---
    // Price makes a higher high; CCI makes a lower high
    var pxHigh = highest(source=high, period=divLookback)
    var cciHigh = highest(source=cci, period=divLookback)
    if (high[0] > prevPxHigh) {
        if (cci[0] < prevCciHigh) {
            bearDiv = true
        }
        prevPxHigh = high[0]
        prevCciHigh = cci[0]
    }

    // --- Regular Bullish Divergence ---
    // Price makes a lower low; CCI makes a higher low
    var pxLow = lowest(source=low, period=divLookback)
    var cciLow = lowest(source=cci, period=divLookback)
    if (low[0] < prevPxLow) {
        if (cci[0] > prevCciLow) {
            bullDiv = true
        }
        prevPxLow = low[0]
        prevCciLow = cci[0]
    }

    // --- Hidden Divergence ---
    if (showHidden) {
        // Hidden bullish: price makes a higher low vs prior low
        if (low[0] > prevPxLow && high[0] < prevPxHigh) {
            if (cci[0] < prevCciLow) {
                hiddenBullDiv = true
            }
        }
        // Hidden bearish: price makes a lower high vs prior high
        if (high[0] < prevPxHigh && low[0] > prevPxLow) {
            if (cci[0] > prevCciHigh) {
                hiddenBearDiv = true
            }
        }
    }
}

// -----------------------------------------------------------------------------
// 8. STATIC STATE TRACKING (Session-level persistence)
// -----------------------------------------------------------------------------
static lastRegime = 0
static regimeChangeCount = 0
static sessionHighCci = -999999.0
static sessionLowCci = 999999.0
static lastBarIndex = 0

var currentBarIndex = bar_index[0]

if (!isnan(currentBarIndex) && currentBarIndex != lastBarIndex) {
    lastBarIndex = currentBarIndex

    if (cci[0] > sessionHighCci) {
        sessionHighCci = cci[0]
    }
    if (cci[0] < sessionLowCci) {
        sessionLowCci = cci[0]
    }

    var currentRegime = regimeBull ? 1 : (regimeBear ? -1 : 0)
    if (lastRegime != currentRegime) {
        lastRegime = currentRegime
        regimeChangeCount = regimeChangeCount + 1
    }
}

// -----------------------------------------------------------------------------
// 9. ALERT CONDITIONS
// -----------------------------------------------------------------------------
// Crossover / crossunder of CCI and signal
var crossUp = cci > cciSignal && cci[1] <= cciSignal[1]
var crossDown = cci < cciSignal && cci[1] >= cciSignal[1]

// OB / OS penetrations (using dynamic or static thresholds)
var obPenetrate = cci > dynOb && cci[1] <= dynOb[1]
var osPenetrate = cci < dynOs && cci[1] >= dynOs[1]

// OB / OS exit (return to neutral zone)
var obExit = cci < dynOb && cci[1] >= dynOb[1]
var osExit = cci > dynOs && cci[1] <= dynOs[1]

// Zero-line cross
var zeroCrossUp = cci > 0 && cci[1] <= 0
var zeroCrossDown = cci < 0 && cci[1] >= 0

// Extreme level penetration
var extUp = cci > dynExt && cci[1] <= dynExt[1]
var extDown = cci < dynExtNeg && cci[1] >= dynExtNeg[1]

// -----------------------------------------------------------------------------
// 10. PLOTTING
// -----------------------------------------------------------------------------

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

// --- OB / OS Zones ---
if (showObOs) {
    hline(value=dynOb, color=transparency(bearColor, 60), width=1)
    hline(value=dynOs, color=transparency(bullColor, 60), width=1)
    hline(value=dynExt, color=transparency(bearColor, 40), width=1)
    hline(value=dynExtNeg, color=transparency(bullColor, 40), width=1)
}

// --- CCI Line (regime-colored) ---
plotLine(
    value=cci,
    width=2,
    colors=[regimeColor],
    label=["CCI"],
    desc=["Commodity Channel Index (Lambert " + cciLen + ")"]
)

// --- Signal Line ---
if (showSignal) {
    plotLine(
        value=cciSignal,
        width=1,
        colors=[signalColor],
        label=["Signal " + maType],
        desc=["Signal MA of CCI (" + signalLen + ")"]
    )
}

// --- CCI vs Signal Fill ---
if (showFill && showSignal) {
    var signalBull = cci > cciSignal
    plotLine(
        value=[cci, cciSignal],
        width=1,
        colors=[transparency(bullColor, 20), transparency(bearColor, 20)],
        colorIndex=signalBull ? 0 : 1,
        fill=true,
        label=["CCI", "Signal"],
        desc=["Fill between CCI and signal MA"]
    )
}

// --- Momentum Histogram ---
if (showHistogram) {
    var histBull = hist >= 0
    plotBar(
        value=hist,
        colors=[transparency(bullColor, 60), transparency(bearColor, 60)],
        colorIndex=histBull ? 0 : 1,
        width=1,
        label=["CCI Momentum"],
        desc=["Histogram of CCI minus signal MA"]
    )
}

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

// --- Alert Shapes (crossovers, OB/OS, extremes) ---
if (showAlerts) {
    if (crossUp) {
        plotShape(
            value=cciSignal,
            shape="circle",
            color=bullColor,
            width=2,
            label=["Cross Up"],
            desc=["CCI crossed above signal MA"]
        )
    }
    if (crossDown) {
        plotShape(
            value=cciSignal,
            shape="circle",
            color=bearColor,
            width=2,
            label=["Cross Down"],
            desc=["CCI crossed below signal MA"]
        )
    }
    if (obPenetrate) {
        plotShape(
            value=dynOb,
            shape="xcross",
            color=bearColor,
            width=2,
            label=["OB Penetrate"],
            desc=["CCI entered overbought zone (> " + dynOb + ")"]
        )
    }
    if (osPenetrate) {
        plotShape(
            value=dynOs,
            shape="xcross",
            color=bullColor,
            width=2,
            label=["OS Penetrate"],
            desc=["CCI entered oversold zone (< " + dynOs + ")"]
        )
    }
    if (extUp) {
        plotShape(
            value=dynExt,
            shape="diamond",
            color=bearColor,
            width=3,
            label=["Extreme Up"],
            desc=["CCI reached extreme overbought (> " + dynExt + ")"]
        )
    }
    if (extDown) {
        plotShape(
            value=dynExtNeg,
            shape="diamond",
            color=bullColor,
            width=3,
            label=["Extreme Down"],
            desc=["CCI reached extreme oversold (< " + dynExtNeg + ")"]
        )
    }
    if (zeroCrossUp) {
        plotShape(
            value=0,
            shape="circle",
            color=transparency(bullColor, 50),
            width=2,
            label=["Zero Up"],
            desc=["CCI crossed above zero line"]
        )
    }
    if (zeroCrossDown) {
        plotShape(
            value=0,
            shape="circle",
            color=transparency(bearColor, 50),
            width=2,
            label=["Zero Down"],
            desc=["CCI crossed below zero line"]
        )
    }
}

// -----------------------------------------------------------------------------
// 11. REGIME TABLE (last bar only)
// -----------------------------------------------------------------------------
if (isLastBar) {
    var regimeText = regimeBull ? "BULLISH" : (regimeBear ? "BEARISH" : "NEUTRAL")
    var regimeTextColor = regimeBull ? bullColor : (regimeBear ? bearColor : "#9e9e9e")
    var obText = useDynamic ? "Dynamic OB: " + dynOb : "Static OB: " + obLevel
    var osText = useDynamic ? "Dynamic OS: " + dynOs : "Static OS: " + osLevel

    plotTable(
        data=[
            ["CCI Pro — Perfected", regimeText],
            ["CCI", cci[0]],
            ["Signal", cciSignal[0]],
            ["Momentum", hist[0]],
            ["Session High", sessionHighCci],
            ["Session Low", sessionLowCci],
            ["Regime Changes", regimeChangeCount],
            [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
    )
}