MM Flow
FlowScripts

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.

3/3 guarded

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

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