Multitimeframe Fair Value Gap – FVG (Zeiierman)

█ Overview
The Multitimeframe Fair Value Gap – FVG (Zeiierman) indicator provides a dynamic and customizable visualization of institutional imbalances (Fair Value Gaps) across multiple timeframes. Built for traders who seek to analyze price inefficiencies, this tool helps highlight potential entry points, unmitigated gaps, and directional bias using smart volume logic and adaptive visual elements.



A Fair Value Gap (FVG) forms when there's a three-candle sequence in which a market imbalance leaves a "gap" between the wicks of candle 1 and candle 3. These areas are often considered footprints of institutional activity, and this indicator gives you the tools to track them with surgical precision across any timeframe you choose—regardless of the one you're viewing.

This indicator also includes a trend filter powered by a low-pass Butterworth filter, enabling traders to distinguish between countertrend vs. trend-aligned FVGs for more intelligent decision-making. On top of that, it features a dynamic FVG table for live tracking and bull/bear volume power visualization inside each gap, adding powerful clarity to market intent.



█ How It Works
The indicator analyzes the open, high, low, close, and volume of candles from a user-selected timeframe. It identifies Fair Value Gaps based on wick logic and only confirms those that meet customizable strength criteria. Once detected, the indicator visualizes each FVG with dynamically extending boxes, optional buy/sell volume bars, and a real-time mitigation check.

⚪ Multitimeframe Logic
Users can analyze FVGs from a higher or lower timeframe regardless of their current chart.
This is achieved using request.security() to fetch OHLCV data from the chosen timeframe.

⚪ Wick Sensitivity & Impulse Filter
The script measures the wick size of potential FVG candles and compares them to a running average. Only FVGs with wick sizes above a certain sensitivity threshold (user-controlled) are plotted. This ensures only meaningful price dislocations (e.g., strong impulsive moves) are shown, reducing noise.

⚪ Midpoint Mitigation Logic
FVGs are marked as "mitigated" when the price revisits the gap area. Traders can choose whether full gap closure or just a midpoint touch is required. This allows faster reactivity in real-time trading environments.

⚪ Bull & Bear Power – Volume-Weighted Visualization
Every Fair Value Gap box includes sub-bars representing the estimated buy and sell effort that created the gap. These are calculated using the candle's close in relation to its high/low range and volume:

• Buy Volume % ≈ effort from low to close
  
• Sell Volume % ≈ effort from high to close
  

Each sub-bar inside the FVG:

• Is color-coded (UpCol for bullish, DnCol for bearish)
  
• Is drawn proportionally to the strength of buyers or sellers
  
• Visually displays who was in control during the imbalance
  

⚪ FVG Table – Dynamic On-Chart Overview
The indicator includes an optional on-chart table that displays all currently active (unmitigated) FVGs in a side panel format:

• Automatic updates as gaps are formed and mitigated
  
• Color-coded rows to show bullish vs. bearish FVGs
  
• Timestamps to know precisely when the gap formed
  
• User-controlled position via Table Left and Table Right
  

This is a gap watchlist overlay, giving traders a concise view of current inefficiencies without manually scanning the chart.

⚪ FVG Trend Filter (Butterworth Smoother)
Using a two-pole Butterworth low-pass filter, the indicator computes a trendline based on average FVG values, offering a smooth but responsive directional signal.

• Passband Ripple (dB): Controls sensitivity and overshoot tolerance
  
• Cutoff Frequency (0–0.5): Sets how quickly the trendline reacts
  

The trendline helps categorize each FVG:

• Trend up → favor bullish FVGs
  
• Trend down → favor bearish FVGs
  

It adds an extra dimension to FVG entries, helping distinguish between trend-aligned and countertrend signals.

█ How to Use
⚪ Identify Institutional Gaps
Use this tool to identify areas where institutions may have left imbalances behind quickly.
These areas often become:

• Strong support/resistance zones
  
• Areas where price might react sharply
  
• Targets for liquidity sweeps or retracements
  

⚪ React to Trend or Countertrend
The built-in trendline helps categorize each FVG:

• Trend up → Bullish FVGs have higher validity
  
• Trend down → Bearish FVGs have higher validity
  

⚪ Volume Context via Bull/Bear Power
Each Fair Value Gap is more than just a price imbalance — it’s a story of effort and intent. The Bull/Bear Power feature visualizes the buy and sell pressure behind each FVG, helping you understand how the gap was formed and who was in control.

• A bullish FVG with a strong buy effort suggests continuation potential — buyers dominated the move.
  
• A bullish FVG with a dominant sell effort could signal a trap or reversal — sellers may have overwhelmed the breakout.
  
• These insights allow you to confirm imbalance strength, spot traps early, and add confidence to entries based on dominant volume profiles.
  

Instead of viewing gaps as static zones, this feature turns each into a live volume map — a visual breakdown of who moved the market and whether that move had conviction.



⚪ Plan with the FVG Table
The FVG Table acts as your on-chart control center for tracking active imbalances. When enabled, it provides a clear summary of all unmitigated Fair Value Gaps, helping you stay organized and focused during fast-moving sessions.

• Track live and historical gaps: See exactly when and where each FVG formed.
  
• Monitor older, still-valid zones: Gaps off-screen but not mitigated remain in play — perfect for anticipating future reactions.
  
• Gauge market bias at a glance: The balance of bullish vs. bearish FVGs helps you understand overall directional pressure.
  
• Plan entries confidently: Use the table to reference all zones for risk management, confluence stacking, or layered execution strategies.
  

Instead of manually scanning your chart, the FVG Table offers a clean, at-a-glance overview of the market’s inefficiencies — giving you the structure needed to act with precision.



█ Settings

• FVG Timeframe
  Select any timeframe to source FVGs independent of your current chart.
  
• Sensitivity
  Filter FVGs by how impulsive the move is — it helps you eliminate weak gaps.
  
• Mitigated on Mid
  Control whether gaps are removed at midpoint touch or full fill.
  
• Table Settings
  Control the table position and width. Cleanly view all active FVGs.
  
• FVG Style
  Customize gap box colors, length, and bullish/bearish overlays.
  
• Trend Filter
  Enable or disable the smoothed FVG-based trendline with customizable smoothing controls.
  

-----------------
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.