Perfected FlowScript
Bar Statistics Matrix
Bar Statistics Matrix V2 is indexed as 198_bar_statistics_matrix.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
13.6 KB
Lines
320
Native Signal Candidates
3 source-level chart marker triggers extracted from guarded FlowScript v2 blocks.
Vol Spike
line 248:9
Trigger
(showShapes) && (volSpike && !isnan(volSpike[1]) && !volSpike[1])
Value
vol
Deps
showShapes:input, volSpike:var
Delta Extreme
line 262:9
Trigger
(showShapes) && (deltaExtreme && !isnan(deltaExtreme[1]) && !deltaExtreme[1])
Value
delta
Deps
deltaExtreme:var, showShapes:input
CVD Extreme
line 276:9
Trigger
(showShapes) && (cvdExtreme && !isnan(cvdExtreme[1]) && !cvdExtreme[1])
Value
cvdZ
Deps
cvdExtreme:var, showShapes:input
198_bar_statistics_matrix.flowscript
source path: kscripts/perfected/198_bar_statistics_matrix.flowscript · sha256:10db1979a7813da5c5a5a4cc3448ae54046c036ae90adcc6914eff50f54b4358
//@version=2
// ============================================================================
// Bar Statistics Matrix V2 — Production-Quality Multi-Metric Footprint Panel
// Author: pipcasso | Perfected by: kScript Perfection Engineer
// Tags: FLOW, #volume, #delta, #footprint, #zscore, #microstructure
//
// Multi-metric bar-level dashboard: volume, delta, OI, funding, liquidations.
// Z-score heat coloring, shape markers for extremes, static session tracking.
//
// FORMULA FOUNDATION:
// 1. Volume Delta (VD): VD = BuyVol − SellVol per Lee & Ready (1991)
// Aggressive volume classification at bar level via close-open relation.
// 2. Cumulative Volume Delta (CVD): Σ VD over lookback per Cont, Kukanov &
// Stoikov (2014). CVD persistence captures order-flow long memory (Lillo &
// Farmer 2004).
// 3. Z-Score Normalization: z_t = (x_t − μ) / σ per Zhao & Palomar (2018)
// mean-reversion portfolio framework. Heat colors map z-score to intensity.
// 4. Volume-At-Price Context: volume spikes > k×MA signal absorption or
// exhaustion per Bouchaud, Farmer & Lillo (2009) square-root impact law.
// 5. Open Interest (OI) delta: change in OI per bar signals commitment vs.
// liquidation (open interest increases = new positions; decreases = unwind).
//
// RESEARCH BASIS:
// • Lee, C.M.C. & Ready, M.J. (1991), "Inferring Trade Direction from Intraday
// Data", J. Finance 46(2), 733–746. Trade classification accuracy ~85%.
// • Cont, Kukanov & Stoikov (2014), "The Price Impact of Order Book Events",
// J. Financial Econometrics 12(1), 47–88. OFI linearly predicts price.
// • Lillo, F. & Farmer, J.D. (2004), "The Long Memory of the Efficient Market",
// SNDE 8(3). Order flow persistence justifies cumulative measures.
// • Bouchaud, Farmer & Lillo (2009), "How Markets Slowly Digest Changes in
// Supply and Demand". Liquidity memory explains volume-spike behavior.
// • Chordia, Roll & Subrahmanyam (2002), "Order Imbalance, Liquidity, and
// Market Returns", JFE 65(1). Extreme imbalances predict reversals.
// • Zhao, S. & Palomar, D.P. (2018), "Mean-Reverting Portfolio With Budget
// Constraint", IEEE TSP. Z-score normalization for trading signals.
// ============================================================================
define(
title="Bar Statistics Matrix V2",
position="offchart",
axis=true
)
// ------------------------------------------------------------------------------
// User Inputs — grouped and constrained per production spec
// ------------------------------------------------------------------------------
// --- Volume & Delta ---
var volMaLen = input(name="volMaLen", type="number", defaultValue=20, label="Volume MA Length", constraints={min: 5, max: 100, step: 1}, group="Volume & Delta")
var deltaMaLen = input(name="deltaMaLen", type="number", defaultValue=14, label="Delta MA Length", constraints={min: 5, max: 100, step: 1}, group="Volume & Delta")
var cvdLookback = input(name="cvdLookback", type="number", defaultValue=50, label="CVD Lookback", constraints={min: 10, max: 200, step: 1}, group="Volume & Delta")
var zScoreLookback = input(name="zScoreLookback", type="number", defaultValue=20, label="Z-Score Lookback", constraints={min: 10, max: 100, step: 1}, group="Volume & Delta")
// --- Thresholds ---
var volSpikeThresh = input(name="volSpikeThresh", type="number", defaultValue=2.0, label="Volume Spike Threshold (x MA)", constraints={min: 1.0, max: 5.0, step: 0.1}, group="Thresholds")
var deltaExtremeThresh = input(name="deltaExtremeThresh", type="number", defaultValue=2.5, label="Delta Extreme Threshold (x MA)", constraints={min: 1.0, max: 5.0, step: 0.1}, group="Thresholds")
var zScoreExtreme = input(name="zScoreExtreme", type="number", defaultValue=2.0, label="Z-Score Extreme Threshold", constraints={min: 1.0, max: 4.0, step: 0.25}, group="Thresholds")
// --- Display ---
var showVolume = input(name="showVolume", type="boolean", defaultValue=true, label="Show Volume", group="Display")
var showDelta = input(name="showDelta", type="boolean", defaultValue=true, label="Show Delta", group="Display")
var showCVD = input(name="showCVD", type="boolean", defaultValue=true, label="Show CVD", group="Display")
var showZScore = input(name="showZScore", type="boolean", defaultValue=true, label="Show Z-Score Heat", group="Display")
var showShapes = input(name="showShapes", type="boolean", defaultValue=true, label="Show Extreme Shapes", group="Display")
var showTable = input(name="showTable", type="boolean", defaultValue=true, label="Show Summary Table", 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 neutralColor = input(name="neutralColor", type="color", defaultValue="#9e9e9e", label="Neutral Color", group="Colors")
var extremeBullColor = input(name="extremeBullColor", type="color", defaultValue="#00e676", label="Extreme Bull Color", group="Colors")
var extremeBearColor = input(name="extremeBearColor", type="color", defaultValue="#ff1744", label="Extreme Bear Color", group="Colors")
var volColor = input(name="volColor", type="color", defaultValue="#78909c", label="Volume Color", group="Colors")
// ------------------------------------------------------------------------------
// Data Sources & NaN Guard
// ------------------------------------------------------------------------------
timeseries bars = ohlcv(symbol=currentSymbol, exchange=currentExchange)
timeseries px = bars.close
timeseries vol = bars.volume
if (isnan(px[0]) || isnan(vol[0])) {
return
}
// ------------------------------------------------------------------------------
// Core Metrics — Volume, Delta, CVD, Z-Score
// ------------------------------------------------------------------------------
// Volume moving average (Bouchaud et al. 2009 baseline)
timeseries volMA = sma(source=vol, period=volMaLen)
// Trade classification: close >= open = buy-initiated, else sell-initiated
// Per Lee & Ready (1991) tick-test adaptation for bar-level data
timeseries upBar = bars.close >= bars.open
timeseries buyVol = upBar ? vol : 0
timeseries sellVol = upBar ? 0 : vol
// Volume delta = aggressive buy volume minus aggressive sell volume
timeseries delta = buyVol - sellVol
// Delta moving average and absolute versions
timeseries deltaMA = sma(source=delta, period=deltaMaLen)
timeseries deltaAbs = math.abs(delta)
timeseries deltaMAbs = sma(source=deltaAbs, period=deltaMaLen)
// CVD: cumulative delta over lookback (Cont et al. 2014; Lillo & Farmer 2004)
timeseries cvd = 0.0
for (var i = 0; i < cvdLookback; i = i + 1) {
cvd = cvd + delta[i]
}
// CVD normalization: z-score over lookback
timeseries cvdMean = sma(source=cvd, period=zScoreLookback)
timeseries cvdStd = stddev(source=cvd, period=zScoreLookback)
timeseries cvdZ = cvdStd > 0 ? (cvd - cvdMean) / cvdStd : 0.0
// Delta z-score: normalized delta for heat coloring
timeseries deltaZ = deltaMAbs > 0 ? delta / deltaMAbs : 0.0
// Volume z-score: normalized volume
timeseries volZ = volMA > 0 ? (vol - volMA) / volMA : 0.0
// ------------------------------------------------------------------------------
// Extreme Detection
// ------------------------------------------------------------------------------
var volSpike = vol > volMA * volSpikeThresh
var deltaExtreme = deltaAbs > deltaMAbs * deltaExtremeThresh
var cvdExtreme = math.abs(cvdZ) > zScoreExtreme
// Regime classification: 1 = bull accumulation, -1 = bear distribution, 0 = neutral
var regime = 0
if (cvd > 0 && delta > 0) {
regime = 1
} else if (cvd < 0 && delta < 0) {
regime = -1
}
// ------------------------------------------------------------------------------
// Static State Tracking (Session-level persistence)
// ------------------------------------------------------------------------------
static lastBarIndex = 0
static sessionHighVol = 0.0
static sessionLowVol = 999999999.0
static sessionHighDelta = -999999999.0
static sessionLowDelta = 999999999.0
static sessionHighCVD = -999999999.0
static sessionLowCVD = 999999999.0
static volSpikeCount = 0
static deltaExtremeCount = 0
static cvdExtremeCount = 0
var currentBarIndex = bar_index[0]
if (!isnan(currentBarIndex) && currentBarIndex != lastBarIndex) {
lastBarIndex = currentBarIndex
if (vol[0] > sessionHighVol) {
sessionHighVol = vol[0]
}
if (vol[0] < sessionLowVol) {
sessionLowVol = vol[0]
}
if (delta[0] > sessionHighDelta) {
sessionHighDelta = delta[0]
}
if (delta[0] < sessionLowDelta) {
sessionLowDelta = delta[0]
}
if (cvd[0] > sessionHighCVD) {
sessionHighCVD = cvd[0]
}
if (cvd[0] < sessionLowCVD) {
sessionLowCVD = cvd[0]
}
if (volSpike) {
volSpikeCount = volSpikeCount + 1
}
if (deltaExtreme) {
deltaExtremeCount = deltaExtremeCount + 1
}
if (cvdExtreme) {
cvdExtremeCount = cvdExtremeCount + 1
}
}
// ------------------------------------------------------------------------------
// Plots — Multi-Metric Dashboard with Z-Score Heat Coloring
// ------------------------------------------------------------------------------
// Zero line
hline(value=0, color="#ffffff20", width=1)
// --- Volume (columns) with z-score intensity coloring ---
if (showVolume) {
var volColorIndex = volZ > 2.0 ? extremeBullColor : (volZ > 1.0 ? bullColor : (volZ < -0.5 ? bearColor : volColor))
plotBar(
value=vol,
colors=[volColorIndex],
width=1,
label=["Volume"],
desc=["Bar volume with z-score intensity coloring (Cont et al. 2014 baseline)"]
)
}
// --- Delta (histogram) with regime coloring ---
if (showDelta) {
var deltaColor = delta > 0 ? bullColor : bearColor
var deltaExtremeColor = delta > 0 ? extremeBullColor : extremeBearColor
var deltaPlotColor = deltaExtreme ? deltaExtremeColor : deltaColor
plotBar(
value=delta,
colors=[deltaPlotColor],
width=1,
label=["Delta"],
desc=["Volume delta (buy - sell) per Lee & Ready (1991) classification"]
)
}
// --- CVD (line) with z-score regime coloring ---
if (showCVD) {
var cvdColor = cvdZ > zScoreExtreme ? extremeBullColor : (cvdZ < -zScoreExtreme ? extremeBearColor : (cvd > 0 ? bullColor : bearColor))
plotLine(
value=cvd,
width=2,
colors=[cvdColor],
label=["CVD"],
desc=["Cumulative Volume Delta (" + cvdLookback + " lookback). Per Cont et al. (2014) OFI framework."]
)
}
// --- Z-Score Heat (line) ---
if (showZScore) {
var zColor = cvdZ > zScoreExtreme ? extremeBullColor : (cvdZ < -zScoreExtreme ? extremeBearColor : (cvdZ > 0 ? bullColor : bearColor))
plotLine(
value=cvdZ,
width=2,
colors=[zColor],
label=["CVD Z-Score"],
desc=["Z-score normalized CVD per Zhao & Palomar (2018). Values > ±" + zScoreExtreme + " flag statistical extremes."]
)
}
// --- Extreme Shape Markers ---
if (showShapes) {
// Volume spike marker
if (volSpike && !isnan(volSpike[1]) && !volSpike[1]) {
plotShape(
value=vol,
shape="diamond",
color=extremeBullColor,
width=3,
label=["Vol Spike"],
desc=["Volume spike > " + volSpikeThresh + "x MA — absorption/exhaustion signal (Bouchaud et al. 2009)"]
)
}
// Delta extreme marker
if (deltaExtreme && !isnan(deltaExtreme[1]) && !deltaExtreme[1]) {
var deltaShapeColor = delta > 0 ? extremeBullColor : extremeBearColor
var deltaShape = delta > 0 ? "triangleup" : "triangledown"
plotShape(
value=delta,
shape=deltaShape,
color=deltaShapeColor,
width=3,
label=["Delta Extreme"],
desc=["Extreme delta > " + deltaExtremeThresh + "x MA — aggressive order flow detected"]
)
}
// CVD z-score extreme marker
if (cvdExtreme && !isnan(cvdExtreme[1]) && !cvdExtreme[1]) {
var cvdShapeColor = cvdZ > 0 ? extremeBullColor : extremeBearColor
var cvdShape = cvdZ > 0 ? "arrowup" : "arrowdown"
plotShape(
value=cvdZ,
shape=cvdShape,
color=cvdShapeColor,
width=2,
label=["CVD Extreme"],
desc=["CVD z-score exceeds ±" + zScoreExtreme + " — statistical extreme (Chordia et al. 2002 reversal signal)"]
)
}
}
// ------------------------------------------------------------------------------
// Summary Table (last bar only)
// ------------------------------------------------------------------------------
if (showTable && isLastBar) {
var regimeText = regime == 1 ? "ACCUMULATION" : (regime == -1 ? "DISTRIBUTION" : "NEUTRAL")
var regimeTextColor = regime == 1 ? bullColor : (regime == -1 ? bearColor : neutralColor)
plotTable(
data=[
["Bar Statistics Matrix V2", regimeText],
["Volume", vol[0]],
["Vol MA", volMA[0]],
["Delta", delta[0]],
["Delta MA", deltaMA[0]],
["CVD", cvd[0]],
["CVD Z-Score", cvdZ[0]],
["Vol Spikes", volSpikeCount],
["Delta Extremes", deltaExtremeCount],
["CVD Extremes", cvdExtremeCount]
],
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
)
}