Get started

Fairvaluegap

FVG Retest Entry Engine [trade_w_samet]🎯 FVG Retest Entry Engine FVG Retest Entry Engine is a structured Fair Value Gap retest analysis indicator designed to help traders study confirmed gap reactions, structure alignment, filtered entry conditions, and multi-target visual trade models directly on the price chart. This script focuses on one main concept: FVG retest-based entry visualization. It is not designed to be a simple buy/sell signal generator. It is not designed to show every possible Fair Value Gap. It is not designed to create constant chart noise. Instead, the goal of FVG Retest Entry Engine is to detect confirmed structure events, identify eligible Fair Value Gaps, monitor their retests, apply configurable quality checkpoints, and visualize accepted setups using one entry level, one protective stop, and three take-profit levels. The indicator includes: • Bullish and bearish market-structure detection • BOS and CHoCH classification • Three-candle Fair Value Gap detection • Internal FVG memory and invalidation handling • Structure-linked FVG candidate selection • FVG quality scoring and setup grading • Armed-zone retest monitoring • Multiple retest confirmation models • Volume, Directional Force, and confirmed HTF bias filters • FVG Retest Passport • Blocker Lens state reporting • Confirmed-close signal commitment • Optional Live Preview dashboard state • Gap-protected and ATR-based stop-loss models • TP1, TP2, and TP3 risk-multiple projections • Optional breakeven movement after TP1 • Active and historical TP / SL areas • Executed FVG retest zones • One-active-trade-at-a-time logic • Mobile chart layout • Multiple visual themes • Advanced entry and lifecycle alerts • JSON webhook support • Compact bottom-right dashboard The purpose of this script is to help users visually study where a structure event and an eligible Fair Value Gap combine with a confirmed retest condition. It should be treated as a chart-analysis and educational decision-support tool. It is not financial advice. It is not an automated trading system. It does not guarantee profitable trades. It does not execute broker orders. It does not replace personal analysis, risk management, or trade validation. ━━━━━━━━━━━━━━━━━━━━━━ 📌 OVERVIEW ━━━━━━━━━━━━━━━━━━━━━━ At a high level, FVG Retest Entry Engine does the following: • Detects confirmed bullish and bearish structure breaks. • Classifies structure events as BOS or CHoCH. • Detects bullish and bearish three-candle Fair Value Gaps. • Stores valid FVG zones in internal memory. • Tracks zone direction, boundaries, age, displacement, volume context, and prior interactions. • Searches for an eligible FVG after a matching structure event. • Scores and ranks available FVG candidates. • Arms the best available zone for retest monitoring. • Waits for the selected minimum retest delay. • Detects the selected FVG retest pattern. • Evaluates reaction quality and optional confluence filters. • Assigns a setup grade such as A+, A, B, or FILTERED. • Confirms final entry conditions only when the chart candle closes. • Draws one Entry, one SL, and three TP levels. • Tracks TP1, TP2, TP3, stop-loss, and breakeven events. • Allows only one active trade projection at a time. • Keeps completed trade areas when historical display is enabled. • Marks completed models as bullish or bearish FVG Retest outcomes. • Displays the current bias, engine state, and active levels in the dashboard. • Provides entry, armed-zone, target, stop, breakeven, and webhook alert options. The script is intentionally built as a structured process. It does not include machine-learning prediction. It does not include guaranteed performance claims. It does not attempt to forecast every future market movement. It provides a transparent way to study structure-linked FVG retests and their projected trade lifecycle. ━━━━━━━━━━━━━━━━━━━━━━ 🧠 CORE IDEA ━━━━━━━━━━━━━━━━━━━━━━ The core idea behind FVG Retest Entry Engine is based on the relationship between market structure and Fair Value Gap reactions. A Fair Value Gap represents a three-candle price imbalance. A bullish FVG is formed when the current candle’s low is above the high from two candles earlier. A bearish FVG is formed when the current candle’s high is below the low from two candles earlier. The script does not treat every FVG as an entry. Instead, it waits for a confirmed structure event and then searches for an eligible FVG that matches that directional context. The selected FVG becomes an armed zone. Price must later return to that zone and satisfy the chosen retest condition. The engine can then evaluate: • gap size relative to ATR • formation displacement • formation volume context • FVG age • prior zone interactions • structure-break quality • retest depth • reaction-candle quality • volume participation • DI / ADX directional force • confirmed higher-timeframe bias • minimum setup grade The goal is not to show more signals. The goal is to create a documented and understandable process from structure event to confirmed FVG retest model. ━━━━━━━━━━━━━━━━━━━━━━ 🧩 WHY THIS SCRIPT IS NOT A SIMPLE BUY/SELL INDICATOR ━━━━━━━━━━━━━━━━━━━━━━ FVG Retest Entry Engine is not intended to be used as a blind buy/sell system. The script is structured as a visual review workflow: Structure event is confirmed → matching FVG candidates are reviewed → one eligible FVG is selected → the FVG becomes armed → price returns to the armed zone → the retest pattern is checked → reaction quality is evaluated → enabled filters are checked → the setup receives a grade → the candle must close with all conditions still valid → Entry, SL, TP1, TP2, and TP3 are projected → the active model is monitored → the model closes at TP3, stop loss, targets complete, or breakeven → the completed FVG Retest model is archived visually Each part has a specific purpose. The structure system identifies a directional event. The FVG memory system stores imbalance zones. The candidate-ranking system selects a relevant gap instead of using every gap. The armed-zone system separates observation from entry. The retest logic defines what qualifies as a valid return. The quality checkpoints reduce setups that fail enabled conditions. The grading system summarizes internal setup quality. The entry model provides visual planning levels. The stop model creates a consistent risk reference. The three-target model provides staged reward references. The Blocker Lens explains the current engine state. The Passport explains why an accepted setup qualified. The alert system supports monitoring of confirmed events. This makes the script a structured FVG retest analysis tool, not a guaranteed trade signal generator. ━━━━━━━━━━━━━━━━━━━━━━ ⚙️ HOW THE SCRIPT WORKS ━━━━━━━━━━━━━━━━━━━━━━ The script operates through several connected stages. First, it identifies confirmed swing highs and swing lows. Price breaking a confirmed swing level can create a bullish or bearish structure event. The break may be classified as BOS when it continues the current structure bias or CHoCH when it changes that bias. The engine separately detects three-candle Fair Value Gaps and stores their contextual information. bool tws_bullish_fvg = bar_index >= 2 and low > high bool tws_bearish_fvg = bar_index >= 2 and high < low float tws_bullish_fvg_top = low float tws_bullish_fvg_bottom = high float tws_bearish_fvg_top = low float tws_bearish_fvg_bottom = high float tws_bullish_fvg_size = tws_bullish_fvg_top - tws_bullish_fvg_bottom float tws_bearish_fvg_size = tws_bearish_fvg_top - tws_bearish_fvg_bottom When a structure event occurs, the engine reviews matching FVG candidates within the selected distance and timing limits. The available candidates are compared using the active profile’s rules. The selected zone becomes armed and remains under observation until: • a confirmed retest creates an entry • the setup expires • the FVG is invalidated • another structure search replaces it Once price interacts with the armed zone, the selected retest model and reaction-quality conditions are checked. Volume, DI / ADX, and higher-timeframe bias can also be required. Only a setup that passes the active rules and remains valid at candle close can create a permanent entry model. ━━━━━━━━━━━━━━━━━━━━━━ 🔵 BULLISH FVG RETEST LOGIC ━━━━━━━━━━━━━━━━━━━━━━ A bullish FVG Retest setup begins with bullish structure context. The script requires a confirmed bullish BOS or CHoCH event and then searches for a directionally matching FVG candidate. The selected zone must remain valid while the engine waits for price to return. Depending on the chosen profile and retest model, bullish confirmation may require: • wick contact with the zone • real-body contact • a close inside the zone • a bullish reaction reclaim • directional recovery above the zone midpoint • a close above the relevant FVG edge • a bullish rejection wick The engine may then check: • reaction strength • volume participation • positive DI dominance • minimum ADX strength • confirmed bullish HTF alignment • minimum accepted grade When every enabled condition remains valid at candle close, the script creates: • a bullish FVG RETEST label • an executed FVG retest box • an entry reference at the confirmation close • a protective stop below the setup reference • TP1, TP2, and TP3 above entry • blue reward visualization • red risk visualization This does not mean price must continue upward. It means the script detected a bullish FVG retest condition that satisfied the selected rules at the time of confirmation. ━━━━━━━━━━━━━━━━━━━━━━ 🔴 BEARISH FVG RETEST LOGIC ━━━━━━━━━━━━━━━━━━━━━━ A bearish FVG Retest setup begins with bearish structure context. The script requires a confirmed bearish BOS or CHoCH event and then searches for a directionally matching FVG candidate. The selected zone must remain valid while the engine waits for price to return. Depending on the chosen profile and retest model, bearish confirmation may require: • wick contact with the zone • real-body contact • a close inside the zone • a bearish reaction reclaim • directional recovery below the zone midpoint • a close below the relevant FVG edge • a bearish rejection wick The engine may then check: • reaction strength • volume participation • negative DI dominance • minimum ADX strength • confirmed bearish HTF alignment • minimum accepted grade When every enabled condition remains valid at candle close, the script creates: • a bearish FVG RETEST label • an executed FVG retest box • an entry reference at the confirmation close • a protective stop above the setup reference • TP1, TP2, and TP3 below entry • blue reward visualization • red risk visualization This does not mean price must continue downward. It means the script detected a bearish FVG retest condition that satisfied the selected rules at the time of confirmation. ━━━━━━━━━━━━━━━━━━━━━━ 💎 FVG QUALITY FILTER SYSTEM ━━━━━━━━━━━━━━━━━━━━━━ The script includes a multi-layer FVG quality system to reduce unnecessary chart signals. This is important because not every gap has the same context and not every retest should create an entry model. The quality system may evaluate: • minimum gap size relative to ATR • displacement of the formation candle • gap location inside the recent dealing range • formation-volume context • gap age • previous interactions with the zone • distance from the matching structure event • structure-break strength • reaction-candle strength • volume participation on retest • DI / ADX directional force • confirmed HTF bias • final setup grade The exact behavior depends on the selected Engine Style. Original Sync uses the first validated calibration and star-based acceptance logic. Balanced Flow uses moderate filtering. Precision Flow applies stricter FVG and retest requirements. Fast Flow accepts more active conditions. Position Flow uses wider structural and timing windows. Custom Lab exposes the advanced thresholds for manual configuration. The filter system does not guarantee better future outcomes. It controls how selective the engine is before creating a confirmed visual model. ━━━━━━━━━━━━━━━━━━━━━━ 📏 GAP / ATR FILTER ━━━━━━━━━━━━━━━━━━━━━━ The gap-width filter measures the detected FVG against ATR. This helps the engine reject extremely small imbalance zones relative to current market volatility. A higher minimum gap-width value makes FVG storage and candidate selection more selective. A lower value allows smaller gaps to enter the internal memory. The filter is volatility-adjusted because the same absolute price distance can have different meaning across symbols and timeframes. The active threshold depends on the chosen profile or Custom Lab value. A larger gap is not automatically a better setup. Gap size is only one component of the complete selection and retest process. ━━━━━━━━━━━━━━━━━━━━━━ 🕯️ DISPLACEMENT QUALITY FILTER ━━━━━━━━━━━━━━━━━━━━━━ The displacement filter evaluates the directional body of the candle associated with FVG formation. The formation body is compared with ATR and converted into a bounded internal score. This helps the script distinguish a stronger directional imbalance from a gap created during weak or narrow price action. When the Gap Impulse Check is enabled, an FVG must satisfy the selected displacement threshold before it is stored as a valid candidate. A higher threshold reduces the number of eligible FVGs. A lower threshold accepts more moderate formations. The displacement score is an internal quality measurement. It does not predict whether the zone will hold in the future. ━━━━━━━━━━━━━━━━━━━━━━ 📊 REACTION STRENGTH FILTER ━━━━━━━━━━━━━━━━━━━━━━ The reaction-strength filter evaluates the candle that interacts with the armed FVG. The score can include: • close location inside the candle • directional wick quality • body size relative to ATR • bullish or bearish candle direction • penetration depth inside the FVG The purpose is to separate a basic touch from a more structured directional response. A higher minimum reaction-strength value requires a clearer response from the zone. A lower value accepts more retest conditions. Original Sync can use its original reaction logic without the same adaptive score requirement. The reaction score is not a win probability. It is a standardized way to evaluate whether the retest candle matches the selected profile’s quality requirements. ━━━━━━━━━━━━━━━━━━━━━━ 🧼 CONFIRMED RETEST FILTER ━━━━━━━━━━━━━━━━━━━━━━ The confirmed-retest layer requires price to satisfy the active retest model and remain valid at candle close. Available Original Sync reaction patterns include: • Any Wick Contact • Real Body Contact • Close Within Gap • Reaction Reclaim Available adaptive reaction models include: • First Contact • Directional Recovery • Edge Reclaim • Rejection Wick First Contact accepts basic interaction with the zone. Directional Recovery requires directional behavior after the interaction. Edge Reclaim requires price to close through the relevant boundary. Rejection Wick applies a stricter wick-and-close response. The script can also use an interaction margin to tolerate minor boundary differences. A minimum delay prevents the engine from confirming a retest too soon after the structure event. An expiry window prevents stale armed zones from producing entries too far from their original context. Final entry commitment remains bar-close based. ━━━━━━━━━━━━━━━━━━━━━━ 🎯 ENTRY MODEL ━━━━━━━━━━━━━━━━━━━━━━ When an armed FVG retest passes all enabled conditions, the script creates a visual entry model. The entry reference is the close of the candle that confirms the retest. Permanent entries, labels, boxes, and entry alerts are committed only after candle close. tws_preview_ready := tws_eval_zone_touched and tws_eval_reaction_pass and tws_direction_filters_pass and tws_eval_grade_pass bool tws_confirmed_entry = tws_preview_ready and barstate.isconfirmed if tws_confirmed_entry tws_long_signal := tws_armed_direction == 1 tws_short_signal := tws_armed_direction == -1 tws_entry_event := true tws_trade_active := true tws_trade_direction := tws_armed_direction tws_trade_open_bar := bar_index tws_trade_entry := close Confirmed Close mode waits for the candle to finish before the dashboard treats the setup as an entry. Live Preview can show that current conditions are ready while the realtime candle is still open. The preview may change intrabar because the candle is unfinished. It does not create a permanent historical entry model unless the setup remains valid when the candle closes. The entry is a visual analysis reference. It is not a broker order and does not require the user to enter a trade. ━━━━━━━━━━━━━━━━━━━━━━ 🛑 ATR STOP-LOSS MODEL ━━━━━━━━━━━━━━━━━━━━━━ The script includes two stop-placement models. Gap-Protected Stop uses the selected FVG boundary plus an ATR-based protective buffer. For bullish setups, the stop is projected below the FVG. For bearish setups, the stop is projected above the FVG. Volatility Stop projects the stop at an ATR multiple from entry. A minimum stop-distance percentage can prevent extremely narrow visual stops. float tws_raw_stop = tws_stop_mode == "Gap-Protected Stop" ? ( tws_trade_direction == 1 ? tws_armed_bottom - tws_atr * tws_fvg_stop_buffer_atr : tws_armed_top + tws_atr * tws_fvg_stop_buffer_atr ) : ( tws_trade_direction == 1 ? tws_trade_entry - tws_atr * tws_atr_stop_multiplier : tws_trade_entry + tws_atr * tws_atr_stop_multiplier ) float tws_raw_stop_distance = math.abs(tws_trade_entry - tws_raw_stop) float tws_guaranteed_distance = tws_trade_entry * tws_minimum_stop_percent / 100.0 float tws_final_stop_distance = math.max(tws_raw_stop_distance, tws_guaranteed_distance) ATR is used because volatility changes across markets and timeframes. A wider stop changes the projected risk distance and therefore also changes all three target levels. The displayed SL is a visual planning level only. It does not place or manage a real broker stop order. ━━━━━━━━━━━━━━━━━━━━━━ 🎯 TAKE-PROFIT RR MODEL ━━━━━━━━━━━━━━━━━━━━━━ The script uses three take-profit levels. Each target is calculated from the distance between entry and the original stop. float tws_trade_risk = math.abs(tws_trade_entry - tws_trade_original_stop) tws_trade_tp1 := tws_trade_direction == 1 ? tws_trade_entry + tws_trade_risk * tws_tp1_r : tws_trade_entry - tws_trade_risk * tws_tp1_r tws_trade_tp2 := tws_trade_direction == 1 ? tws_trade_entry + tws_trade_risk * tws_tp2_r : tws_trade_entry - tws_trade_risk * tws_tp2_r tws_trade_tp3 := tws_trade_direction == 1 ? tws_trade_entry + tws_trade_risk * tws_tp3_r : tws_trade_entry - tws_trade_risk * tws_tp3_r The default concept is: TP1 = first risk-multiple target TP2 = second risk-multiple target TP3 = final risk-multiple target The exact R values can be adjusted in Position Architecture. The script also contains visual position-share percentages for TP1, TP2, and TP3. These shares are used by the internal lifecycle model. They do not represent a broker account, real position size, or verified financial performance. The RR settings only control projected visual distances. They should not be interpreted as recommendations or guaranteed objectives. ━━━━━━━━━━━━━━━━━━━━━━ 📦 ACTIVE TP / SL BOX SYSTEM ━━━━━━━━━━━━━━━━━━━━━━ When a confirmed FVG Retest entry appears, the script can draw a complete visual trade model. The visual model includes: • executed FVG retest zone • entry line • original stop line • active stop line • TP1 line • TP2 line • TP3 line • red risk box • blue reward box • Entry price label • SL price label • TP1, TP2, and TP3 price labels • bullish or bearish entry label The active boxes extend to the right while the model is open. When the model closes, the right edge is fixed at the closing candle. If Keep Completed Trade Areas is enabled, completed boxes and lines remain visible for historical review. The Completed Trade History Limit controls how many previous visual models are retained. The TP area uses a blue-toned visual palette. TP price labels use a different, darker background so they remain distinct from the reward box. The SL area remains red for clearer risk separation. ━━━━━━━━━━━━━━━━━━━━━━ 🚦 ONE ACTIVE TRADE AT A TIME ━━━━━━━━━━━━━━━━━━━━━━ The script includes one-active-trade-at-a-time logic. If a trade model is active, the engine does not create another trade model until the current one closes. The active model may close through: • TP3 • targets complete • stop loss • breakeven exit This design separates: • FVG and structure detection • trade-model creation permission The engine can continue calculating market context while a model is active, but another entry model is not opened. This helps prevent overlapping TP / SL areas and keeps the chart easier to interpret. The one-active-model rule is a visual management decision. It is not a restriction on the user’s personal trading activity. ━━━━━━━━━━━━━━━━━━━━━━ ⚠️ SAME-CANDLE TP / SL HANDLING ━━━━━━━━━━━━━━━━━━━━━━ If a target and the active stop are both touched on the same candle, standard OHLC data cannot reveal the true intrabar sequence. The script therefore includes two selectable assumptions: Protective First Target First Protective First assumes the stop is processed before target events. Target First processes available target events before the stop check. bool tws_conservative_mode = tws_intrabar_priority == "Protective First" if tws_conservative_mode and tws_stop_touched tws_trade_remaining_percent := 0.0 tws_close_trade := true tws_close_reason := tws_trade_active_stop == tws_trade_entry ? "BREAKEVEN" : "STOP LOSS" tws_final_exit_price := tws_trade_active_stop else if not tws_tp1_reached and tws_tp1_touched tws_tp1_reached := true tws_tp1_event := true Protective First is the more conservative bar-based assumption. Target First is more optimistic. Neither option reproduces exact tick-by-tick broker execution. The model does not include spread, slippage, commissions, latency, or partial-fill behavior. ━━━━━━━━━━━━━━━━━━━━━━ 🏷️ FVG RETEST LABELS ━━━━━━━━━━━━━━━━━━━━━━ The script uses clear directional FVG Retest labels. Bullish entry labels use: 🟢 FVG RETEST 📈 LONG Bearish entry labels use: 🔴 FVG RETEST 📉 SHORT Entry labels can also display: • grade • setup score • FVG age • retest depth • Passport information Completed-model labels emphasize that the closed model originated from an FVG retest. A completed bullish model can display: 🟢 BULLISH FVG RETEST 🔒 MODEL CLOSED 🎯 close reason ⭐ grade TP1 / TP2 / TP3 status A completed bearish model uses the corresponding bearish wording and color. The labels do not display USD profit or account-profit claims. All chart labels use bold and italic text formatting. The signal-label size can be adjusted from the settings. ━━━━━━━━━━━━━━━━━━━━━━ 📍 FVG ZONE DISPLAY MODES ━━━━━━━━━━━━━━━━━━━━━━ The FVG display system includes three modes: Hidden Selected Gap All Active Gaps Hidden mode removes active FVG memory boxes from the chart while allowing the engine to continue calculating them internally. Selected Gap shows only the FVG currently armed for retest monitoring. All Active Gaps displays every currently stored and valid FVG zone. Show Executed FVG Retests separately controls whether the FVG zone that created an entry remains highlighted as part of the trade model. The selected display mode affects visual presentation only. It does not change the underlying FVG calculations. For the cleanest chart, Selected Gap is generally the most focused mode. All Active Gaps can be useful for research but may create more chart density. ━━━━━━━━━━━━━━━━━━━━━━ 🧹 FVG INVALIDATION ━━━━━━━━━━━━━━━━━━━━━━ The script can automatically remove invalidated FVG zones. A bullish FVG may be invalidated when confirmed price action closes through the zone in the opposite direction. A bearish FVG may be invalidated when confirmed price action closes through its opposite boundary. An armed zone can also be cleared when: • its retest window expires • the zone exceeds the permitted lifetime • the internal memory limit removes an older gap • the active structure search is replaced When an armed FVG becomes invalid, the Blocker Lens can display FVG INVALIDATED. When the retest window expires, it can display SETUP EXPIRED. Removing invalidated or stale zones helps prevent outdated FVGs from creating later entries outside their intended context. Users can disable automatic invalidation removal if they prefer to retain more zones visually. ━━━━━━━━━━━━━━━━━━━━━━ 📟 DASHBOARD ━━━━━━━━━━━━━━━━━━━━━━ The script includes a compact dashboard positioned in the bottom-right corner. The dashboard displays: • BIAS • STATE • ENTRY • TP1 • TP2 • TP3 • SL BIAS uses the confirmed higher-timeframe filter when that filter is enabled and valid. Otherwise, it reflects the current internal structure bias. STATE is powered by the Blocker Lens. Possible states include: • WAITING STRUCTURE • SCANNING FVG • NO ELIGIBLE FVG • FVG ARMED • RETEST DELAY • WAITING RETEST • VOLUME BLOCK • DI BLOCK • HTF BLOCK • WEAK REACTION • GRADE BLOCK • LIVE PREVIEW READY • WAITING BAR CLOSE • TRADE ACTIVE • COOLDOWN • SETUP EXPIRED • FVG INVALIDATED The dashboard size can be set to Micro, Compact, or Standard. The dashboard is designed to summarize engine state and current price references. It is not a performance report. It is not a replacement for TradingView Strategy Tester. ━━━━━━━━━━━━━━━━━━━━━━ 🚨 ALERT SYSTEM ━━━━━━━━━━━━━━━━━━━━━━ FVG Retest Entry Engine includes advanced alert options for: • FVG armed • bullish FVG Retest entry • bearish FVG Retest entry • any FVG Retest entry • TP1 reached • TP2 reached • TP3 reached • breakeven activated • stop loss • breakeven exit Alert packages include: Off Qualified Entries Premium Entries Full Lifecycle Webhook JSON Qualified Entries focuses on confirmed accepted entries. Premium Entries applies stricter grade-based alert delivery. Full Lifecycle includes entry and management events. Webhook JSON sends structured event messages for external processing. Alert Direction can be limited to Both Directions, Bullish Only, or Bearish Only. Minimum Alert Grade can be set to All Qualified, A / A+, or A+ Only. Alert filtering affects alert delivery only. It does not change the chart’s signal calculations. alertcondition(tws_armed_alert_event, title="trade_w_samet • FVG ARMED", message='trade_w_samet FVG ARMED | {{ticker}} | TF: {{interval}} | Score: {{plot("SIGNAL_SCORE")}}') alertcondition(tws_entry_alert_event and tws_trade_direction == 1, title="trade_w_samet • BULLISH FVG RETEST", message='trade_w_samet BULLISH FVG RETEST | {{ticker}} | TF: {{interval}} | Score: {{plot("SIGNAL_SCORE")}} | Entry: {{plot("ENTRY")}} | SL: {{plot("SL")}} | TP1: {{plot("TP1")}} | TP2: {{plot("TP2")}} | TP3: {{plot("TP3")}}') alertcondition(tws_entry_alert_event and tws_trade_direction == -1, title="trade_w_samet • BEARISH FVG RETEST", message='trade_w_samet BEARISH FVG RETEST | {{ticker}} | TF: {{interval}} | Score: {{plot("SIGNAL_SCORE")}} | Entry: {{plot("ENTRY")}} | SL: {{plot("SL")}} | TP1: {{plot("TP1")}} | TP2: {{plot("TP2")}} | TP3: {{plot("TP3")}}') alertcondition(tws_tp1_alert_event, title="trade_w_samet • TP1 REACHED", message='trade_w_samet TP1 REACHED | {{ticker}} | TP1: {{plot("TP1")}}') alertcondition(tws_stop_alert_event, title="trade_w_samet • STOP LOSS", message='trade_w_samet STOP LOSS | {{ticker}} | SL: {{plot("SL")}}') Alerts are monitoring tools only. They do not execute trades or place broker orders. ━━━━━━━━━━━━━━━━━━━━━━ 🔔 HOW TO USE ALERTS ━━━━━━━━━━━━━━━━━━━━━━ A practical alert workflow: 1. Add FVG Retest Entry Engine to the chart. 2. Select the desired Engine Style and confirmation settings. 3. Open TradingView’s alert window. 4. Select the indicator as the alert condition. 5. Choose the desired entry or lifecycle condition. 6. Select the alert frequency appropriate for confirmed-candle monitoring. 7. Use the Alert Package, direction, and grade controls inside the indicator when needed. 8. Add a webhook URL only when using a compatible external workflow. 9. Test the alert configuration before depending on it. 10. Confirm every event with personal analysis and risk management. For confirmed entry monitoring, users should avoid treating provisional realtime candle conditions as permanent signals. Entry alerts are designed around the script’s confirmed event variables. Alert delivery can still depend on TradingView servers, the user’s alert configuration, data availability, and any external webhook destination. ━━━━━━━━━━━━━━━━━━━━━━ 🧪 HOW TO USE THE INDICATOR ━━━━━━━━━━━━━━━━━━━━━━ A practical workflow: 1. Add FVG Retest Entry Engine to a standard candlestick chart. 2. Begin with Original Sync or Balanced Flow. 3. Keep Signal Timing on Confirmed Close for the clearest workflow. 4. Use Selected Gap to keep the chart focused. 5. Observe the dashboard STATE value. 6. Wait for a confirmed structure event and an armed FVG. 7. Review the FVG zone before the retest occurs. 8. When price returns, allow the selected retest model and filters to complete. 9. Review the FVG Retest Passport when an entry appears. 10. Use the displayed Entry, SL, TP1, TP2, and TP3 as visual references only. 11. Evaluate whether the setup fits personal structure, liquidity, session, and risk rules. 12. Use alerts for monitoring rather than blind execution. 13. Review completed FVG Retest labels to understand the model lifecycle. 14. Test settings on the exact markets and timeframes personally studied. The indicator is best used as a structured FVG retest review tool. It should not be used as an automatic decision-maker. ━━━━━━━━━━━━━━━━━━━━━━ ⚙️ SETTINGS REFERENCE ━━━━━━━━━━━━━━━━━━━━━━ ⚡ Signal Blueprint Engine Style Controls the active configuration profile. Available profiles: Original Sync Balanced Flow Precision Flow Fast Flow Position Flow Custom Lab Allow Bullish Setups Enables or disables bullish FVG Retest models. Allow Bearish Setups Enables or disables bearish FVG Retest models. ━━━━━━━━━━━━━━━━━━━━━━ 🪪 Retest Experience FVG Retest Passport Controls whether Passport information is Off, Compact, or Detailed. Show Blocker Lens Shows or hides the engine STATE explanation in the dashboard. Signal Timing Selects Confirmed Close or Live Preview behavior. Live Preview affects the dashboard’s provisional realtime state. Permanent entries remain candle-close confirmed. ━━━━━━━━━━━━━━━━━━━━━━ 🧬 Original Sync Engine Original Signal Calibration Selects Manual Sync, Bitcoin Map, Ethereum Map, Solana Map, or Gold Map. Structure Window Controls pivot sensitivity in Manual Sync. Minimum Gap Footprint — ATR Controls the minimum FVG width. Gap Lifetime Controls how long stored FVGs remain eligible. Gap Memory Capacity Controls the number of stored zones. Break-to-Gap Distance Controls the maximum allowed distance between structure context and FVG eligibility. After-Break Scan Window Controls how long the engine continues searching after a break. Reaction Pattern Selects Any Wick Contact, Real Body Contact, Close Within Gap, or Reaction Reclaim. Reaction Margin % Adds tolerance around FVG boundaries. Minimum Reaction Delay Controls how many bars must pass before retest confirmation. Reaction Expiry Bars Controls how long the armed setup may wait. Participation Multiplier Controls the Original Sync volume requirement. Minimum Directional Force Controls the Original Sync ADX threshold. Minimum Sync Rating Controls the minimum accepted star rating. Minimum Risk Distance % Prevents extremely narrow stops. ━━━━━━━━━━━━━━━━━━━━━━ 🧭 Structure Pulse Structure Sensitivity Controls pivot detection in Custom Lab. Display Structure Tags Shows or hides BOS / CHoCH labels. Close-Lock Breaks Requires a candle close beyond structure when enabled. Break Momentum Check Requires directional expansion on the break candle. Break Body Threshold — ATR Controls the required break-candle body size. Break Clearance — ATR Adds an ATR-based buffer beyond the structure level. ━━━━━━━━━━━━━━━━━━━━━━ 🧱 Gap Intelligence Minimum Gap Width — ATR Controls the minimum stored FVG size. Gap Impulse Check Enables displacement filtering. Minimum Gap Impulse Controls the required formation displacement. Minimum Gap Score Controls the minimum candidate-quality score. Allowed Prior Reactions Controls how many previous zone interactions are accepted. Gap Expiry Bars Controls maximum FVG age. Active Gap Capacity Controls stored-zone capacity. Maximum Structure Link Controls the maximum structure-to-FVG distance. Break Follow-Through Window Controls post-break candidate scanning. Delete Invalidated Gaps Removes zones invalidated by confirmed opposite price action. ━━━━━━━━━━━━━━━━━━━━━━ 🎯 Reaction Trigger Reaction Model Selects First Contact, Directional Recovery, Edge Reclaim, or Rejection Wick. Gap Interaction Margin % Adds tolerance around FVG boundaries. Minimum Reaction Strength Controls the required retest-candle score. Reaction Delay Bars Controls the minimum delay before retest confirmation. Setup Expiry Bars Controls how long the armed zone remains available. Signal Cooldown Bars Controls the delay after a completed model before another entry is permitted. ━━━━━━━━━━━━━━━━━━━━━━ 🛂 Quality Checkpoints Volume Participation Check Enables or disables the retest-volume filter. Volume Baseline Length Controls the volume moving-average period. Required Volume Expansion Controls the required volume multiplier. Directional Force Check Enables or disables DI / ADX filtering. Directional Force Length Controls the DI period. Trend Strength Smoothing Controls ADX smoothing. Minimum Trend Strength Controls the required ADX value. Higher-Timeframe Bias Check Enables or disables HTF directional alignment. Bias Timeframe Selects the higher timeframe. Bias Fast EMA Controls the fast HTF EMA length. Bias Slow EMA Controls the slow HTF EMA length. Minimum Setup Grade Selects B Grade or Better, A Grade or Better, or A+ Only. The HTF layer uses previous completed higher-timeframe values. float tws_htf_close = request.security( syminfo.tickerid, tws_htf_timeframe, close , barmerge.gaps_off, barmerge.lookahead_on ) float tws_htf_fast_ema = request.security( syminfo.tickerid, tws_htf_timeframe, ta.ema(close, tws_htf_fast_length) , barmerge.gaps_off, barmerge.lookahead_on ) float tws_htf_slow_ema = request.security( syminfo.tickerid, tws_htf_timeframe, ta.ema(close, tws_htf_slow_length) , barmerge.gaps_off, barmerge.lookahead_on ) ━━━━━━━━━━━━━━━━━━━━━━ 🛡️ Position Architecture ATR Calculation Length Controls ATR calculation. Stop Placement Model Selects Gap-Protected Stop or Volatility Stop. Volatility Stop Multiplier Controls ATR stop distance from entry. Gap Stop Buffer — ATR Controls the protective distance beyond the FVG. Minimum Stop Distance % Prevents extremely narrow risk zones. TP1 Risk Multiple Controls the first target distance. TP2 Risk Multiple Controls the second target distance. TP3 Risk Multiple Controls the final target distance. TP1 Position Share % Controls the internal visual share assigned to TP1. TP2 Position Share % Controls the internal visual share assigned to TP2. TP3 Position Share % Controls the internal visual share assigned to TP3. Move Stop to Entry After TP1 Moves the active stop to entry after TP1 according to confirmed lifecycle rules. Same-Candle Priority Selects Protective First or Target First. ━━━━━━━━━━━━━━━━━━━━━━ 🎨 Chart Design Color System Selects Obsidian Signal, Carbon Grid, Ivory Pulse, Neon Voltage, Acid Circuit, or Violet Flux. Gap Display Mode Selects Hidden, Selected Gap, or All Active Gaps. Show Executed FVG Retests Shows or hides the FVG zone used by a confirmed trade model. Display TP / SL Areas Shows or hides the reward and risk boxes. Keep Completed Trade Areas Keeps completed model boxes and lines. Completed Trade History Limit Controls the maximum historical visual models. Active Area Projection Controls the initial right-side projection length. Chart Layout Selects Desktop or Mobile. Signal Label Size Selects Micro, Compact, Standard, or Large. Dashboard Size Selects Micro, Compact, or Standard. Display Bias EMA Shows or hides the confirmed HTF fast EMA reference. Display Setup Dashboard Shows or hides the bottom-right dashboard. ━━━━━━━━━━━━━━━━━━━━━━ 📡 Alert Center Alert Package Selects Off, Qualified Entries, Premium Entries, Full Lifecycle, or Webhook JSON. Alert Direction Selects Both Directions, Bullish Only, or Bearish Only. Minimum Alert Grade Selects All Qualified, A / A+, or A+ Only. Alert When FVG Is Armed Enables armed-zone alerts for compatible packages. Alert When Stop Moves to Entry Enables breakeven-activation alerts for compatible packages. ━━━━━━━━━━━━━━━━━━━━━━ 🧠 WHAT MAKES THIS SCRIPT ORIGINAL ━━━━━━━━━━━━━━━━━━━━━━ FVG Retest Entry Engine uses familiar analytical concepts such as: • Fair Value Gaps • swing-point structure • BOS and CHoCH • ATR • volume analysis • DI / ADX • higher-timeframe EMA bias • risk/reward projection • staged targets • breakeven management These concepts are not unique by themselves. The originality of this script lies in how they are organized into a transparent FVG retest workflow: Structure confirmation → directional FVG memory → contextual candidate comparison → selected armed zone → configurable retest validation → reaction-quality evaluation → optional volume, DI, and HTF checkpoints → setup grading → confirmed-close entry commitment → three-target visual management → optional breakeven movement → completed FVG Retest archiving → Blocker Lens state reporting → Passport explanation → lifecycle alerts Distinctive implementation features include: • structure-linked FVG selection instead of signaling every gap • multiple Engine Style profiles • Original Sync market calibrations • an armed-zone state before entry • candidate ranking using several FVG characteristics • multiple retest models • a visible reason when an entry is waiting or blocked • a Passport explaining accepted setup context • confirmed-close permanent signal commitment • previous-completed HTF values • executed FVG zone preservation • three-stage target management • Desktop and Mobile display modes • alert filtering separated from chart calculations This structure is designed to provide a focused and explainable review process without relying on hidden prediction claims. ━━━━━━━━━━━━━━━━━━━━━━ ⚠️ IMPORTANT PRACTICAL NOTES ━━━━━━━━━━━━━━━━━━━━━━ The script’s behavior depends heavily on settings and market conditions. Signal frequency and visual output may change based on: • Engine Style • structure sensitivity • close-based or wick-based breaks • break momentum requirements • minimum FVG width • displacement filtering • candidate-score threshold • previous zone interactions • FVG lifetime • retest model • reaction-strength threshold • retest delay • setup expiry • volume filter settings • DI / ADX settings • HTF timeframe and EMA lengths • minimum setup grade • stop model • target multiples • signal cooldown • timeframe • symbol volatility • market session • available historical bars A setting that appears clean on one market may behave differently on another. A profile that produces suitable frequency on one timeframe may be too strict or too active on another. Volume behavior can differ across asset classes and data providers. Higher-timeframe filtering only operates as intended when the selected bias timeframe is genuinely higher than the chart timeframe. Users should test the exact symbol, timeframe, profile, and session they personally study. ━━━━━━━━━━━━━━━━━━━━━━ ⚠️ LIMITATIONS AND SHORTCOMINGS ━━━━━━━━━━━━━━━━━━━━━━ This script has important limitations: It does not guarantee profitable trades. It does not predict future price movement. It does not replace risk management. It does not execute trades. It does not place broker orders. It does not include broker slippage. It does not include commissions. It does not include spreads. It does not include execution delay. It does not include partial-fill behavior. It uses bar-based chart data. Same-candle TP / SL order cannot be known from standard OHLC data. Same-Candle Priority is a modeling assumption. Live Preview can change intrabar because the realtime candle is unfinished. Permanent entry models are committed only after bar close. Confirmed pivots require future bars before becoming available as confirmed swing points. The dashboard is not TradingView Strategy Tester. The internal target-share model is not account-performance reporting. Historical boxes and completed labels do not guarantee similar future behavior. Setup grades are internal classifications, not win probabilities. Filter settings do not guarantee improved future results. Higher-timeframe values depend on selected timeframe and available data. Data-feed revisions or chart-history differences can affect historical calculations. Alert delivery depends on TradingView and the user’s alert configuration. Webhook delivery also depends on the external destination. One-active-trade logic is a visual management rule, not broker execution logic. For these reasons, FVG Retest Entry Engine should be used as an educational decision-support and chart-analysis tool, not as a standalone automated trading strategy. ━━━━━━━━━━━━━━━━━━━━━━ 👤 WHO THIS SCRIPT MAY BE USEFUL FOR ━━━━━━━━━━━━━━━━━━━━━━ This script may be useful for traders who: • study Fair Value Gap retests • use BOS and CHoCH context • prefer selected FVGs instead of every raw gap • want a visible armed-zone workflow • want to understand why a setup is waiting or blocked • prefer confirmed-close entries • want a setup-grade framework • want Entry, SL, TP1, TP2, and TP3 visualization • want optional breakeven behavior • want completed FVG Retest models preserved visually • use higher-timeframe directional context • want mobile-friendly chart presentation • use lifecycle alerts for monitoring • want a structured educational analysis framework It may be less suitable for users who: • want guaranteed buy/sell signals • want a fully automated trading bot • want every raw FVG to create an entry • expect one profile to work on every market • expect grades to represent guaranteed probability • require exact tick-level execution simulation • expect visual projections to match broker fills • expect alerts to execute trades automatically • want an indicator to replace independent decision-making ━━━━━━━━━━━━━━━━━━━━━━ 🧭 BEST PRACTICE SUGGESTIONS ━━━━━━━━━━━━━━━━━━━━━━ For cleaner review: • Start with Original Sync or Balanced Flow. • Keep Signal Timing on Confirmed Close. • Use Selected Gap to reduce chart clutter. • Enable Blocker Lens while learning the engine workflow. • Use Compact Passport for concise context. • Use Detailed Passport when reviewing why a setup qualified. • Review the armed FVG before the entry appears. • Check whether the FVG retest agrees with personal market-structure analysis. • Evaluate the displayed stop against nearby structure and volatility. • Treat TP1, TP2, and TP3 as planning references only. • Keep Protective First when a conservative same-candle assumption is preferred. • Use Precision Flow when fewer, stricter setups are preferred. • Use Fast Flow only after understanding its higher signal frequency. • Use Custom Lab only after learning how each threshold affects the engine. • Use Mobile layout on smaller screens. • Use alerts for monitoring, not blind execution. • Always apply independent analysis, risk management, and position sizing. ━━━━━━━━━━━━━━━━━━━━━━ 🔓 PUBLICATION NOTE ━━━━━━━━━━━━━━━━━━━━━━ FVG Retest Entry Engine is published as an educational and visual market-analysis tool. The purpose of this description is to explain: • what the script does • how structure events are confirmed • how three-candle FVGs are detected • how FVGs are stored and invalidated • how structure and FVG candidates are linked • how an FVG becomes armed • how retest models work • how reaction quality is evaluated • how volume, DI / ADX, and HTF checkpoints operate • how setup grades are assigned • how Confirmed Close and Live Preview differ • how Entry and stop levels are calculated • how TP1, TP2, and TP3 are projected • how breakeven and same-candle assumptions work • how active and completed trade areas behave • what the Passport and Blocker Lens show • what the dashboard displays • what the alert packages do • what the limitations are • how the indicator should and should not be used The script is designed to support structured analysis. It does not promise profitable results. It does not remove market risk. It does not execute trades. It should not be used as a blind buy/sell system. It is best used as a visual framework for reviewing structure-linked FVG retests and projected risk/reward behavior. ━━━━━━━━━━━━━━━━━━━━━━ 🛡️ DISCLAIMER ━━━━━━━━━━━━━━━━━━━━━━ FVG Retest Entry Engine is provided for educational and informational purposes only. It does not constitute financial, investment, trading, legal, or tax advice. No indicator can guarantee future results. Markets are uncertain, conditions change, and historical behavior does not ensure future performance. Every user is responsible for their own analysis, validation, risk management, position sizing, alert configuration, trading decisions, and broker execution. The structure labels, FVG zones, armed-zone states, Passport values, Blocker Lens messages, grades, scores, entry references, stop-loss levels, take-profit levels, TP / SL boxes, dashboard values, completed-model labels, and alerts are visual analysis tools only. Use this script as a structured decision-support and visual review framework, not as a promise of profitability or a substitute for independent judgment.
Pine Script® indicator
by trade_w_samet
6
Fair Value Gaps + Inversion FVG [Quantum Algo]Fair Value Gaps + Inversion FVG █ OVERVIEW Most FVG indicators stop at drawing boxes. This one tracks the complete lifecycle of every gap — fresh → midline-tested → filled → INVERTED → retested — and automates the part of the model that traders actually trade: the Inversion Fair Value Gap (IFVG). A Fair Value Gap is a 3-candle imbalance left behind when price moves too fast for two-sided trade to occur. Price frequently returns to these zones. But when price closes through a gap instead of respecting it, the zone does not die — it flips polarity. A violated bullish gap becomes resistance; a violated bearish gap becomes support. The first retest of that inverted zone is one of the cleanest entry models in the Smart Money Concepts framework, and this script detects, restyles, and signals it automatically. █ FEATURES Gap detection — Bullish and bearish FVGs detected on confirmed bars only (non-repainting). — ATR minimum-size filter removes insignificant micro-gaps. — Optional displacement filter: the middle candle must be a genuine expansion bar (range greater than a configurable multiple of ATR), keeping only gaps created by aggressive participation. Volume strength score Every gap is stamped with a 0–100 score comparing the displacement candle's volume against its 20-bar average. A 90% gap and a 20% gap are not the same zone — now you can see the difference at a glance. Consequent Encroachment (CE) Each gap carries its 50% midline. The first touch of the CE is detected, the gap is visually dimmed to separate tested zones from fresh ones, and an alert is available. Inversion engine (IFVG) — A close through the gap converts it into an inverted zone with distinct styling. — The first retest of an inverted zone prints an on-chart signal (long model for inverted bearish gaps, short model for inverted bullish gaps). — A close back through the far side invalidates and removes the zone. — Inversion can be disabled, in which case gaps simply fill and are removed or frozen (wick-fill or close-fill modes). Multi-timeframe mode Display gaps from one higher timeframe directly on your chart as dashed boxes. HTF gaps are built exclusively from closed higher-timeframe bars, so they do not repaint. Dashboard A compact panel shows active bullish gaps, bearish gaps, inverted zones, plus the nearest demand level below price and the nearest supply level above it. Alerts Eight alert conditions cover the full lifecycle: new bullish/bearish gap, CE touch, fill, bullish/bearish inversion, and long/short IFVG retest. █ HOW DETECTION WORKS A bullish FVG forms when the current bar's low sits entirely above the high from two bars earlier — the zone spans that void. A bearish FVG is the mirror image. Detection runs only on bar close, so a gap that appears never disappears or redraws. Lifecycle state changes (CE touches, fills, inversions, retests) are likewise evaluated on confirmed bars. █ HOW TO USE IT 1. Classic continuation: in a trend, wait for price to retrace into a fresh high-strength gap aligned with the trend; the CE midline is the standard entry refinement. 2. Inversion reversal: when a gap is closed through, stop looking for the old reaction — wait for the retest of the inverted zone in the new direction. The on-chart IFVG markers identify exactly this moment. 3. Multi-timeframe confluence: enable HTF mode and prioritize chart-timeframe signals that occur inside a higher-timeframe gap. 4. Use the dashboard's nearest demand/supply readout for quick situational awareness of where the next reaction zones sit. Works on all symbols and timeframes. Crypto and index futures tend to produce the cleanest gaps on 5m–1H; forex gaps are more frequent on 15m and above. █ SETTINGS Detection — minimum gap size (× ATR), displacement filter, maximum zones kept on chart. Mitigation & Inversion — inversion on/off, fill source (close or wick), removal of filled gaps, retest signals. Multi-Timeframe — HTF on/off and timeframe selection. Visuals — colors for bullish / bearish / inverted zones, fill transparency, CE line, labels, dimming of tested gaps, dashboard. █ NOTES — All state changes occur on closed bars; the developing bar can always change until it closes. — This is an analysis tool for mapping imbalance and inversion zones, intended as a confluence layer within a complete trading plan. It is not a standalone buy/sell system. █ DISCLAIMER This script is provided for educational and informational purposes only and does not constitute financial advice. Trading involves substantial risk of loss. Past behavior does not guarantee future results. Always do your own research and apply sound risk management.
Pine Script® indicator
by Quantum-Algo
Market Structure & LiquidityMARKET STRUCTURE & LIQUIDITY — Calibrated Zones, Premium/Discount & Setup Grade ================================================================================ WHAT THIS SCRIPT IS A single price-action framework that maps the structural read of a chart and then measures it. It plots market structure (break of structure and change of character), supply/demand order blocks, fair value gaps, resting liquidity (equal highs and lows) and the sweeps that take it, premium/discount with an optimal-entry band, a higher-timeframe bias, and a rolling volume profile. On top of those objects it does three things most structure tools do not: it validates every structure break, it scores each zone by confluence and quality, and it reports — using past data on the current symbol only — how often each zone type has actually been respected, with statistical confidence intervals. The levels are the raw material; the framework adds a measured read of which ones to trust. WHY THE COMPONENTS ARE COMBINED (how the parts work together) These are not independent indicators bolted together. They describe one process — how large participants build positions: rest liquidity, take it, displace price, and leave an inefficiency behind — and each layer covers a blind spot of the others, feeding one combined decision: - Market structure (swing and internal) gives trend context and the moment it shifts. Because raw break detection is noisy, a break is only counted when it shows real displacement (range expansion with body, or a volatility compression followed by a release), closes beyond the level with body rather than leaving a rejection wick, and breaks a tight, recent (quality) pivot. This removes most false breaks before anything else is drawn. - Regime context (efficiency ratio + ADX + volatility clustering + a whipsaw score) conditions how far to trust a read: continuation breaks are reliable in a trending regime, reversals are more reliable in a range, and a choppy regime weights everything down. Structure on its own cannot tell you this. - Liquidity (equal highs/lows, sweeps, and inducement) marks where stops rest and the moment they are taken — the trigger that typically precedes a real move, and the event that validates a nearby zone. - Order blocks and fair value gaps mark the origin of the displacement and the inefficiency price tends to revisit. A zone that forms on a sweep, on a high-volume node, in the correct half of the range scores highest — which is exactly why liquidity, the volume profile and premium/discount all feed the zone score rather than living in separate panes. - Volume profile (point of control, high- and low-volume nodes, and untested "naked" points of control) tells you whether a zone sits on acceptance (tends to hold) or on a thin gap (tends to slice), and marks magnet levels price is drawn back toward. - Premium/discount and the OTE band frame every zone as expensive or cheap relative to the current dealing range, so a long in discount and a short in premium are favoured. - The confluence engine and setup grade fuse structure direction, a recent sweep, zone quality, node type, premium/discount alignment, higher-timeframe bias and a momentum-divergence confirmation into one A/B/C read per zone, so the chart self-prioritises instead of leaving you to weigh eight things by eye. - Calibration measures, on past bars only, how often each zone type produced a meaningful reaction on the current symbol, and reports it with Wilson confidence intervals — so reliability is earned per instrument, not assumed. In one sentence: structure says direction, regime says whether to believe it, liquidity says when, the zones say where, premium/discount says whether it is worth it, the grade fuses them, and the calibration keeps the whole thing honest. HOW IT WORKS (mechanics, briefly) Pivots use the standard left/right confirmation, so structure is non-repainting: a break is only labelled after the pivot is confirmed and the close validates it. Order blocks anchor to the last opposing candle before a validated break, are scored on formation, and are re-scored for confluence on the most recent bar. Calibration records, the first time a zone is tagged, whether price then travels a chosen ATR multiple in the zone's direction within a fixed horizon, and aggregates that into the respect rate shown on the dashboard. All thresholds are ATR-relative, so nothing is tied to a particular price scale. HOW TO USE IT 1. Read the dashboard headline: the SETUP grade and the structure bias. 2. Favour higher-grade setups — a validated structure direction, a recent sweep, a fresh high-quality zone sitting on a volume node, in discount for longs or premium for shorts, with higher-timeframe agreement. 3. Use the OTE band for entry context and an opposing fair value gap as a logical target. 4. Check the respect rows. If order blocks or fair value gaps rarely hold on this symbol, weight the read down accordingly. 5. Treat everything as descriptive context, not a signal to act on. USE ON ANY MARKET The High / Low / Close source inputs let you drive structure, liquidity and premium/discount from any series (standard candles, Heikin-Ashi, or another source), so the framework applies to stocks, indices, futures, forex and crypto. A volume-borrow input supplies volume for symbols that report none. WHAT MAKES IT ORIGINAL The contribution is the closed loop, not the individual objects, which are common to price-action analysis. Here, validated structure and liquidity feed a per-zone confluence and quality score and a single setup grade, and a past-only calibration tracker reports each zone type's actual respect rate on the current symbol with confidence intervals. That turns a set of drawing tools into a measured, self-prioritising read. SETTINGS WORTH KNOWING - Break Validation: turn displacement, anti-wick and pivot-quality gates on/off and tune their strictness to make structure more or less selective. - Volume Profile / Nodes: bins, window and HVN/LVN percentiles control node tagging; naked POC tracking is session-based and turns itself off when the chart is not intraday. - Confluence & Setup Grade: cluster tolerance controls how close levels must be to count as confluent. - Calibration: horizon and minimum reaction define what counts as a "respected" zone. - Visuals: theme is auto/dark/light; grade-weighted opacity makes strong zones bold and weak ones faint; the identity strip shows the script name, symbol and timeframe. LIMITATIONS Pivots confirm after the right-bars lag, so forming structure is not drawn until confirmed. Volume layers require real or borrowed volume. Calibration describes past behaviour only — it is not a backtest and not a probability of future results. Every read is probabilistic context, never a certainty. DISCLAIMER This is a study/indicator for chart analysis and education only. It is not a strategy, not a recommendation, and not financial advice. It places no orders and guarantees no outcome. Markets carry risk, and the past behaviour of a level does not assure its future behaviour. Do your own research and manage your own risk.
Pine Script® indicator
by Market_Logic_India
Watchman Fib + FVG + VWAP + Session Lines👀 Watchman Fib + FVG + VWAP A clean, all-in-one intraday toolkit for traders who work off 4-hour session structure and Fair Value Gaps. Built for lower-timeframe execution (2m–15m), it keeps the levels that matter on your chart without the clutter. 🛠️ What it plots 📊 Session VWAP — daily-anchored, with adjustable color and width, and a simple on/off toggle. 🟧 Multi-timeframe Fair Value Gaps — both 15m and 1hr gaps, drawn no matter what timeframe your chart is on, and held in place until price fully fills them. Each timeframe has independent fill, border, mid-line, and label controls so you can tell them apart at a glance. 📏 Session-open lines — four fully configurable vertical lines (default 2am / 6am / 10am / 2pm EST to mark the 4H opens), each with its own time, color, and toggle. 🎯 4H range fib — automatically tracks the running high and low of the 6am–10am window and plots your retracement levels live as the range builds. Optional history mode keeps every past session's fib on the chart, which makes it ideal for backtesting the model day by day. 💡 The idea behind it The setup it's built for: during a 4H session the market expands and leaves a 15m Fair Value Gap during 6am-10am - Price later comes back to rebalance that gap, and you look for continuation in the direction of the original expansion or look to catch a reversal — taking the entry down on a 2m–5m chart once the rebalance is in. The fib helps you gauge how deep the retracement has gone relative to the prior range. ⚙️ Everything is modular — turn off what you don't use, recolor what you keep. 📺 For walkthroughs of the model, backtests, and how I trade it live, find my YouTube and Discord links in my TradingView profile. ⚠️ Educational tool only. Nothing here is financial advice — trade your own plan and manage your risk.
Pine Script® indicator
by IxIIxIGENESISIxIIxI
1
Fair Value Gap Continuation FrameworkOverview This strategy studies how price interacts with Fair Value Gaps (FVGs), which are areas that can form after strong directional price movement. The script identifies potential imbalance zones and monitors future price interaction with those areas. Rather than entering immediately after a gap forms, the strategy waits for price to revisit the zone and show signs of continuing in the original direction. The objective is to explore how imbalance zones may be incorporated into a rules-based trading framework. What Is a Fair Value Gap? A Fair Value Gap is commonly described as an area created when price moves rapidly, leaving a gap between portions of surrounding candles. In this script: Bullish gaps are identified after upward displacement. Bearish gaps are identified after downward displacement. Previously identified zones remain available for future analysis when price revisits them. Strategy Logic Gap Identification The script searches for simple three-candle imbalance patterns that may indicate a Fair Value Gap. Zone Retest Once a gap has been identified, the strategy waits for price to return to that area. Continuation Confirmation A trade is considered only after price revisits the zone and closes back in the direction of the original move. Risk Management Stop-loss and target levels are calculated using ATR, allowing risk parameters to adapt to changing volatility conditions. Features Fair Value Gap detection Retest-based entries ATR-based risk management Trend continuation framework Research and testing focused design Intended Use This script is designed as an educational example demonstrating one approach to identifying and testing Fair Value Gap behavior. It may be used to study: Price imbalances Retest behavior Trend continuation concepts Volatility-adjusted exits Users may choose to modify parameters and test the script across different symbols and timeframes. Notes Fair Value Gap concepts are interpreted differently by different traders. This script provides one simplified implementation and should not be considered a complete representation of all Fair Value Gap methodologies. Disclaimer This script is provided for educational and research purposes only. It demonstrates one method of identifying and testing Fair Value Gap behavior using Pine Script. The script does not predict future market direction and should be evaluated through independent testing before being incorporated into any trading process.
Pine Script® strategy
by AIScripts
Fair Value Gap Fill Probability [PickMyTrade]Fair Value Gap Fill Probability applies a Gaussian Naive Bayes classifier — trained entirely within Pine Script® v6 — to every Fair Value Gap it detects, in order to estimate the posterior probability that each gap will be filled before it expires. Instead of treating all FVGs as equal, it asks a different question: given this gap's order-flow signature, geometry, and the time price has already spent nearby, how likely is it to actually fill? ―――――――――――――――――――――――――――――――――――――― 🔷 WHAT IT MEASURES 🔸 Fair Value Gaps A Fair Value Gap is the three-candle imbalance where an impulsive move leaves a price range untraded. A bullish FVG forms when the high of two bars ago sits below the current low; a bearish FVG forms when the low of two bars ago sits above the current high. Each gap is detected only on confirmed bar closes and is filtered by a minimum size relative to ATR, so noise gaps are ignored. 🔸 Three classifier features When a gap forms, the classifier records three z-score normalised features that describe its context: F1 — CVD Momentum : the rate of change of Cumulative Volume Delta at the moment the gap is created, normalised by its rolling mean and standard deviation. This encodes whether aggressive order flow was accelerating or fading as the imbalance formed. F2 — Gap Geometry : the size of the gap expressed as a multiple of ATR. Larger relative gaps behave differently from small ones, and this feature lets the model separate the two. F3 — Time-at-Price : the fraction of recent bars whose close fell inside the gap's price band. A zone the market has already revisited carries different fill odds than fresh, untested space. 🔸 Fill vs no-fill outcomes Every gap is followed until one of two things happens: price trades to the gap's midpoint (a fill ), or the gap survives past the expiry window untouched (a no-fill ). Each resolved gap becomes a labelled training example, so the model learns continuously from the chart's own history. ―――――――――――――――――――――――――――――――――――――― 🔷 THE CLASSIFIER 🔸 Welford online learning Rather than storing arrays of past gaps, the classifier keeps running sufficient statistics — count, mean and variance — for each (feature × outcome) pair using Welford's numerically stable online update. Parameters shift gradually as market conditions change, with no fixed lookback buffer. 🔸 Gaussian likelihood + Bayesian posterior Each feature is modelled as a Gaussian distribution under both the fill and no-fill classes. The three per-feature likelihoods are multiplied under the Naive Bayes independence assumption, combined with an empirically updated class prior, and normalised via Bayes' theorem to produce P(fill | F1, F2, F3) for the live gap. A warmup gate suppresses probabilities until enough fill and no-fill samples have accumulated, at which point the info table switches to LIVE. ―――――――――――――――――――――――――――――――――――――― 🔷 SIGNALS AND DISPLAY 🔸 Probability-shaded zones Each active FVG is drawn as a translucent zone with a crisp coloured border — blue for bullish, orange for bearish. The fill intensity scales with the posterior across three tiers, so a high-conviction gap reads instantly against a faint, low-probability one. Filled gaps turn grey so mitigation is obvious. 🔸 Live probability labels Every open gap carries a running " X% fill " label that updates each bar as the classifier re-evaluates it. When a gap clears the high-probability threshold, a bold callout (" Bullish FVG · 81% fill prob ") marks it directly on the chart. 🔸 Info table The corner table reports the live state — fill samples, no-fill samples, active gaps, CVD flow direction, and a LIVE / WARMUP status flag so you always know whether the model has enough data to be trusted. ―――――――――――――――――――――――――――――――――――――― 🔷 INPUTS ATR Period — basis for the minimum gap-size filter. Min Gap Size (ATR ×) — gaps smaller than this multiple of ATR are ignored. Max Active FVGs — cap on simultaneously tracked gaps. Expire after N bars — unfilled gaps retire as no-fill samples after this many bars. CVD Momentum Period — lookback for feature F1. Z-Score Window — normalisation window for all three features. Warmup Samples Per Class — minimum fill and no-fill samples before probabilities display. High-Prob Threshold — posterior level that marks a gap as high-conviction. ―――――――――――――――――――――――――――――――――――――― 🔷 REQUIREMENTS AND LIMITATIONS The classifier requires a warmup period before probabilities are valid; on instruments with little history the table will read WARMUP until enough gaps have resolved. The CVD estimator is synthetic — derived from intrabar price position, not true bid/ask data — and is noisier on illiquid symbols. Because all three features are CVD- and geometry-derived, the Naive Bayes independence assumption is only approximately satisfied, so the posteriors are best read as relative confidence scores rather than calibrated frequentist probabilities. Fill rates are also regime- and timeframe-dependent and are historically associated with, not predictive of, future behaviour. ―――――――――――――――――――――――――――――――――――――― Built natively in Pine Script® v6. No external libraries, no data feeds, no fixed lookback arrays. The Gaussian Naive Bayes classifier trains continuously from the chart's own gap history using Welford's online algorithm. Open source — Mozilla Public License 2.0.
Pine Script® indicator
by PickMyTrade_Official
HTF Fair Value Gap (FVG) IndicatorAutomatically detects and plots Fair Value Gaps from the 1H, 4H, and Daily timeframes directly on any chart. A Fair Value Gap is a 3-candle imbalance where the wick of candle A and the wick of candle C do not overlap, leaving an unfilled gap in price. Bullish FVGs form when the high of candle A is below the low of candle C. Bearish FVGs form when the low of candle A is above the high of candle C. Each FVG is drawn as a colored box spanning the gap zone with a dotted midline. When price trades back through a zone it becomes an Inverse Fair Value Gap (IFVG), changing color to indicate the shift in character. IFVGs can be toggled off to simply remove mitigated zones. All colors and borders are fully customizable. You can control how many FVGs per timeframe are displayed at once, keeping the chart clean regardless of what timeframe you are trading on.
Pine Script® indicator
by M355Y
[MAD] SMC1. OVERVIEW SMC Event Markers is a complete Smart-Money-Concepts toolkit that draws every major institutional footprint on the chart — and then ranks every zone by relevance so you instantly see which ones actually matter. Most SMC indicators have the same problem: they paint dozens of FVGs, order blocks, and liquidity lines, and leave you to decide what to trade. After ten zones the chart looks like a dropped Lego set. This indicator solves that. Every active zone is scored 0–100 against five independent factors. Low-scoring zones fade or disappear automatically. A compact dashboard pins the top-ranked setups to a chart corner so you always know where the high-probability opportunities are. The indicator detects 14+ SMC event types — FVG, IFVG, Order Blocks, Breaker Blocks, BSL/SSL, BPR, EQH/EQL, BOS/CHoCH, Sweep, IDM, Reversal Confirmed, Premium/Discount/Equilibrium, OTE, Volume Imbalance, SMT Divergence, PDH/PDL/PWH/PWL/PMH/PML, and ICT killzones. Every zone is ranked 0–100 by a relevance score built from five factors; opacity scales with that score so the eye is drawn to the bright zones while weak ones recede, and a threshold filter deletes the weakest zones entirely to free chart drawing budget. A top-N dashboard ranks the strongest setups by price, direction, age, and score. Three colour schemas — Default (customizable), Dark, and Light — are switchable globally, with all 22 default colours exposed as individual inputs. Per-type drawing caps and an FVG merge engine keep performance steady on busy timeframes. 2. HOW IT WORKS SMC Event Detection The script identifies institutional footprints in real time. Every event has its own creation logic and mitigation logic — once price returns and fills the inefficiency, the zone is removed from the chart. Fair Value Gaps are 3-bar imbalances where the wicks don't touch, rendered as semi-transparent boxes with a centre-line at the consequent encroachment (CE). Order Blocks are the last opposite-coloured candle before a structure break, gated by minimum displacement (× ATR). Breaker Blocks are Order Blocks that flip side after price violates them, indicating role reversal. Liquidity (BSL / SSL) lines mark confirmed swing highs and lows where retail stops cluster, while BPR (Balanced Price Range) zones are detected as overlaps between opposing FVGs — high-probability institutional pivots. EQH / EQL marks equal highs and lows within an ATR tolerance, identifying magnet liquidity. BOS / CHoCH distinguishes Break of Structure (continuation) from Change of Character (reversal); when a CHoCH prints shortly after a liquidity sweep, it is auto-tagged as Reversal Confirmed . The script also detects Sweep , IDM (Inducement) , and SMT divergence against a configurable reference symbol, and shades Killzones for the Asia, London, NY-AM, and NY-PM sessions in the timezone of your choice. Confluence Scoring For every active zone, the script counts how many other zones overlap its price range within an ATR-based tolerance. Confluence between an Order Block, a Fair Value Gap, and a previous-day high is the textbook setup smart-money traders look for — this metric quantifies it. Composite Relevance Score Each zone is scored 0–100 from five normalised factors with user-editable weights: Confluence (default 30%) measuring how many other zones overlap, Freshness (20%) decaying exponentially with bars since creation, Displacement (20%) capturing the size of the impulse that created the zone divided by ATR, Trend Alignment (15%) rewarding zones that match the current swing-structure direction, and Proximity (15%) favouring zones near current price normalised by ATR reach. Weights don't have to sum to 100 — normalisation happens internally. The score recalculates every bar, so as price moves the proximity factor updates and the ranking shifts in real time. Visual Hierarchy Opacity scales with score — a zone at score 90 is vivid; at score 35 it's nearly transparent. Same colours, different volume. The threshold filter takes this further: anything below a configurable score (default 30) is deleted, not just dimmed — this frees drawing slots and prevents drawing-limit overflow on busy charts. Every zone label optionally appends its score, e.g. "Bull OB 82". Dashboard Panel On the last bar, a compact table renders in the chart corner showing the top N zones ranked by score. Each row displays rank, type, price, direction, age in bars, and score with star rating and tier colour (≥80 green, ≥60 teal, ≥40 amber, <40 grey). The table updates with every new bar. 3. HOW TO USE The Dashboard Workflow Glance at the dashboard. The top 2–3 zones are your high-probability watchlist for this chart — combine the price level shown with the type and direction to plan your entries. If nothing has a score above 60, the market isn't offering quality setups; wait. Trading Reversals Look for this sequence on the chart. First, price sweeps a BSL or SSL line and a sweep label appears. Within a few bars, CHoCH prints — a close back through the opposing swing — and a Reversal Confirmed label fires at that CHoCH point. From there, look for a fresh Order Block or FVG in the direction of the new bias, ideally inside the Discount or Premium zone or the OTE. Enter on retracement to that zone, place your stop beyond the swept extreme, and target the opposite liquidity pool (the BSL or SSL on the other side). Trading Continuations After a BOS in the direction of the current trend, the OB or FVG that produced the break becomes a high-probability retracement entry. The dashboard will surface it automatically if its score is in the top tier. Decluttering for Clarity The Threshold input is your declutter dial. On a busy 1H chart with 50+ historical zones, set it to 60 — only the cream stays visible. On a clean 15m intraday, set it to 30 to keep more context. At 0, every detected zone is drawn (legacy mode). Combine With Other Confluence The scoring system already integrates intra-indicator confluence. For external confluence, overlay your higher-timeframe levels, a volume profile, or session VWAPs — anything that aligns with a high-score zone is a stronger setup. 4. SETTINGS Settings are organised into logical groups in the dialog. Structure: swing and internal pivot lengths, BOS / CHoCH toggles, HH/HL/LH/LL labels Liquidity: BSL/SSL/INT_LQ toggles, sweep window, IDM, Reversal Confirmed Order Blocks: minimum displacement (× ATR), Breaker conversion on violation EQH / EQL: ATR tolerance for equal levels Fair Value Gap: small-gap filter, extension bars, mitigation-on-close, BPR detection FVG Merge: consolidates old overlapping FVGs by age and ATR tolerance Volume Imbalance: body-to-body gap detection Premium / Discount: range plot and OTE zone (62–79% retrace) Previous H/L: PDH/PDL, PWH/PWL, PMH/PML toggles SMT: divergence reference symbol (default NQ futures) Killzones: session backgrounds in selectable timezone Drawing Limits: per-type caps to control total draw count Scoring: confluence tolerance, freshness decay, proximity reach, five weights, threshold, opacity toggle, score-in-label toggle Dashboard: show / rows / position / cell size Colors: schema enum (Default / Dark / Light) plus 22 individual colour inputs Style: label size, extension bars, all event label text 5. DESIGN DECISIONS This indicator was built around three principles. Decluttering is more valuable than detection. Anyone can detect an FVG — the hard part is knowing which of the twelve currently on screen is the one you should care about. The scoring system exists because the trader's biggest enemy is signal-to-noise, not missing signals. Every zone should justify its space. Opacity scaling and the threshold-delete behaviour mean that low-conviction zones don't merely fade — they're erased from the drawing pool, so the chart stays performant even on minute-tick instruments with thousands of bars of history. The drawing-limit caps (configurable per event type) reinforce this. Customisation should be opt-in. The Default schema is the production-ready palette. Most traders won't touch the 22 colour inputs. But for designers who care, every base colour is individually editable. Dark and Light schemas exist as one-click presets for OLED users and light-theme users respectively. 6. CREDITS AND ATTRIBUTION The Smart Money Concepts framework is a community-developed body of knowledge built on the work of Richard Wyckoff (1930s — accumulation / distribution cycles, composite-man theory), Charles Dow (higher-highs / higher-lows market structure), Michael J. Huddleston / ICT (modern SMC terminology — BOS, CHoCH, Liquidity, Breaker, FVG, OTE, Killzones), and the wider SMC trading community that refined, tested, and disseminated these ideas. 7. DISCLAIMER For educational and informational purposes only — not financial advice. Past performance does not guarantee future results, and all trading decisions are made at your own risk. The author accepts no liability for any loss arising from use of or reliance on this script.
Pine Script® indicator
by djmad
4
[ A L P H A X ] VOIDAlphaX VOID — Fair Value Gap Confluence System: FVG Detection, 5-Layer Retest Entries, CE Rejection Filter & ATR Trailing Exit Engine AlphaX VOID is a professional-grade smart money confluence system built around the single most powerful concept in institutional price action: the Fair Value Gap. Where price moves so aggressively that it leaves an unmitigated imbalance in the order book — a void — institutions return to fill orders at those levels. VOID detects every qualifying gap in real time, tracks its state, and waits. When price returns to retest that void, a 5-layer confluence engine evaluates the quality of that retest across EMA structure, squeeze momentum, volume delta pressure, VWAP bias, and ADX directional strength. Only when enough layers agree does a signal fire — not on the gap formation, not on the first touch, but on a confirmed, high-quality institutional retest with the trend and momentum behind it. Designed for active traders on crypto, forex, gold, and indices across the 1-minute to 15-minute timeframes. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🕳 What Is a Fair Value Gap? A Fair Value Gap (FVG) is a three-candle price structure where the middle candle moves with such force that it creates a gap between the wick of the first candle and the wick of the third candle — a zone where no two-sided trading occurred. Price moved through that area too fast for the market to establish fair value. Bull FVG: The low of candle 3 is above the high of candle 1. Price left a gap to the upside — an unmitigated bullish imbalance. When price returns to this zone, institutions are likely resting buy orders there. Bear FVG: The high of candle 3 is below the low of candle 1. Price left a gap to the downside — an unmitigated bearish imbalance. When price returns to this zone, institutions are likely resting sell orders there. Why FVGs matter to institutional traders: Market makers and large institutions cannot fill their full order size in a single fast move. When price revisits the FVG zone, they use the retest to complete their position. This is why FVG retests so frequently produce high-velocity continuation moves — they are not random support/resistance, they are unfilled institutional order clusters. AlphaX VOID does not simply draw FVG boxes. It tracks the lifecycle of every gap — from formation through active, retest, and filled — and only presents entry signals when the retest coincides with genuine multi-layer confluence. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔬 FVG Detection Engine — Quality Filters Not every gap is worth trading. Gaps formed during weak, choppy price action are noise. VOID applies two mandatory quality filters to every detected gap before registering it as valid. Displacement Filter: The middle candle of the three-candle structure must show genuine displacement — its body must exceed the average body size over the last 14 bars by a configurable multiplier (default: 1.15×). This ensures the gap was formed by a real impulsive move, not a slow grind that happened to leave a small gap. A gap without displacement is a weak gap. Minimum Gap Size Filter: The physical size of the gap (the distance between the relevant wicks of candle 1 and candle 3) must meet a minimum threshold expressed as a multiple of ATR (default: 0.15×). This eliminates micro-gaps that are too small to be meaningful — gaps so narrow that spread and noise would immediately invalidate any retest entry. Only gaps passing both filters are registered, stored, and tracked. FVG Lifecycle Tracking: Every registered FVG is stored in memory arrays with its top, bottom, direction, formation bar, and fill state. On every bar, VOID updates the state of all active gaps: Active — gap is unmitigated. Box and CE line extend forward in real time Filled — price has fully closed through the gap boundary. Box color shifts to neutral gray, CE line fades. Optionally hidden entirely via the Hide Filled FVGs setting Age cutoff — gaps older than the configured Max FVG Age (default: 120 bars) are excluded from retest scanning. Old gaps lose institutional relevance as market structure evolves ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📐 The FVG Visual System Every active FVG is rendered directly on the price chart as a structured visual zone with three components. FVG Box: A shaded rectangle spanning the full gap from top to bottom. Bull gaps are shaded in semi-transparent yellow-green; bear gaps in semi-transparent red. The box extends forward by the configured number of bars (default: 30) and updates in real time as price evolves. When a gap fills, the box shifts to neutral gray — or is removed entirely if Hide Filled FVGs is enabled. CE Line (Consequent Encroachment — 50% Level): A dashed line at the exact midpoint of the FVG zone. This is the Consequent Encroachment level — the 50% retracement into the gap. This level is critical for entries: the most reliable FVG retests are those where price dips into the gap but closes back above (bull) or below (bear) the CE line, demonstrating that the institutional zone held and rejected price cleanly. The CE Rejection filter is on by default and can be toggled in settings. FVG Formation Dots: Small squares appear below (bull FVG) or above (bear FVG) the bar at the moment a new qualifying gap is formed, providing instant chart-level notification of every new gap without requiring dashboard attention. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🧠 The Retest Detection Engine Detecting a gap is the easy part. Detecting a high-quality retest of that gap is the core intellectual challenge VOID is built to solve. On every bar, VOID scans all active, unfilled FVGs of the appropriate direction for a valid retest condition. A retest requires all of the following to be true simultaneously: 1. Price overlap: The current bar's low must be at or below the FVG top, and the current bar's high must be at or above the FVG bottom. Price is physically inside or touching the zone. 2. Candle rejection: The bar must close in the correct direction — a bullish close (close above open) for a bull FVG retest, a bearish close for a bear FVG retest. Price entered the gap but the candle closed back out, demonstrating rejection. 3. CE rejection (when enabled): For bull retests, the close must be at or above the CE midline — not just any bullish close, but one that reclaims the institutional midpoint. For bear retests, the close must be at or below the CE midline. This is the single most important retest quality filter in the system. A retest that fails to reclaim the 50% level is a weak, indecisive retest. 4. Age validation: The gap must be no older than the configured maximum age. Gaps older than this threshold are excluded even if all other conditions are met. 5. Most recent qualifying gap priority: When multiple gaps qualify simultaneously, VOID selects the most recently formed gap — the freshest institutional imbalance takes precedence. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📊 The 5-Layer Confluence Engine A valid FVG retest alone is not sufficient for a signal. VOID requires that the retest occur within a high-quality confluence environment across five independent layers. Each layer casts a directional vote on every bar. Signals only fire when a configurable minimum number of votes align (default: 3 of 5). ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Layer 1 — EMA Ribbon (Trend Structure) A triple EMA ribbon using Fast (default: 8), Slow (default: 21), and Signal (default: 50) EMAs. All three must stack in directional order and price must be on the correct side for a full ribbon vote. Bull: Fast above Slow above Signal, close above Fast EMA. Bear: Fast below Slow below Signal, close below Fast EMA. A separate EMA Trend Alignment setting (default: on) enforces that bull FVG retest signals only fire when the fast EMA is above the slow EMA — the minimum trend structure condition — even if the full ribbon stack is not met. This prevents counter-trend FVG entries that carry the lowest success rate. The ribbon is plotted on the chart as a gradient fill between the Fast and Slow EMA lines — yellow-green fill during bull structure, red during bear, gray during flat. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Layer 2 — Squeeze Momentum (Energy Detection) The TTM Squeeze momentum engine measures whether energy is building or releasing and in which direction. Squeeze state: When Bollinger Bands compress inside Keltner Channels, volatility is contracting and a directional breakout is loading. This state is displayed as an orange background tint and flagged on the dashboard as ⚡ SQZ. An FVG retest that coincides with a squeeze release is one of the highest-quality setups the system can detect — the gap provides the structural level, the squeeze provides the breakout energy. Momentum direction: Calculated via linear regression of price relative to the midpoint of the recent high-low range. Positive and rising = bull momentum. Negative and falling = bear momentum. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Layer 3 — Volume Delta (Institutional Pressure) A proprietary volume pressure model that splits each candle's volume into estimated bullish and bearish components based on the close position within the high-low range, smoothed by EMA. A secondary OBV slope confirms the dominant pressure direction over the configured lookback. Bull vote: Bull volume EMA exceeds bear, delta EMA is positive, and OBV slope is rising — three independent volume signals all confirming buying pressure. Bear vote: The full inverse. An FVG retest with genuine volume delta confirmation means real capital is flowing into the gap zone, not just price drifting back. This is the distinction between a high-probability institutional retest and a low-energy drift that is likely to fail. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Layer 4 — VWAP Bias (Institutional Session Reference) The Volume Weighted Average Price anchored to the session provides the clearest single reference for institutional directional bias. Price above VWAP means institutions are net buyers for the session. Price below means net sellers. Bull vote: Close above VWAP. Bear vote: Close below VWAP. A bull FVG retest that occurs while price is above VWAP is a with-institution trade. A bull FVG retest while price is below VWAP is counter-institutional — the gap exists, the retest is clean, but the session-level bias is working against the entry. This distinction is worth one full confluence point and often determines whether a retest succeeds or fails. The VWAP filter can be toggled off, and the VWAP line itself can be shown or hidden independently. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Layer 5 — ADX Directional Strength (+DI / -DI) The ADX filter in VOID operates at two levels. First, the ADX value must meet the minimum threshold (default: 18) confirming the market is trending rather than ranging. Second, the directional component is used — +DI versus -DI — to confirm that the ADX strength is aligned with the signal direction. Bull vote: ADX above threshold and +DI exceeding -DI — the trend strength is directionally bullish. Bear vote: ADX above threshold and -DI exceeding +DI — the trend strength is directionally bearish. This is fundamentally different from a simple ADX on/off gate. An ADX reading of 25 with +DI above -DI in a bull FVG setup is confirming. An ADX reading of 25 with -DI above +DI in a bull FVG setup means the trend strength is bearish — directionally opposed to the signal — and this layer will not vote for it. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🏷 Signal Firing Logic A VOID signal fires when all of the following are simultaneously true: A valid FVG retest is detected (overlap + candle rejection + CE rejection if enabled + age check) The confluence score meets or exceeds the configured minimum (default: 3 of 5 layers) ADX confirms a trending market (value above minimum threshold) Session filter confirms active hours Signal cooldown has elapsed since the last signal (default: 8 bars) — prevents repeated signals during extended retest zones EMA trend alignment condition is met if the Require EMA Trend Alignment setting is enabled Edge triggering: The signal fires only on the bar where all conditions first become true simultaneously — not on every bar they remain true. Each triangle on the chart represents a distinct, fresh confluence event. Score label: Every signal prints a label (e.g., 4/5 FVG ) showing the live confluence score at signal time. The FVG suffix confirms this is an institutional gap retest entry, not a generic momentum entry. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🎯 FVG-Anchored Stop Loss Placement VOID includes a purpose-built stop loss mode unique to FVG trading: Place SL Beyond FVG Edge (default: on). When enabled, the stop loss for a bull retest entry is placed at the bottom of the retested FVG minus an ATR buffer — not below the current bar's low. For a bear retest, the stop is placed at the top of the retested FVG plus an ATR buffer. Why this matters: The FVG boundary is the institutional invalidation level. If price closes beyond the far edge of the gap, the imbalance has been fully absorbed — the institutional thesis for the retest is gone and the trade is structurally invalid. Using the FVG edge as the stop base produces stops that are: Structurally meaningful — anchored to the actual invalidation level, not an arbitrary ATR distance from entry Tighter when gaps are narrow — better risk-reward on high-quality, precise gaps Wider when gaps are large — providing the trade room to breathe within the full institutional zone When this setting is off, the stop reverts to a standard ATR-based distance from the bar's low or high — consistent with the Pulse Scalper behavior. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🛡 Dynamic ATR Exit System All three exit mechanisms from the VOID exit engine work together on every open trade: Stop Loss: Placed at the FVG far edge (when enabled) or bar low/high, minus/plus an ATR buffer (default: 1.2×). Your maximum risk boundary. Does not move. TP1 — Partial Target (50%): 1.8× ATR from entry. Scale out half the position here and move the remainder to breakeven. A small circle marker appears at the TP1 bar. TP2 — Full Target: 3.5× ATR from entry. Full position exits and the system resets. A labeled TP marker confirms the exit on the chart. ATR Trailing Stop: A dynamic stop that advances with price every bar — always positioned 1.5× ATR behind the current bar's low (bull) or high (bear). Plotted as a live orange line. In strong institutional continuation moves, the trail captures significantly more than the fixed TP2 target. In weak retests that stall early, the trail cuts the loss before the fixed SL is reached — providing a tighter actual exit than the structural stop. All exit levels are plotted as live lines on the chart for the duration of the trade and cleared automatically on exit. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📊 Live Dashboard The real-time dashboard displays the complete internal state of the indicator across four sections, updated on every bar. FVG STATE Bull FVGs — count of currently active, unfilled bull FVGs being tracked Bear FVGs — count of currently active, unfilled bear FVGs being tracked Retest — live retest detection status: ▲ BULL RETEST or ▼ BEAR RETEST when a valid gap touch is occurring, — NONE otherwise. This updates in real time so you can see a retest developing before the full signal fires MARKET Session — ✓ ACTIVE or ✗ OFF-HOURS. Confirms whether the session filter gate is open ADX — live ADX value with ✓ or ✗ pass/fail. Confirms whether market structure is trending strongly enough to support FVG retest entries CONFLUENCE L1 EMA — current ribbon state: ▲ BULL, ▼ BEAR, or — FLAT L2 Momentum — current momentum state: ⚡ SQZ (squeeze building), ▲ BULL, ▼ BEAR, or — FLAT. The squeeze state is the highest pre-signal alert condition L3 Vol Delta — current volume pressure: ▲ BULL, ▼ BEAR, or — NEUTRAL L4 VWAP — current VWAP position: ▲ ABOVE (institutional bull bias) or ▼ BELOW (institutional bear bias) L5 ADX Dir — ADX directional vote: ▲ BULL (+DI dominant), ▼ BEAR (-DI dominant), or — FLAT Bull Score — live 0–5 score. Background highlights yellow-green when the minimum threshold is met Bear Score — live 0–5 score. Background highlights red when the minimum threshold is met POSITION Position — current tracked position: ▲ LONG, ▼ SHORT, or — FLAT with background color highlight Stop Loss — the active SL level (FVG-anchored or ATR-based depending on settings), color-coded by direction TP1 / TP2 — the active first take-profit level; TP2 is tracked internally and triggers the full exit marker Bars in Trade — bars elapsed since entry, tracking trade duration ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📈 Chart Visual System FVG Boxes (yellow-green / red) — active imbalance zones extending forward in real time. Color shifts to gray on fill CE Dashed Lines — the 50% midpoint of every active FVG. The key level for CE rejection filtering Formation Dots — small squares marking the exact bar a new qualifying FVG was detected ▲ Triangle (below bar) — bull retest entry signal. All conditions met ▼ Triangle (above bar) — bear retest entry signal. All conditions met Score Label (e.g. 4/5 FVG) — confluence score at signal time, printed on every entry triangle EMA Ribbon Fill — yellow-green fill during bull EMA structure, red during bear, gray during flat VWAP Line (purple) — optional, toggleable session VWAP reference Orange Squeeze Background — active during Bollinger/Keltner squeeze conditions Yellow-green background tint — active during open long trades Red background tint — active during open short trades SL Line — fixed stop loss level, active while trade is open TP1 Line — first partial take-profit target TP2 Line (bright) — full exit target Trail Line (orange) — dynamic trailing stop, advances with price every bar TP marker — confirms TP2 hit and full exit SL marker — confirms stop loss or trail triggered ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🚀 How to Trade with AlphaX VOID — Step by Step Step 1 — Read the FVG State Check the dashboard: how many active bull and bear FVGs are on the chart? Multiple active FVGs in one direction indicate a well-defined institutional order cluster — a zone with stacked imbalances that price is likely to respect strongly on retest Zero active FVGs in a direction means no institutional retest opportunity exists yet — wait for a new gap to form Step 2 — Watch for Retest Alert on the Dashboard The RETEST row updates in real time. ▲ BULL RETEST or ▼ BEAR RETEST appearing means price is currently inside a valid FVG zone with a rejection candle forming This is your cue to check the confluence score rows. Watch the bull or bear score building in real time on the current bar — if it is approaching or has crossed the threshold, a signal may be seconds away Step 3 — Enter on the Signal Triangle A ▲ triangle below the bar is a confirmed bull FVG retest entry. All conditions — FVG retest quality, confluence score, ADX, session, cooldown, trend alignment — are met simultaneously A ▼ triangle above the bar is a confirmed bear FVG retest entry Read the score label. A 5/5 signal is the maximum confluence available — all five layers and the gap retest aligned simultaneously. These are the highest-conviction setups VOID produces Enter on the close of the signal bar or the open of the next bar Step 4 — Manage the Trade with Live Exit Lines The SL line is your structural invalidation. If you used the FVG-anchored SL, price closing beyond this level means the institutional gap has been fully absorbed — the thesis is invalid Watch the orange Trail Stop advancing with price as the trade moves in your favor At TP1, scale out 50% of the position. Move your stop to breakeven on the remainder Let the trailing stop manage the rest — it captures whatever continuation the institutional imbalance produces Step 5 — Exit and Reset A TP marker confirms TP2 hit. Full exit and system reset An SL marker confirms stop or trail triggered. Accept the loss and wait — the FVG that was retested is now filled or invalidated, and a new setup will develop from the next qualifying gap Never re-enter immediately after a stopped trade. Wait for the confluence score to rebuild and a new qualifying gap to form or a fresh retest of a different active gap ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚠ Identifying Low-Quality Conditions — When Not to Trade Stand aside when: ADX ✗ on the dashboard — the market is not trending. FVG retests in ranging markets are frequently absorbed rather than rejected, producing whipsaw exits RETEST shows ▲ or ▼ but no triangle appears — a retest is occurring but the confluence score or other filters are blocking the signal. This is the system explicitly telling you the quality threshold is not met — do not override it manually Session ✗ OFF-HOURS — thin liquidity environments produce unreliable FVG reactions. The institutional actors who created the gap are not active Multiple gap fills in quick succession — if several FVGs are filling rapidly without producing entries, the market is in a trending impulse phase eating through old imbalances rather than respecting them. Wait for the new gaps being created by this impulse to age and become valid retest candidates Score stuck at 1 or 2 of 5 — the confluence environment is fragmented. Too few layers agree for a reliable institutional retest Orange squeeze background present but score below threshold — energy is coiling but the directional confluence is not established. Wait for the squeeze to release in a clear direction with score confirmation before acting What to do: Monitor the dashboard for the RETEST row and confluence scores building simultaneously — the ideal setup shows both developing on the same bar Prioritize gaps with the CE Rejection filter active — CE-rejected retests are the cleanest institutional entries available Wait for ADX to confirm — a trending ADX above threshold combined with a directional +DI/-DI alignment is the ideal background for FVG retest entries The highest-quality VOID setup: active squeeze on the dashboard, price retesting a fresh FVG at the CE level, 5/5 confluence score, ADX ✓, session ✓. These conditions together rarely occur — when they do, they produce the strongest continuation moves the system identifies ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚡ Key Features 🕳 Real-time FVG detection engine — identifies all qualifying bull and bear Fair Value Gaps with displacement and minimum gap size filters 📦 Full FVG lifecycle tracking — every gap stored in memory arrays with top, bottom, direction, age, and fill state updated on every bar 📐 CE (Consequent Encroachment) filter — requires price to reclaim the 50% midpoint of the gap on retest, eliminating weak, indecisive touches 🧠 5-layer confluence gate — EMA Ribbon, Squeeze Momentum, Volume Delta, VWAP Bias, and ADX Directional Strength must agree before a retest signal fires 📊 Live confluence scoring — bull and bear scores updated every bar, displayed on the dashboard before the signal appears 🎯 FVG-anchored stop loss — places the SL at the structural invalidation level (the far FVG edge) rather than a generic ATR distance, producing structurally meaningful risk levels ⚡ Squeeze momentum integration — TTM-style Bollinger/Keltner squeeze detection flags pre-breakout energy buildup with orange background tint and dashboard state 📡 VWAP session bias — confirms whether a retest is with or against institutional session direction 🔬 ADX directional filter — uses both the ADX value and +DI/-DI directionality, not just a simple trend/no-trend gate 🛡 Dynamic ATR trailing stop — orange line advances with price every bar, capturing extended institutional continuation moves beyond the fixed TP2 level 📈 EMA ribbon with trend alignment enforcement — prevents counter-trend FVG entries that carry the lowest success rate 🕐 Session filter — restricts entries to active market hours, eliminating thin-liquidity false retest reactions ⏱ Signal cooldown — prevents repeated signals during extended retest zones, ensuring each entry represents a distinct high-quality event 📊 21-row live dashboard — FVG State, Market, Confluence, and Position sections updated in real time 🔔 10 alert conditions — new FVG formation, retest entry, TP1/TP2 hits, stop hits for both bull and bear 🎨 Fully cohesive dual-tone color system — yellow-green for all bullish elements, red for all bearish elements, orange for squeeze and trail, gray for filled gaps and neutral states ⚙ Fully configurable — FVG parameters, confluence layers, EMA periods, squeeze settings, VWAP filter, ADX threshold, exit multipliers, session window, and all colors are independently adjustable ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚙ Settings Reference Fair Value Gaps Show FVG Zones — toggle FVG boxes on or off Show CE (50%) Lines — toggle the consequent encroachment midpoint lines Max Active FVGs — maximum number of FVGs stored in memory simultaneously (default: 40) Zone Extend (bars) — how many bars forward the FVG box and CE line project (default: 30) Max FVG Age for Entries — gaps older than this bar count are excluded from retest scanning (default: 120) Min Gap Size (ATR x) — minimum gap width as a multiple of ATR required for gap registration (default: 0.15) Min Displacement (body x) — middle candle body must exceed average body by this multiplier (default: 1.15) Require CE Rejection — close must reclaim the 50% gap midpoint on retest (default: on — strongly recommended) Hide Filled FVGs — removes boxes and CE lines for gaps that have been fully mitigated (default: off) EMA Ribbon Fast EMA — fastest ribbon line (default: 8) Slow EMA — intermediate ribbon line (default: 21) Signal EMA — macro trend anchor (default: 50) Show EMA Ribbon — toggle ribbon fill and lines Squeeze Momentum BB Length / BB Mult — Bollinger Band parameters for squeeze detection (defaults: 20 / 2.0) KC Length / KC Mult — Keltner Channel parameters (defaults: 20 / 1.5) Momentum Length — linear regression period for momentum direction (default: 12) Volume Delta Volume MA Length — EMA smoothing for bull and bear volume estimates (default: 14) OBV Slope Length — lookback for OBV slope directionality (default: 10) VWAP Use VWAP Filter — when on, Layer 4 requires close to be on the correct side of VWAP (default: on) Show VWAP Line — toggle the VWAP line on the chart (default: off) Confluence Gate Min Layers Required — minimum confluence votes needed for a signal (default: 3 of 5) Session Filter — toggle active hours restriction Active Session — configurable session window (default: 0700-2000) Signal Cooldown — minimum bars between consecutive signals (default: 8) Require EMA Trend Alignment — enforces minimum EMA directional alignment even when full ribbon is not stacked (default: on) ADX Filter Use ADX Filter — toggle the trend quality and directional gate ADX Length — calculation lookback (default: 14) ADX Minimum — threshold below which all signals are suppressed (default: 18) Exit Settings ATR Length — lookback for all ATR exit calculations (default: 10) SL ATR Mult — stop loss ATR buffer beyond FVG edge or bar low/high (default: 1.2) TP1 ATR Mult — first take-profit target (default: 1.8) TP2 ATR Mult — full exit target (default: 3.5) Use ATR Trailing Stop — toggle dynamic trailing stop Trail ATR Mult — trailing distance from current bar's extreme (default: 1.5) Show Exit Levels — toggle SL, TP1, TP2, and trail lines on the chart Place SL Beyond FVG Edge — anchors stop to the structural gap invalidation level (default: on) Display Show Confluence Score Label — prints live score on every signal triangle Show Dashboard — toggle the full dashboard panel Dashboard Position — Top Left / Top Right / Bottom Left / Bottom Right Colors Bull / Bull Bright — yellow-green family for all bullish signals, fills, ribbons, and labels Bear / Bear Bright — red family for all bearish signals, fills, ribbons, and labels Squeeze — orange for squeeze tint and trailing stop line Bull FVG / Bear FVG — gap box fill and border colors Filled FVG — neutral gray for mitigated gaps EMA Fast / Slow / Signal — individual EMA line colors Ribbon Fill Bull / Bear / Flat — ribbon fill colors for each trend state VWAP Line — VWAP plot color (default: purple) SL / TP / TP2 / Trail Lines — individual exit level line colors Long Zone BG / Short Zone BG — active trade background tints Bull Label Text / Bear Label Text — text color for score labels on bull and bear signals Dash Text / Dash BG / Dash Header / Dash Section / Dash Frame — full dashboard color control ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔔 Alert Conditions (10 total) FVG Formation Alerts New Bull FVG Formed — a qualifying bullish Fair Value Gap has been detected. Watch for retest entry New Bear FVG Formed — a qualifying bearish Fair Value Gap has been detected. Watch for retest entry Entry Alerts Bull FVG Retest Entry — all conditions met: bull FVG retest, CE rejection, confluence score, ADX, session Bear FVG Retest Entry — all conditions met for a short institutional retest entry Exit Alerts Bull TP1 Hit — price reaches the first bull take-profit. Scale out 50% Bull TP2 Hit — price reaches the full bull exit target. Position closed Bull Stop Hit — stop loss or trailing stop triggered on a long position Bear TP1 Hit — price reaches the first bear take-profit. Scale out 50% Bear TP2 Hit — price reaches the full bear exit target. Position closed Bear Stop Hit — stop loss or trailing stop triggered on a short position All alert messages are formatted as const strings for clean webhook and notification platform integration. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🎯 Recommended Settings by Instrument & Timeframe The default configuration is optimized for XAUUSD, major forex pairs, and crypto on M1–M5 : Min Layers at 3/5 — strong confluence without requiring perfection on every bar CE Rejection on — the single most important FVG quality filter. Leave this enabled in all configurations ADX minimum at 18 — slightly more permissive than the Pulse Scalper default, accounting for the structural quality already provided by the FVG retest condition FVG-anchored SL on — structurally superior stop placement for all FVG-specific entries Max FVG Age at 120 bars — covers approximately 2 hours on M1, 10 hours on M5. Sufficient for intraday imbalances without trading excessively old gaps For other instruments or timeframes, adjust: Higher timeframes (M15, H1, H4) — increase Max FVG Age to 200–300, increase Retest Cooldown to 15–25, increase TP2 to 4.5–5.5× ATR, raise Min Confidence to 4/5 Crypto (BTC, ETH) — increase Min Gap Size to 0.25–0.35× ATR to filter micro-gaps in volatile crypto price action, increase KC Mult to 2.0 for the squeeze layer Indices (NAS100, US30) — use defaults with session tightened to 09:30–16:00. Increase displacement multiplier to 1.3 for cleaner gap quality on index moves More signals — lower Min Layers to 2, disable CE Rejection, increase Max FVG Age, reduce Cooldown Fewer, higher-quality signals — raise Min Layers to 4 or 5, keep CE Rejection on, raise ADX minimum to 22–25, reduce Max FVG Age to 60–80 bars ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 👥 Who This Is For 🏦 Smart money and institutional price action traders — VOID is built on the core concept that institutional order flow creates imbalances and returns to fill them. This is the foundational logic of ICT methodology applied with quantitative confluence filters 🥇 Gold (XAUUSD) and forex scalpers — FVGs are particularly reliable on gold and major forex pairs where institutional order flow is most dominant 📊 Crypto and index traders — the displacement and gap size filters adapt the system to higher-volatility instruments without producing noise 🎯 Precision entry traders — the CE rejection filter and FVG-anchored stop produce tighter, more structurally defined entries than generic momentum systems 🧠 Systematic traders — the 5-layer confluence score provides a quantitative quality metric for every retest event, not just a visual signal 📉 Traders who want to stop chasing breakouts — VOID forces you to wait for price to return to the institutional level, eliminating the discipline failure of entering on extended, overheated moves ⚠ Traders who struggle with stop placement — the FVG-anchored SL system provides structurally meaningful stop levels determined by the market's own imbalance boundaries, not arbitrary ATR multiples ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📝 Notes All signals are confirmed on bar close — the indicator is non-repainting by design. FVG boxes and CE lines may extend or update visually on the current bar, but no signal is generated until bar close confirmation The CE Rejection filter is strongly recommended. Disabling it allows signals on any touch of the FVG box, including weak wicks that are unlikely to produce clean continuation moves Maximum 500 labels, 500 lines, and 500 boxes are rendered. On very low timeframes with extended chart history, the oldest FVG boxes, CE lines, and signal markers may be automatically removed by TradingView's rendering limits. Reduce Max Active FVGs if this becomes an issue FVG fill state is based on bar close — a wick through the gap boundary that closes inside or above the zone does not mark the gap as filled. Only a close beyond the boundary constitutes a fill The VWAP calculation resets at the start of each session. On 24-hour crypto instruments, the VWAP anchors to the chart's visible history. For best VWAP behavior on crypto, consider disabling the VWAP filter (Layer 4) and relying on the remaining four layers Gap age counting begins from the formation bar. A gap formed 5 bars ago on M5 is 25 minutes old — very fresh. The same gap age on H1 is 5 hours old — potentially stale. Adjust Max FVG Age to your timeframe context The Trade Status section tracks position direction from signal to exit within a single chart session — it does not connect to your broker or brokerage account ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚠ Disclaimer This indicator is a technical analysis and visualization tool intended for educational and informational purposes only. It does not constitute financial advice or a recommendation to buy or sell any financial instrument. All signals are generated from historical and real-time price data using mathematical calculations — their accuracy or profitability is not guaranteed. Past performance of any signal type does not guarantee future results. Always conduct your own analysis, use proper risk management, and consult a licensed financial advisor before making any trading decisions. The author accepts no responsibility for any losses incurred from the use of this indicator. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Built for traders who understand that price always returns to where it left unfinished business — and who want a system precise enough to be there when it does.
Pine Script® indicator
by AlphaX-Trade
Fair Value Gap Zones MTF + Wait CloseFair Value Gap Zones MTF + Wait Close Fair Value Gap Zones MTF is a market imbalance and liquidity indicator designed to automatically identify and project Fair Value Gap (FVG) zones across customizable timeframes. Fair Value Gaps represent areas where price moves aggressively enough to leave an imbalance between buyers and sellers, creating regions that may later act as areas of interest for reaction, continuation, retracement, or liquidity interaction. This indicator allows for multi-timeframe FVG analysis, optional displacement filtering, customizable gap thresholds, and dynamic zone management to provide greater flexibility across different trading styles and market environments. Features: • Automatic bullish and bearish Fair Value Gap detection • Multi-timeframe (MTF) support • Optional "Wait Until Bar Close" confirmation logic • Multiple minimum gap sizing methods: • ATR-based • Percentage-based • Fixed points-based • Optional displacement candle requirement • Box or line display modes • Optional FVG midline plotting • Extend zones into future price action • Adjustable zone count limits • Optional automatic deletion when zones become filled • Fully customizable colors and styles Alerts Included: • New Bullish Fair Value Gap • New Bearish Fair Value Gap Potential use cases: • Identify market imbalances • Locate potential retracement areas • Monitor liquidity interaction zones • Add confluence to existing strategies • Study continuation versus rebalancing behavior • Analyze higher timeframe market structure Interpretation: Bullish Fair Value Gap Indicates an imbalance created by aggressive upward movement where price may revisit the area before continuing. Bearish Fair Value Gap Indicates an imbalance created by aggressive downward movement where price may revisit the area before continuing. Midline Displays the midpoint of the imbalance and can act as an additional area of interest. Displacement Filter Allows filtering for stronger moves by requiring a larger displacement candle before creating a zone. This indicator is designed to provide a flexible way to visualize potential market imbalances while allowing traders to adapt the behavior to different instruments and strategies. About TrendGenY Indicators TrendGenY indicators are built from market experience, creative concepts, and a constant pursuit of unique perspectives. Rather than following conventional ideas, the focus is on uncovering alternative insights and viewing market behavior through different angles to reveal information that traditional tools may overlook and help traders build a more meaningful edge in the market.
Pine Script® indicator
by TrendGenY
FVG MagicHello, This FVG is a copy of FVG Magic by @OakleyJM but his FVG is certainly used by only Premium Tradingview Subscribers while i removed a few barriers to make it useable by every free traders who can't afford to pay for the Premium subscription. Almost everything kept default is applied everywhere but in a few scripts, you will need to Tick (Yes) to Auto-Tune by Timeframe and also Tick (Yes) to Remove on 50% SQ. Check every way possible to find the FairValueGap possible. This is the best version of FVG available in the market and all thanks to OakleyJM for his generous efforts.
Pine Script® indicator
by ShareMarketSaga
EdgeMachine - FVG ProEdgeMachine - FVG Pro detects, draws, and manages ICT Fair Value Gaps on any symbol and timeframe - stocks, futures, forex, and crypto. What is a Fair Value Gap? A Fair Value Gap (FVG) is a 3-candle imbalance pattern from ICT concepts where price moves so fast it leaves an unfilled gap. Bullish FVGs form when the high of candle is below the low of candle . Bearish FVGs form when the low of candle is above the high of candle . These zones act as magnets where price tends to return and react. Features: - Bullish FVGs drawn as teal boxes - potential long entry zones - Bearish FVGs drawn as red boxes - potential short entry zones - Dashed midpoint line on every gap - Labels show gap type and size in points - Boxes extend right until price mitigates them - Mitigated FVGs fade to gray or are removed automatically - Built-in alerts when new FVGs form on any timeframe Settings: - Mitigation Level: 50% Mid / Full Fill / Never - Min Gap Size filter to remove noise - Max Active FVGs on screen (keeps chart clean) - Show or hide faded mitigated zones - Fully customizable bull/bear colors and borders - Dashboard position: Top Right / Top Left / Bottom Right / Bottom Left Dashboard (top right by default): Shows live count of active bullish and bearish FVGs, current symbol, timeframe, mitigation mode, and total active zones. Alerts: Set alerts for New Bullish FVG and New Bearish FVG - fires on any ticker and timeframe. Works universally on all asset classes and timeframes. No repainting - all detections confirmed on bar close. EdgeMachine
Pine Script® indicator
by EdgeMachine
DandoWelcome to Dando, the ultimate all-in-one suite for traders utilizing Smart Money Concepts (SMC) and Inner Circle Trader (ICT) methodologies. Instead of cluttering your chart with a dozen different indicators, Dando combines the most powerful price action concepts into a single, highly customizable, and visually clean overlay. From precision Fair Value Gap (FVG) tracking and multi-timeframe trend analysis to automated Liquidity Sweeps and Killzone detection, Dando is designed to provide actionable, high-probability trade setups based on algorithmic logic.
Pine Script® indicator
by Samdando
2
xLevTrading AI SMC Algo v.0.6The xLevTrading AI Smart Money Concept Indicator is a significantly expanded and independently developed institutional trading framework based on LuxAlgo’s Smart Money Concept source code. While the script builds upon established Smart Money Concept principles such as market structure, liquidity analysis, order blocks, and fair value gaps, the internal logic, filtering systems, visual prioritization, and execution tools have been heavily redesigned and extended to create a more adaptive and context-aware analytical environment. The primary objective of this indicator is not to generate excessive signals, but to help traders better understand how price interacts with liquidity, imbalance, and structural shifts in real market conditions. Instead of treating Smart Money Concepts as isolated visual tools, the indicator combines multiple layers of analysis into a unified framework where each component contributes contextual information to the others. This allows traders to evaluate not only where price currently is, but also why certain areas may become important during future market movement. At the core of the system is the Adaptive Market Structure Engine, which acts as the foundation for all higher-level calculations. This engine continuously evaluates swing highs, swing lows, internal structure transitions, and external break-of-structure events in order to determine directional context across changing market conditions. Unlike simplified structure indicators that only label highs and lows, the system distinguishes between internal market behavior and broader external trend development. This distinction allows traders to identify whether price action is currently impulsive, corrective, ranging, or transitioning into a potential reversal phase. The structure engine also serves as a contextual filter for all other modules. Order blocks, fair value gaps, liquidity sweeps, and entry confirmations are evaluated relative to active structural conditions. This prevents isolated signals from appearing without broader market confirmation and helps traders focus on areas where multiple concepts align simultaneously. One of the major components of the framework is the enhanced Order Block Engine. Traditional Smart Money Concept implementations often display large amounts of order blocks regardless of quality or contextual relevance, which can quickly overcrowd charts and reduce clarity. In this script, the order block system was redesigned to prioritize quality, structural alignment, and reaction probability instead of quantity. The engine analyzes several contextual variables before validating a zone, including displacement strength, mitigation behavior, structural positioning, surrounding liquidity conditions, and overall market alignment. Zones that do not meet minimum contextual requirements are filtered out in order to reduce noise and improve readability. This process creates a cleaner chart environment where institutional-style supply and demand zones become easier to interpret. The goal is not simply to identify historical candles, but to highlight areas where market participants may still have unfilled interest or where future reactions could become more likely. To further improve usability, the indicator introduces Dynamic Fill Technology across both order blocks and fair value gaps. Instead of displaying every zone with equal visual weight, transparency levels dynamically adapt according to the internal scoring and contextual relevance of each area. This visual hierarchy helps traders quickly distinguish stronger zones from weaker ones without manually analyzing every individual structure. Higher-confidence zones appear more visually dominant, while weaker areas fade into the background. The intention behind this system is to transform complex structural information into an intuitive visual workflow that supports faster decision-making during live market conditions. Another major feature is the Dual Fair Value Gap Engine. Fair value gaps represent areas where price moved aggressively, creating temporary inefficiencies in the market. These imbalances often become important reaction zones as price later revisits them in an attempt to rebalance liquidity and restore market efficiency. The Dual FVG system was specifically developed to identify strong imbalances across both lower timeframes (LTF) and higher timeframes (HTF) simultaneously. This allows traders to observe not only short-term inefficiencies, but also broader institutional imbalances that may influence market behavior over extended periods. One of the key advantages of this approach is the ability to identify overlapping imbalances between different timeframe structures. When lower-timeframe and higher-timeframe fair value gaps align within similar price regions, these areas can represent stronger institutional interest and potentially more precise market impulses. This multi-timeframe imbalance framework helps traders better understand where price may accelerate, react, or seek liquidity. By combining local execution zones with broader macro inefficiencies, traders gain additional context for identifying higher-probability entries and continuation opportunities. The Liquidity Engine represents another central pillar of the framework. Liquidity behavior is one of the most important concepts in institutional trading because price often seeks areas where stop-loss orders, breakout traders, and resting liquidity are concentrated. Instead of relying solely on static support and resistance levels, the liquidity system actively identifies equal highs, equal lows, liquidity pools, sweep conditions, and engineered liquidity grabs in real time. These events are then evaluated relative to structure and directional context. This allows traders to better understand potential market intent rather than simply reacting to price movement after it has already occurred. For example, a liquidity sweep occurring against higher-timeframe directional bias may indicate temporary stop-hunting behavior rather than genuine reversal strength. The interaction between liquidity and structure becomes especially important when combined with order blocks and fair value gaps. Areas where liquidity sweeps occur directly into structurally aligned imbalance zones can often provide significantly stronger contextual setups than isolated technical signals. To further support directional analysis, the indicator also incorporates a Multi-Timeframe Moving Average Module. This feature provides optional trend filtering and directional confirmation by allowing traders to compare lower-timeframe execution against higher-timeframe trend conditions. The moving average framework is not intended as a standalone signal generator, but rather as an additional contextual layer that helps traders avoid counter-trend positioning during strongly directional environments. This can be particularly useful when combining liquidity sweeps with continuation structures. One of the newest additions to the framework is the Entry Finder Module, which is currently in Beta development. The purpose of the Entry Finder is not to replace discretionary trading decisions, but to assist traders in locating areas where multiple forms of confirmation align simultaneously. The Entry Finder analyzes the relationship between structure direction, liquidity interaction, order block positioning, fair value gap alignment, and market momentum in order to identify potential execution zones. The system attempts to detect moments where price may be transitioning from liquidity collection into directional continuation. For example, during bullish market conditions, the Entry Finder may identify a scenario where downside liquidity is swept below recent lows before price re-enters a bullish order block or bullish fair value gap that aligns with higher-timeframe structure. In bearish environments, the same logic can apply inversely after upside liquidity has been collected. The purpose of this process is to help traders avoid emotional momentum entries and instead focus on structurally supported retracement opportunities where institutional participation may become more probable. The Entry Finder can also assist traders by improving timing during volatile conditions. Many traders correctly identify directional bias but struggle with execution precision. By highlighting areas where liquidity, imbalance, and structure align simultaneously, the system attempts to improve entry location and reduce unnecessary chasing behavior. Because the Entry Finder remains in Beta, its filtering logic and confirmation models are still being refined. Current versions should be viewed as execution assistance tools rather than fully automated signal systems. Traders are encouraged to combine the Entry Finder with their own risk management and market interpretation. In addition to its analytical capabilities, the overall design philosophy of the indicator focuses heavily on chart readability and workflow efficiency. One of the common challenges with Smart Money Concept tools is visual overload caused by excessive labels, overlapping zones, and unnecessary calculations appearing simultaneously. This framework was designed to reduce that issue through selective filtering, contextual prioritization, and dynamic visual weighting. Rather than attempting to display every possible technical event, the indicator focuses on highlighting areas where multiple concepts converge. The result is a cleaner trading environment that allows users to focus more effectively on liquidity behavior, structural shifts, and execution planning without becoming overwhelmed by chart clutter. The xLevTrading AI Smart Money Concept Indicator should be viewed as a professional-grade analytical framework designed for discretionary traders who want a deeper understanding of institutional price behavior. By combining enhanced Smart Money Concept principles with proprietary filtering systems, dynamic visualization methods, liquidity analysis, and multi-timeframe contextual alignment, the script aims to transform complex market behavior into a more structured and actionable decision-making process. This indicator does not guarantee profitable trades and should not be interpreted as financial advice. It is intended as a decision-support and market-structure analysis tool that assists traders in interpreting price action, identifying contextual confluence, and improving overall market awareness across different trading environments. Chart Visualization & Color Structure To improve chart readability and help traders quickly distinguish between different market concepts, the indicator uses a structured color hierarchy across all major components. The visual system was intentionally designed to reduce confusion during live analysis and to make the interaction between liquidity, structure, order blocks, and fair value gaps easier to interpret. Bearish higher-timeframe order blocks are displayed in purple. These zones represent institutional-style supply areas that align with broader bearish market structure and may act as potential reaction or continuation zones during retracements. Bearish higher-timeframe fair value gaps (HTF FVGs) are displayed in orange. These imbalance zones represent aggressive bearish displacement on higher timeframes and are intended to highlight areas where price inefficiencies may still attract future reactions or rebalancing behavior. Bearish chart timeframe fair value gaps are displayed in red. These zones reflect local bearish imbalances directly on the active chart timeframe and are primarily used for short-term execution analysis and momentum continuation setups. Bullish chart timeframe fair value gaps are displayed in green. These indicate local bullish inefficiencies where price moved aggressively to the upside, potentially leaving behind imbalance zones that may later provide support during retracements. Bullish higher-timeframe fair value gaps are displayed in turquoise. These zones represent larger bullish imbalances from higher timeframe price action and are intended to provide macro directional context and stronger institutional reaction areas. The interaction between these colors and zones is an important part of the overall framework. Traders can use overlapping higher-timeframe and lower-timeframe imbalances to identify areas where multiple forms of market inefficiency align simultaneously. For example, when a lower-timeframe bullish fair value gap develops inside a higher-timeframe bullish imbalance zone, this may indicate stronger continuation potential and improved structural confluence. The chart layout shown in the publication intentionally focuses only on the indicator’s own analytical components without unnecessary overlays or unrelated tools. This cleaner presentation is designed to help traders clearly identify how the different modules interact with one another in real market conditions. Labels such as Break of Structure (BOS), Change of Character (CHoCH), liquidity sweeps, moving averages, order blocks, and fair value gaps are displayed directly within their relevant market context to support visual interpretation and execution planning.
Pine Script® indicator
by xLevTR
Order Flow VWAP Deviation [LuxAlgo]The Order Flow VWAP Deviation indicator provides a comprehensive toolkit for analyzing market structure through volume-weighted price levels, liquidity zones, and order flow imbalances. It combines classic VWAP standard deviation bands with dynamic stop-run detection and localized volume profiles to identify high-probability reversal and expansion zones. 🔶 USAGE The tool is designed for intraday and swing traders who focus on liquidity "sweeps" and mean reversion. By plotting significant pivot highs and lows (Stop Zones) alongside VWAP bands, the indicator highlights areas where institutional liquidity is likely resting. When price pierces these zones on high volume, the script flags a potential stop-run, signaling that a trend exhaustion or reversal may be imminent. 🔹 Stop Zones and Liquidity The script tracks historical pivot points and extends them as dashed lines. When price crosses these lines with a volume surge (defined by the Stop Zone Volume Multiplier), it indicates that resting orders have been triggered. These events are marked with circles on the chart to alert the trader to a shift in order flow. 🔹 Anchor Volume Profile A specialized Volume Profile anchors to a specific time range (e.g., New York Open). This profile appears on the right side of the chart, highlighting the Point of Control (POC) in yellow and high-volume "Stop Nodes" in orange. Each significant node displays a volume multiplier (e.g., 2.5x) and a buyer/seller bias (B/S) to show which side of the market is dominant at that price level. 🔹 Inversion Fair Value Gaps (IFVGs) The indicator can optionally track Fair Value Gaps that have been "inverted." An IFVG occurs when a bearish gap is closed above or a bullish gap is closed below. These act as refreshed support or resistance levels and are visualized as boxes on the chart until they are mitigated by price action. 🔶 DETAILS The script utilizes a proxy for delta volume, calculating the bias based on the relationship between the close and the high/low of each bar within the profile calculation. The Stop Zone logic uses a lookback period to ensure only significant structural pivots are considered, preventing chart clutter while focusing on major liquidity pools. 🔶 SETTINGS VWAP Anchor: Determines the period for VWAP calculation (Session, Week, Month, or Year). Std. Dev Multiplier: Sets the distance for the upper and lower deviation bands. Pivot Lookback: The number of bars used to identify significant highs and lows for stop zones. Max Active Lines: Limits the number of horizontal liquidity levels displayed on the chart. Profile Rows: Adjusts the vertical granularity of the anchored Volume Profile. Anchor Time Range: Specifies the exact time (HHMM) used to start the volume collection for the profile. Stop Zone Volume Multiplier: Defines the threshold relative to average volume required to highlight a "Stop Node" in the profile. Show IFVGs: Toggles the visibility of Inversion Fair Value Gaps. IFVG Volatility Filter: A multiplier used to ensure only gaps formed by significant price moves are tracked.
Pine Script® indicator
by LuxAlgo
11
Ultimate FVG/NWOG By FreedomByChartsUltimate FVG/NWOG By FreedomByCharts A clean, no-bloat FVG and NWOG indicator built around how I actually trade: chart timeframe + three independent higher timeframes + the New Week Opening Gap, all in one global colour scheme with sensible defaults and granular per-source control. Why this one Most FVG indicators on TV fall into one of two camps. Either they're stripped down to the bare chart-timeframe pattern with a single fill colour and a hardcoded mitigation rule, or they're bloated with theme presets, IPDA modes, half-finished features and ten settings groups you'll never use. This one is built the other way round: deep where it matters (mitigation logic, NWOG accuracy, display control), and stripped of everything that doesn't earn its place on the chart. What's actually different: Four mitigation modes, not one. Wick Filled (full), Body Filled (full), Wick 50%, Body 50%. Pick what matches your model — strict body close beyond the far side, or a partial wick into the midpoint, or anything between. Independent box and line visibility per source. Box on, lines off. Lines on, box off. Top + bottom only, no middle. Mid line dotted, top and bottom solid. Whatever you want — five sources, each independent. Mitigated FVGs become iFVGs. When an FVG gets mitigated its label flips from e.g. `1H` to `1H iFVG`, marking the zone as an inverted FVG — the same level can now act in the opposite direction. NWOG labels stay as `NWOG` since the inversion concept doesn't apply. Mitigated zones can drop their lines automatically. Per-source toggle: keep the grey box for context, lose the line clutter. Active zones stay fully drawn. Three HTFs at once, plus chart TF, plus NWOG. Run 1H, 4H, 1D simultaneously while the chart-TF FVGs print on whatever you're looking at. Each fully configurable. No request.security guesswork — the HTF tracking is explicit and aligned to the chart bars where each HTF period's high and low actually occurred. NWOG done properly, including holiday weeks. The NWOG anchors to the close of the last 1H bar before the weekend (Friday on a normal week, Thursday on Easter / Good Friday week) and the open of Sunday's first 1H bar. No stale Friday-only state, no wrong-priced boxes anchored at the wrong bar after holiday closes. Single global colour scheme. One bullish colour, one bearish colour, one mitigated grey. Applied uniformly across every source for a clean, professional look. NWOG can override its own bull/bear colours if you want it to stand out. No display caps you have to work around. Set the unfilled count and mitigated count per source to whatever you actually want to see. Old zones get pruned automatically as new ones form. What it draws Chart FVGs — current timeframe, both bullish and bearish. HTF1, HTF2, HTF3 — three configurable higher timeframes (defaults: 1H, 4H, 1D), all rendered on the current chart. NWOG — the body gap between the close of the last 1H trading bar before the weekend and the open of Sunday's first 1H bar. For each zone you get an optional coloured box (transparency adjustable), an optional top line, mid line, bot line (each with independent show/hide and Solid/Dashed/Dotted style), and an optional label showing the timeframe (auto-formatted as "1H", "4H", "1D", "NWOG", etc). When a zone is mitigated, the box recolours to grey, the lines either go grey or hide entirely depending on the per-source toggle, and the label flips to show iFVG status (e.g. `1H` becomes `1H iFVG` — NWOGs keep their `NWOG` label). Mitigated zones stay visible for as many slots as you allow, then get pruned. Mitigation methods explained For a bullish FVG (zone below price), the chosen method tests whether price has come back down into the zone: Wick Filled (full) — bar's low has reached the bottom of the zone. Default. Body Filled (full) — bar's close has reached the bottom of the zone. Wick 50% — bar's low has reached the midpoint. Body 50% — bar's close has reached the midpoint. Bearish zones (above price) test the opposite direction. Mitigation triggers an alert if you've enabled it for that source. Alerts Two alert flags per source: entry (price first touches the zone) and mitigation (price meets the mitigation criterion). Alert text identifies the source timeframe, direction (bull or bear) and the price. Settings, top to bottom Appearance — bull / bear / mitigated colours, box transparency, mitigated box transparency, line width, right-edge extension (default 0 = right edge sits at the current bar; raise it to extend further right), label text colour. Mitigation — single global mitigation method dropdown. Chart — enable, box / line visibility, line styles, unfilled and mitigated counts, mitigated-lines toggle, label settings, alerts. HTF 1, HTF 2, HTF 3 — same controls as Chart plus a timeframe input. NWOG — same controls as the others, plus optional NWOG-specific bull/bear colour overrides. Notes on usage For NWOG live detection use a 1H or smaller intraday chart. On 4H+ charts the bar boundaries don't land on the 18:00 NY moment cleanly so new NWOGs won't form. HTF FVGs appear on the chart at the bar where their HTF period closed, anchored back to the chart bars where the relevant HTF candle highs and lows occurred — this gives a clean "stepped" visual at the zone's left edge that shows how it formed. The right edge of every zone tracks the current bar in real time. Set "Extend right beyond current bar" higher if you prefer a fixed runway. TradingView caps total drawn objects at 500 lines / 500 boxes / 500 labels. With three lines per zone enabled across many sources at high display caps, you can hit those limits — drop the mid line first (it's off by default for that reason) and you double your headroom. Built specifically for the way I trade GC futures on the 1H. Sharing because I haven't seen another FVG indicator that handles all three of these together: holiday-week NWOGs, four mitigation modes, and independent box/line control per source. Feedback welcome.
Pine Script® indicator
by FreedomByCharts
Breaker Confluence Engine [Nick789]Breaker Confluence Engine ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ OVERVIEW ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Breaker Confluence Engine is built to map out breaker-style zones, Fair Value Gaps, and key confluence areas without making the chart look like a Christmas tree. The idea is simple: Use a higher source timeframe to find the important breaker and FVG structure, then project those zones onto the chart you are actually trading from. So instead of constantly switching timeframes, you can sit on your lower timeframe and still see where the bigger structure is sitting. This tool is not about throwing random buy and sell labels everywhere. It is designed to help you see where price has shifted, where imbalance is sitting, and where price may react if it comes back for a retest. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ WHAT IT DOES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1. Breaker Zone Detection The script detects bullish and bearish breaker-style zones using pivot-based swing structure. These zones help show areas where price has broken through previous structure and may later come back to test that area. - Bullish breaker zones can act as support - Bearish breaker zones can act as resistance - Zones extend forward until tested, filled, or invalidated - Overlap prevention helps avoid stacking too many similar zones - Zone limits help keep the chart clean 2. Fair Value Gap Mapping The script can detect 3-candle Fair Value Gaps from the selected source timeframe and project them onto the current chart. There is also an optional current-timeframe FVG layer for traders who want more lower-timeframe detail. Use the source FVGs for the cleaner main view. Turn on current-timeframe FVGs when you want to dig deeper or review price action. 3. Breaker + FVG Confluence This is where the tool starts to get interesting. When a breaker zone lines up with a source-timeframe FVG, the zone is highlighted as a stronger confluence area. Not every breaker matters. Not every FVG matters. But when structure shift and imbalance show up together, that area is worth paying attention to. 4. Zone Rating System Each zone can be rated using a mix of confluence factors: - Displacement - Relative volume - Directional delta proxy - Sweep context - FVG alignment The rating scale is: Weak → Interest → Momentum → Absorption → Institutional This gives you a quick way to separate basic zones from the ones that actually have a bit more story behind them. Weak zones can stay simple by default, or you can turn on full weak rating details if you want to study everything. 5. Tested and Mitigated Tracking The script tracks whether a zone is fresh, tested, or already used up. - Fresh zones show areas price has not returned to yet - Tested zones show areas price has touched - Filled or invalidated zones can be hidden automatically - Or you can fade them for review and back testing This helps you avoid treating an old used-up zone like it is still fresh. 6. Potential Breaker Zones The optional Potential Breaker layer gives an early heads-up when price is approaching a prior swing level before a confirmed breaker forms. It uses an ATR-based proximity threshold. Think of it as: “Price is getting close. Something may be building here.” Potential zones are removed once the breaker confirms or the level gets invalidated. 7. Source Timeframe & Session Control Choose the source timeframe you want the main logic to come from. Examples: - 5m / 15m / 30m for scalping - 1H / 4H for intraday structure - 4H / Daily for bigger context There is also an optional New York session filter for traders who want to focus only on a specific liquidity window. 8. Alerts The script includes alerts for: - Bullish breaker events - Bearish breaker events - Source-timeframe FVGs - Current-timeframe FVGs - Potential breaker events - Mitigation and fill events - Master alert for combining events into one cleaner message The master alert is useful if you do not want a massive alert list or you are setting up webhook-style workflows. 9. Status Table A small table on the chart shows the main tool status at a glance: - Source timeframe - Current chart timeframe - Session filter - Source FVG status - Current-timeframe FVG status - Potential Breaker status - Rating status Simple, clean, and easy to check. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ HOW TO USE IT ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1. Pick Your Source Timeframe Choose the timeframe you want the important structure to come from. For example, you might trade on the 1m or 5m chart, but use 15m or 1H as the source timeframe. That lets you trade lower-timeframe entries while still respecting the bigger zones. 2. Watch the Breaker Zones Breaker zones show where price has shifted through prior structure. If price comes back to that area, it may react, reject, continue, or fail. The zone gives you a place to focus, not a guaranteed trade. 3. Look for Confluence The best zones usually have more than one thing going for them. A breaker by itself is okay. A breaker with FVG alignment, displacement, sweep context, volume, and delta support is much more interesting. That is the whole point of the tool. 4. Pay Attention to Tested Status Fresh zones are usually cleaner. Once price has already tapped, filled, or invalidated a zone, it may not carry the same weight anymore. The tested and mitigated tracking helps keep that clear. 5. Keep the Chart Clean For live trading, less is usually better. A clean setup could be: - Source FVGs: On - Current-timeframe FVGs: Optional - Hide Mitigated: On - Prevent Overlap: On - Potential Breakers: Off - Weak Ratings: Off For review and back testing, turn more layers on and study how price reacts. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ BEST USE CASE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ This tool is best used as a structure and confluence map. It helps answer questions like: - Where is the higher-timeframe breaker? - Is there an FVG sitting with it? - Has the zone already been tested? - Did price sweep before forming the zone? - Is the move away strong or weak? - Is this area actually worth watching? It is not meant to replace your own trading plan. It is meant to make the important areas easier to see. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ IMPORTANT NOTES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ - Source-timeframe logic confirms after the source candle closes - The tool uses lookahead-off source timeframe logic - Current-timeframe FVGs are optional and can add more visual load - Zone ratings are guides, not guarantees - Best used on liquid markets with clean price action - Keep your chart clean if you are using it live ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ DISCLAIMER ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ This indicator is for educational and informational use only. It does not provide financial advice, guaranteed signals, or automatic trade decisions. Trading involves risk. Always use your own analysis, confirmation, risk management, and testing before making any trading decision.
Pine Script® indicator
by NICK789
13
PD ArraysHi all! This indicator is based on my indicator 'Order blocks' () that will show you order blocks (OB) found by the indicator or the once that are in alignment with the current trend. This indicator will, however, not only show you order blocks but it will also find fair value gaps (FVG). Order blocks and fair value gaps are popular and a big part of inner circle trading (ICT). The true power lies in that the indicator will give you alerts and show you labels for retest ('R'), false breakouts ('FB') and breakouts ('B'). This is possible through my library 'Touched' (). The possibilities of interactions in the form of breakouts allows for the findings of broken order blocks and fair value gaps. That means that this indicator allows the showing of zones that are before the CHoCH/CHoCH+ and has flipped function. So a support becomes resistance and vice versa. These zones are popular and are called breaker blocks (BB, a flipped order block) and inversion fair value gap (IFVG, a flipped fair value gap). If a broken order block is before a BOS (instead of a CHoCH/CHoCH+) it's called a mitigation block (MB) instead of a breaker block, but it has the same function. So, broken order blocks are called breaker blocks (BB) if they're before a change of character (CHoCH/CHoCH+) and mitigation blocks (MB) if they're before a break of structure (BOS). Broken fair value gaps are called inversion fair value gaps (IFVG). The following zones will be displayed by the indicator: • Fair value gaps • Inversion fair value gaps • Order blocks • Breaker blocks • Mitigation blocks The trend is based on price action that creates change of characters (CHoCH/CHoCH+) and break of structures (BOS). This is based on pivots/swings with your set length for left and right and is possible through my script 'PriceAction' (). The market structure will be displayed with solid lines and a label showing the type (CHoCH/CHoCH+/BOS). 2 things can invalidate a zone and cause it to disappear; • broken by price or • a CHoCH/CHoCH+ appears to start a new trend. I.e. a bullish zone (OB/FVG/BB/MB/IFVG) will disappear upon the closing price being lower than the zone's low or a bearish CHoCH/CHoCH+ happens. A bullish BB/MB/IFVG means a bearish OB/FVG that has been broken by price and is now bullish. I've tried to make the ability to find zones to be on a different timeframe than chart (like in my script 'Order blocks') but I have not found it to be reliable yet, so the zones are found on the chart's timeframe. I will keep working on making it more reliable, but for now it's only possible to find them on the chart's timeframe. The default settings will show you all zones (OB/FVG) and their broken version (BB/MB/IFVG). If the trend is bullish it will show bullish OBs and bullish FVGs and bearish OBs/FVGs that are broken and now are bullish (BB/MB/IFVG), and vice versa. OBs and FVGs will be displayed as soon as they are found, IFVGs when it's broken by price and BBs/MBs upon the next structural break (CHoCH/CHoCH+/BOS). All zones within a CHoCH/CHoCH+ (from the high/low pivot that's broken to when it's broken by price) will be kept to be take action on by the script's code. They're hidden until they make sense regarding to the new trend that's determined by the 'PriceAction' library. Settings • Keep history Check this if you want old zones to be kept (from previous trends). They are removed if they are broken or a CHoCH/CHoCH+ appears. PD ARRAYS • Fair value gaps Show fair value gaps or not. • Inversion fair value gaps Show inversion fair value gaps or not. • Order blocks Show order blocks or not. • Breaker blocks Show breaker blocks or not. • Mitigation blocks Show mitigation blocks or not. FAIR VALUE GAPS • Consecutive rising/falling The candles in the reaction must consecutivly rise or fall (the 'hl2' must be rising/falling). • Force strong If this is enabled it will force the FVG middle candle to have a higher/lower 'hl2' (middle of the entire candle) than the first candle's high. • Hide consecutive zones If multiple fair value gaps are found after each other only the first one will be found by the indicator. • Minimum size A factor of the Average True Range (of length 14) that the size of the fair value gap must have. ORDER BLOCKS • Reaction A factor of the Average True Range (of length 14) that the total reaction must have. A higher value will create fewer zones with a bigger reaction. And check the checkbox if you want the limit to be displayed. • Take out The bar that start the reaction must take out the previous bar high/low (liquidity sweep). • Consecutive rising/falling The candles in the reaction must consecutivly rise or fall. • Fair value gap The middle bar in the order block must create a fair value gap. • Hide consecutive zones If multiple order blocks are found after each other only the first one will be found by the indicator. DISPLAY • Bull The color for bullish zones (OB or FVG). This is the color before a breakout from the price, if it's broken by price once its a bearish zone instead. • Bear The color for bearish zones (OB or FVG). This is the color before a breakout from the price, if it's broken by price once its a bullish zone instead. MARKET STRUCTURE • Enable If zones found should follow market structure or not. This is automatically enabled if 'Current trend' is true. • Pivot Set the length of pivots and check if they should be shown or not. • Font size Set the font size of market structure text. ALERT • Retests Enable alerts for retest. • False breakouts Enable alerts for false breakouts. • Breakouts Enable alerts for breakouts. Examples Below will be some examples of how the indicator behaves. All the examples are with the default settings but only the example zone is visible. • This demonstrates a retest of an inversion fair value gap after a CHoCH+. After price goes higher (after that support) price retests later IFVGs and goes even higher. • Shows the lowest bullish fair value gap that's retested two times and goes higher. On the journey of higher prices more FVGs are retested/has false breakouts and price goes higher. • Shows a bearish order block (at the top) that's retested and price goes lower. • Shows a bearish breaker block that has two retests and a false breakout. The origin is a bullish order block that's now (after price has broken it) a bearish breaker block. After that resistance price goes lower. • Shows a retest of a bullish mitigation block (that's a broken bearish order block). The code for finding these PD Arrays are extracted to my library 'PDArrays' (). I hope that this indicator will help you in your trading and I've been trying to make an indicator like this for a very long time. Many new tries, a lot of time spent and lots of lines of code I managed to make one that I think is good enough! If you have any findings of unexpected behavior or feature of, feel free to reach out! Best of luck trading!
Pine Script® indicator
by mickes
PDArraysLibrary "PDArrays" Hi all! This library will help you to draw fair value gaps and order blocks and their broken version; breaker blocks, mitigation blocks and inversion fair value gaps. It does not contain any example code, but I will create an indicator called 'PD Arrays' that uses this library. Best of luck trading! Remove(zones, settings)   Removes the zone in 'zones.Remove' and its visuals. The visuals will be kept if 'settings.KeepHistoryZones' is true.   Parameters:      zones (Zones) : The current zone.      settings (Settings) : Set all values in this parameter to define the settings for the zones. Interactions(zones, settings, trend)   Sets the interactions (retests\false breakouts\breakouts) from the library 'Touched'.   Parameters:      zones (array)      settings (Settings) : set all values in this parameter to define the settings for the order block creation.      trend (int) : the market structure trend that's used for the integrations direction. 1 = bullish, -1 = bearish, 0 = both. HiddenInteractions(zones, settings, marketStructureInfo, trend)   Sets the hidden interactions (only breakouts) from the library 'Touched'.   Parameters:      zones (Zones)      settings (Settings) : set all values in this parameter to define the settings for the order block creation.      marketStructureInfo (MarketStructureInfo) : The state of market structure needed.      trend (int) : the market structure trend that's used for the integrations direction. 1 = bullish, -1 = bearish, 0 = both. Pivots(settings)   Creates pivots (high and low) to be used for order block creation.   Parameters:      settings (Settings) : set all values in this parameter to define the settings for the order block creation.   Returns: a tuple containing two pivot values (high and low) or 'na' OrderBlock(settings, pivotHigh, pivotLow)   Creates an order block if one is found according to the settings parameter.   Parameters:      settings (Settings) : set all values in this parameter to define the settings for the order block creation.      pivotHigh (float) : The high pivot to use.      pivotLow (float) : The low pivot to use.   Returns: a Zone object if an order block is found, na otherwise FairValueGap(settings)   Creates a fair value gap if one is found according to the settings parameter.   Parameters:      settings (Settings) : set all values in this parameter to define the settings for the fair value gap creation.   Returns: a Zone object if a fair value gap is found, na otherwise SetBarIndex(zone)   Sets the 'BarIndex' value of the 'zone' object according to 'zone.ChartBaseTime'.   Parameters:      zone (Zone) : The 'Zone' object to set the bar index on. MarketStructureZones(marketStructureInfo, foundZones, zones, priceAction, settings)   Creates/draws zones (order blocks and fair value gaps) depending on the current market structure from the price action.   Parameters:      marketStructureInfo (MarketStructureInfo) : The infirmation about the market structure from the price action.      foundZones (array) : All zones (order blocks and fair value gaps) to take action on.      zones (Zones) : The 'Zones' object that holds the current context.      priceAction (PriceAction type from mickes/PriceAction/5) : The 'PriceAction.PriceAction' object from the library 'PriceAction'.      settings (Settings) : set all values in this parameter to define the settings for the fair value gap creation. Visual   Holds the visual elements or the zone.   Fields:      Boxes (array) : All the visual boxes.      Lines (array) : All the visual lines.      Labels (array) : All the visual labels. Zone   Holds the values for visuals for the zone and to handle interactions (retests, false breakouts and breakouts).   Fields:      BaseTimeClose (series int) : The time close for the start of the zone.      FoundTimeClose (series int) : The time close for the zone when it's found.      ChartBaseTime (series int) : The time for the start of the zone according to the chart bar.      High (series float) : The maximimum price of the zone.      Low (series float) : The minimum price of the zone.      ReactionLimit (series float) : Set a factor (%) of the Average True Range (of length 14) that the total reaction must have.      TouchedZone (Zone type from mickes/Touched/17) : Zone object that will be created and sent to the library 'Touched'.      Visual (Visual) : An object that holds the visual elements for the zone.      SourceTimeframeSeconds (series int) : The 'timeframe.in_seconds' for the zone.      Direction (series int) : Defines if the found zone is bullish (1) or bearish (-1).      LatestRetestBarIndex (series int) : The latest 'bar_index' for a retest.      LatestFalseBreakoutBarIndex (series int) : The latest 'bar_index' for a false breakout.      LatestBreakoutBarIndex (series int) : The latest 'bar_index' for a breakout.      BarIndex (series int) : The chart's timeeframe 'bar_index'.      OriginType (series Type) : The 'Type' for the origin (order block or fair value gap).      Type (series Type) : The type of the zone.      Visible (series bool) : If the zone is drawn and not removed or re-drawn. Zones   Holds the values for the charts zones.   Fields:      Zones (array) : The currently active zones.      Removes (array) : Reprsents the zones that will be replaced.      HiddenZones (array) : The currently hidden zones. OrderBlockSettings   The settings specific for order block creation.   Fields:      TakeOut (series bool) : If the bas candle needs to be higher\lower than the previous candle (liquidity sweep\grab).      FairValueGap (series bool) : If there needs o be a fair value gap between the first and the last (third) candle of the order block.      ConsecutiveRisingOrFalling (series bool) : The candles in the reaction must consecutivly rise or fall (the 'hl2' must be rising/falling).      ReactionFactor (series float) : A factor of the Average True Range (of length 14) that the total reaction must have. A higher value will create fewer zones with a bigger reaction. And check the checkbox if you want the limit to be displayed.      ShowReaction (series bool) : Show a solid line for the reaction limit.      HideConsecutiveZones (series bool) : If multiple order blocks are found after each other only the first one will be found by the indicator. FairValueGapSettings   The settings specific for fair value gap creation.   Fields:      ConsecutiveRisingOrFalling (series bool) : The candles in the reaction must consecutivly rise or fall (the 'hl2' must be rising/falling).      Strong (series bool) : If this is enabled it will force the FVG middle candle to have a higher/lower 'hl2' (middle of the entire candle) than the first candle's high.      HideConsecutiveZones (series bool) : If multiple order blocks are found after each other only the first one will be found by the indicator.      MinimumSizeFactor (series float) : A factor of the Average True Range (of length 14) that the size of the fair value gap must have. Settings   The settings for the creation of order blocks and fair value gaps. You will need to set all the containing values in here.   Fields:      KeepHistoryZones (series bool) : Set to true if you want removed (from previous trend) zones to be displayed.      Bull (series color) : The color of bullish zones.      Bear (series color) : The color of bearish zones.      CreateCreationZone (series bool) : Set to true if you want a box with a border to be drawn at the creation of the zone. This is usefull when the zones comes from a higher timeframe, but not from a lower. If this is false the 'Draw()' function will start at 'time - time_close'.      AlertRetests (series bool) : Enable if you want alerts to fire when the 'Touched' library signals that a retest of the order block has occured.      AlertFalseBreakouts (series bool) : Enable if you want alerts to fire when the 'Touched' library signals that a false breakout of the order block has occured.      AlertBreakouts (series bool) : Enable if you want alerts to fire when the 'Touched' library signals that a breakout of the order block has occured.      AlertMessageFormat (series string) : Set the format of the fired alert uppon 'Touched' library signals. Need to be in the format of '{0} on order block from ...' where '{0}' is replaced with 'retest', 'false breakout' or 'breakout'.      Types (array) : All types that should be displayed.      FairValueGapSettings (FairValueGapSettings) : The settings for the creation of fair value gaps.      OrderBlockSettings (OrderBlockSettings) : The settings for the creation of order blocks. MarketStructurePivot   Pivot The 'PriceAction.Pivot' for the market structure.   Fields:      BrokenBarIndex (series int)      Pivot (Pivot type from mickes/PriceAction/5) MarketStructureInfo   Holds the needed market structure pivots needed for this library.   Fields:      LatestBreakOfStructure (MarketStructurePivot) : The latest break of structure (BOS) found by the 'PriceAction' library.      LatestChangeOfCharacter (MarketStructurePivot) : The latest change of character (CHoCH\CHoCH+) found by the 'PriceAction' library.
Pine Script® library
by mickes
FVG Inverse (IFVG) All TimeframesTracks standard Fair Value Gaps (FVGs) and Inverse Fair Value Gaps (IFVGs) automatically on any chart timeframe. The indicator detects bullish and bearish FVGs based on classic 3-candle imbalance structure, draws the zone with its Consequent Encroachment (CE) as a dotted midpoint line, and labels each setup clearly as BULL FVG or BEAR FVG. When price fully closes through an opposing FVG, the zone automatically converts into an IFVG and is relabeled accordingly, helping traders quickly identify potential shifts in market structure and support/resistance flips. Designed as a clean, strategy-neutral tool for all markets and timeframes, with customizable colors, opacity, and a simplified visual layout that keeps only the most recent zones on screen for clarity.
Pine Script® indicator
by JustinOnTheCharts
Fair Value GapsFair 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.
Pine Script® indicator
by ajaypercy
FVG Quality Scorer | Flux ChartsGENERAL OVERVIEW: FVG Quality Scorer is a Fair Value Gap analysis tool designed to extend beyond basic gap detection. Instead of treating every gap equally, this indicator evaluates each FVG across four independent scoring axes and assigns a letter grade (A through D) based on configurable thresholds. This creates a structured view of the chart where gaps are organized by their relative characteristics. Every FVG is scored once at the moment of creation across Displacement Strength, Volume Delta, Contextual Location, and Structural Alignment. Each axis is scored from 0 to 25, producing a weighted composite score out of 100. Scores are fixed at creation, ensuring the evaluation reflects the conditions present at the time of formation and does not change retroactively. In contrast, each FVG’s lifecycle state (Fresh, Tested, Partially Filled, Mitigated) updates in real time as price interacts with the zone, providing a current view of how price is interacting with each gap. A companion dashboard tracks grade distribution, active counts, total formations, and average fill times across the visible chart history. Score labels at the edge of each FVG box provide a quick reference to the assigned grade, with optional tooltips displaying the full scoring breakdown and current lifecycle state. FEATURES: ◇ Four-axis scoring system: Displacement Strength, Volume Delta, Contextual Location, and Structural Alignment, each scored from 0 to 25 for a maximum composite score of 100 ◇ Letter grade assignment (A, B, C, D) using per-axis threshold gates with configurable minimum scores and required axes per grade ◇ Lower timeframe volume delta analysis using intrabar data to estimate directional volume distribution within the displacement candle ◇ Higher timeframe FVG nesting detection to identify when current timeframe gaps are positioned within higher timeframe imbalances ◇ Session timing reference covering Asian, London, New York AM, and New York PM sessions based on New York time ◇ Premium and Discount zone scoring using a proportional gradient based on the FVG’s position within a defined price range ◇ Market structure classification using swing high and swing low sequences to label conditions as bullish, bearish, or mixed ◇ Break of Structure (BOS) tracking using crossover logic to identify recent structural breaks relative to the FVG direction ◇ Post-sweep proximity detection identifying FVGs that form after a liquidity sweep of a swing level ◇ Lifecycle state tracking: Fresh → Tested → Partially Filled → Mitigated, with corresponding visual updates on the chart ◇ Score labels with optional tooltips displaying axis scores and current lifecycle state ◇ Dashboard displaying active counts, total formations, and average bars to mitigation per grade, along with nearest A-grade distance tracking ◇ Configurable axis weights for adjusting the influence of each scoring dimension in the composite score ◇ Alerts for newly formed A-grade and B-grade FVGs based on defined grading criteria WHAT IS A FAIR VALUE GAP? A Fair Value Gap is a three-candle price formation that highlights an imbalance in price movement. It occurs when the third candle’s wick does not overlap with the first candle’s wick, leaving a visible gap created by the middle candle. This middle candle is often referred to as the “displacement” candle, as it reflects a relatively strong move in price over a short period. In a bullish FVG, the low of the third candle is positioned above the high of the first candle. In a bearish FVG, the high of the third candle is positioned below the low of the first candle. The space between these two wicks defines the FVG zone. Within ICT and Smart Money Concepts frameworks, these gaps are interpreted as areas where price moved quickly, leaving limited trading activity at certain levels. As a result, these zones are often monitored as areas of interest if price revisits them in the future. However, not all FVGs share the same characteristics, and variations in formation context are what this indicator evaluates using its scoring system. WHAT IS THE THEORY BEHIND THIS INDICATOR? The core premise behind FVG Quality Scorer is that gap detection alone does not capture the full context of how Fair Value Gaps form. On any given trading day, multiple FVGs can appear across timeframes, each with different characteristics depending on the surrounding price action. This indicator evaluates those characteristics using a structured scoring approach. Not all FVGs form under the same conditions. For example, a gap created by a relatively small candle during low volume periods in a ranging market will differ in structure from one formed during a strong displacement move with increased volume, aligned with broader market structure and session timing. These differences are often considered when analyzing FVGs, but evaluating them manually across multiple factors and timeframes can be time intensive and subjective. FVG Quality Scorer standardizes this process by quantifying these characteristics into a consistent framework. The indicator’s four-axis model reflects commonly used analytical considerations within ICT and Smart Money Concepts methodologies. These include measuring displacement strength, assessing volume characteristics, evaluating contextual positioning within a range or session, and identifying alignment with market structure. By organizing these factors into a rule-based system, the indicator provides a consistent method for comparing FVG formations based on their underlying attributes. Axis 1: Displacement Strength (0 to 25 points) The displacement candle is the middle candle of the three-bar FVG formation and is the candle responsible for creating the gap. This axis evaluates the characteristics of that candle based on its size, structure, and relation to surrounding price action. Candles with larger bodies relative to their total range, higher relative size compared to recent volatility, and alignment with neighboring candles are scored differently than candles with smaller bodies or more pronounced wicks. The indicator evaluates three sub-metrics within this axis. Body-to-range ratio (0 to 10 points) measures how much of the candle’s total range is composed of the body versus the wicks. A ratio of 0.85 or higher receives 10 points, ratios between 0.70 and 0.85 receive 7 points, ratios between 0.55 and 0.70 receive 4 points, and anything below 0.55 receives zero. ATR multiple (0 to 10 points) compares the displacement candle’s total range to the 14-period Average True Range. A range equal to or greater than 2 times the ATR receives 10 points, 1.5x to 2x receives 7 points, 1x to 1.5x receives 4 points, and values below 1x receive zero. Consecutive displacement (0 to 5 points) evaluates whether the candles immediately before and after the displacement candle close in the same direction as the FVG. If both surrounding candles align, the FVG receives 5 points. If one aligns, it receives 2 points. If neither aligns, it receives zero. This metric reflects the consistency of direction across the three-candle formation. Axis 2: Volume Delta (0 to 25 points) Volume reflects how much activity occurred, while volume delta separates that activity into directional components based on price movement. By analyzing lower timeframe data, volume can be divided into buying and selling activity within the displacement candle, providing additional context on how volume was distributed during the move. The indicator uses lower timeframe intrabar data (configurable, default 1 minute) to estimate this distribution. Each lower timeframe candle within the displacement bar is classified as bullish volume (close above open) or bearish volume (close at or below open), and these values are aggregated to form a directional breakdown. This axis evaluates three sub-metrics. LTF dominance (0 to 12 points) measures the percentage of total volume on the displacement candle that aligns with the FVG direction. Values above 75% receive 12 points, 60% to 75% receive 8 points, 50% to 60% receive 4 points, and values below 50% receive zero. Relative volume (0 to 8 points) compares the displacement candle’s volume to the 20-period volume average. Volume equal to or greater than 2 times the average receives 8 points, 1.5x to 2x receives 5 points, 1x to 1.5x receives 2 points, and values below the average receive zero. Volume rising (0 to 5 points) evaluates whether volume increases across the three candles of the formation, where volume on the displacement candle exceeds the prior candle, and the prior candle exceeds the one before it. This metric captures the progression of volume across the formation. Screenshot: Zoomed view showing the Delta volume panel below with visible volume spike on the displacement candle] Axis 3: Contextual Location (0 to 25 points) The location of an FVG within the recent price range provides additional context for how it formed. In ICT methodology, the range is often divided into two halves using the equilibrium (50%) level. The lower half is referred to as the “discount zone,” while the upper half is referred to as the “premium zone.” A bullish FVG forming in the lower portion of the range is positioned within the discount zone, while a bearish FVG forming in the upper portion is positioned within the premium zone. FVGs that form closer to the midpoint or on the opposite side of the range can be described as having different contextual positioning relative to the defined range. This indicator incorporates that positioning into its scoring by evaluating where the FVG forms within the selected lookback range, using a proportional approach rather than a fixed cutoff at the midpoint. In addition to premium and discount positioning, other contextual factors can be used to describe how an FVG forms within the broader price environment. These include whether the FVG appears after a liquidity sweep, whether it is positioned within a higher timeframe FVG, and whether it forms during specific session windows. These elements provide additional structure for evaluating the formation context. This axis evaluates four sub-metrics. Premium and Discount scoring (0 to 8 points) uses a proportional gradient across the recent price range defined by the Range Lookback setting. For bullish FVGs, gaps forming in the lower half of the range (below equilibrium) receive the full 8 points. Gaps forming above equilibrium receive a reduced score that decreases progressively as the FVG approaches the top of the range. The same logic is applied in reverse for bearish FVGs. HTF FVG nesting (0 to 8 points) evaluates whether the current FVG is fully contained within a higher timeframe FVG of the same direction. The indicator retrieves higher timeframe data using the configurable HTF input and checks for this containment condition. Post-sweep proximity (0 to 5 points) evaluates whether a swing level was exceeded shortly before the FVG formed. A sweep is defined as price moving beyond a swing high or swing low and then returning back within the prior range. This metric checks for that condition within a configurable lookback window. Killzone timing (0 to 4 points) evaluates whether the FVG forms during predefined session windows. The indicator converts bar time to New York time and checks against four intervals: Asian session (20:00 to 00:00), London session (02:00 to 05:00), New York AM (09:30 to 11:00), and New York PM (13:30 to 16:00). Axis 4: Structural Alignment (0 to 25 points) Market structure provides a framework for describing how price is evolving over time. This axis evaluates how the direction of an FVG relates to the current structure defined by swing highs and swing lows. The indicator identifies swing highs and swing lows using pivot detection with a configurable swing length and evaluates three sub-metrics. Market structure classification (0 to 10 points) compares the most recent swing highs and swing lows to determine whether price is forming higher highs and higher lows, lower highs and lower lows, or a mixed sequence. These conditions are labeled as bullish, bearish, or mixed. Scoring is then assigned based on the relationship between the FVG direction and the identified structure. EMA alignment (0 to 8 points) evaluates the position of price relative to a configurable Exponential Moving Average (default 50 period). For bullish FVGs, higher scores are assigned when price is positioned above the EMA, while for bearish FVGs, higher scores are assigned when price is positioned below the EMA. Scores are reduced when price is positioned on the opposite side relative to the FVG direction. Recent BOS detection (0 to 7 points) evaluates whether a Break of Structure (BOS) has occurred within a configurable lookback window (default 20 bars). A BOS is defined as price closing beyond a recent swing high or swing low. The indicator uses crossover logic to identify these events and ensures each structural break is only counted once. Scoring is based on whether a recent BOS aligns with, differs from, or is absent relative to the FVG direction. Screenshot: Showing BoS and HH Grade Assignment System Instead of using a single composite score cutoff, FVG Quality Scorer applies a per-axis threshold system for grade assignment. For each grade level (A, B, C), you can define which axes are required and the minimum score each must meet. An FVG must satisfy all required axis thresholds to be assigned a given grade. This structure ensures that each selected dimension is evaluated independently rather than relying on a single averaged value. For example, with default settings, an A grade requires all four axes to meet a minimum score of 12 out of 25. A B grade requires only the Displacement and Volume axes to meet a minimum of 12, while a C grade requires those same axes to meet a minimum of 8. Any FVG that does not meet the criteria for A, B, or C is assigned a D grade. These thresholds and required axes can be fully customized for each grade level. A weighted composite score (0 to 100) is also calculated and displayed in the score label tooltip for reference, but it does not determine the assigned grade. This allows the grading system to operate independently of the composite value. The composite score uses configurable axis weights (default 25 per axis), which can be adjusted to modify how each dimension contributes to the total score. Lifecycle State Machine Each FVG is tracked through a series of lifecycle states as price interacts with the zone, and these transitions occur automatically regardless of grade. The lifecycle begins at Fresh when the FVG forms and no candle has interacted with the zone boundary. When price first wicks into the boundary (detected using crossover logic that excludes the formation candle), the state transitions to Tested. If price closes within the zone, the state changes to Partially Filled, and the visual appearance of the box is adjusted to reflect this state. If price later closes back outside the zone, the state returns to Tested rather than Fresh, as the zone has already been interacted with. When price fully crosses through the zone, the FVG is marked as Mitigated. The definition of mitigation can be configured to require either a wick crossing or a full candle close beyond the zone. Mitigated FVGs can either be removed from the chart or remain visible as dimmed boxes using the Show Historic setting. When mitigation occurs, the right edge of the box is fixed at the candle where the event took place. The current lifecycle state is displayed in the tooltip alongside the scoring breakdown when hovering over the score label. 🔹 Dashboard The dashboard provides a statistical summary of FVG activity across the visible chart history. It is structured as a table with one row per grade (A through D) and three data columns. The Active column displays the number of unmitigated FVGs currently present on the chart for each grade. The Total column shows the total number of FVGs formed for each grade across the chart history. The Avg Fill Time column displays the average number of bars between formation and mitigation for FVGs of that grade that have been fully mitigated. This calculation includes only completed (mitigated) FVGs. A bottom row in the dashboard tracks the nearest active A-grade FVG relative to the current price. It displays the distance from the current close to the nearest boundary of the zone (the lower boundary if the FVG is above price, or the upper boundary if below), along with a directional indicator. If price is currently within an A-grade zone, the dashboard displays “Inside zone.” If no A-grade FVGs are active, it displays “None active.” The dashboard position and text size can be configured. Screenshot: Close up of the dashboard table showing all four grade rows with Active, Total, and Avg Fill Time populated. Include the Nearest A row showing a directional arrow with distance. 🔹 Score Labels and Tooltips Each FVG box displays its grade letter (A, B, C, or D) centered inside the zone. At the right edge of the box, a small label shows the composite quality score out of 100. Hovering over this label reveals a detailed tooltip with the complete scoring breakdown: the total score, the grade, individual scores for all four axes (each out of 25), and the current lifecycle state. This gives you instant access to why a particular FVG earned its grade without needing to open any settings. Score labels can be toggled off using the Show Score Labels setting if you prefer a cleaner chart. INPUTS: 🔹 Settings ◇ Swing Length: Lookback period for pivot high and pivot low detection used in market structure analysis, BOS tracking, and sweep detection. Higher values produce fewer, more significant swing points. Default 5. ◇ ATR Length: Period for the Average True Range calculation used in displacement scoring. Default 14. ◇ LTF for Volume Delta: Lower timeframe used to calculate intrabar volume delta on the displacement candle. Default 1 minute. Must be lower than the chart timeframe for accurate results. ◇ HTF for FVG Nesting: Higher timeframe checked for FVG nesting confluence. Default 60 minutes (1 hour). Should be higher than the chart timeframe. ◇ Range Lookback: Number of bars used to calculate the premium and discount range for contextual scoring. Default 50. ◇ Sweep Proximity Window: Number of bars to look back for recent liquidity sweeps when scoring post sweep proximity. Default 5. ◇ BOS/CHoCH Lookback: Maximum number of bars a Break of Structure can be from the current bar and still be considered "recent" for structural scoring. Default 20. ◇ EMA Length: Period for the Exponential Moving Average used in structural alignment scoring. Default 50. ◇ Mitigation Method: Determines how FVG invalidation is measured. Wick mode triggers mitigation when a wick crosses through the zone. Close mode requires a candle close beyond the zone. Default Wick. Screenshot of the Settings input group in TradingView showing all the configurable parameters: Swing Length, ATR Length, LTF, HTF, Range Lookback, Sweep Window, BOS Lookback, EMA Length, and Mitigation Method. 🔹 Axis Weights ◇ Displacement Weight: Relative weight applied to the Displacement Strength axis when calculating the composite score displayed in the tooltip. Higher weight increases this axis's influence on the total score. Default 25. ◇ Volume Delta Weight: Relative weight for the Volume Delta axis. Default 25. ◇ Contextual Weight: Relative weight for the Contextual Location axis. Default 25. ◇ Structural Weight: Relative weight for the Structural Alignment axis. Default 25. 🔹 Display ◇ Minimum Display Grade: Hides FVGs below this grade threshold from the chart. Set to D to show all grades, or A to show only the highest quality gaps. Default C. ◇ Show Historic (Mitigated): When enabled, mitigated FVGs remain visible as grayed out boxes instead of being removed from the chart. Useful for studying how different grade levels performed historically. Default off. ◇ Show Score Labels: Toggles the score labels at the right edge of each FVG box. Hover over the label to see the full axis breakdown tooltip. Default on. ◇ Grade Colors (A → D): Four color pickers on a single row controlling the color for each grade tier. Defaults are green (A), teal (B), amber (C), and gray (D). 🔹 Dashboard ◇ Show Dashboard: Toggles the statistics dashboard on or off. Default on. ◇ Dashboard Position: Choose from all nine screen positions (top, middle, bottom combined with left, center, right). Default Top Right. ◇ Dashboard Size: Controls the text size of the dashboard. Options are Tiny, Small, Normal, and Large. Default Small. 🔹 A Grade / B Grade / C Grade ◇ Each grade tier has its own settings group with four minimum score thresholds (one per axis, 0 to 25) and four toggle switches to select which axes are required for that grade. An FVG must meet or exceed the minimum score on every required axis to earn the grade. Grades are checked top down: A first, then B, then C. Any FVG that fails all three checks receives a D grade. Unchecking a required axis means that axis is ignored for that grade's evaluation, allowing you to create grade profiles that focus on specific quality dimensions. Screenshot of the settings panel showing the A Grade, and B Grade input groups with their min score thresholds and require toggles visible. ALERTS: ◇ New A Grade FVG: Fires when a new Fair Value Gap is detected that meets all A grade requirements. Use this to get notified of the highest quality setups without watching the chart continuously. ◇ New B Grade FVG: Fires when a new Fair Value Gap is detected that meets B grade requirements but does not qualify for A grade. UNIQUENESS: Many FVG indicators on TradingView focus on detecting gaps and may include basic filtering based on size or direction. FVG Quality Scorer extends this approach by evaluating each gap across multiple dimensions, including lower timeframe volume distribution, higher timeframe positioning, market structure classification, and session-based context. These factors are combined into a structured scoring framework. The axis-based grading system provides an alternative to single-threshold scoring methods. Instead of relying on a single composite cutoff, each grade level is determined by minimum requirements across selected axes. This ensures that each specified dimension meets defined criteria rather than being offset by higher values in other areas. The lifecycle state system tracks how each FVG evolves as price interacts with the zone, while the dashboard aggregates metrics such as counts and average bars to mitigation across grade levels. These features provide a structured way to review how FVGs have behaved over the selected chart history and to adjust grading configurations accordingly.
Pine Script® indicator
by fluxchart
7