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