Volumatic Fair Value Gaps [BigBeluga]

🔵 OVERVIEW
The Volumatic Fair Value Gaps [BigBeluga] indicator detects and plots size-filtered Fair Value Gaps (FVGs) and immediately analyzes the bullish vs. bearish volume composition inside each gap. When an FVG forms, the tool samples volume from a 10× lower timeframe, splits it into Buy and Sell components, and overlays two compact bars whose percentages always sum to 100%. Each gap also shows its total traded volume. A live dashboard (top-right) summarizes how many bullish and bearish FVGs are currently active and their cumulative volumes—offering a quick read on directional participation and trend pressure.

🔵 CONCEPTS

• FVGs (Fair Value Gaps): Imbalance zones between three consecutive candles where price “skips” trading. The script plots bullish and bearish gaps and extends them until mitigated.
  
• Size Filtering: Only significant gaps (by relative size percentile) are drawn, reducing noise and emphasizing meaningful imbalances.
  

  // Gap Filters
  float diff         =  close[1] > open[1] ? (low - high[2]) / low * 100 : (low[2] - high) / high *100
  float sizeFVG   = diff / ta.percentile_nearest_rank(diff, 1000, 100) * 100
  bool  filterFVG = sizeFVG > 15

  
• Volume Decomposition: For each FVG, the indicator inspects a 10× lower timeframe and aggregates volume of bullish vs. bearish candles inside the gap’s span.
  
• 100% Split Bars: Two inline bars per FVG display the % Bull and % Bear shares; their total is always 100%.
  
• Total Gap Volume: A numeric label at the right edge of the FVG shows the total traded volume associated with that gap.
  
• Mitigation Logic: Gaps are removed when price closes through (or touches via high/low—user-selectable) the opposite boundary.
  
• Dashboard Summary: Counts and sums the active bullish/bearish FVGs and their total volumes to gauge directional dominance.
  

🔵 FEATURES

• Bullish & Bearish FVG plotting with independent color controls and visibility toggles.
  
• Adaptive size filter (percentile-based) to keep only impactful gaps.
  
• Lower-TF volume sampling at 10× faster resolution for more granular Buy/Sell breakdown.
  
• Per-FVG volume bars: two horizontal bars showing Bull % and Bear % (sum = 100%).
  
• Per-FVG total volume label displayed at the right end of the gap’s body.
  
• Mitigation source option: choose close or high/low for removing/invalidating gaps.
  
• Overlap control: older overlapped gaps are cleaned to avoid clutter.
  
• Auto-extension: active gaps extend right until mitigated.
  
• Dashboard: shows count of bullish/bearish gaps on chart and cumulative volume totals for each side.
  
• Performance safeguards: caps the number of active FVG boxes to maintain responsiveness.
  

🔵 HOW TO USE

• Turn on/off FVG types: Enable Bullish FVG and/or Bearish FVG depending on your focus.
  
• Tune the filter: The script already filters by relative size; if you need fewer (stronger) signals, increase the percentile threshold in code or reduce the number of displayed boxes.
  
• Choose mitigation source:
  close — stricter; gap is removed when a closing price crosses the boundary.
  high/low — more sensitive; a wick through the boundary mitigates the gap.
  
• Read the per-FVG bars:
  A higher Bull % inside a bullish gap suggests constructive demand backing the imbalance.
  A higher Bear % inside a bearish gap suggests supply is enforcing the imbalance.
  
• Use total gap volume: Larger totals imply more meaningful interest at that imbalance; confluence with structure/HTF levels increases relevance.
  
• Watch the dashboard: If bullish counts and cumulative volume exceed bearish, market pressure is likely skewed upward (and vice versa). Combine with trend tools or market structure for entries/exits.
  
• Optional: hide volume bars: Disable Volume Bars when you want a cleaner FVG map while keeping total volume labels and the dashboard.
  

🔵 CONCLUSION
Volumatic Fair Value Gaps [BigBeluga] blends precise FVG detection with lower-timeframe volume analytics to show not only where imbalances exist but also who powers them. The per-gap Bull/Bear % bars, total volume labels, and the cumulative dashboard together provide a fast, high-signal read on directional participation. Use the tool to prioritize higher-quality gaps, align with trend bias, and time mitigations or continuations with greater confidence.