Indicator · Pine Script v6 · On the chart

Fair Value Gaps Basic

by shubhamtaywade82

Marks three-candle fair value gaps on the price chart as shaded boxes, using green for bullish gaps and red for bearish gaps.

View on GitHub

Archived by its author

GitHub stars1on the repository
Pine versionv6current
Lines of code48
Settings5inputs
LicenceNone statedfile: MPL-2.0
Last update5 months ago31 May 2026

Add It to Your TradingView Chart

  1. 1Copy the scriptPress Copy script above, or the copy button on the code below.
  2. 2Open the Pine EditorOpen a TradingView chart and choose Pine Editor at the bottom of the screen.
  3. 3Paste over the templateCreate a new indicator, select all of the template text and paste. Press Save and give it a name.
  4. 4Add it to the chartPress Add to chart, then adjust the settings with the gear icon next to its name.

Source Code

48 lines of Pine Script v6 from indicators/agent-examples/fair-value-gaps-basic.pine, published under MPL-2.0 (file header). Keep the author's credit and licence lines when you reuse it.

fair-value-gaps-basic.pine
// This Pine Script® code is subject to the terms of the Mozilla Public License 2.0 at https://mozilla.org/MPL/2.0/
// Ported from pinescript-agents/examples/simple/fair-value-gaps-basic.pine for local testing in pinescripts-collections.

//@version=6
indicator("Fair Value Gaps Basic [Agent Example]", "FVG · AE", overlay=true, max_boxes_count=100)

show_bullish = input.bool(true, "Show Bullish FVG", group="Display")
show_bearish = input.bool(true, "Show Bearish FVG", group="Display")
fvg_color_bull = input.color(color.new(#089981, 82), "Bullish FVG", group="Colors")
fvg_color_bear = input.color(color.new(#f23645, 82), "Bearish FVG", group="Colors")
max_boxes = input.int(50, "Max FVG Boxes", minval=1, maxval=100, group="Settings")

var box[] bullish_fvgs = array.new<box>()
var box[] bearish_fvgs = array.new<box>()

is_bullish_fvg() =>
    high[2] < low[0] and close[1] > open[1]

is_bearish_fvg() =>
    low[2] > high[0] and close[1] < open[1]

cleanup_boxes(boxes_array) =>
    while array.size(boxes_array) > max_boxes
        old_box = array.shift(boxes_array)
        box.delete(old_box)

if barstate.isconfirmed
    if show_bullish and is_bullish_fvg()
        fvg_top = low[0]
        fvg_bottom = high[2]
        fvg_left = bar_index - 1
        fvg_right = bar_index + 20
        new_box = box.new(fvg_left, fvg_top, fvg_right, fvg_bottom, bgcolor=fvg_color_bull, border_color=color.new(#089981, 0))
        array.push(bullish_fvgs, new_box)
        cleanup_boxes(bullish_fvgs)
    if show_bearish and is_bearish_fvg()
        fvg_top = low[2]
        fvg_bottom = high[0]
        fvg_left = bar_index - 1
        fvg_right = bar_index + 20
        new_box = box.new(fvg_left, fvg_top, fvg_right, fvg_bottom, bgcolor=fvg_color_bear, border_color=color.new(#f23645, 0))
        array.push(bearish_fvgs, new_box)
        cleanup_boxes(bearish_fvgs)

bull_fvg_bar = is_bullish_fvg()
bear_fvg_bar = is_bearish_fvg()
alertcondition(bull_fvg_bar, "Bullish FVG", "Bullish Fair Value Gap detected")
alertcondition(bear_fvg_bar, "Bearish FVG", "Bearish Fair Value Gap detected")

Overview

A gap is drawn once the bar is confirmed, and each box extends twenty bars to the right. Settings toggle each direction, change colours and cap the number of boxes kept. It does not track whether a gap is later filled. Alerts are available for new bullish and bearish gaps.

Details

Published by

shubhamtaywade82 on GitHub

Draws

On the price chart

Markets

Any symbol

Timeframes

Any timeframe

Risk Notes

No repainting, lookahead or stacked entries were found in its code or README. That says nothing about how well it works: test it first.

Settings

The inputs you can change from the gear icon on the chart. Defaults are the author's.

SettingTypeDefaultVariable
Show Bullish FVGbooltrueshow_bullish
Show Bearish FVGbooltrueshow_bearish
Bullish FVGcolorcolor.new(#089981, 82)fvg_color_bull
Bearish FVGcolorcolor.new(#f23645, 82)fvg_color_bear
Max FVG Boxesint50max_boxes
Third-party code. ForexR did not write, test or endorse this script, and the summary above was generated automatically from its code and README. Indicators describe the past, and a strategy's backtest can look better than live trading, especially when a script repaints. Check it in the Strategy Tester and on a demo account before you rely on it.

Similar Pine Scripts

575 stars

The indicator plots ICT displacement candles on the price chart and can switch to retracement scanning. Displacement requires a move larger than a set share of the 14-bar average high-low range, lasting at least a chosen number of bars, with optional close, pr

Indicator v6 SMC / ICT / price actionCandlestick patterns
Updated 1 year ago · MPL-2.0 GitHub repository of ICT Displacement Candles Indicator

DE-tracker

by Allen1212
303 stars

This indicator plots labels on the TradingView price chart to mark ARK Invest's buy and sell trades for the DE stock. Buy transactions appear in green with X1 or X2 multipliers showing the number of ARK ETFs involved on the same day; sells appear in red. The m

Indicator v4 Support & resistanceSMC / ICT / price action
Updated 2 years ago · None stated GitHub repository of DE-tracker

This Pine Script indicator plots a ZigZag on the price chart. It identifies reversal points when price moves more than a set percentage from the last pivot. The script calculates forecasts using zigzag data and labels detected geometric patterns including harm

Indicator v4 TrendSupport & resistance

Fair Value Gaps - Basic

by TradersPost
228 stars

This indicator detects bullish and bearish fair value gaps on the price chart and draws a translucent box for each gap. A bullish gap needs the high two bars back below the current low and a bullish middle candle; a bearish gap uses the opposite gap and a bear

Indicator v6 SMC / ICT / price action
Updated 3 months ago · None stated GitHub repository of Fair Value Gaps - Basic

Open Source Fractal

by cantolab
183 stars

This indicator implements the Fractal Model concept to plot market structure shifts, liquidity sweeps, and Change in State of Delivery (CISD) levels. It overlays custom higher-timeframe candle previews, open prices, and time markers directly on the price chart

Indicator v6 SMC / ICT / price actionSupport & resistance
Updated 2 months ago · MIT GitHub repository of Open Source Fractal

Swing Failure Signals

by Ganador1
154 stars

This indicator calculates pivot highs and pivot lows to detect liquidity sweeps and Swing Failure Patterns. It identifies when price breaks past recent key swing highs or lows within a configurable historical window, then looks for a quick reversal or change i

Indicator v6 SMC / ICT / price actionSupport & resistance
Updated 2 months ago · Apache-2.0 GitHub repository of Swing Failure Signals

More SMC / ICT scripts

Related on ForexR

Trade Your Charts With a Regulated Broker

Compare brokers that connect to TradingView, with spreads, minimum deposits and leverage side by side.

Compare brokers