What this TradingView script does
The Volumatic Fair Value Gaps 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 > open ? (low - high) / low * 100 : (low - 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.
How traders can use it
Use Volumatic Fair Value Gaps as a chart context layer inside TradingView: read the structure it highlights, compare it with your market bias, and let the script narrow which moves deserve attention.
The strongest workflow is to combine the script with higher timeframe structure, volume context, and a repeatable execution plan instead of treating any single label as a standalone trade.




