OPEN-SOURCE SCRIPT

[ A L P H A X ] VOID

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

Skrip open-source

Dengan semangat TradingView yang sesungguhnya, pembuat skrip ini telah menjadikannya sebagai sumber terbuka, sehingga para trader dapat meninjau dan memverifikasi fungsinya. Salut untuk penulisnya! Meskipun Anda dapat menggunakannya secara gratis, perlu diingat bahwa penerbitan ulang kode ini tunduk pada Tata Tertib kami.

AlphaX-Trade

🌐 alphax.trading
Institutional Grade Signals --> Engineered for Retail

💎ᴠɪᴘ tradingview.com/v/TaXohZvb/
[ A L P H A X ] PRIME - Premium Signal Engine

🔢 alphax.trading/resources/calculators
AlphaX Calculators

Juga di:

Pernyataan Penyangkalan

Informasi dan publikasi ini tidak dimaksudkan, dan bukan merupakan, saran atau rekomendasi keuangan, investasi, trading, atau jenis lainnya yang diberikan atau didukung oleh TradingView. Baca selengkapnya di Ketentuan Penggunaan.

Skrip open-source

AlphaX-Trade

Juga di: