MM Flow
FlowScripts

Perfected FlowScript

Bar Stats • [Leviathan]

Bar Stats Leviathan V2 is indexed as 123_bar_stats_leviathan.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

19.4 KB

Lines

415

Native Signal Candidates

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

10/10 guarded

VD Extreme+

line 352:9

Trigger

(showShapes) && (vdExtremeUp)

Value

vdZ

Deps

showShapes:input, vdExtremeUp:var

VD Extreme-

line 355:9

Trigger

(showShapes) && (vdExtremeDn)

Value

vdZ

Deps

showShapes:input, vdExtremeDn:var

OI Extreme+

line 358:9

Trigger

(showShapes) && (oidExtremeUp)

Value

oidZ + rowOffset

Deps

oidExtremeUp:var, showShapes:input

OI Extreme-

line 361:9

Trigger

(showShapes) && (oidExtremeDn)

Value

oidZ + rowOffset

Deps

oidExtremeDn:var, showShapes:input

Fund Extreme+

line 364:9

Trigger

(showShapes) && (fExtremeUp)

Value

fZ + rowOffset * 2

Deps

fExtremeUp:var, showShapes:input

Fund Extreme-

line 367:9

Trigger

(showShapes) && (fExtremeDn)

Value

fZ + rowOffset * 2

Deps

fExtremeDn:var, showShapes:input

OB Extreme+

line 370:9

Trigger

(showShapes) && (obExtremeUp)

Value

obZ + rowOffset * 3

Deps

obExtremeUp:var, showShapes:input

OB Extreme-

line 373:9

Trigger

(showShapes) && (obExtremeDn)

Value

obZ + rowOffset * 3

Deps

obExtremeDn:var, showShapes:input

Comp Bull

line 376:9

Trigger

(showShapes) && (compCrossUp)

Value

composite + rowOffset * 4

Deps

compCrossUp:var, showShapes:input

Comp Bear

line 379:9

Trigger

(showShapes) && (compCrossDn)

Value

composite + rowOffset * 4

Deps

compCrossDn:var, showShapes:input

123_bar_stats_leviathan.flowscript

source path: kscripts/perfected/123_bar_stats_leviathan.flowscript · sha256:6be986a5c135ee289fb4713ec996f08ebf5731753c7119897ddc5e54ad500bd5

hash verified
//@version=2
// ============================================================================
// Bar Stats Leviathan V2 — Production-Quality Multi-Metric Bar Microstructure Dashboard
// Author: Leviathan (@Leviathan) | Perfected by: kScript Perfection Engineer
// Tags: ADVANCED, #barstatistics, #oi, #cvd, #liquidations, #orderbook, #microstructure
//
// Multi-metric bar-level dashboard computing z-score normalized statistics across
// volume delta, open-interest delta, funding rate, and orderbook imbalance.
// Each metric is colored by statistical significance (heat-map intensity) with
// extreme-event shape markers and a composite aggregate score.
//
// FORMULA FOUNDATION:
// 1. Volume Delta (tick-rule classified): buyV − sellV where buyV = V if close ≥ mid, else 0
// 2. Open-Interest Delta: ΔOI = OI[t] − OI[t−1] (proxy for position buildup / liquidation)
// 3. Funding Rate Z-Score: z = (f − μ_f) / σ_f over rolling lookback
// 4. Orderbook Imbalance: OBI = (BidVol − AskVol) / (BidVol + AskVol) ∈ [−1, +1]
// 5. Composite Aggregate: weighted average of normalized z-scores, EMA-smoothed
//
// RESEARCH BASIS:
//  • Hasbrouck (2007), "Empirical Market Microstructure": trade classification, VAR
//    price-discovery models, spread decomposition. Underpins multi-metric framework.
//  • Cont, Kukanov & Stoikov (2014), J. Financial Econometrics 12(1), 47–88.
//    Linear OFI-price impact: ΔP = λ·OFI + ε. Validates volume delta + OBI.
//  • Brunnermeier & Pedersen (2009), "Market Liquidity and Funding Liquidity":
//    liquidity spiral framework. Funding liquidity ↔ market liquidity reinforcement.
//    Underpins funding rate + liquidations correlation.
//  • Easley, López de Prado & O'Hara (2012), "Flow Toxicity and Liquidity in a
//    High-Frequency World": VPIN = Σ|V_buy − V_sell| / ΣV_total. Volume imbalance
//    as toxicity metric; underpins z-score significance thresholds.
//  • Campbell, Ramadorai & Vuolteenaho (2005), "Caught On Tape": institutional
//    footprint detection from trade-size patterns; validates volume delta focus.
// ============================================================================

define(
    title="Bar Stats Leviathan V2",
    position="offchart",
    axis=true
)

// ------------------------------------------------------------------------------
// User Inputs — grouped and constrained per production spec
// ------------------------------------------------------------------------------

// --- Statistical Settings ---
var lookback = input(name="lookback", type="number", defaultValue=30, label="Z-Score Lookback", constraints={min: 10, max: 200, step: 5}, group="Statistics")

// --- Metric Toggles ---
var showVolDelta = input(name="showVolDelta", type="boolean", defaultValue=true, label="Show Volume Delta", group="Metrics")
var showOIDelta = input(name="showOIDelta", type="boolean", defaultValue=true, label="Show OI Delta", group="Metrics")
var showFunding = input(name="showFunding", type="boolean", defaultValue=true, label="Show Funding Rate", group="Metrics")
var showImbal = input(name="showImbal", type="boolean", defaultValue=true, label="Show Orderbook Imbalance", group="Metrics")
var showComposite = input(name="showComposite", type="boolean", defaultValue=true, label="Show Composite Aggregate", group="Metrics")

// --- 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")
var showGuides = input(name="showGuides", type="boolean", defaultValue=true, label="Show Z-Score Guide Lines", group="Display")

// --- External Data Configuration ---
var oiSymbol = input(name="oiSymbol", type="string", defaultValue="BTCUSDT", label="OI Symbol", group="External Data")
var oiExchange = input(name="oiExchange", type="string", defaultValue="BYBIT", label="OI Exchange", group="External Data")
var fundSymbol = input(name="fundSymbol", type="string", defaultValue="BTCUSDT", label="Funding Symbol", group="External Data")
var fundExchange = input(name="fundExchange", type="string", defaultValue="BYBIT", label="Funding Exchange", group="External Data")

// --- Colors ---
var bullColor = input(name="bullColor", type="color", defaultValue="#26a69a", label="Bullish Color", group="Colors")
var bearColor = input(name="bearColor", type="color", defaultValue="#ef5350", label="Bearish Color", group="Colors")
var neutralColor = input(name="neutralColor", type="color", defaultValue="#9e9e9e", label="Neutral Color", group="Colors")
var extremeBidColor = input(name="extremeBidColor", 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")

// --- Thresholds ---
var zModerate = input(name="zModerate", type="number", defaultValue=1.0, label="Moderate Z-Score Threshold", constraints={min: 0.5, max: 2.0, step: 0.1}, group="Thresholds")
var zStrong = input(name="zStrong", type="number", defaultValue=2.0, label="Strong Z-Score Threshold", constraints={min: 1.0, max: 3.0, step: 0.1}, group="Thresholds")
var zExtreme = input(name="zExtreme", type="number", defaultValue=3.0, label="Extreme Z-Score Threshold", constraints={min: 2.0, max: 5.0, step: 0.1}, group="Thresholds")

// ------------------------------------------------------------------------------
// Data Sources
// ------------------------------------------------------------------------------
timeseries bars = ohlcv(symbol=currentSymbol, exchange=currentExchange)
timeseries c = bars.close
timeseries h = bars.high
timeseries l = bars.low
timeseries v = bars.volume

timeseries oiSeries = open_interest(symbol=oiSymbol, exchange=oiExchange)
timeseries fundSeries = funding_rate(symbol=fundSymbol, exchange=fundExchange)
timeseries book = source("orderbook", currentSymbol, currentExchange)

// NaN guard — prevent execution before data is loaded (Hasbrouck 2007 data-integrity best practice)
if (isnan(c[0])) {
    return
}

// External data availability flags
var oiAvailable = !isnan(oiSeries.close[0]) && !isnan(oiSeries.close[1])
var fundAvailable = !isnan(fundSeries[0])

// ------------------------------------------------------------------------------
// Metric 1: Volume Delta (Tick-Rule Classified)
// ------------------------------------------------------------------------------
// Per Hasbrouck (2007), tick rule classifies trades as buyer-initiated (close ≥ mid)
// or seller-initiated (close < mid). Cumulative delta = Σ(buyV − sellV).

var mid = (h + l) / 2.0
var buyV = c >= mid ? v : 0.0
var sellV = c < mid ? v : 0.0
var volDelta = buyV - sellV

var vdMean = sma(volDelta, lookback)
var vdStd = stddev(volDelta, lookback)
var vdZ = vdStd > 0 ? (volDelta - vdMean) / vdStd : 0.0

// ------------------------------------------------------------------------------
// Metric 2: Open-Interest Delta
// ------------------------------------------------------------------------------
// ΔOI = OI[t] − OI[t−1]. Positive ΔOI with rising price = new longs building.
// Negative ΔOI with falling price = long liquidation (Brunnermeier & Pedersen 2009).

var oiDelta = oiAvailable ? oiSeries.close - nz(oiSeries.close[1]) : 0.0
var oidMean = sma(oiDelta, lookback)
var oidStd = stddev(oiDelta, lookback)
var oidZ = oidStd > 0 ? (oiDelta - oidMean) / oidStd : 0.0

// ------------------------------------------------------------------------------
// Metric 3: Funding Rate Z-Score
// ------------------------------------------------------------------------------
// Positive funding = longs pay shorts (bullish bias); negative = shorts pay longs.
// Z-score standardizes against historical distribution.

var fMean = sma(fundSeries, lookback)
var fStd = stddev(fundSeries, lookback)
var fZ = fundAvailable && fStd > 0 ? (fundSeries - fMean) / fStd : 0.0

// ------------------------------------------------------------------------------
// Metric 4: Orderbook Imbalance (OBI)
// ------------------------------------------------------------------------------
// OBI = (BidVol − AskVol) / (BidVol + AskVol) ∈ [−1, +1]
// Per Cont, Kukanov & Stoikov (2014): price impact ∝ OFI / depth.

var bids1 = sumBids(book, 1.0)
var asks1 = sumAsks(book, 1.0)
var bookAvailable = bids1 > 0 && asks1 > 0
var denomOb = bids1 + asks1
var obImbal = bookAvailable && denomOb > 0 ? (bids1 - asks1) / denomOb : 0.0

var obMean = sma(obImbal, lookback)
var obStd = stddev(obImbal, lookback)
var obZ = obStd > 0 ? (obImbal - obMean) / obStd : 0.0

// ------------------------------------------------------------------------------
// Z-Score Heat Color Mapping (four-level intensity)
// ------------------------------------------------------------------------------
// Heat levels: 0 = neutral, 1 = moderate, 2 = strong, 3 = extreme

var vdAbs = math.abs(vdZ)
var vdHeat = vdAbs >= zExtreme ? 3 : (vdAbs >= zStrong ? 2 : (vdAbs >= zModerate ? 1 : 0))
var vdColor = vdHeat == 3 ? (vdZ > 0 ? extremeBidColor : extremeBearColor) : (vdHeat == 2 ? (vdZ > 0 ? bullColor : bearColor) : (vdHeat == 1 ? (vdZ > 0 ? transparency(bullColor, 60) : transparency(bearColor, 60)) : neutralColor))

var oidAbs = math.abs(oidZ)
var oidHeat = oidAbs >= zExtreme ? 3 : (oidAbs >= zStrong ? 2 : (oidAbs >= zModerate ? 1 : 0))
var oidColor = oidHeat == 3 ? (oidZ > 0 ? extremeBidColor : extremeBearColor) : (oidHeat == 2 ? (oidZ > 0 ? bullColor : bearColor) : (oidHeat == 1 ? (oidZ > 0 ? transparency(bullColor, 60) : transparency(bearColor, 60)) : neutralColor))

var fAbs = math.abs(fZ)
var fHeat = fAbs >= zExtreme ? 3 : (fAbs >= zStrong ? 2 : (fAbs >= zModerate ? 1 : 0))
var fColor = fHeat == 3 ? (fZ > 0 ? extremeBidColor : extremeBearColor) : (fHeat == 2 ? (fZ > 0 ? bullColor : bearColor) : (fHeat == 1 ? (fZ > 0 ? transparency(bullColor, 60) : transparency(bearColor, 60)) : neutralColor))

var obAbs = math.abs(obZ)
var obHeat = obAbs >= zExtreme ? 3 : (obAbs >= zStrong ? 2 : (obAbs >= zModerate ? 1 : 0))
var obColor = obHeat == 3 ? (obZ > 0 ? extremeBidColor : extremeBearColor) : (obHeat == 2 ? (obZ > 0 ? bullColor : bearColor) : (obHeat == 1 ? (obZ > 0 ? transparency(bullColor, 60) : transparency(bearColor, 60)) : neutralColor))

// ------------------------------------------------------------------------------
// Composite Aggregate Score
// ------------------------------------------------------------------------------
// Weighted average of available z-scores. Normalized to approximate z-scale.

var activeCount = (showVolDelta ? 1 : 0) + (showOIDelta ? 1 : 0) + (showFunding ? 1 : 0) + (showImbal ? 1 : 0)
var compositeRaw = activeCount > 0 ? ((showVolDelta ? vdZ : 0) + (showOIDelta ? oidZ : 0) + (showFunding ? fZ : 0) + (showImbal ? obZ : 0)) / activeCount : 0.0
var composite = ema(compositeRaw, 3)

var compMean = sma(composite, lookback)
var compStd = stddev(composite, lookback)
var compZ = compStd > 0 ? (composite - compMean) / compStd : 0.0

var compAbs = math.abs(compZ)
var compHeat = compAbs >= zExtreme ? 3 : (compAbs >= zStrong ? 2 : (compAbs >= zModerate ? 1 : 0))
var compColor = compHeat == 3 ? (compZ > 0 ? extremeBidColor : extremeBearColor) : (compHeat == 2 ? (compZ > 0 ? bullColor : bearColor) : (compHeat == 1 ? (compZ > 0 ? transparency(bullColor, 60) : transparency(bearColor, 60)) : neutralColor))

// ------------------------------------------------------------------------------
// Regime Detection (Composite-based)
// ------------------------------------------------------------------------------
// Regime classification: Bullish = composite ≥ zModerate, Bearish = ≤ −zModerate.

var regime = 0      // 0 = neutral, 1 = bull, -1 = bear
var extremeRegime = 0  // 0 = normal, 1 = extreme bull, -1 = extreme bear

if (composite >= zModerate) {
    regime = 1
} else if (composite <= -zModerate) {
    regime = -1
}

if (composite >= zStrong) {
    extremeRegime = 1
} else if (composite <= -zStrong) {
    extremeRegime = -1
}

// ------------------------------------------------------------------------------
// Static State Tracking (Session-level persistence)
// ------------------------------------------------------------------------------
// Stateful computation for session highs/lows, extreme-event counters, and bar tracking.

static sessionHighComp = -999999.0
static sessionLowComp = 999999.0
static sessionHighVdZ = -999999.0
static sessionLowVdZ = 999999.0
static sessionHighOidZ = -999999.0
static sessionLowOidZ = 999999.0
static extremeCount = 0
static lastBarIndex = 0

var currentBarIndex = bar_index[0]

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

    if (composite > sessionHighComp) {
        sessionHighComp = composite
    }
    if (composite < sessionLowComp) {
        sessionLowComp = composite
    }
    if (vdZ > sessionHighVdZ) {
        sessionHighVdZ = vdZ
    }
    if (vdZ < sessionLowVdZ) {
        sessionLowVdZ = vdZ
    }
    if (oidZ > sessionHighOidZ) {
        sessionHighOidZ = oidZ
    }
    if (oidZ < sessionLowOidZ) {
        sessionLowOidZ = oidZ
    }

    if (math.abs(compZ) >= zExtreme) {
        extremeCount = extremeCount + 1
    }
}

// ------------------------------------------------------------------------------
// Plots — Multi-Row Dashboard with Z-Score Heat Coloring
// ------------------------------------------------------------------------------

hline(value=0, color="#ffffff30", width=1)

// Z-score guide lines
if (showGuides) {
    hline(value=zModerate, color=transparency(bullColor, 70), width=1)
    hline(value=-zModerate, color=transparency(bearColor, 70), width=1)
    hline(value=zStrong, color=transparency(bullColor, 40), width=1)
    hline(value=-zStrong, color=transparency(bearColor, 40), width=1)
    hline(value=zExtreme, color=transparency(extremeBidColor, 30), width=1)
    hline(value=-zExtreme, color=transparency(extremeBearColor, 30), width=1)
}

// Row offsets for visual separation in off-chart dashboard
var rowOffset = 6.0

// Volume Delta row (base level 0)
if (showVolDelta) {
    plotBar(
        value=vdZ,
        colors=[vdColor],
        width=1,
        label=["Vol Delta Z"],
        desc=["Volume Delta z-score: tick-rule classified buy/sell volume imbalance"]
    )
}

// OI Delta row
if (showOIDelta) {
    plotBar(
        value=oidZ + rowOffset,
        colors=[oidColor],
        width=1,
        label=["OI Delta Z"],
        desc=["Open Interest Delta z-score: position buildup / liquidation proxy"]
    )
}

// Funding Rate row
if (showFunding) {
    plotBar(
        value=fZ + rowOffset * 2,
        colors=[fColor],
        width=1,
        label=["Funding Z"],
        desc=["Funding Rate z-score: positive = longs pay shorts (bullish bias)"]
    )
}

// Orderbook Imbalance row
if (showImbal) {
    plotBar(
        value=obZ + rowOffset * 3,
        colors=[obColor],
        width=1,
        label=["OB Imbalance Z"],
        desc=["Orderbook Imbalance z-score: bid/ask pressure at 1% depth (Cont et al. 2014)"]
    )
}

// Composite aggregate line (top row with fill)
if (showComposite) {
    plotLine(
        value=composite + rowOffset * 4,
        width=2,
        colors=[compColor],
        label=["Composite Aggregate"],
        desc=["Weighted aggregate of all metric z-scores (EMA-smoothed). Regime-coded."],
        fill=true
    )
}

// ------------------------------------------------------------------------------
// Extreme Event Shape Markers
// ------------------------------------------------------------------------------
if (showShapes) {
    // Volume Delta extremes
    var vdExtremeUp = vdZ >= zExtreme && !isnan(vdZ[1]) && vdZ[1] < zExtreme
    var vdExtremeDn = vdZ <= -zExtreme && !isnan(vdZ[1]) && vdZ[1] > -zExtreme

    // OI Delta extremes
    var oidExtremeUp = oidZ >= zExtreme && !isnan(oidZ[1]) && oidZ[1] < zExtreme
    var oidExtremeDn = oidZ <= -zExtreme && !isnan(oidZ[1]) && oidZ[1] > -zExtreme

    // Funding extremes
    var fExtremeUp = fZ >= zExtreme && !isnan(fZ[1]) && fZ[1] < zExtreme
    var fExtremeDn = fZ <= -zExtreme && !isnan(fZ[1]) && fZ[1] > -zExtreme

    // Orderbook extremes
    var obExtremeUp = obZ >= zExtreme && !isnan(obZ[1]) && obZ[1] < zExtreme
    var obExtremeDn = obZ <= -zExtreme && !isnan(obZ[1]) && obZ[1] > -zExtreme

    // Composite regime cross shapes
    var compCrossUp = composite >= zModerate && !isnan(composite[1]) && composite[1] < zModerate
    var compCrossDn = composite <= -zModerate && !isnan(composite[1]) && composite[1] > -zModerate

    if (vdExtremeUp) {
        plotShape(value=vdZ, shape="triangleup", color=extremeBidColor, width=3, label=["VD Extreme+"], desc=["Volume delta extreme positive z-score"])
    }
    if (vdExtremeDn) {
        plotShape(value=vdZ, shape="triangledown", color=extremeBearColor, width=3, label=["VD Extreme-"], desc=["Volume delta extreme negative z-score"])
    }
    if (oidExtremeUp) {
        plotShape(value=oidZ + rowOffset, shape="triangleup", color=extremeBidColor, width=3, label=["OI Extreme+"], desc=["OI delta extreme positive z-score"])
    }
    if (oidExtremeDn) {
        plotShape(value=oidZ + rowOffset, shape="triangledown", color=extremeBearColor, width=3, label=["OI Extreme-"], desc=["OI delta extreme negative z-score"])
    }
    if (fExtremeUp) {
        plotShape(value=fZ + rowOffset * 2, shape="triangleup", color=extremeBidColor, width=3, label=["Fund Extreme+"], desc=["Funding rate extreme positive z-score"])
    }
    if (fExtremeDn) {
        plotShape(value=fZ + rowOffset * 2, shape="triangledown", color=extremeBearColor, width=3, label=["Fund Extreme-"], desc=["Funding rate extreme negative z-score"])
    }
    if (obExtremeUp) {
        plotShape(value=obZ + rowOffset * 3, shape="triangleup", color=extremeBidColor, width=3, label=["OB Extreme+"], desc=["Orderbook imbalance extreme positive z-score"])
    }
    if (obExtremeDn) {
        plotShape(value=obZ + rowOffset * 3, shape="triangledown", color=extremeBearColor, width=3, label=["OB Extreme-"], desc=["Orderbook imbalance extreme negative z-score"])
    }
    if (compCrossUp) {
        plotShape(value=composite + rowOffset * 4, shape="triangleup", color=extremeBidColor, width=3, label=["Comp Bull"], desc=["Composite aggregate crossed into bullish regime"])
    }
    if (compCrossDn) {
        plotShape(value=composite + rowOffset * 4, shape="triangledown", color=extremeBearColor, width=3, label=["Comp Bear"], desc=["Composite aggregate crossed into bearish regime"])
    }
}

// ------------------------------------------------------------------------------
// Summary Table (last bar only)
// ------------------------------------------------------------------------------
if (showTable && isLastBar) {
    var regimeText = regime == 1 ? "BULLISH" : (regime == -1 ? "BEARISH" : "NEUTRAL")
    var regimeTextColor = regime == 1 ? bullColor : (regime == -1 ? bearColor : neutralColor)

    plotTable(
        data=[
            ["Bar Stats Leviathan", regimeText],
            ["Vol Delta Z", vdZ[0]],
            ["OI Delta Z", oidZ[0]],
            ["Funding Z", fZ[0]],
            ["OB Imbalance Z", obZ[0]],
            ["Composite", composite[0]],
            ["Session High Comp", sessionHighComp],
            ["Session Low Comp", sessionLowComp],
            ["Extreme Events", extremeCount]
        ],
        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
    )
}