Volume DNA: Heatmap [BigBeluga]

The Volume DNA: Heatmap is an advanced technical indicator created by BigBeluga to decode institutional volume and price action dynamics using market microstructure principles. Traditional volume indicators often look at volume in isolation, failing to account for the efficiency or inefficiency of price movement. In order to provide a solution to this problem, this indicator combines rolling volume Z-scores with high-low price spread Z-scores, classifying every single bar into distinct institutional signatures—such as Absorption, Effort, Exhaustion, and Stagnation.



The indicator aims to visualize institutional accumulation, distribution, and exhaustion points directly on the chart. The core element of its calculation involves tracking volume and spread deviations against rolling means defined as:

volZ = (volume - volMean) / volStd
spreadZ = (spread - spreadMean) / spreadStd

where volMean and spreadMean are moving averages over lookback lengths volLengthInput and spreadLengthInput, and volStd and spreadStd represent standard deviations. Higher values of volThreshInput and spreadThreshInput allow the indicator to filter out random market noise and isolate major institutional footprints.

The system utilizes a multi-layered matrix structure to provide actionable market intelligence:

1 — DNA Engine & Classification Matrix

• Absorption (ABS): Triggered by high volume and narrow spread via highVol and narrowSpread, signaling institutional limit orders absorbing market flow.
  
• Effort Bullish / Bearish (EFF+ / EFF-): Triggered by high volume and wide spread via highVol and wideSpread, signaling aggressive buying or selling pressure driving trend continuation.
  
• Exhaustion (EXH) & Stagnation (STG): Tracks low volume relative to price spreads to identify thin liquidity moves or equilibrium consolidation phases.
  

2 — Visual Enhancements & Ghost Glows

• Ghost Glow Effect: Renders a semi-transparent wider candle behind classified DNA bars using plotcandle(showGlowBar ? bodymax + glowExpand : na, ...) to visually distinguish key events from normal price action.
  
• Liquidity Clouds: Draws transparent box zones over Absorption bars extending cloudExtendInput bars to the right, marking where institutional limit orders may be resting.
  

3 — Real-Time Barcode Tape & Statistics Tables

• DNA Barcode Tape: Displays a vertical heatmap table on the chart showing the DNA type and volume of the last tapeRowsInput bars as a real-time institutional activity tape.
  
• Stats Panel Table: Summarizes current bar status, Volume Z-Scores via str.tostring(volZ, "#.##"), and Spread Z-Scores for instant quantitative feedback.
  

Apart from the basic visualization of institutional volume signatures, this tool can also act in alternative ways to support decision-making:

1. Spot Institutional Absorption: Look for ABS candles and their accompanying Liquidity Cloud zones to identify potential support or resistance levels where large market participants are absorbing flow.
2. Ride Trend Continuations via Effort: Monitor EFF+ and EFF- signal shapes (where size and color intensity scale with volume Z-scores) to confirm aggressive momentum driving price in the direction of the breakout.
3. Anticipate Reversals with Exhaustion: Watch for EXH signals where price moves on thin liquidity, signaling that a current trend may be running out of fuel and nearing a pullback or reversal.

Why this implementation is unique:

• It merges volume and price spread analytics using statistical Z-scores rather than arbitrary thresholds, offering an objective look at market efficiency.
• The multi-table interface provides both historical sequencing (Barcode Tape) and real-time metric tracking without crowding the main price action view.
• The script is fully optimized for Pine Script version 6, utilizing high-performance array management (`var array<int> dnaHistory = array.new<int>(tapeRowsInput, 0)`) for smooth execution across extensive historical data.
• Note: The indicator relies on rolling standard deviation calculations; initial chart loads require enough bars to populate the lookback window accurately.