Perfected FlowScript
Dynamic Volatility Bands
Dynamic Volatility Bands — Perfected Edition is indexed as 315_dynamic_volatility_bands.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
16.3 KB
Lines
534
Native Signal Candidates
5 source-level chart marker triggers extracted from guarded FlowScript v2 blocks.
Upper Touch
line 436:9
Trigger
(showShapes) && (touchUpper)
Value
upperBand
Deps
showShapes:input, touchUpper:var
Lower Touch
line 446:9
Trigger
(showShapes) && (touchLower)
Value
lowerBand
Deps
showShapes:input, touchLower:var
Upper Break
line 456:9
Trigger
(showShapes) && (breakUpper && !touchUpper)
Value
src
Deps
breakUpper:var, showShapes:input, touchUpper:var
Lower Break
line 466:9
Trigger
(showShapes) && (breakLower && !touchLower)
Value
src
Deps
breakLower:var, showShapes:input, touchLower:var
Squeeze
line 476:9
Trigger
(showShapes) && (squeeze)
Value
midline
Deps
showShapes:input, squeeze:var
315_dynamic_volatility_bands.flowscript
source path: kscripts/perfected/315_dynamic_volatility_bands.flowscript · sha256:5b74a766e8b66551f228f73c924c796ddce8e91848ea9a1fce82002cac19b62d
//@version=2
// ============================================================================
// Dynamic Volatility Bands — Perfected Edition
// Author: D (@ddave334) | Enhanced by kScript_Perfection_Engineer
// Tags: CORE, #volatility, #bands, #atr, #stddev, #regime, #fractal
//
// Production-quality adaptive volatility band system combining Bollinger-style
// standard deviation bands with ATR-based channels and Kaufman Efficiency Ratio
// regime detection. Bands dynamically tighten in trending markets and expand
// in choppy conditions, with full color coding, fill, shape markers, and
// statistical validation.
//
// Research papers underpinning this design:
// 1. Bollinger (2001), "Bollinger on Bollinger Bands": definitive work on
// volatility bands using SMA ± 2σ. %B measures relative position within
// bands; BandWidth measures volatility squeeze. Middle = 20-period SMA.
// [Formula] Upper = SMA + 2·σ; Lower = SMA − 2·σ; %B = (Close−Lower)/(Upper−Lower)
//
// 2. Kaufman (1995), "Smarter Trading: Improving Performance in Changing Markets":
// introduced Efficiency Ratio (ER) = |Close − Close(n)| / Σ|Close(t) − Close(t−1)|.
// ER ranges 0 (no direction) to 1 (perfect trend). Drives adaptive smoothing.
// [Formula] ER = Change / Volatility; SC = [ER × (FastSC − SlowSC) + SlowSC]²
//
// 3. Mandelbrot (1963), "The Variation of Certain Speculative Prices":
// fractal geometry in financial markets. D = 2 − H where H is Hurst exponent.
// Trending: H > 0.5 (D < 1.5); Mean-reverting: H < 0.5 (D > 1.5).
// Supports fractal efficiency as a band-width driver.
//
// 4. Keltner (1960) / Raschke (1980s): Keltner Channels using EMA ± k×ATR.
// ATR-based bands produce smoother, more consistent width than σ-based.
// [Formula] Keltner = EMA(20) ± 2×ATR(10)
//
// 5. Peters (1994), "Fractal Market Analysis": Fractal Market Hypothesis (FMH).
// Market stability depends on heterogeneous investment horizons. Crises
// correspond to periods dominated by short-term behavior (high fractal dim).
// Supports efficiency-ratio regime classification.
//
// 6. Wilder (1978), "New Concepts in Technical Trading Systems": ATR formula
// for true range: TR = max[(High−Low), |High−Close_prev|, |Low−Close_prev|].
// Smoothing: ATR = (Prior_ATR × 13 + Current_TR) / 14.
// ============================================================================
define(
title="Dynamic Volatility Bands — Perfected Edition",
position="onchart",
axis=false
)
// -----------------------------------------------------------------------------
// 1. USER INPUTS — grouped with constraints
// -----------------------------------------------------------------------------
// --- Band Core ---
var maLen = input(
name="maLen",
type="number",
defaultValue=20,
label="Band Moving Average Length",
constraints={min: 5, max: 100, step: 1},
group="Band Core"
)
var maType = input(
name="maType",
type="select",
defaultValue="SMA",
label="MA Type",
options=["SMA", "EMA"],
group="Band Core"
)
// --- Band Width ---
var bandMode = input(
name="bandMode",
type="select",
defaultValue="Hybrid",
label="Band Width Mode",
options=["StdDev", "ATR", "Hybrid"],
group="Band Width"
)
var sdLen = input(
name="sdLen",
type="number",
defaultValue=20,
label="StdDev Lookback",
constraints={min: 5, max: 100, step: 1},
group="Band Width"
)
var sdMult = input(
name="sdMult",
type="number",
defaultValue=2.0,
label="StdDev Multiplier",
constraints={min: 0.5, max: 5.0, step: 0.1},
group="Band Width"
)
var atrLen = input(
name="atrLen",
type="number",
defaultValue=14,
label="ATR Length",
constraints={min: 5, max: 50, step: 1},
group="Band Width"
)
var atrMult = input(
name="atrMult",
type="number",
defaultValue=2.0,
label="ATR Multiplier",
constraints={min: 0.5, max: 5.0, step: 0.1},
group="Band Width"
)
// --- Dynamic Adjustment ---
var useDynamic = input(
name="useDynamic",
type="boolean",
defaultValue=true,
label="Enable Dynamic Width Adjustment",
group="Dynamic Adjustment"
)
var erLen = input(
name="erLen",
type="number",
defaultValue=10,
label="Efficiency Ratio Lookback",
constraints={min: 5, max: 50, step: 1},
group="Dynamic Adjustment"
)
var trendThr = input(
name="trendThr",
type="number",
defaultValue=0.6,
label="Trend Efficiency Threshold",
constraints={min: 0.1, max: 0.9, step: 0.1},
group="Dynamic Adjustment"
)
var chopThr = input(
name="chopThr",
type="number",
defaultValue=0.3,
label="Chop Efficiency Threshold",
constraints={min: 0.1, max: 0.5, step: 0.1},
group="Dynamic Adjustment"
)
// --- Display ---
var showStddev = input(
name="showStddev",
type="boolean",
defaultValue=true,
label="Show StdDev Bands",
group="Display"
)
var showAtr = input(
name="showAtr",
type="boolean",
defaultValue=true,
label="Show ATR Bands",
group="Display"
)
var showFill = input(
name="showFill",
type="boolean",
defaultValue=true,
label="Show Band Fill",
group="Display"
)
var showShapes = input(
name="showShapes",
type="boolean",
defaultValue=true,
label="Show Touch / Break Shapes",
group="Display"
)
var showPercentB = input(
name="showPercentB",
type="boolean",
defaultValue=false,
label="Show %B (offchart)",
group="Display"
)
// --- Colors ---
var trendUpColor = input(
name="trendUpColor",
type="color",
defaultValue="#26a69a",
label="Trending Up Color",
group="Colors"
)
var trendDnColor = input(
name="trendDnColor",
type="color",
defaultValue="#ef5350",
label="Trending Down Color",
group="Colors"
)
var chopColor = input(
name="chopColor",
type="color",
defaultValue="#ffca28",
label="Choppy / Neutral Color",
group="Colors"
)
var midColor = input(
name="midColor",
type="color",
defaultValue="#2962ff",
label="Midline Color",
group="Colors"
)
// -----------------------------------------------------------------------------
// 2. DATA SOURCES & NaN GUARD
// -----------------------------------------------------------------------------
timeseries bars = ohlcv(symbol=currentSymbol, exchange=currentExchange)
timeseries src = bars.close
if (isnan(src[0])) {
return
}
// -----------------------------------------------------------------------------
// 3. CORE COMPUTATIONS
// -----------------------------------------------------------------------------
// -- 3.1 Middle band (central moving average) --
timeseries midline = maType == "SMA" ? sma(src, maLen) : ema(src, maLen)
// -- 3.2 StdDev-based bands --
timeseries sd = stddev(src, sdLen)
timeseries sdUpper = midline + sd * sdMult
timeseries sdLower = midline - sd * sdMult
// -- 3.3 ATR-based bands (Keltner-style) --
// True Range per Wilder (1978)
timeseries tr = math.max(
math.max(bars.high - bars.low, math.abs(bars.high - src[1])),
math.abs(bars.low - src[1])
)
// Using ATR function if available; otherwise approximate via EMA of TR
// Since we don't have a direct atr() function, we use EMA of TR as Wilder smoothing
timeseries atr = ema(tr, atrLen)
timeseries atrUpper = midline + atr * atrMult
timeseries atrLower = midline - atr * atrMult
// -- 3.4 Hybrid band selection --
timeseries upperBand = 0.0
timeseries lowerBand = 0.0
if (bandMode == "StdDev") {
upperBand = sdUpper
lowerBand = sdLower
} else if (bandMode == "ATR") {
upperBand = atrUpper
lowerBand = atrLower
} else {
// Hybrid: average of StdDev and ATR bands
upperBand = (sdUpper + atrUpper) / 2
lowerBand = (sdLower + atrLower) / 2
}
// -- 3.5 Kaufman Efficiency Ratio (adaptive width driver) --
// ER = |Close − Close(n)| / Σ|Close(t) − Close(t−1)|
// ER = 0 → choppy (wide bands); ER = 1 → trending (tight bands)
var erChange = math.abs(src[0] - src[erLen])
// Sum of absolute bar-to-bar changes over ER lookback
var erVolSum = 0.0
for (var i = 0; i < erLen; i = i + 1) {
erVolSum = erVolSum + math.abs(src[i] - src[i + 1])
}
var er = erVolSum > 0 ? erChange / erVolSum : 0.0
var efficiency = er
// -- 3.6 Dynamic width factor --
// When ER is high (trending), bands tighten (factor < 1)
// When ER is low (choppy), bands expand (factor > 1)
// Dynamic factor: 0.5 (trend) to 1.5 (chop) via (1 − ER)
var dynFactor = 0.5 + (1.0 - efficiency) * 1.0
if (useDynamic) {
upperBand = midline + (upperBand - midline) * dynFactor
lowerBand = midline - (midline - lowerBand) * dynFactor
}
// -- 3.7 %B (Bollinger's normalized position indicator) --
// %B = (Close − Lower) / (Upper − Lower) × 100
// 0 = at lower band, 100 = at upper band, 50 = at midline
timeseries percentB = (upperBand != lowerBand) ?
((src - lowerBand) / (upperBand - lowerBand)) * 100 : 50
// -- 3.8 Bandwidth (volatility squeeze detector) --
// BandWidth = (Upper − Lower) / Midline × 100
timeseries bandWidth = (midline > 0) ?
((upperBand - lowerBand) / midline) * 100 : 0
// -----------------------------------------------------------------------------
// 4. REGIME DETECTION
// -----------------------------------------------------------------------------
// Regime classification via Kaufman Efficiency Ratio:
// Trending Up: ER > trendThr AND price above midline
// Trending Down: ER > trendThr AND price below midline
// Choppy: ER < chopThr
// Neutral: everything else
var regimeTrendUp = efficiency > trendThr && src > midline
var regimeTrendDn = efficiency > trendThr && src < midline
var regimeChop = efficiency < chopThr
var regimeNeutral = !regimeTrendUp && !regimeTrendDn && !regimeChop
var regimeColor = regimeTrendUp ? trendUpColor :
(regimeTrendDn ? trendDnColor : (regimeChop ? chopColor : "#9e9e9e"))
// -----------------------------------------------------------------------------
// 5. STATIC STATE TRACKING
// -----------------------------------------------------------------------------
// Track consecutive bars in each regime and band-touch history
static lastRegime = 0
static trendUpBars = 0
static trendDnBars = 0
static chopBars = 0
if (regimeTrendUp) {
trendUpBars = trendUpBars + 1
trendDnBars = 0
chopBars = 0
lastRegime = 1
} else if (regimeTrendDn) {
trendDnBars = trendDnBars + 1
trendUpBars = 0
chopBars = 0
lastRegime = -1
} else if (regimeChop) {
chopBars = chopBars + 1
trendUpBars = 0
trendDnBars = 0
lastRegime = 0
} else {
trendUpBars = 0
trendDnBars = 0
chopBars = 0
lastRegime = 0
}
// -----------------------------------------------------------------------------
// 6. ALERT CONDITIONS
// -----------------------------------------------------------------------------
// Price touches / breaks bands
var touchUpper = src >= upperBand && src[1] < upperBand[1]
var touchLower = src <= lowerBand && src[1] > lowerBand[1]
var breakUpper = src > upperBand
var breakLower = src < lowerBand
// Squeeze detection: BandWidth at lowest N bars (volatility contraction)
// Squeeze when BandWidth < lowest BandWidth of last 20 bars
var squeeze = bandWidth < lowest(bandWidth, 20) && bandWidth[1] >= lowest(bandWidth[1], 20)
// Expansion detection: BandWidth rising sharply
var expansion = bandWidth > bandWidth[1] * 1.2 && bandWidth > 5
// Regime change alerts
var regimeToTrend = (regimeTrendUp || regimeTrendDn) && (lastRegime == 0 || lastRegime == 0)
// Simplified: check if transitioning from chop to trend
var chopToTrend = efficiency > trendThr && efficiency[1] <= chopThr
// -----------------------------------------------------------------------------
// 7. PLOTTING
// -----------------------------------------------------------------------------
// --- Midline ---
plotLine(
value=midline,
width=2,
colors=[midColor],
label=["Midline"],
desc=["Central " + maType + " (" + maLen + ") — band anchor"]
)
// --- StdDev Bands ---
if (showStddev) {
plotLine(
value=[sdLower, sdUpper],
width=1,
colors=[transparency("#9e9e9e", 40), transparency("#9e9e9e", 40)],
fill=false,
label=["SD Lower", "SD Upper"],
desc=["StdDev lower band (" + sdMult + "σ)", "StdDev upper band (" + sdMult + "σ)"]
)
}
// --- ATR Bands ---
if (showAtr) {
plotLine(
value=[atrLower, atrUpper],
width=1,
colors=[transparency("#78909c", 40), transparency("#78909c", 40)],
fill=false,
label=["ATR Lower", "ATR Upper"],
desc=["ATR lower band (" + atrMult + "×ATR)", "ATR upper band (" + atrMult + "×ATR)"]
)
}
// --- Primary Dynamic Bands (regime-colored) ---
if (showFill) {
plotLine(
value=[lowerBand, upperBand],
width=2,
colors=[transparency(regimeColor, 30), transparency(regimeColor, 30)],
fill=true,
label=["Lower Band", "Upper Band"],
desc=["Dynamic lower band — regime-colored", "Dynamic upper band — regime-colored"]
)
} else {
plotLine(
value=lowerBand,
width=2,
colors=[transparency(regimeColor, 50)],
label=["Lower Band"],
desc=["Dynamic lower band — regime-colored"]
)
plotLine(
value=upperBand,
width=2,
colors=[transparency(regimeColor, 50)],
label=["Upper Band"],
desc=["Dynamic upper band — regime-colored"]
)
}
// --- Shape Markers ---
if (showShapes) {
if (touchUpper) {
plotShape(
value=upperBand,
shape="triangledown",
colorIndex=regimeTrendUp ? trendDnColor : chopColor,
width=2,
label=["Upper Touch"],
desc=["Price touched upper band — potential resistance / exhaustion"]
)
}
if (touchLower) {
plotShape(
value=lowerBand,
shape="triangleup",
colorIndex=regimeTrendDn ? trendUpColor : chopColor,
width=2,
label=["Lower Touch"],
desc=["Price touched lower band — potential support / exhaustion"]
)
}
if (breakUpper && !touchUpper) {
plotShape(
value=src,
shape="circle",
colorIndex=trendUpColor,
width=2,
label=["Upper Break"],
desc=["Price broke above upper band — momentum expansion"]
)
}
if (breakLower && !touchLower) {
plotShape(
value=src,
shape="circle",
colorIndex=trendDnColor,
width=2,
label=["Lower Break"],
desc=["Price broke below lower band — momentum expansion"]
)
}
if (squeeze) {
plotShape(
value=midline,
shape="diamond",
colorIndex="#ffeb3b",
width=2,
label=["Squeeze"],
desc=["Volatility squeeze — BandWidth at 20-bar low; expansion likely"]
)
}
}
// --- %B (offchart) ---
if (showPercentB) {
plotLine(
value=percentB,
width=2,
colors=[midColor],
label=["%B"],
desc=["Bollinger %B: position within bands (0=lower, 100=upper, 50=mid)"],
forceOffchart=true
)
hline(value=0, color="#ffffff15", width=1)
hline(value=50, color="#ffffff30", width=1)
hline(value=100, color="#ffffff15", width=1)
}
// -----------------------------------------------------------------------------
// 8. REGIME TABLE (last bar only)
// -----------------------------------------------------------------------------
if (isLastBar) {
var regimeText = regimeTrendUp ? "TREND UP" :
(regimeTrendDn ? "TREND DOWN" : (regimeChop ? "CHOPPY" : "NEUTRAL"))
var bandModeText = bandMode
plotTable(
data=[
["Dynamic Vol Bands", regimeText],
["Midline", midline[0]],
["Upper Band", upperBand[0]],
["Lower Band", lowerBand[0]],
["%B", percentB[0]],
["BandWidth", bandWidth[0]],
["Efficiency Ratio", efficiency],
["Band Mode", bandModeText]
],
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
)
}