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