OPEN-SOURCE SCRIPT

Fair Value Gaps

3 337
Fair Value Gaps (FVG) auto-detects bullish (+FVG) and bearish (-FVG) three-candle imbalances on any chart, any timeframe. Tracks each gap's state through its lifecycle and shows a real-time dashboard with active gap counts, nearest gap distance, and exact zone prices.

WHAT IS A FAIR VALUE GAP

An FVG is a three-candle pattern where the middle candle moves so aggressively that it leaves a gap between the wick of the prior candle and the wick of the following candle. Price often returns to fill these gaps before continuing — making them useful as targets, entry zones, or invalidation levels.

A bullish (+FVG) forms when the low of the current candle is above the high of two candles ago, with a bullish middle candle. A bearish (-FVG) is the inverse.

FEATURES

Auto-detects pip size for JPY pairs, other forex, metals, indices, and crypto — no manual configuration needed
Tracks up to 10 active FVGs per side with configurable minimum size filter to ignore noise
Auto-removes filled FVGs OR keeps them on chart greyed out (your choice)
Optional midline marker (50% mitigation level)
Configurable label limit so only your most recent active gaps are annotated — prevents chart clutter
Dashboard shows active count, distance to nearest gap, and exact zone prices
Cells highlight amber when price is currently inside a gap (mid-mitigation)
Movable dashboard position (six options) so it coexists with other indicators
Built-in alerts for new bullish and bearish FVG formations

HOW TO USE

Use FVGs as targets when price has left an unfilled gap behind — markets often return to fill them. Use them as entry zones when price retraces into a gap in the direction of the higher-timeframe trend. Use them as invalidation when price closes through a gap that should have held as support or resistance.

Particularly useful for SMC and ICT traders watching for liquidity sweeps followed by displacement into a fair value gap, then a retracement entry.

Pairs cleanly with the Key Swing Levels (KSL) indicator from the same author — KSL's dashboard defaults to top-right, FVG's to bottom-left, no overlap.

Open-source. Feedback and forks welcome.

Disclaimer

The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.