Liquidity Void Detector (Zeiierman)

█ Overview

Liquidity Void Detector (Zeiierman) is an oscillator highlighting inefficient price displacements under low participation. It measures the most recent price move (standardized return) and amplifies it only when volume is below its own trend.

• Positive readings ⇒ strong up-move on low volume → potential Buy-Side Imbalance (void below) that often refills.
  
• Negative readings ⇒ strong down-move on low volume → potential Sell-Side Imbalance (void above) that often refills.
  

This tool provides a quantitative “void” proxy: when price travels far with unusually thin volume, the move is flagged as likely inefficient and prone to mean-reversion/mitigation.


█ How It Works

⚪Volume Shock (Participation Filter)
Each bar, volume is compared to a rolling baseline. This is then z-scored.

// Volume Shock calculation
volTrend = ta.sma(volume, L)
vs       = (volume > 0 and volTrend > 0) ? math.log(volume) - math.log(volTrend) : na
vsZ      = zScore(vs, vzLen)  // z-scored volume shock
lowVS    = (vsZ <= vzThr)     // low-volume condition

Bars with VolShock Z ≤ threshold are treated as low-volume (thin).

⚪Prior Return Extremeness
The 1-bar log return is computed and z-scored.

// Prior return extremeness
r1   = math.log(close / close[1])
retZ = zScore(r1, rLen)  // z-scored prior return

This shows whether the latest move is unusually large relative to recent history.

⚪Void Oscillator
The oscillator is:

// Oscillator construction
weight = lowVS ? 1.0 : fadeNoLow
osc    = retZ * weight

where Weight = 1 when volume is low, otherwise fades toward a user-set factor (0–1).

• Osc > 0: up-move emphasized under low volume ⇒ Buy-Side Imbalance.
  
• Osc < 0: down-move emphasized under low volume ⇒ Sell-Side Imbalance.
  

█ Why Use It

⚪Targets Inefficient Moves
By filtering for low participation, the oscillator focuses on moves most likely driven by thin books/noise trading, which are statistically more likely to retrace.

⚪Simple, Robust Logic
No need for tick data or order-book depth. It derives a practical void proxy from OHLCV, making it portable across assets and timeframes.

⚪Complements Price-Action Tools
Use alongside FVG/imbalance zones, key levels, and volume profile to prioritize voids that carry the highest reversal probability.

█ How to Use

Sell-Side Imbalance = aggressive sell move (price goes down on low volume) → expect price to move up to fill it.


Buy-Side Imbalance = aggressive buy move (price goes up on low volume) → expect price to move down to fill it.


█ Settings

• Volume Baseline Length — Bars for the volume trend used in VolShock. Larger = smoother baseline, fewer low-volume flags.
  
• Vol Shock Z-Score Lookback — Bars to standardize VolShock; larger = smoother, fewer extremes.
  
• Low-Volume Threshold (VolShock Z ≤) — Defines “thin participation.” Typical: −0.5 to −1.0.
  
• Return Z-Score Lookback — Bars to standardize the 1-bar log return; larger = smoother “extremeness” measure.
  
• Fade When Volume Not Low (0–1) — Weight applied when volume is not low. 0.00 = ignore non-low-volume bars entirely. 1.00 = treat volume condition as irrelevant (pure return extremeness).
  
• Upper Threshold (Osc ≥) — Trigger for Sell-Side Imbalance (void below).
  
• Lower Threshold (Osc ≤) — Trigger for Buy-Side Imbalance (void above).
  

-----------------
Disclaimer

The content provided in my scripts, indicators, ideas, algorithms, and systems is for educational and informational purposes only. It does not constitute financial advice, investment recommendations, or a solicitation to buy or sell any financial instruments. I will not accept liability for any loss or damage, including without limitation any loss of profit, which may arise directly or indirectly from the use of or reliance on such information.

All investments involve risk, and the past performance of a security, industry, sector, market, financial product, trading strategy, backtest, or individual's trading does not guarantee future results or returns. Investors are fully responsible for any investment decisions they make. Such decisions should be based solely on an evaluation of their financial circumstances, investment objectives, risk tolerance, and liquidity needs.