[ A L P H A X ] SURGEAlphaX SURGE — Liquidity Sweep + Market Structure + Premium/Discount Confluence Engine: Smart Money Concepts with 6-Layer Institutional Entry System, HTF Bias Filter & Order Block Detection
AlphaX SURGE is a professional-grade smart money concepts system built around the three foundational mechanics that drive institutional price delivery: liquidity sweeps, market structure shifts, and premium/discount zone positioning. Where most SMC indicators simply draw labels on a chart, SURGE integrates these concepts into a live 6-layer confluence scoring engine that only fires when a genuine liquidity grab, a confirmed structure event, correct PD zone positioning, higher timeframe bias alignment, squeeze momentum, and volume delta pressure are all pointing in the same direction simultaneously. The result is a system that reads the market the way institutional traders do — not chasing breakouts, not entering on arbitrary crossovers, but waiting for the precise sequence of events that precedes the highest-probability directional moves. Designed for active traders across crypto, forex, gold, and indices on any timeframe.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏦 The Smart Money Framework — How Institutions Move Price
To understand AlphaX SURGE, you first need to understand the three-phase institutional trade cycle that the system is designed to detect.
Phase 1 — Liquidity Accumulation:
Institutions need massive order size. They cannot fill that size at a single price — they need a pool of counterparty orders. Retail stop losses clustered below swing lows (sell-side liquidity) and above swing highs (buy-side liquidity) are that pool. Before a major directional move, institutions deliberately push price into these liquidity pools to trigger stops and fill their positions against the retail orders being stopped out.
Phase 2 — Structure Shift:
After the liquidity grab, the institution has filled its position. Now price reverses aggressively. This reversal breaks the prior market structure — creating either a Change of Character (CHoCH) if it reverses the previous trend, or confirming a Break of Structure (BOS) continuation if it aligns with the existing trend. The structure event is the confirmation that the liquidity sweep was genuine, not noise.
Phase 3 — Delivery:
With positions filled and structure confirmed, the institution delivers price to its target. This delivery phase is what SURGE is designed to capture — entering at the moment the sweep and structure confirmation align with the broader institutional context.
AlphaX SURGE does not simply detect these phases independently. It requires them to occur in the correct sequence and within a qualifying multi-layer confluence environment before any signal fires.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💧 Liquidity Sweep Detection
The sweep detection engine identifies the moment institutions grab liquidity from a significant swing level. Every swing high and swing low is tracked in real time using a configurable pivot length (default: 5 bars). These levels represent the two most important current liquidity pools — the sell-side liquidity (SSL) below the most recent swing low, and the buy-side liquidity (BSL) above the most recent swing high.
Bull Liquidity Sweep (SSL Grab):
The bar's low extends below the tracked swing low level by at least the minimum sweep wick threshold (default: 0.05× ATR)
The bar closes back above the swing low level — confirming the wick was a grab, not a genuine breakdown
The bar closes bullish (close above open) — confirming buying pressure on the reversal close
Bear Liquidity Sweep (BSL Grab):
The bar's high extends above the tracked swing high level by at least the minimum wick threshold
The bar closes back below the swing high level
The bar closes bearish — confirming selling pressure on the reversal close
The minimum sweep wick filter is a critical quality gate. Without it, any bar that briefly touches a swing level and reverses would register as a sweep. The ATR-normalized wick requirement ensures the grab extended far enough below or above the level to genuinely trigger stop orders — not just grazed the level on low momentum.
Sweep recency: To accommodate the reality that entry signals often develop one bar after the sweep rather than on the sweep bar itself, SURGE accepts sweeps from the current or immediately preceding bar. This one-bar lookback prevents missed entries on fast-moving setups where the structure confirmation fires on the bar immediately following the sweep candle.
Visual output: Every confirmed sweep is marked with a diamond shape — yellow-green below the bar for bull sweeps, red above for bear sweeps — providing instant visual identification of every liquidity grab on the chart.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📐 Market Structure Engine — BOS & CHoCH
The market structure engine runs a real-time tracking system for the current structural trend and identifies every significant structure event as it occurs.
Structural trend tracking:
The engine continuously tracks the most recent confirmed swing high and swing low. When price closes above the most recent swing high, a bullish structure break is detected. When price closes below the most recent swing low, a bearish structure break is detected. The structural trend variable updates on every such event — shifting between bullish (1) and bearish (-1) states.
Change of Character (CHoCH):
A CHoCH occurs when a structure break happens in the opposite direction of the current structural trend. A bullish CHoCH means price was in a bearish structural trend and has now broken above a swing high — the character of the market has changed. A bearish CHoCH is the inverse. CHoCH events are the highest-quality structure signals in the system — they represent a genuine reversal of the institutional order flow direction. Labeled on the chart in orange.
Break of Structure (BOS):
A BOS occurs when a structure break aligns with the current structural trend — a continuation event. A bullish BOS in a bullish trend confirms the uptrend is intact. A bearish BOS in a bearish trend confirms the downtrend continues. Labeled on the chart in yellow-green (bull) or red (bear).
Signal type control:
Two settings independently toggle which structure types can trigger signals:
Allow CHoCH Reversal Setups — enables signals on trend-reversal structure events. These are typically the highest-reward setups but require the sweep and confluence conditions to be exceptionally strong
Allow BOS Continuation Setups — enables signals on trend-continuation structure events. These are typically higher-frequency and occur within established directional flows
Both can be enabled simultaneously, giving SURGE the ability to detect both reversal and continuation setups across all market conditions.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 Order Block Detection & Visualization
Every confirmed structure event automatically spawns an Order Block — the institutional supply or demand zone that preceded the structure break. Order blocks represent the price range where the institutional position was built before the delivery move.
How order blocks are spawned:
When a bullish CHoCH or bullish BOS is confirmed, SURGE looks back up to the configured lookback period (default: 12 bars) to find the most recent bearish candle prior to the structure break — the last selling candle before the institutional buying move began. The high and low of that candle become the bull order block zone.
When a bearish CHoCH or bearish BOS is confirmed, SURGE looks back to find the most recent bullish candle — the last buying candle before the institutional selling move began. That candle's range becomes the bear order block zone.
Why this candle: The last opposing candle before a major directional move is where institutions were absorbing the final counterparty orders. It is the true origin of the move — and the zone where unfilled institutional orders are most likely to remain, making it the natural magnet for price on any retest.
Order block visualization: Each order block is rendered as a semi-transparent box extending forward by the configured number of bars (default: 20). Bull order blocks are shaded yellow-green; bear order blocks in red. The most recent active order block of each direction is tracked by the confluence system.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚖ Premium / Discount Zone Engine
The Premium/Discount framework is one of the most powerful filtering tools in institutional price action analysis. It answers a simple question: is price currently cheap or expensive relative to the recent dealing range?
Dealing range calculation:
On every bar, SURGE calculates the highest high and lowest low over the configured range length (default: 50 bars). The midpoint of this range is the Equilibrium level — the 50% point of the current dealing range, plotted as a purple dotted line on the chart.
Discount zone: Price at or below equilibrium. From an institutional perspective, price is cheap — this is where smart money buys. Bull entries in discount align with the institutional buying thesis.
Premium zone: Price at or above equilibrium. Price is expensive — this is where smart money sells. Bear entries in premium align with the institutional selling thesis.
Why this filter dramatically improves accuracy: A bullish sweep and structure confirmation at premium prices is a low-quality setup — you are buying at the top of the range where institutions are looking to distribute, not accumulate. The same bullish setup in discount is a structurally superior entry — buying at the institutional accumulation zone where the reward-to-risk profile is fundamentally better. The PD zone filter enforces this discipline automatically, blocking counter-PD setups before they reach the confluence gate.
The PD filter can be toggled off for traders who prefer to trade all qualifying setups regardless of range position — useful on strongly trending markets where price consistently stays on one side of equilibrium.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📡 HTF Bias Filter — Multi-Timeframe Alignment
The Higher Timeframe Bias filter is one of the most consequential filters in the entire system. A setup that occurs against the higher timeframe trend is a counter-trend trade — it may look compelling on the current timeframe but is fighting the dominant institutional flow.
How it works:
SURGE pulls two EMAs from the configured higher timeframe (default: 60-minute) — a fast EMA (default: 21) and a slow EMA (default: 55). When the fast HTF EMA is above the slow HTF EMA, the higher timeframe trend is bullish. When below, it is bearish.
Bull bias: Fast HTF EMA above slow HTF EMA — the higher timeframe institutional flow is upward. Bull setups on the current timeframe are with-trend trades.
Bear bias: Fast HTF EMA below slow HTF EMA — the higher timeframe flow is downward. Bear setups are with-trend trades.
The power of HTF alignment in SMC trading: A bullish sweep and CHoCH on M5 in the direction of a confirmed H1 uptrend is a fundamentally different trade from the same setup occurring against an H1 downtrend. The HTF filter ensures SURGE only fires setups where the current timeframe structure event is aligned with the broader institutional delivery direction — the single highest-quality filter available for SMC-based systems.
The HTF timeframe is fully configurable. For M1–M5 scalping, H1 is the default. For M15–H1 trading, H4 or Daily is recommended.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧠 The 6-Layer Confluence Engine
All six layers score independently on every bar. A signal only fires when the score meets the configured minimum (default: 4 of 6), the sweep condition is active, a qualifying structure event has occurred, and the ADX, session, and cooldown conditions are met.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Layer 1 — Liquidity Sweep
The foundational layer. Awards 1 point when a qualifying liquidity sweep (SSL for bull, BSL for bear) has occurred on the current or immediately preceding bar. This layer is also a hard requirement — regardless of the confluence score, no SURGE signal can fire without a recent sweep. This is the event that initiates the institutional sequence. Without a genuine liquidity grab, the setup is not a SURGE setup.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Layer 2 — Market Structure
Awards 1 point when the current structural trend agrees with the signal direction — a bullish structural trend for bull signals, bearish for bear. The structure layer also enforces the structure type requirement : a qualifying CHoCH or BOS must have occurred (subject to the Allow CHoCH / Allow BOS settings) for a signal to fire. Structure is both a scoring layer and a hard prerequisite, identical to the sweep requirement.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Layer 3 — Premium / Discount Zone
Awards 1 point when price is in the correct PD zone for the signal direction — discount for bull signals, premium for bear signals. When the PD filter setting is off, this layer always votes in favor. This layer encodes the institutional value positioning principle: buy cheap, sell expensive.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Layer 4 — HTF Bias
Awards 1 point when the higher timeframe EMA structure agrees with the signal direction. This is the multi-timeframe alignment layer — the most macro of the six confluence inputs. When HTF bias is disabled in settings, this layer always votes in favor.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Layer 5 — Squeeze Momentum
The TTM Squeeze momentum layer — identical to the implementation in Pulse Scalper and VOID. When the Bollinger Band/Keltner Channel squeeze fires with directional momentum (positive and rising for bull, negative and falling for bear), this layer votes. The orange squeeze background tint provides pre-signal awareness when energy is compressing. A SURGE setup that coincides with a squeeze release means the SMC structure event and the breakout energy event are occurring simultaneously — one of the highest-quality convergences the system can detect.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Layer 6 — Volume Delta
The proprietary volume pressure model — splitting each candle's volume into estimated bull and bear components, confirmed by OBV slope. This layer confirms that real institutional capital flow is behind the sweep and structure move. A liquidity sweep with no volume delta confirmation is a weak, potentially algorithmic sweep. A sweep with strong volume delta agreement means genuine order flow drove the grab — the highest-quality sweep condition.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏷 Signal Firing Logic
A SURGE signal fires when all of the following are simultaneously true:
A qualifying liquidity sweep occurred on the current or immediately preceding bar (hard requirement — independent of scoring)
A qualifying structure event (CHoCH or BOS per settings) has confirmed the structural direction (hard requirement)
Confluence score meets or exceeds the configured minimum (default: 4 of 6)
VWAP bias confirms — price above VWAP for bull, below for bear (when VWAP filter is enabled)
ADX confirms a trending market above the minimum threshold
Session filter confirms active market hours
Signal cooldown has elapsed since the last signal in the same direction (default: 10 bars)
Edge triggering: The signal fires only on the bar the conditions first become true — not repeatedly while they remain true. Each triangle is a distinct, fresh setup event.
Score label: Every signal prints the live confluence count (e.g., 5/6 or 6/6 ) directly on the chart so you know the quality of every setup at a glance.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 Sweep-Anchored Stop Loss Placement
SURGE includes a purpose-built stop loss mode specifically designed for liquidity sweep setups: SL Beyond Sweep Wick (default: on).
When enabled, the stop loss for a bull entry is placed at the tracked swing low level (the level that was swept) minus an ATR buffer. For a bear entry, the stop is placed at the tracked swing high level plus an ATR buffer.
Why this is the structurally correct stop for sweep setups: The sweep wick represents the maximum extent of the institutional grab. If price returns below the swept swing low (bull) and closes there, the sweep thesis is invalidated — institutions were not grabbing that liquidity for a reversal, the level was genuinely broken. Placing the stop at the swept level is therefore not an arbitrary distance — it is the exact price at which the setup's core premise is proven wrong.
When this setting is off, the stop reverts to a standard ATR distance from the entry bar's low or high.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛡 Dynamic ATR Exit System
Stop Loss: Placed at the swept swing level (when enabled) or bar extreme, plus an ATR buffer (default: 1.3×). Your structural invalidation boundary.
TP1 — Partial Target (50%): 2.0× ATR from entry — slightly wider than the Pulse Scalper and VOID defaults, reflecting the higher-conviction, lower-frequency nature of SURGE setups. Scale out 50% here and move the remainder to breakeven.
TP2 — Full Target: 3.8× ATR from entry. Full position exits on TP2 hit. A labeled TP marker appears on the chart.
ATR Trailing Stop: Dynamic stop advancing with price every bar at 1.6× ATR behind the current bar's extreme. Plotted as a live orange line. In genuine institutional delivery moves following a sweep, price frequently extends well beyond the fixed TP2 — the trail captures this extension without predetermining a ceiling on the gain.
All exit levels are plotted as live lines for the duration of the trade and cleared automatically on exit.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 Live Dashboard
The real-time dashboard displays the complete internal state across four sections, updated on every bar.
STRUCTURE
Trend — current market structure state: ▲ BULLISH, ▼ BEARISH, or — RANGE. This reflects the confirmed structural trend as tracked by the BOS/CHoCH engine
Liquidity — live sweep detection status: ▲ SSL SWEEP (sell-side grab, bullish signal) or ▼ BSL SWEEP (buy-side grab, bearish signal). Updates in real time on sweep bars
PD Zone — current premium/discount position: ◧ DISCOUNT, ◧ PREMIUM, or — EQ (at equilibrium). Color-coded yellow-green for discount, red for premium
HTF / SESSION
HTF Bias — higher timeframe EMA alignment: ▲ BULL or ▼ BEAR. Confirms whether the macro institutional flow supports the current setup direction
Session — ✓ ACTIVE or ✗ OFF. Confirms whether the session filter is open for signals
ADX — live ADX value with ✓ or ✗ pass/fail indicator
CONFLUENCE
Momentum — squeeze and directional momentum state: ⚡ SQZ (squeeze building), ▲ or ▼ for directional momentum, or — for flat
Vol Delta — volume pressure direction: ▲ BULL, ▼ BEAR, or —
Bull Score — live 0–6 score. Background highlights yellow-green when threshold is met
Bear Score — live 0–6 score. Background highlights red when threshold is met
POSITION
Position — ▲ LONG, ▼ SHORT, or — FLAT with background color highlight
Stop Loss — active SL level (sweep-anchored or ATR-based), color-coded by direction
TP1 — active first take-profit level
Bars in Trade — bars elapsed since entry
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📈 Chart Visual System
◆ Diamond (below bar, yellow-green) — bull liquidity sweep confirmed. SSL grabbed with close back above the swing low
◆ Diamond (above bar, red) — bear liquidity sweep confirmed. BSL grabbed with close back below the swing high
CHoCH ▲ / CHoCH ▼ label (orange) — Change of Character detected. Trend reversal structure event
BOS ▲ / BOS ▼ label (yellow-green / red) — Break of Structure detected. Trend continuation structure event
▲ Triangle (below bar) — bull SURGE entry. All conditions met
▼ Triangle (above bar) — bear SURGE entry. All conditions met
Score Label (e.g. 5/6) — confluence count at signal time on every entry triangle
Order Block Boxes — semi-transparent zones marking institutional supply and demand origins. Yellow-green for bull OBs, red for bear OBs
Liquidity Level Lines — dashed lines projecting the current swing high (sell-side liquidity, red dashed) and swing low (buy-side liquidity, yellow-green dashed) forward
Equilibrium Line (purple dots) — the 50% midpoint of the current dealing range
EMA Ribbon Fill — yellow-green fill during bull EMA structure, red during bear, gray during flat
VWAP Line (purple) — optional, toggleable session VWAP
Orange Squeeze Background — active during Bollinger/Keltner squeeze compression
Yellow-green background tint — active during open long trades
Red background tint — active during open short trades
SL / TP1 / TP2 / Trail Lines — all four exit levels plotted live for the duration of every trade
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 How to Trade with AlphaX SURGE — Step by Step
Step 1 — Establish Context Before the Session
Check the dashboard: what is the current structural trend and HTF bias? If both show the same direction, you have macro confluence — prioritize setups in that direction
Check the PD Zone row: is price currently in discount (favor longs) or premium (favor shorts)? Price at equilibrium is the lowest-quality PD position — wait for it to develop to one side
Note where the liquidity level lines are on the chart — these dashed lines mark exactly where the next sweep targets are sitting
Step 2 — Watch for a Sweep Diamond
A yellow-green ◆ diamond below the bar signals an SSL grab — the sweep phase has occurred. The system is now in active scan mode for a SURGE signal
A red ◆ diamond above the bar signals a BSL grab
The sweep is the trigger for your attention — not the entry signal. The entry comes next
Step 3 — Confirm the Structure Event
Watch for a CHoCH or BOS label to appear following the sweep. A CHoCH after a sweep is the highest-quality sequence — institutional grab followed by genuine trend reversal confirmation
Check the confluence scores on the dashboard. After a sweep, the bull or bear score should be climbing toward the threshold as the structure, PD, and momentum layers align
Step 4 — Enter on the SURGE Triangle
A ▲ triangle confirms all conditions are met for a long. A ▼ triangle confirms all conditions for a short
Read the score label. A 6/6 signal means every layer — sweep, structure, PD zone, HTF bias, momentum, and volume — are all aligned simultaneously. These are the highest-conviction setups SURGE produces and warrant full position size
A 4/6 or 5/6 signal is still a valid SURGE entry — standard position size, strict stop management
Step 5 — Manage with Live Exit Lines
The SL line is your swept level invalidation. If the sweep level is retaken cleanly, the setup thesis is gone
Watch the orange trail line advance with price as the institutional delivery move develops
At TP1, scale out 50% and move the remainder to breakeven — let the trail capture the full delivery
Step 6 — Exit and Reset
A TP marker confirms TP2 reached — full exit and system reset
An SL marker confirms stop or trail triggered — close the position and wait for the next sweep event to develop
Do not re-enter on impulse after a stopped trade. The swept level that was just violated is now the new liquidity target for the next setup. Wait for the next clean sweep and structure sequence
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠ Identifying Low-Quality Conditions — When Not to Trade
Stand aside when:
HTF Bias opposes the setup direction — a bullish sweep and CHoCH against an H1 downtrend is a counter-trend reversal trade. The institutional macro flow is working against you. These setups fail at a much higher rate than with-trend entries
PD Zone is wrong for the direction — a bull setup in premium or a bear setup in discount means you are entering at the institutionally unfavorable side of the range. Wait for price to correct to the appropriate zone
Sweep occurred but no CHoCH or BOS followed — a sweep without structure confirmation means the liquidity grab did not produce a genuine reversal or continuation. The institution may have filled only part of its position. Wait for structure to develop
ADX ✗ — the market is not trending. SMC concepts work best in directional markets. In ranging conditions, sweeps are frequently noise events rather than institutional accumulation
Score stuck at 2 or 3 of 6 after a sweep — the confluence environment is too fragmented. Too many layers are disagreeing. A sweep in isolation is not a trade
Multiple sweeps in rapid succession without entry signals — choppy markets produce repeated liquidity grabs in both directions. The confluence gate will block most of these, but the underlying message is that the market is in an oscillating range — not the institutional delivery environment SURGE is designed for
Structure trend and HTF bias are both — or FLAT — no clear institutional direction exists. No SURGE setup can develop until structural bias is established
What to do:
Wait for HTF bias and structural trend to align in the same direction — this is the macro setup condition for the highest-quality SURGE signals
Wait for price to reach the correct PD zone for the anticipated direction before the sweep occurs — the ideal sequence is: price in discount, SSL sweep, bullish CHoCH, 5–6/6 confluence signal
Watch the liquidity level lines — price approaching a level is the pre-alert that a sweep may be imminent. Prepare your confluence scan as price approaches those lines
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ Key Features
💧 Real-time liquidity sweep detection — identifies SSL and BSL grabs with minimum ATR wick filter and close-back confirmation, eliminating noise sweeps
📐 Full market structure engine — tracks swing highs and lows, detects CHoCH and BOS events, maintains a live structural trend state
📦 Automatic order block detection — spawns OB zones on every confirmed structure event, marking the exact institutional origin of each move
⚖ Premium/Discount zone filter — enforces institutionally correct entry positioning using a dynamic equilibrium level across the recent dealing range
📡 HTF bias filter — pulls a dual-EMA structure from a configurable higher timeframe to confirm macro institutional flow alignment
🧠 6-layer confluence gate — Sweep, Structure, PD Zone, HTF Bias, Squeeze Momentum, and Volume Delta must reach the minimum score threshold before a signal fires
📊 Live confluence scoring — bull and bear scores updated every bar, displayed on the dashboard before any signal appears
🔀 CHoCH / BOS signal type control — independently enable reversal setups, continuation setups, or both
🎯 Sweep-anchored stop loss — places the SL at the structural invalidation level (the swept swing point) rather than an arbitrary ATR distance
⚡ TTM Squeeze integration — Bollinger/Keltner compression detection flags pre-breakout energy with orange background tint and dashboard state
📈 Proprietary volume delta model — estimates institutional order flow pressure without exchange-level data, confirmed by OBV slope
🌐 VWAP session bias — enforces institutional session direction alignment on every signal
🛡 Dynamic ATR trailing stop — orange line advances with price every bar, capturing full institutional delivery moves beyond the fixed TP2
💹 Liquidity level lines — dashed projections of the current swing high and swing low showing exactly where the next liquidity pools sit
📊 22-row live dashboard — Structure, HTF/Session, Confluence, and Position sections updated in real time
🔔 12 alert conditions — sweep events, CHoCH events, entry signals, TP1/TP2 hits, and stop hits for both directions
🎨 Fully cohesive dual-tone color system — yellow-green for all bullish elements, red for all bearish, orange for squeeze and trail, purple for VWAP and equilibrium
⚙ Fully configurable — all pivot lengths, OB parameters, PD range, HTF timeframe and EMA periods, confluence minimum, ADX threshold, exit multipliers, session window, and all colors are independently adjustable
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙ Settings Reference
Structure & Liquidity
Swing Pivot Length — bars used for pivot high/low detection. Controls the significance of swing levels tracked for sweeps and structure (default: 5)
Show BOS / CHoCH Labels — toggle structure event labels on the chart
Show Liquidity Levels — toggle the dashed swing high and swing low projection lines
Liquidity Line Extend — how many bars forward the liquidity level lines project (default: 25)
Min Sweep Wick (ATR x) — minimum wick extension beyond the swing level required to register a sweep (default: 0.05× ATR)
Order Blocks
Show Order Blocks — toggle OB zone boxes on or off
Max Order Blocks — maximum OBs stored in memory simultaneously (default: 25)
OB Extend (bars) — how many bars forward OB boxes project (default: 20)
OB Lookback Bars — how many bars back to search for the origin candle when spawning an OB (default: 12)
Premium / Discount
Show Equilibrium Line — toggle the dealing range midpoint line
Dealing Range Length — bars used to calculate the high/low range for PD zone positioning (default: 50)
Require Correct PD Zone — when on, longs require discount positioning and shorts require premium positioning (default: on)
HTF Bias
Use HTF Trend Filter — toggle the higher timeframe bias requirement
HTF Timeframe — the higher timeframe to pull EMA data from (default: 60-minute)
HTF Fast EMA — fast EMA period on the HTF (default: 21)
HTF Slow EMA — slow EMA period on the HTF (default: 55)
EMA Ribbon
Fast / Slow / Signal EMA — triple ribbon periods (defaults: 8 / 21 / 50)
Show EMA Ribbon — toggle ribbon fill and line plots
Squeeze Momentum
BB Length / BB Mult — Bollinger Band parameters (defaults: 20 / 2.0)
KC Length / KC Mult — Keltner Channel parameters (defaults: 20 / 1.5)
Momentum Length — linear regression momentum period (default: 12)
Volume Delta
Volume MA Length — EMA smoothing for volume estimates (default: 14)
OBV Slope Length — lookback for OBV slope directionality (default: 10)
VWAP
Use VWAP Filter — when on, requires price to be on the correct VWAP side for each signal direction
Show VWAP Line — toggle VWAP line on the chart
Confluence Gate
Min Layers Required — minimum confluence votes needed for a signal (default: 4 of 6)
Session Filter — toggle active hours restriction
Active Session — configurable session window (default: 0700-2000)
Signal Cooldown — minimum bars between consecutive signals in the same direction (default: 10)
Allow CHoCH Reversal Setups — enables signals on trend-reversal structure events
Allow BOS Continuation Setups — enables signals on trend-continuation structure events
ADX Filter
Use ADX Filter — toggle the trend quality 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 — ATR buffer beyond the swept swing level (default: 1.3)
TP1 ATR Mult — first take-profit distance (default: 2.0)
TP2 ATR Mult — full exit target distance (default: 3.8)
Use ATR Trailing Stop — toggle dynamic trailing stop
Trail ATR Mult — trailing distance from current bar's extreme (default: 1.6)
Show Exit Levels — toggle all exit level lines
SL Beyond Sweep Wick — anchors stop to the swept swing level (default: on)
Display
Show Confluence Score Label — prints live score on every signal triangle
Show Dashboard — toggle the full dashboard
Dashboard Position — Top Left / Top Right / Bottom Left / Bottom Right
Colors
Bull / Bull Bright — yellow-green family for all bullish signals, fills, and labels
Bear / Bear Bright — red family for all bearish signals, fills, and labels
Squeeze — orange for squeeze tint and trailing stop line
EMA Fast / Slow / Signal — individual EMA line colors
Ribbon Fill Bull / Bear / Flat — ribbon fill colors for each trend state
Buy-Side / Sell-Side Liquidity — liquidity level line colors
Bull / Bear Order Block — OB box fill and border colors
Equilibrium Line — dealing range midpoint color (default: purple)
VWAP Line — VWAP plot color
BOS Bull / BOS Bear / CHoCH — structure label colors
Bull / Bear Sweep Marker — sweep diamond colors
SL / TP / TP2 / Trail Lines — individual exit level line colors
Long Zone BG / Short Zone BG — active trade background tints
Bull / Bear Label Text — score label text colors
Dash Text / Dash BG / Dash Header / Dash Section / Dash Frame — full dashboard color control
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔔 Alert Conditions (12 total)
Liquidity Alerts
Bull Liquidity Sweep — sell-side liquidity grabbed, watch for long setup development
Bear Liquidity Sweep — buy-side liquidity grabbed, watch for short setup development
Structure Alerts
Bull CHoCH — bullish Change of Character confirmed, structural trend shifting to bullish
Bear CHoCH — bearish Change of Character confirmed, structural trend shifting to bearish
Entry Alerts
Bull SURGE Entry — all conditions met: sweep, structure, confluence, ADX, session
Bear SURGE Entry — all conditions met for a short institutional sweep entry
Exit Alerts
Bull TP1 Hit — scale out 50% of long position
Bull TP2 Hit — full long position exit
Bull Stop Hit — stop loss or trail triggered on long
Bear TP1 Hit — scale out 50% of short position
Bear TP2 Hit — full short position exit
Bear Stop Hit — stop loss or trail triggered on short
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–M15 :
Min Layers at 4/6 — strong confluence while accounting for the complexity of the 6-layer system
HTF at 60-minute — provides meaningful higher timeframe context for intraday M1–M15 setups
Sweep wick at 0.05× ATR — sensitive enough to catch genuine institutional grabs without registering micro-noise sweeps
SL Beyond Sweep Wick on — structurally anchored stop placement at the institutional invalidation level
Allow CHoCH and BOS both on — captures both reversal and continuation setups in the full range of institutional delivery scenarios
For other instruments or timeframes, adjust:
Higher timeframes (H1, H4) — set HTF to Daily or Weekly, increase Swing Pivot Length to 8–10, increase TP2 to 5.0–6.0× ATR, raise Min Confidence to 5/6
Crypto (BTC, ETH) — increase Min Sweep Wick to 0.1–0.15× ATR to filter out the higher frequency of noise sweeps in volatile crypto sessions, increase KC Mult to 2.0
Indices (NAS100, US30) — tighten session to 09:30–16:00, increase ADX minimum to 22, set HTF to H4 for intraday M5–M15 trading
CHoCH-only mode — disable Allow BOS Continuation, raise Min Layers to 5/6. This produces the fewest signals but each represents a genuine trend reversal with maximum institutional evidence
More signals — lower Min Layers to 3, reduce Cooldown, disable PD Zone requirement, disable HTF filter
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
👥 Who This Is For
🏦 Smart money concepts and ICT methodology traders — SURGE is the quantitative implementation of the core SMC trading sequence: liquidity grab, structure shift, PD zone entry. Everything you execute manually in an SMC framework is automated and filtered here
🥇 Gold (XAUUSD) and forex traders — institutional order flow mechanics are most consistent and powerful on these instruments. Default settings are calibrated for gold intraday
📊 Multi-timeframe traders — the HTF bias filter is built for traders who use higher timeframe confluence as a core component of their trade selection process
🎯 Traders who want to stop buying highs and selling lows — the PD zone filter enforces the discipline of buying in discount and selling in premium, the foundational institutional positioning principle
🧠 Systematic traders — the 6-layer confluence score provides a fully quantified quality metric for every setup, replacing subjective SMC judgment with objective numerical scoring
📈 Traders who want to trade with institutions, not against them — every component of SURGE — the sweep detection, structure engine, PD zone, HTF filter, order blocks, and liquidity lines — is designed to identify and align with genuine institutional order flow
⚠ Traders who struggle with SMC subjectivity — traditional SMC analysis requires significant discretion. SURGE removes that discretion by encoding the rules objectively and applying them consistently on every bar across all instruments and timeframes
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📝 Notes
All signals are confirmed on bar close — the indicator is non-repainting by design. Structural trend tracking, sweep detection, and confluence scoring all finalize on confirmed bars only
The swing pivot detection has an inherent offset of swingLen bars — a pivot is only confirmed after swingLen bars have passed to the right of the pivot bar. This is standard for pivot-based systems and is not repainting — it is real-time confirmation
Order blocks are spawned on structure confirmation bars. The OB origin candle is the most recent opposing candle within the lookback window prior to the structure event — representing the genuine institutional origin zone
The structural trend variable is persistent — once a bullish trend is established by a BOS/CHoCH, it remains bullish until a bearish structure break occurs. This means the structure layer can remain in a favorable state across many bars between signals
Maximum 500 labels and 500 lines and 300 boxes are rendered. On very active low-timeframe charts with long history, oldest labels, order block boxes, and liquidity lines may be removed by TradingView's rendering limits
The VWAP calculation resets at each session start. On 24-hour crypto instruments, consider disabling the VWAP filter for best system behavior
The Trade Status section tracks position direction from signal to exit within the 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 moves to take liquidity before it moves to deliver value — and who want a system precise enough to be positioned for that delivery every time. Indicador
Indicador
Session Volume Pulse [TSL]Session Volume Pulse shows whether the current bar's volume is unusual for this exact time of day — not just compared to the last 20 bars, but compared to the same minute across the last 14 trading sessions (configurable 5–60).
Most volume indicators give you raw volume and a moving average. The problem: the 9:30 AM open is always busy, and noon is always quiet. A 3x spike at 9:30 means nothing — that's just what 9:30 looks like. A 3x spike at noon is genuinely unusual. This indicator makes that distinction obvious.
═══ WHAT YOU SEE ═══
Two visual signals on the volume pane:
1. A subtle blue baseline line showing the typical volume for this exact minute of the trading day, averaged across the past 14 sessions. The line curves upward at the open, dips through lunch, rises into the close — because that's what the average session looks like.
2. A multiplier label drawn only on bars where volume is ≥ 2.5x the recent 12-bar average (e.g., "2.7"). Most bars don't get a label. The ones that do are the bars worth attention. Position and orientation are both configurable — see the settings reference below.
That's it. No divergence tints. No z-score overlay. No nine-row corner table. Two signals, both readable at a glance.
═══ HOW TO READ IT ═══
- Bar above baseline + no spike label = elevated participation, soft confirmation
- Bar at or below baseline + no spike label = normal session activity, ignore
- Spike label appears = conviction event worth attention
The combination matters most: a spike at the cash open is less meaningful than a spike at noon, because the baseline tells you what's typical for each minute.
═══ CRITICAL SETTING: BARS PER SESSION ═══
This is the only setting most users need to configure for non-default markets. The default of 0 auto-detects assuming 24h trading, which is correct for crypto/forex and close enough for ~23h futures (NQ, ES, MNQ, MES at 15m).
For US stocks during regular trading hours (6.5h), override to:
- 1m chart: 390
- 5m chart: 78
- 15m chart: 26
- 30m chart: 13
For futures across other timeframes:
- 1m: 1380
- 5m: 276
- 15m: 92 (or leave at 0)
- 30m: 46
- 1h: 23
On 4h and higher timeframes, disable "Show time-of-day baseline" — there aren't enough bars per session for the baseline math to be meaningful. The spike detection still works fine.
═══ TUNING THE LOOKBACK ═══
The "Baseline sessions to average" setting controls how many past sessions feed the time-of-day average. The default is 14, but the right choice depends on your style:
- 5–10 sessions: very responsive, adapts fast after regime shifts (vol expansion, holiday weeks). More spike-alert noise.
- 14 sessions: DEFAULT. Two trading weeks of context. Balances responsiveness with stability. Best for active intraday on 15m futures.
- 21 sessions: one calendar month. More stable baseline, fewer false-spike alerts. Slower to adapt to new regimes.
- 30–60 sessions: swing/positioning context. Very stable, very slow to update. Single high-impact event days (FOMC, CPI) linger in the average for weeks.
Rule of thumb: too many marginal spike alerts? Increase the lookback. Baseline feels stale after a vol regime change? Decrease it.
═══ ALERTS ═══
Two alert conditions, both useful:
1. "Volume spike" — fires when volume hits the spike threshold. Use for multi-symbol monitoring.
2. "Crossed session baseline" — fires when volume transitions from below to above the typical level (or vice versa). Quieter signal indicating regime change.
═══ HONEST LIMITATIONS ═══
- Does not predict direction. A spike with a green close is bullish confirmation; a spike with a red close is often capitulation or distribution. The indicator surfaces the conviction event; reading direction is on you.
- Does not work on symbols without volume. Most spot forex pairs on retail platforms report tick count, not volume. Use the equivalent futures contract (6E, 6J, 6B) for real volume analysis on forex.
- Needs history. On a fresh symbol with fewer sessions of historical bars than your lookback setting, the baseline averages whatever's available and may be choppy for the first few sessions.
- Not session-aware for time changes. DST transitions or holiday-shortened sessions in the lookback window will offset the baseline by a bar or two until they roll out of the average.
═══ WHY OPEN SOURCE ═══
Closed-source indicators in finance are a known yellow flag — they often do less than claimed or rely on lookahead bias to look better in backtests. Every line of this script is readable. Audit the math, fork it, modify it for your strategy. The math is straightforward by design.
═══ SETTINGS REFERENCE ═══
Acceleration lookback (bars): 12 default. How many recent bars feed spike detection. Use 20 for daily charts.
Spike threshold (× average): 2.5 default. How far above average a bar must be to get a label. Lower = more labels.
Baseline sessions to average: 14 default (range 5–60). See "Tuning the Lookback" above.
Bars per session: 0 (auto). See table above.
Spike label position: Four options.
- On bar (top) — text floats just inside the top of the orange bar
- On bar (middle) — text centered inside the bar
- On bar (bottom) — text sits at the base of the bar (DEFAULT)
- Below bar (pill) — legacy orange pill anchored below the bar
Spike label orientation: Two options.
- Vertical (stacked) — each character on its own line. Best for narrow bars on lower timeframes. DEFAULT.
- Horizontal — standard single-line text. Best for wider bars on higher timeframes or when bar width comfortably fits the ratio.
Position and orientation are independent — any of the four positions can use either orientation, giving you eight visual combinations.
Colors: Six configurable colors for bars, baseline, and labels.
═══════════════════════════════════════════════════════════════
Maintained by TrailingStopLoss.com — more free, open-source trading tools at trailingstoploss.com/tradingview-indicators
═══════════════════════════════════════════════════════════════
Disclaimer: This is an analytical tool that displays publicly available volume data with a time-of-day baseline overlay. It does not predict price direction or guarantee any trading outcome. Volume spikes can precede continuation, reversal, or no follow-through. Trading futures and equities involves substantial risk of loss. For educational purposes only. Indicador
[ 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. Indicador
MTIDDescription
MTID is an all-in-one overlay built for swing and position traders who want price action, key statistics and fundamentals on a single pane. Six configurable moving averages, a "big move" marker, a live stats dashboard, and an 8-quarter fundamentals table are combined into one indicator with independent toggles for every section.
WHAT'S ON THE CHART
• Six moving averages — each with its own length, type (SMA/EMA), color and timeframe-visibility filter (All / Intraday+Daily / Weekly+Monthly / Intraday-only / Daily-only / Weekly-only). Default lengths 10/20/50/100/150/200 cover the most-watched values.
• Purple-Dot Big Move — flags bars whose move ≥ a configurable % AND volume ≥ a configurable threshold. Shape, size, color and timeframe-visibility are all configurable; bars can be color-coded on move direction.
• Optional bar coloring for high relative-volume bars.
STATS DASHBOARD (vertical table or horizontal headband)
• Sector & Industry (auto-detected from the symbol)
• Market Cap with currency conversion (Auto / USD / INR / EUR / GBP / JPY) and Indian (Cr/LCr) or Western (M/B/T) formatting
• 52-Week High/Low — % off the high and % off the low (daily-candle based regardless of chart TF)
• 13-Week Peak/Bottom — same idea over a quarter
• ADR (Average Daily Range %) and ATR — daily-candle based
• U/D Ratio — up-volume vs down-volume
• Float %
• Distance vs Daily SMA and Distance vs Weekly SMA — both shown simultaneously, regardless of chart timeframe
• Relative Volume (RVol)
• % above Low-of-Day (intraday session low; bar low on daily+)
FUNDAMENTALS TABLE
Last four quarters (with three more held internally for YoY math) of:
• EPS with YoY and QoQ % change
• Sales (auto-scaled units) with YoY and QoQ % change
• OPM% (Operating Margin = Operating Income / Revenue) with YoY and QoQ
• Per-quarter P/E (annualised from quarter EPS)
Plus an optional row showing the next two estimated quarters (EPS estimates, YoY/QoQ).
Header row showing Market Cap, Free-Float Mkt Cap, ROE and TTM P/E.
Vertical (full grid) or horizontal (transposed headband) layout.
IPO-FRIENDLY
Lookback windows adapt to available history. A newly listed symbol with fewer than 52 weeks (or 13 weeks, 50 bars for RVol, 20 days for ADR, etc.) still gets values computed over whatever data exists, instead of showing "N/A".
CUSTOMIZATION
• Every section independently togglable.
• Per-table position (6 anchor points), text size, layout (vertical / horizontal headband), border & frame width.
• Per-column text alignment (Left / Center / Right) for the dashboard.
• Configurable blank spacer rows at the top of each table — useful when TradingView's hover controls overlap the table.
• Fully themable colors (positive / negative / neutral, backgrounds, borders).
NOTES
• Sector, Industry, Market Cap, ROE, Float, EPS, Sales, Operating Income and EPS estimates are sourced from TradingView's request.financial / request.earnings and may be unavailable for some symbols or exchanges.
• Currency conversion uses FX_IDC daily rates.
• Built in Pine Script v6. Indicador
VWAP Regime Filter & Signal Quality Indicator [LunqFX]VWAP Regime Filter & Signal Quality Indicator
A complete trading framework built on volume-weighted flow analysis.
Identifies market regimes, detects high-probability reversal entries,
and rates each signal 1–5 stars so you know exactly how much conviction to trade with.
─────────────────────────────────────────
WHAT IT MEASURES
─────────────────────────────────────────
▸ VELOCITY — how fast the VWAP is moving, normalized by volatility.
Values > +0.8 = rising momentum. Values < -0.8 = falling momentum.
SURGE / RISING / UP / FLAT / DOWN / FALLING / CRASH shown in the panel.
▸ PRESSURE — how far price is stretched from VWAP, measured in standard
deviations (σ). Values near 0 = price at VWAP. Values > ±2σ = extreme
extension, strong mean-reversion candidate.
▸ TURBULENCE — the ratio of current velocity volatility to its 50-bar average.
< 0.8 = calm, trending market (LAMINAR). > 1.3 = choppy, avoid entries.
Only trade when turbulence is low.
▸ REGIME SCORE — 0–100% score summarizing overall flow quality.
> 60% = clean conditions. < 30% = stay out.
─────────────────────────────────────────
5 MARKET PHASES
─────────────────────────────────────────
🟡 BREAKOUT — price beyond ±2.8σ outer band. Manage open positions,
do not chase. Mean reversion imminent.
🟢 EXPANSION — velocity rising strongly. Trend is building.
Do not fade the move.
🟠 CONTRACTION — velocity falling. Energy compressing toward VWAP.
Watch for fresh reversal entries.
🔵 LAMINAR FLOW — low turbulence, steady drift. Best window for entries.
Signals here carry the highest quality.
🟣 CONSOLIDATION — mixed signals, no clear bias. Reduce size or wait.
─────────────────────────────────────────
HOW SIGNALS ARE GENERATED
─────────────────────────────────────────
LONG — price crosses back above the inner lower band (−1.5σ)
AND pressure is below −0.8σ (oversold stretch)
AND market is in LAMINAR regime (turbulence < 0.8)
SHORT — price crosses back below the inner upper band (+1.5σ)
AND pressure is above +0.8σ (overbought stretch)
AND market is in LAMINAR regime
In plain terms: the indicator buys when price bounced from below the VWAP
lower band in a calm, trending market. It shorts when price rejected from
above the VWAP upper band in the same conditions.
A cooldown of 5 bars prevents signal clustering (adjustable).
Optional reversal candle filter (pin bar / engulfing) adds confirmation.
─────────────────────────────────────────
SIGNAL QUALITY SCORE — 1 to 5 STARS
─────────────────────────────────────────
Each signal is rated automatically. Use it to size positions:
★☆☆☆☆ 1 — baseline signal, minimal confirmation
★★☆☆☆ 2 — low conviction, reduce size
★★★☆☆ 3 — decent setup, standard size
★★★★☆ 4 — high quality, can add size
★★★★★ 5 — all conditions aligned, maximum confidence
Points are awarded for:
+ Pressure beyond ±2σ (strong extension)
+ Very low turbulence (< 0.5)
+ Full 3/3 MTF alignment
+ Both extreme pressure AND very calm market simultaneously
─────────────────────────────────────────
MULTI-TIMEFRAME CONFLUENCE (MTF)
─────────────────────────────────────────
The indicator reads velocity on 3 timeframes simultaneously:
• Current chart timeframe
• TF 2 (default: 1H)
• TF 3 (default: 4H)
Panel shows each TF with ▲ (bullish velocity) or ▼ (bearish velocity).
FULL ALIGN 3/3 — all timeframes agree → highest conviction
PARTIAL 2/3 — majority agreement → tradeable
DIVERGED 1/3 or less → conflicting signals, skip the trade
─────────────────────────────────────────
HOW TO TRADE — STEP BY STEP
─────────────────────────────────────────
1. Check REGIME first.
→ If TURBULENT or Regime Score < 30% — do not enter. Wait.
→ If LAMINAR or Score > 60% — proceed.
2. Check MTF FLOW BIAS.
→ FULL ALIGN (3/3) = strong directional conviction.
→ PARTIAL (2/3) = ok to trade, smaller size.
→ DIVERGED = skip.
3. Wait for a signal label (▲ LONG or ▼ SHORT) on the chart.
→ More stars = higher conviction = larger position size.
4. Entry: at the signal candle close (or next open).
5. Stop loss: beyond the outer band (±2.8σ).
→ Long: stop below the outer lower band (−2.8σ).
→ Short: stop above the outer upper band (+2.8σ).
6. Take profit: use NEXT TARGET in the panel.
→ Shows the next VWAP band level and the % distance to it.
→ Long target: inner top band → outer top band.
→ Short target: inner bottom band → outer bottom band.
7. If phase switches to TURBULENT — tighten stop or exit.
─────────────────────────────────────────
PANEL GUIDE
─────────────────────────────────────────
PHASE — current market phase + pressure reading + regime score
REGIME — LAMINAR / MIXED / TURBULENT + progress bar
VELOCITY — trend word + normalized value
PRESSURE — distance from VWAP in σ + bar
TURBULENCE — market noise level + bar
FLOW BIAS — MTF alignment status
— per-timeframe direction (▲ bull, ▼ bear)
SIGNAL — last signal direction + bars ago
QUALITY — star rating of last signal
NEXT TGT — nearest VWAP band + % distance
─────────────────────────────────────────
ALERTS (11 total)
─────────────────────────────────────────
• Long Signal
• Short Signal
• High Quality Long (4-5★)
• High Quality Short (4-5★)
• Regime: Laminar Flow (Trading Window Open)
• Regime: Turbulent (Avoid Trading)
• Phase: Breakout
• Phase: Expansion
• Phase: Contraction
• Full MTF Alignment (3/3)
• Pressure Extreme (>2σ)
Recommended setup: enable "Regime: Laminar Flow" and "High Quality Long/Short"
alerts to get notified only when market conditions are optimal.
─────────────────────────────────────────
SETTINGS
─────────────────────────────────────────
VWAP Window — lookback for VWAP calculation (default 50)
Inner Band σ — inner band distance, signals trigger here (default 1.5)
Outer Band σ — outer band distance, stop loss reference (default 2.8)
Show Signals — toggle signal labels on/off
Cooldown (bars) — minimum bars between signals (default 5)
Reversal Filter — require pin bar or engulfing candle (default ON)
Show Panel — toggle info panel
TF 2 / TF 3 — second and third timeframes for MTF confluence
─────────────────────────────────────────
CREDITS
─────────────────────────────────────────
Built on the same VWAP flow engine as Plasma Flow by the same author.
This indicator extends that framework with a dedicated signal quality scoring
system and enhanced multi-timeframe confluence layer.
© LunqFX Indicador
Aurora Expanded Trend Cloud [Pineify]Aurora Expanded Trend Cloud
This indicator uses a Donchian Channel breakout to define trend direction and then projects an asymmetric "cloud" zone above or below price — a visual region where the market is expected to find support (in uptrends) or resistance (in downtrends). What makes it different from a plain Donchian system is the one-directional trailing cloud boundary: once the floor starts rising (or the ceiling falling), it never reverses, creating a ratcheting effect that tightens as a trend matures without whipping back on normal pullbacks.
Key Features
Trend direction determined by Donchian Channel breakouts — clean, objective, no oscillator subjectivity
Cloud width scales with the current channel width, so the zone automatically widens during high-volatility periods and compresses when price is ranging
One-way trailing boundary: the cloud floor only moves up in bull trends; the cloud ceiling only moves down in bear trends — reducing false exits during healthy retracements
Trend-start circles mark the exact bar where each breakout first confirmed, providing a clear visual reference for entry timing
Trend state exposed in the Data Window for use in external scripts or Pine Strategy bridges
How It Works
The calculation pipeline has three stages:
Channel Construction — Each bar, the indicator computes the N-bar highest high (upper band) and lowest low (lower band). The difference is the channel width, which serves as a volatility proxy.
Expansion Offset — An expansion percentage (default 50 %) is applied to the channel width to derive an offset. For example, on a bar where the channel spans 10 points, a 50 % setting produces a 5-point offset. This offset is added to the lower band (bullish cloud floor) or subtracted from the upper band (bearish cloud ceiling).
One-Directional Trail — Rather than placing the cloud boundary exactly at the shifted band each bar, the indicator uses math.max (bullish) or math.min (bearish) against the prior trail value. Once the floor is at level X, it will not drop below X even if the Donchian lower band temporarily dips — the level "locks in" and can only continue advancing. On a trend flip, the trail resets from the new band anchor.
How the Components Work Together
The Donchian breakout sets the trend but is inherently reactive — it waits for price to close beyond the N-bar extreme, so the first signal can be a bar or two late on fast moves. The cloud's one-way trail compensates for this by providing a persistent, non-retreating reference level throughout the trend. Because the floor never pulls back, it acts as a natural trailing stop zone: if price closes below the green cloud boundary, the bullish structure has likely deteriorated beyond normal noise. The two mechanisms are complementary — breakout for entry, one-directional trail for management.
The expansion percentage links cloud width to current volatility. On a stock moving 1 % a day in a tight channel, the cloud stays narrow. During a high-momentum phase where the channel widens, the cloud expands proportionally, giving the trade more room to breathe. This avoids one of the common frustrations with fixed-offset trailing stops: premature exits during volatile but sustained trends.
Trading Ideas and Insights
When a green circle appears and the cloud floor begins to form below price, it may signal an early-stage uptrend. Consider entries on the first close above the upper band with the cloud floor as an initial stop reference.
As a trend matures, the cloud floor rises and tightens. A close back into the cloud zone — especially with a wick that tags the floor — may indicate a pause rather than a reversal. A close below the cloud often warrants reassessment.
Compression of the Donchian Channel ahead of a circle signal (upper and lower bands converging) can suggest accumulated energy before a breakout. These setups may produce cleaner follow-through than breakouts from already-wide channels.
On higher timeframes the cloud acts as a broad trend filter. If price is above the green cloud on the daily, consider filtering intraday long setups only from that direction.
Past behavior does not guarantee future results. The indicator has no predictive capability — it identifies conditions based on historical price structure. Always combine with independent confirmation and proper risk management.
Limitations to Be Aware Of
The Donchian breakout condition requires a close beyond the N-bar extreme. On fast-moving bars, the entry signal appears one bar after the actual breakout, which can result in a worse fill price.
The one-way trail means the cloud boundary never retreats during a trend, but it also means it can diverge significantly from current price during extended moves. In those situations, the cloud is no longer a tight stop reference — it reflects the starting anchor of the trend, not current structure.
In choppy, range-bound conditions, the indicator will produce frequent trend flips (circles in rapid alternation). No trend-following tool performs well in this regime; watch the channel width as a rough proxy for regime type.
How to Use
Add the indicator to any chart and timeframe. It works on overlay mode, drawing directly on price.
A green cloud below price confirms a bullish trend. A red cloud above price confirms a bearish trend. The solid-colored boundary line is the active trailing level.
Colored circles mark trend start bars. Green below price = trend flipped bullish. Red above price = trend flipped bearish.
Use the Trend Length input to adjust sensitivity. Shorter values (10–15) react faster and suit shorter timeframes or momentum styles. Longer values (30–50) filter more noise and suit swing or position trading.
Adjust the Expansion % to control how far the cloud boundary sits from the Donchian band. Higher values give more room and widen the cloud; lower values keep the trail tight to price.
Customization
Trend Length (default: 20) — Lookback window for the Donchian Channel. Larger values require a more sustained breakout to flip the trend and produce fewer, higher-conviction signals. Smaller values increase responsiveness at the cost of more noise.
Expansion % (default: 50) — How wide the cloud is expressed as a fraction of the channel width. At 100 %, the cloud spans the full channel. At 0 %, the cloud collapses to a line at the channel boundary. Values between 30 %–70 % work well for most setups.
Conclusion
Aurora Expanded Trend Cloud combines a Donchian breakout system with a volatility-adaptive, one-directional trailing zone to give both a clear trend signal and a persistent visual reference level throughout the move. It is best suited for traders who want an objective, rule-based trend overlay without manual line-drawing — particularly on trending assets and timeframes where Donchian systems historically perform best.
Indicador
XAU Grid - Long IndicatorXAU Grid — Long Indicator
🔷 What it does:
This is a signal-only indicator that mirrors a price-grid long workflow between two fixed bounds. It tracks up to 48 independent virtual slots between a configurable High and Low — each slot fires a webhook-ready buy signal when price crosses down through it, and a paired sell signal when price subsequently crosses up through the slot immediately above. The indicator computes a running average entry, total deployed capital, and open PnL from the live slot ledger and renders all of it on the chart.
- Pre-computes 5–50 grid levels in Geometric (default) or Arithmetic spacing.
- Each slot is an independent ownership flag with its own buy/sell webhook payload.
- Avg entry is derived from fill-by-fill bookkeeping — total cost and total qty are updated on every event.
- Every event emits a webhook-ready JSON alert payload tagged with the specific grid slot.
🔷 Who is it for:
- Swing traders harvesting volatility on range-bound assets where directional bias is unclear.
- Bot operators looking for a chart-driven signal source that emits per-slot JSON ready for a DCA Bot configured for grid emulation.
- Traders who want to monitor a virtual grid state — avg entry, owned slots, deployed capital, open PnL — directly on the chart without a backtest engine.
- Portfolio operators using a low-volatility contributor alongside directional strategies.
🔷 How does it work:
Grid Construction: On script load, the indicator computes N price levels between the configured High and Low bounds. In Geometric mode (default), level k is at High × (Low/High)^(k/(N-1)), giving constant percent spacing. In Arithmetic mode, levels are linearly spaced by absolute price.
Per-Slot State Machine: Each grid level is an independent slot tracked by a boolean ownership flag. When close price crosses down through an empty slot's level, the slot is marked owned, virtual cost-basis is added, and the BUY webhook payload is dispatched. When close price crosses up through the level immediately above an owned slot, the slot is marked free, virtual cost-basis is subtracted, and the SELL webhook payload is dispatched.
Honest Virtual Bookkeeping: Total cost and total qty are updated incrementally on each event, so the avg entry, deployed capital, and open PnL displayed in the status table reflect the actual broker-equivalent position state — no shortcuts from base entry, no synthetic averaging.
No Trailing, No Stop Loss: By design, each slot has a fixed exit (the level above). The indicator never trails the exit and never signals a slot-out for a loss — slots that fall below their entry stay owned until price comes back. This is the canonical grid bot behavior.
🔷 Why it's unique:
- Per-Level Webhook Ledger: Every BUY and SELL emits a fully-formed JSON alert payload tagged with the specific grid slot ("Grid_BUY_L5" / "Grid_TP_L5"). The indicator can drive a DCA Bot configured for grid emulation without any glue layer.
- Fill-by-Fill Avg Entry: The orange avg-entry line is derived from running totals updated on every event — what you see is what the broker-equivalent position would actually have.
- Active Slot Highlighting: Owned grid levels are rendered with a thicker green stroke; empty slots stay dashed gray. Slot density and current loading are visible at a glance.
- Range Box & Bounds Labels: A semi-transparent box spans the configured High/Low range, and crisp HIGH/LOW labels mark the bounds — the grid topology is obvious without zooming.
🔷 Considerations Before Using the Indicator:
Market Selection: Grid strategies are most profitable in range-bound, mean-reverting markets. On strong directional trends, the indicator will keep marking slots as owned as price moves away and won't free any until price reverses. Pick assets that respect a defined range, and re-tune High/Low whenever the regime changes.
Range Configuration: The default High/Low (4857.27 / 3568.69) was set against XAUTUSDT historical extremes. Update both bounds before deploying on any other asset — the Geometric spacing is sensitive to the bounds ratio.
Cross Detection Granularity: Crossings are detected on bar close, comparing the current close to the previous close. A bar that spikes through a level and returns within the same bar may be missed by design — this prevents over-signaling on intra-bar wicks.
Live vs Historical State: The virtual slot ledger is rebuilt from chart history each time the indicator is recompiled. If the indicator is added mid-deployment or the live bot diverges from the signal stream (manual interventions, partial fills), the indicator state may not match the live bot. Toggle the indicator off and on to reset.
No Stop Loss: There is no exit signal on adverse moves below the lowest grid level. Risk is structurally capped on the bot side by the bounded Total Investment input. If a hard stop is required, layer it on the bot side.
Backtesting Note: This is an indicator, not a strategy. There is no built-in P&L tester. For performance metrics, use the companion strategy version on the same parameters.
🔷 How to Use It:
🔸 Add the indicator to a chart on the asset and timeframe you want to trade.
🔸 Set the High and Low bounds to a range you expect the asset to respect.
🔸 Pick Geometric (default, recommended for crypto and commodities) or Arithmetic spacing.
🔸 Set Grid Levels (5–50) and the virtual Total Investment used for avg-entry computation.
🔸 In the DCA Bot Webhook group, paste your Bot ID, Email Token, and Pair (QUOTE_BASE format, e.g., USDT_XAU).
🔸 Create an alert on the indicator with "Any alert() function call". Paste the DCA Bot's webhook URL into the alert's Webhook field. Every grid-level buy and grid-level close will emit a dedicated JSON payload tagged with the slot index, so each level can be tracked independently downstream.
🔷 INDICATOR SETTINGS
High Price: Top of the grid. The highest level a slot can be created from.
Low Price: Bottom of the grid. The lowest level a slot can be created from.
Grid Levels: Number of price levels between High and Low (default 48, capped at 50).
Spacing Mode: Geometric (constant percent step) or Arithmetic (constant absolute step).
Total Investment (USDT): Virtual capital allocated across all slots. Used for the avg-entry and open-PnL computation only.
Bot ID / Email Token / Pair: Webhook fields injected into every alert payload.
Visualization: Toggle grid lines, range box, HIGH/LOW labels, avg entry plot, fill labels, signal triangles, status table.
Brand Watermark: Configurable text, position, size, and transparency.
👨🏻💻💭 We hope this tool helps enhance your trading. Your feedback is invaluable, so feel free to share any suggestions for improvements or new features you'd like to see implemented.
__
The information and publications within the 3Commas TradingView account are not meant to be and do not constitute financial, investment, trading, or other types of advice or recommendations supplied or endorsed by 3Commas and any of the parties acting on behalf of 3Commas, including its employees, contractors, ambassadors, etc. Indicador
Elaris Session Strength Indicator## Elaris Session Breakout Pro
Elaris Session Breakout Pro is a clean and professional session-based trading indicator designed to help traders identify high-probability breakout opportunities during key market sessions such as London and New York.
The indicator automatically tracks the opening range of the selected session and highlights breakout confirmations when price closes above or below the defined session range. This allows traders to quickly spot momentum expansion, liquidity-driven moves, and potential intraday trend continuation setups without manually drawing levels.
Built with a strong focus on clarity, usability, and real-time decision support, the indicator is optimized for scalpers, day traders, and momentum traders across crypto, forex, and index markets.
### Key Features
• Automatic session opening range detection
• Dynamic breakout signals for bullish and bearish moves
• Non-repainting breakout confirmations
• Clean chart visualization with minimal clutter
• Configurable session timings and breakout logic
• Visual breakout labels and session range plotting
• Suitable for crypto, forex, and traditional markets
• Optimized for lower timeframes and intraday trading
### How It Works
The indicator monitors the first candle or opening range of the selected trading session. When price successfully closes above the session high, a bullish breakout signal is generated. When price closes below the session low, a bearish breakout signal is generated.
This approach helps traders identify moments where liquidity and volatility expand during active market hours, often leading to strong directional movement.
### Best Use Cases
• London session breakout trading
• New York open momentum trades
• Crypto volatility expansion setups
• Intraday trend continuation strategies
• Liquidity and range breakout confirmation
### Notes
Like all trading indicators, this tool should be used as part of a complete trading plan with proper risk management and confirmation techniques. Market conditions can vary, and no indicator guarantees profitability or a 100% win rate.
TradingView session concepts referenced in this script are based on TradingView’s official Pine Script session documentation.
Indicador
Indicador
Indicador
Triple Lens by MOUTriple Lens by MOU
After spending years burning money on candlestick patterns, MACD crossovers, and Elliott Waves, I came to a simple conclusion: most retail technical analysis has been arbitraged into oblivion by quant funds. What survives — and what still works — sits in three places that machines can't fully eat: trend stage, accumulation pattern, and market breadth.
This indicator is what I built for my own trading. It overlays three independent frameworks from three legendary technicians:
Stan Weinstein — Stage Analysis (where are we in the cycle?)
William O'Neil — CANSLIM accumulation (is smart money building?)
Walter Deemer — Market Breadth (is the broader tape supporting us?)
Each lens looks at a completely different dimension. When all three light up green at the same time, you get a ▲ signal on the chart. That's the moment to pay attention.
Why three? Because any single indicator gets gamed. But three independent signals confirming the same direction is a different statistical animal — it's confluence, not coincidence.
One thing I want to be honest about: this isn't a crystal ball. Technical analysis cannot predict the future, period. What a good system can do is take you from 50/50 coin-flip entries to maybe 60-70% odds. That's it. But over hundreds of trades, that edge compounds — and that's where real wealth is built.
A ▲ signal is your green light to consider entering, not a guarantee that you'll win every time. Sizing, stops, and risk management still matter.
Important: This indicator goes blind during earnings. Earnings re-price the fundamentals — and technical analysis is built on the assumption that fundamentals are stable. If a ▲ fires right before an earnings call, wait it out. Let the dust settle, then re-evaluate.
Free to use. No tweaking needed. Built for swing and position traders on daily/weekly timeframes.
If this helps you, drop a boost. If you have feedback, comments are open.
— MOU Indicador
Indicador
Perpetual Basis Drift Map [AGPro Series]Perpetual Basis Drift Map
🧠 Core Idea
Is the perpetual market quietly drifting away from spot, or is the basis relationship compressing back toward neutral?
📌 Overview / What it does
Perpetual Basis Drift Map is a crypto derivatives context tool designed to monitor how the active perpetual or futures market behaves against a matching spot reference.
The script compares the active chart price with an automatically selected spot reference, measures basis percentage, basis drift, normalized basis z-score, drift velocity, persistence, and trend context. It converts that relationship into an open three-rail basis drift meter, state labels, right-side tags, alerts, and an AG Pro dashboard.
It does not read official funding payments, automate trades, predict future price direction, or promise that basis must mean-revert. It is a structured visual map for interpreting perpetual premium, perpetual discount, basis expansion, basis compression, reset, and spot-reference mismatch conditions.
🎯 Purpose & Design Philosophy
This script was built to separate basis drift from generic funding or premium talk.
Funding pressure can be noisy, and a raw premium number is often not enough. Traders need to know whether the relationship between perp/futures and spot is widening, compressing, persisting, or simply resetting.
The design goal is to make basis behavior visible as a chart story, not just a number in a panel.
⚡ Why This Script Is Different
Most tools show a spread or premium value and leave the interpretation to the user.
This script does NOT treat basis as a simple buy or sell signal, does NOT claim that premium must reverse, and does NOT hide reference mismatch risk.
Instead, it maps the basis relationship into states: Positive Drift, Negative Drift, Basis Expansion, Basis Compression, Reset, and Check Spot Ref, while the chart labels use Premium Drift, Discount Drift, Spread Expansion, and Basis Compression for faster visual reading. It uses spot-reference comparison, baseline drift, z-score, velocity, persistence, and trend context together.
⚙️ Methodology
1. Context Detection
The script builds a spot reference from the active chart base currency, selected exchange, and selected quote.
2. Reference Mapping
It compares the active market against the spot reference and calculates basis percentage.
3. Reaction Evaluation
The model evaluates basis drift from baseline, normalized basis z-score, drift velocity, persistence, and trend context.
4. Visual Output
The result is shown as a compact open basis drift meter, centered meter label, right-side tags, event labels, and dashboard panel.
🗺️ How to Read the Chart
The basis drift meter separates the current read into three visible layers: state rail, basis value rail, and pressure score rail. It is intentionally open-ended rather than a closed corridor, so the visual story feels different from zone-first tools.
Labels mark state changes such as Premium Drift, Discount Drift, Spread Expansion, and Basis Compression. Optional compact pulse markers add additional context when premium, discount, expansion, or compression pressure appears without turning the script into a signal engine.
Colors communicate context:
• Teal = positive/perp-premium drift pressure
• Pink = negative/perp-discount drift pressure
• Yellow = spread expansion or reference warning
• Indigo = compression/reset regime
The panel summarizes state, score, basis, basis z-score, velocity, persistence, direction, quality, spot reference, trend, and meter values.
🚦 Signals & States
• Positive Drift → perpetual/futures market is drifting above the spot reference
• Negative Drift → perpetual/futures market is drifting below the spot reference
• Basis Expansion → basis deviation and drift velocity are widening
• Basis Compression → basis deviation is compressing back toward neutral
• Reset → no active drift state is strong enough to dominate the read
• Check Spot Ref → selected spot reference appears mismatched or unavailable
🔔 Alerts Logic
Alerts trigger when the script transitions into selected basis states.
Positive Basis Drift alerts mark meaningful upward perp-versus-spot drift.
Negative Basis Drift alerts mark meaningful downward perp-versus-spot drift.
Basis Expansion alerts mark widening basis deviation and drift velocity.
Basis Compression alerts mark movement back toward a neutral basis relationship.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest context appears when multiple components align:
Basis percentage + normalized basis z-score + drift velocity + persistence + trend context.
When basis widens and persists, the relationship may deserve closer attention. When basis compresses, the market may be returning toward a more neutral perp-versus-spot condition.
📊 When to Use
• Crypto perpetual and futures charts
• Markets where spot reference comparison is meaningful
• Perp/spot monitoring on BTC, ETH, and liquid crypto pairs
• Basis expansion, basis compression, and drift-context analysis
• Sessions where derivatives premium or discount behavior matters
⚠️ When NOT to Use
• Symbols with poor spot-reference alignment
• Illiquid markets with unreliable pricing
• Spot-only charts if the user expects a derivatives basis story
• Extreme news events where spread behavior can become unstable
• Markets where the active symbol and selected reference are not comparable
🎛️ Key Inputs
• Auto Spot Reference → automatically builds a matching spot reference
• Basis Baseline Length → controls how quickly the normal basis relationship adapts
• Basis Normalization Lookback → controls how unusual basis drift must be
• Drift Velocity Lookback → measures whether basis is widening or tightening
• Persistence Window → measures whether basis behavior continues across bars
• Reference Mismatch Guard % → prevents mismatched references from being interpreted as real basis drift
• Visual Settings → control meter projection, labels, right-side tags, and font sizes
🖥️ Interface & Visual Design
The interface is designed around a premium chart-first story.
The basis drift meter provides the main visual anchor. Centered meter text explains the state without relying on weak transparent labels or a large corridor box. Right-side tags keep the current state, basis, and score visible near the active price area.
The panel follows the AG Pro standard with a merged blue header row, adjustable location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Apply the script to a crypto perpetual or futures chart.
2. Keep Auto Spot Reference enabled for the first pass.
3. Confirm the Spot Ref row matches the active market base currency.
4. Read State, Score, Basis, Basis Z, and Velocity.
5. Inspect whether basis is drifting, expanding, compressing, or resetting.
6. Confirm the read with broader market structure, liquidity, volatility, and risk management.
🔍 Interpretation Guidelines
Positive basis drift can show perp premium building, but it does not automatically mean price must fall.
Negative basis drift can show perp discount building, but it does not automatically mean price must rise.
Basis expansion is a context marker, not a trade instruction.
Basis compression can indicate normalization, but normalization does not guarantee direction.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an auto trading system.
This script is not a guaranteed signal engine.
This script does not read official funding payments directly.
This script does not claim that basis drift must immediately reverse.
⚠️ Limitations & Transparency
The script estimates basis from active-symbol versus spot-reference price behavior.
Reference quality matters. If the selected reference is wrong or unavailable, the script shows Check Spot Ref rather than presenting the spread as valid basis drift.
Different exchanges, contract types, liquidity conditions, and timeframes can produce different basis behavior.
Very low basis values can be visually clean but may not produce a dramatic story.
🧠 Market Context Notes
Perpetual basis can help traders understand whether derivatives pricing is leaning above or below spot.
The value of this tool is strongest when combined with structure, volatility, liquidity, open interest, and disciplined risk management.
Basis tells context. It does not create certainty.
🧾 Use Case Examples
When a perpetual chart trades persistently above spot and basis velocity expands, the script may classify Positive Drift or Basis Expansion.
When a perpetual chart trades persistently below spot and basis velocity expands downward, the script may classify Negative Drift.
When basis returns toward its baseline, Basis Compression can help show normalization.
🧱 System Philosophy
Perpetual Basis Drift Map follows the AGProLabs principle of building decision-support maps rather than prediction tools.
The script is designed to make hidden derivatives context easier to see, not to replace judgment.
🔐 Non-Promise Statement
No basis model can guarantee future price direction.
No drift score removes uncertainty.
This tool helps organize context; it does not create certainty.
📉 Risk Disclosure
Trading involves risk.
Crypto derivatives can be highly volatile and may involve leverage, liquidation risk, exchange risk, funding-cost changes, and rapid market movement.
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
📚 Educational Note
Use the script as a learning layer for understanding how perpetual premium, perpetual discount, basis drift, basis velocity, and spot-reference behavior can combine into a cleaner derivatives-context read.
Indicador
Indicador
Failed Continuation Trap Map [AGPro Series]Failed Continuation Trap Map
🧠 Core Idea
Did a continuation attempt fail strongly enough to trap traders and create pressure in the opposite direction?
📌 Overview / What it does
Failed Continuation Trap Map is a rule-based price-action and market-structure visualization tool designed to study failed continuation attempts.
The script identifies trend-aligned continuation attempts, maps the attempted breakout zone, evaluates whether the move fails back through that zone, and highlights when trapped longs or trapped shorts may create opposite pressure.
It does not predict reversals, automate trades, or guarantee that a failed continuation will produce follow-through. It is a structured decision-support map for continuation failure, trap behavior, and opposite-pressure context.
🎯 Purpose & Design Philosophy
Many breakout and continuation tools focus on whether price moved beyond a level.
This script was built to answer a more selective question:
Did the continuation attempt fail in a way that changes the market narrative?
The design goal is to help traders read failed continuation as a trap context instead of treating every rejection as a reversal signal.
⚡ Why This Script Is Different
Most tools focus on breakouts, pullbacks, continuation signals, or reversal labels.
This script does NOT label every failed move as a trap.
Instead, it waits for a trend-aligned continuation attempt, tracks the attempt zone, evaluates failure quality, maps the trap pocket, and checks whether opposite pressure confirms after trapped participants are created.
⚙️ Methodology
1. Continuation Bias Detection
The script uses fast and slow EMAs to define the active continuation bias.
2. Attempt Mapping
When price attempts continuation beyond recent structure, the script records the attempt level and builds an attempt zone.
3. Failure Evaluation
After the attempt, the script watches a defined failure window to detect rejection back through the attempt level.
4. Trap and Pressure Scoring
Trap quality uses rejection wick behavior, relative volume, and failure timing.
5. Visual Output
The chart displays the attempt zone, trap pocket, opposite-pressure rail, centered trap label, event labels, right-side tags, alerts, and a compact AG Pro decision panel.
🗺️ How to Read the Chart
Attempt Zone = the area around the continuation level where breakout or continuation participants may enter.
Trap Pocket = the area where failed continuation can create trapped participants.
Opposite-Pressure Rail = the level used to read whether the failed continuation is turning into stronger pressure against the attempt.
Centered Trap Label = the main visual anchor inside the active trap pocket.
Event Labels = compact labels for attempts, long traps, short traps, and pressure confirmation.
Right-Side Tags = current trap state, attempt level, and pressure quality.
Panel = summarizes trap state, attempt type, trapped side, trap quality, pressure quality, next context, and timeframe.
🚦 Signals & States
• ATTEMPT ACTIVE → price attempted continuation and is still inside the failure evaluation window.
• TRAP ACTIVE → the continuation attempt failed back through the attempt level.
• OPPOSITE PRESSURE → price confirmed pressure away from the failed continuation attempt.
• CONTINUATION HOLD → the attempt is holding beyond the continuation zone.
• ATTEMPT EXPIRED → the attempt did not create a timely failure or pressure signal.
• WAIT ATTEMPT → no valid continuation attempt is active.
🔔 Alerts Logic
Alerts trigger when a major continuation-failure state appears.
• Continuation Attempt → price attempted continuation beyond recent structure.
• Failed Continuation Trap → continuation attempt failed back through the attempt zone with trap quality.
• Opposite Pressure Confirmed → opposite pressure confirmed after a failed continuation attempt.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• Continuation bias is clear
• Price attempts continuation beyond recent structure
• The attempt fails back through the zone quickly
• Rejection wick quality is strong
• Relative volume supports participation
• Opposite-pressure rail confirms after the trap
• The panel state agrees with the chart labels
If these elements do not align, the script avoids forcing a trap interpretation.
📊 When to Use
• Breakout failure analysis
• Failed continuation review
• Trend continuation trap studies
• Intraday and swing market-structure analysis
• Crypto, forex, stocks, and index markets
• 1H, 4H, and daily charts
• Markets where continuation attempts are common and readable
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely sideways markets with no continuation bias
• News-driven candles that distort rejection quality
• Ultra-low timeframes with excessive noise
• Markets where recent structure is too compressed to define a clean attempt zone
• Situations where a single failed attempt should not be treated as a standalone decision
🎛️ Key Inputs
• Fast EMA Length → defines the faster continuation-bias component.
• Slow EMA Length → confirms the broader continuation direction.
• ATR Length → normalizes attempt zones, trap pockets, labels, and failure levels.
• Continuation Breakout Lookback → defines recent structure used to identify continuation attempts.
• Failure Evaluation Window → controls how long after an attempt the script can classify failure.
• Attempt Zone ATR → controls the thickness of the continuation attempt zone.
• Trap Wick Threshold → defines how much rejection quality is needed before a failure becomes trap context.
• Use Volume Confirmation → adds relative volume to trap-quality scoring.
• Projection Bars → controls how far zones, rails, and right-side tags project.
• Label Font Size → controls chart label and tag text size.
• Panel Font Size → controls panel text size.
🖥️ Interface & Visual Design
The visual hierarchy is built around the failed-continuation story.
The attempt zone shows where continuation was attempted.
The trap pocket shows where trapped participants may become part of the next narrative.
The opposite-pressure rail gives a clean reference for pressure confirmation.
The centered badge keeps the active trap context readable at first glance.
The AG Pro panel summarizes the current trap state without forcing the user to decode every element manually.
🧪 Practical Usage Workflow
1. Let the script identify the active continuation bias.
2. Watch for an attempt beyond recent structure.
3. Check whether the attempt holds or fails back through the zone.
4. If trap context appears, watch the opposite-pressure rail.
5. Use the panel to confirm trap state, trapped side, and quality scores.
6. Interpret the output inside broader trend, liquidity, volatility, and support/resistance context.
🔍 Interpretation Guidelines
A continuation attempt does not guarantee follow-through. It means price attempted to move beyond recent structure in the trend direction.
A trap active state does not guarantee reversal. It means the continuation attempt failed back through the attempt zone with enough quality to deserve attention.
Opposite pressure does not guarantee trend change. It means trapped participants may be adding pressure against the attempted continuation.
The strongest readings occur when trap state, pressure rail, and broader market context align.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed entry or exit signals.
It is not a generic breakout indicator.
It is not a simple reversal marker.
⚠️ Limitations & Transparency
EMA bias can lag during fast reversals.
Failure windows may miss slow-developing traps.
Low-liquidity markets can produce misleading wick behavior.
High volatility can make attempt zones wider or less stable.
Timeframe differences can change how continuation attempts appear.
The script is designed for structured interpretation, not certainty.
🧠 Market Context Notes
Failed continuation traps often matter most when traders are leaning heavily in one direction and price fails to reward that pressure.
The same failed attempt can have different meaning in a strong trend, range, liquidity sweep, or volatility shock.
The script should be read together with broader structure, volume, liquidity, and trend context.
🧾 Use Case Examples
• If price attempts upside continuation and then closes back below the attempt level with a strong upper wick, the script may show long-trap context.
• If price attempts downside continuation and then rejects back above the attempt level, the script may show short-trap context.
• If price continues beyond the pressure rail after a trap, the script may show opposite-pressure confirmation.
🧱 System Philosophy
Failed Continuation Trap Map is part of the AGPro Series approach to decision-support tools:
clear structure, premium chart readability, honest interpretation, and no promise of certainty.
The goal is to help traders see when continuation logic breaks, without turning every failure into a forced reversal signal.
🔐 Non-Promise Statement
No script can know the future.
No failed continuation guarantees reversal.
No signal should be interpreted without broader market context.
📉 Risk Disclosure
Trading involves risk.
Markets can move unpredictably.
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
📚 Educational Note
Use this script to study how continuation attempts fail and how trapped participants can affect the next phase of market behavior.
The value is not only in the trap label. The value is in learning when a continuation narrative is accepted, rejected, or converted into opposite pressure.
Indicador
Impulse Correction Balance Map [AGPro Series]Impulse Correction Balance Map
🧠 Core Idea
Is the current correction still healthy compared with the prior impulse, or is the impulse losing structural balance?
📌 Overview / What it does
Impulse Correction Balance Map is a rule-based impulse and correction visualization tool designed to compare the current pullback with the prior directional swing leg.
The script identifies a valid bullish or bearish impulse, measures correction depth, maps the healthy-to-balanced correction pocket, and highlights whether price is still respecting the impulse structure or moving into failure risk.
It does not predict price direction, automate trades, or guarantee continuation after a pullback. It is a structured market-structure and wave-analysis tool for reading impulse strength, correction depth, balance, continuation, and failure context.
🎯 Purpose & Design Philosophy
Many pullback tools mark a retracement or draw generic Fibonacci levels.
This script was built to answer a more practical question:
Is the correction proportionate to the impulse that created it?
The design goal is to help traders evaluate pullbacks as part of a complete impulse-correction relationship instead of treating every retracement as equal.
⚡ Why This Script Is Different
Most tools focus on static retracement levels, generic trend strength, or simple pullback labels.
This script does NOT mark every pullback as a clean opportunity.
Instead, it builds the impulse leg first, measures the correction against that leg, separates healthy correction, balanced pullback, deep correction, continuation, and failure risk, then displays the story through premium chart visuals and a compact AG Pro panel.
⚙️ Methodology
1. Swing Detection
The script uses confirmed swing pivots to identify meaningful bullish or bearish impulse legs.
2. Impulse Validation
An impulse must meet a minimum ATR-normalized size before it becomes the active reference leg.
3. Correction Mapping
After the impulse forms, the script tracks the deepest correction point and calculates retracement depth as a percentage of the impulse.
4. Balance Evaluation
Correction depth is classified into healthy, balanced, deep, continuation, or failure states.
5. Visual Output
The chart displays the impulse box, correction pocket, depth ladder, centered pocket label, right-side tags, event labels, alerts, and a compact AG Pro decision panel.
🗺️ How to Read the Chart
Impulse Box = the prior validated directional swing leg.
Correction Pocket = the projected healthy-to-balanced retracement area.
Depth Ladder = reference rails for shallow, balanced, and deep correction zones.
Centered Pocket Label = the main visual anchor for the active balance pocket and quality score.
Right-Side Tags = current correction depth, balance state, and continuation reference.
Event Labels = key moments such as healthy correction, deep correction, continuation, or correction failure.
Panel = summarizes balance state, impulse direction, correction depth, impulse size, quality score, next context, and timeframe.
🚦 Signals & States
• HEALTHY CORRECTION → correction depth remains shallow relative to the impulse.
• BALANCED PULLBACK → correction is deeper but still inside the normal balance area.
• DEEP CORRECTION → correction is pressing into a riskier retracement zone.
• HIGH FAILURE RISK → correction is beyond the preferred balance area.
• CONTINUATION → price extends beyond the impulse end in the impulse direction.
• CORRECTION FAIL → price invalidates the impulse start area.
• WAIT IMPULSE → no valid impulse reference is active yet.
🔔 Alerts Logic
Alerts trigger when a major impulse-correction state appears.
• Healthy Correction → correction remains inside the healthy retracement area.
• Deep Correction Risk → correction depth moves into the deep-correction risk area.
• Continuation Trigger → price breaks beyond the impulse end in the impulse direction.
• Correction Failure → correction invalidates the impulse start area.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• The impulse leg is large enough relative to ATR
• Correction depth remains proportionate
• Price respects the balance pocket
• Continuation appears after a controlled correction
• The panel state agrees with the event label
• Broader trend structure supports the impulse direction
If these elements do not align, the script avoids forcing a continuation interpretation.
📊 When to Use
• Trend continuation analysis
• Pullback evaluation
• Swing structure review
• Crypto, forex, stocks, and index markets
• Wave-style impulse and correction studies
• 1H, 4H, and daily charts
• Markets with clear directional legs and retracement behavior
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely choppy markets with no clear swing structure
• News-driven candles where pivots may be distorted
• Ultra-low timeframes with excessive noise
• Markets where every pullback is immediately invalidated by volatility
• Situations where a single retracement should not be treated as a standalone decision
🎛️ Key Inputs
• Swing Pivot Length → controls how swing highs and lows are confirmed.
• Minimum Impulse ATR → defines how large the impulse must be before it becomes active.
• ATR Length → normalizes impulse size, label spacing, and correction context.
• Healthy Correction Max % → defines the upper boundary of the shallow correction zone.
• Balance Correction Max % → defines the upper boundary of the balanced correction zone.
• Deep Correction Max % → defines the deep-correction risk boundary.
• Projection Bars → controls how far correction pockets, rails, and tags project.
• Label Font Size → controls chart label and tag text size.
• Panel Font Size → controls panel text size.
🖥️ Interface & Visual Design
The visual hierarchy is built around the impulse-correction relationship.
The impulse box shows the directional leg.
The correction pocket shows where a controlled retracement can remain balanced.
The depth ladder shows where the correction becomes shallow, balanced, deep, or risky.
The centered badge makes the pocket readable at first glance.
The AG Pro panel summarizes the current state without forcing the user to inspect every level manually.
🧪 Practical Usage Workflow
1. Wait for a valid impulse leg to appear.
2. Check the correction pocket and depth ladder.
3. Read the current balance state in the panel.
4. Watch whether the correction stays healthy, becomes deep, or fails.
5. Look for continuation only after the correction context remains controlled.
6. Interpret the result inside broader trend, liquidity, and volatility context.
🔍 Interpretation Guidelines
A healthy correction does not guarantee continuation. It means the retracement is still proportionate to the prior impulse.
A deep correction does not guarantee reversal. It means the pullback is approaching an area where the original impulse is less structurally clean.
A continuation trigger does not guarantee follow-through. It means price extended beyond the impulse end according to the script's rule set.
A correction failure is a structural warning, not a trading command.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed entry or exit signals.
It is not a standard Fibonacci retracement tool.
It is not a full Elliott Wave counter.
⚠️ Limitations & Transparency
Swing detection depends on pivot confirmation, so signals can appear after pivots are confirmed.
Timeframe differences can change impulse and correction structure.
High volatility may cause correction depth to expand quickly.
Low-liquidity markets may produce unreliable swing pivots.
The script is designed for structured interpretation, not certainty.
🧠 Market Context Notes
Impulse-correction behavior is strongest when the market has a clear directional leg, a readable retracement, and enough liquidity for swing structure to matter.
The same correction depth can mean different things in a strong trend, a range, or a volatility shock.
The script should be read together with broader structure, volume, volatility, and market regime.
🧾 Use Case Examples
• If a bullish impulse forms and the correction remains shallow, the map may show healthy correction context.
• If a bearish impulse forms and price retraces deeply against it, the map may show deep correction or failure risk.
• If price breaks beyond the impulse end after a controlled correction, the map may show continuation.
🧱 System Philosophy
Impulse Correction Balance Map is part of the AGPro Series approach to decision-support tools:
clear structure, premium chart readability, honest interpretation, and no promise of certainty.
The goal is to help traders understand the relationship between impulse strength and correction depth without turning analysis into signal spam.
🔐 Non-Promise Statement
No script can know the future.
No correction depth guarantees continuation or reversal.
No signal should be interpreted without broader market context.
📉 Risk Disclosure
Trading involves risk.
Markets can move unpredictably.
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
📚 Educational Note
Use this script to study how impulses and corrections relate to each other.
The value is not only in the label. The value is in learning whether a pullback is proportionate, stretched, balanced, or structurally weak compared with the impulse that came before it.
Indicador
Stop Cluster Magnet Map [AGPro Series]Stop Cluster Magnet Map
🧠 Core Idea
Where are clustered stops likely sitting, and is price being pulled toward them or rejecting after a sweep?
📌 Overview / What it does
Stop Cluster Magnet Map is a rule-based liquidity and market-structure visualization tool designed to identify repeated swing-high and swing-low areas where stop orders may cluster.
The script maps upper and lower stop-cluster zones, grades their quality, tracks magnet pressure, and highlights potential sweep or rejection behavior after price interacts with those zones.
It does not predict future price direction, automate trades, or claim that any stop cluster must be taken. It only visualizes structural conditions that may deserve attention.
🎯 Purpose & Design Philosophy
This script was built to solve a common chart-reading problem: traders often talk about liquidity above highs or below lows, but many tools do not clearly separate clustered stop areas from random swing points.
The design goal is to make stop-cluster context visible at a glance without turning the chart into a noisy signal machine.
It helps traders who study price action, liquidity sweeps, equal highs, equal lows, stop hunts, and structural reaction zones.
⚡ Why This Script Is Different
Most tools mark every swing high or swing low as if each level has the same importance.
This script does NOT treat every pivot as meaningful liquidity.
Instead, it looks for repeated nearby swing points, builds a mapped stop-cluster zone, grades the cluster, tracks magnet pressure, and separates sweep behavior from simple proximity.
⚙️ Methodology
1. Context Detection
The script detects confirmed swing highs and swing lows using a configurable pivot length.
2. Reference Mapping
Nearby repeated swing highs are grouped into an upper stop cluster, while nearby repeated swing lows are grouped into a lower stop cluster.
3. Reaction Evaluation
The script evaluates distance, recency, number of touches, sweep events, and post-sweep close behavior.
4. Visual Output
The active stop-cluster zones, magnet rail, right-side tags, event labels, and decision panel are displayed using a clean AGPro visual hierarchy.
🗺️ How to Read the Chart
Zones represent areas where repeated highs or lows have created potential clustered stops.
Labels identify important events such as upper stops, lower stops, magnet pressure, and sweep behavior.
Colors follow the AGPro visual language: teal for lower-side or recovery-oriented context, pink for upper-side or risk-oriented context, yellow for neutral attention, and indigo for magnet reference.
The panel summarizes the current magnet state, score, upper/lower cluster quality, cluster prices, sweep risk, next context, and active timeframe.
🚦 Signals & States
• UPPER STOPS → repeated swing highs have formed a valid upper stop cluster
• LOWER STOPS → repeated swing lows have formed a valid lower stop cluster
• UPSIDE MAGNET → price is near a higher-quality upper stop cluster
• DOWNSIDE MAGNET → price is near a higher-quality lower stop cluster
• UPPER SWEEP → price moved above the upper cluster and closed back inside
• LOWER SWEEP → price moved below the lower cluster and closed back inside
• BALANCED CLUSTERS → both upper and lower clusters are active, with no dominant side
🔔 Alerts Logic
Alerts can trigger when a new upper or lower stop cluster becomes valid, when price sweeps a stop cluster and closes back inside, or when the dominant magnet side changes.
These alerts are attention markers only. They are not buy or sell signals.
🧩 Confluence Logic (Optional)
The context becomes stronger when a valid stop cluster has multiple touches, remains recent, price approaches the cluster, and sweep behavior appears with a close back inside the mapped zone.
Cluster quality plus proximity plus reaction behavior creates a stronger read than any single condition alone.
📊 When to Use
• Around equal highs or equal lows
• During range-bound markets where stop pools may form
• Before or after liquidity sweeps
• When price is approaching a visible cluster of prior swing points
• When evaluating whether a move is targeting external liquidity
⚠️ When NOT to Use
• In extremely illiquid markets
• During chaotic news-driven candles
• When price history is too short to build reliable clusters
• When the chart is dominated by random spikes rather than readable structure
• As a standalone entry or exit system
🎛️ Key Inputs
• Swing Pivot Length → controls how swing highs and lows are confirmed
• Cluster Validity Lookback → controls how long a cluster remains relevant
• Minimum Cluster Touches → controls how many nearby pivots are needed
• Cluster Width ATR → controls how wide each stop-cluster grouping can be
• Magnet Nearness ATR → controls how sensitive magnet proximity becomes
• Visual settings → control zones, labels, right-side tags, panel, and font sizes
🖥️ Interface & Visual Design
The interface is designed for fast chart reading.
The panel gives the current decision context. Zones show where clustered stops may sit. Labels mark key events. Right-side tags keep current levels readable without forcing the trader to inspect every candle.
The layout is intentionally clean, premium, and structured for public-chart screenshots.
🧪 Practical Usage Workflow
1. Read the panel to identify the current magnet state.
2. Check whether the upper or lower stop-cluster zone is active.
3. Watch how price behaves near the mapped cluster.
4. Evaluate whether a sweep closes back inside or continues beyond the zone.
5. Use broader market context before making any decision.
🔍 Interpretation Guidelines
A strong stop cluster does not mean price must move there.
A sweep does not automatically mean reversal.
The best interpretation comes from combining cluster quality, distance, market structure, volume behavior, volatility, and the trader's own higher-timeframe context.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an automated trading system.
It does not provide guaranteed signals.
It does not know where actual broker stop orders are placed.
⚠️ Limitations & Transparency
The script estimates stop-cluster areas using visible chart structure only.
Different timeframes may show different clusters.
High volatility can expand zones and change quality scores quickly.
Market conditions can shift, and a previously important cluster may lose relevance over time.
🧠 Market Context Notes (Optional)
Stop clusters often matter because repeated highs and lows can become obvious reference points.
When many traders see the same level, price may react around that area, sweep it, reject from it, or continue through it.
This script is designed to make that structural pressure easier to observe.
🧾 Use Case Examples (Optional)
When price approaches an upper stop cluster with a high quality score, the trader can monitor whether the market sweeps above it and closes back inside.
When lower stops cluster beneath a range, the trader can watch whether price is being pulled toward downside liquidity or rejecting before reaching it.
🧱 System Philosophy (Advanced)
The AGPro approach focuses on structured decision support, not hype.
This script turns repeated swing references into a readable liquidity map so traders can evaluate context instead of reacting to isolated candles.
🔐 Non-Promise Statement
No script can guarantee outcomes.
Stop-cluster mapping is a contextual tool, not certainty.
📉 Risk Disclosure
Trading involves risk.
Users are fully responsible for their own analysis, risk management, and trading decisions.
This script is provided for educational and analytical purposes only and does not constitute financial advice.
📚 Educational Note (Optional)
Use this tool to study how repeated highs, repeated lows, sweeps, and reactions appear across different timeframes.
The goal is to improve market observation, not to replace disciplined analysis. Indicador
Opening Auction Trap Map [AGPro Series]Opening Auction Trap Map
🧠 Core Idea
Did the opening auction accept value, reject an early extreme, or trap breakout participants?
📌 Overview / What it does
Opening Auction Trap Map is an intraday session-open analysis tool built to study the first auction window of the trading session.
The script builds an opening auction box, tracks the auction high and low, draws an acceptance rail, maps upper and lower failed-auction trap zones, and classifies whether price is accepting outside the auction or rejecting back into the range.
It does not predict price direction, automate trades, or claim that every opening trap will create a reversal. It is a structured visualization and decision-support tool for intraday auction context.
🎯 Purpose & Design Philosophy
Many opening-range tools focus only on breakout direction.
This script was built to answer a more precise auction question:
Was the opening move accepted, or did it trap traders who chased the first extreme?
The design goal is to help intraday traders read the opening range as an auction behavior map instead of treating it as a simple breakout box.
⚡ Why This Script Is Different
Most ORB tools mark the opening high and low, then wait for a breakout.
This script does NOT treat every opening breakout as valid.
Instead, it checks whether the move accepts beyond the auction edge, fails back inside the auction range, or retests a failed edge. The focus is auction behavior, trap risk, range control, and acceptance quality.
⚙️ Methodology
1. Opening Auction Window
The script tracks high, low, and midpoint during the selected opening auction window.
2. Auction Box and Rails
After the auction completes, the script projects the auction box, upper and lower trap zones, and the midpoint acceptance rail.
3. Failed-Auction Detection
If price breaks above the auction high and closes back inside the range with enough upper-wick rejection, the script can mark an upper auction trap.
If price breaks below the auction low and closes back inside the range with enough lower-wick rejection, the script can mark a lower auction trap.
4. Acceptance Evaluation
If price holds beyond the auction edge for the required number of closes, the script can mark accepted movement above or below the auction.
5. Visual Output
The chart displays the auction box, trap zones, acceptance rail, event labels, right-side tags, alerts, and a compact AG Pro panel.
🗺️ How to Read the Chart
Opening Auction Box = the high-low range created during the selected opening window.
Acceptance Rail = the midpoint of the opening auction range.
Upper Trap Zone = the area around the auction high where failed upside breakouts may be evaluated.
Lower Trap Zone = the area around the auction low where failed downside breakouts may be evaluated.
UPPER AUCTION TRAP = price failed above the auction high and closed back inside the range.
LOWER AUCTION TRAP = price failed below the auction low and closed back inside the range.
ACCEPT UP = price accepted above the auction high.
ACCEPT DOWN = price accepted below the auction low.
Panel = summarizes auction state, quality score, auction high/low, range control, trap risk, next context, session window, and timeframe scope.
TF Scope = shows whether the current chart timeframe is inside the supported auction-building range.
🚦 Signals & States
• UPPER TRAP → upside auction breakout failed back inside the range.
• LOWER TRAP → downside auction breakout failed back inside the range.
• ACCEPT UP → price accepted above the auction high.
• ACCEPT DOWN → price accepted below the auction low.
• RANGE CONTROL → price is trading inside the auction range.
• ABOVE AUCTION → price is above the auction high but not yet classified as accepted.
• BELOW AUCTION → price is below the auction low but not yet classified as accepted.
• BUILDING → the opening auction window is still forming.
🔔 Alerts Logic
Alerts trigger when a new major auction behavior state appears.
• Upper Opening Auction Trap → price failed above the auction high and closed back inside the range.
• Lower Opening Auction Trap → price failed below the auction low and closed back inside the range.
• Accepted Above Opening Auction → price accepted above the opening auction high.
• Accepted Below Opening Auction → price accepted below the opening auction low.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• The auction range is clearly formed
• Price probes an auction edge
• The close rejects back inside the range
• Wick quality is strong
• Relative volume confirms participation
• The panel state agrees with the event label
If these elements do not align, the script avoids forcing a trap interpretation.
📊 When to Use
• Intraday session-open analysis
• Opening range review
• ORB validation and failed-breakout detection
• Equity index, stock, futures, forex, and crypto session studies
• 1m, 3m, 5m, 15m, 30m, and 1H charts
• Markets where the selected opening session has meaning
⚠️ When NOT to Use
• Daily, weekly, or monthly charts
• Symbols without a meaningful session open
• Very low-liquidity assets
• Extremely noisy markets where wick behavior is unreliable
• Charts where the selected auction window does not match the actual market session
• Situations where a single opening range should not be over-interpreted
🎛️ Key Inputs
• Opening Auction Window → defines the session segment used to build the auction range.
• Active Session Window → defines the session where post-auction behavior is evaluated.
• Max Chart TF Minutes → defines the largest chart timeframe that should build the auction map. With the default 09:30-10:00 auction window, 30m and lower charts are the intended use.
• Acceptance Close Count → sets how many closes are required before a breakout is treated as accepted.
• Trap Evaluation Window → limits how long after the auction trap logic remains active.
• Trap Wick Quality Threshold → controls how strong the rejection wick must be before a trap label appears.
• Use Volume Confirmation → adds relative volume to quality scoring.
• Trap Zone Width ATR → controls the thickness of the upper and lower trap zones.
• Event Label Mode → Premium focuses on traps and accepted moves. Detailed also allows lower-priority retest labels.
• Projection Bars → controls how far the auction structure projects to the right.
🖥️ Interface & Visual Design
The visual hierarchy is built around the auction range:
The box defines the opening auction.
Trap zones frame the dangerous edges.
The midpoint rail shows range control.
Event labels mark important acceptance or failure behavior.
The AG Pro panel summarizes the current auction state without requiring the user to decode every element manually.
🧪 Practical Usage Workflow
1. Select the opening auction window that matches the market.
2. Wait until the auction box completes.
3. Watch how price behaves around the auction high and low.
4. Check whether price accepts beyond the edge or fails back inside the range.
5. Use the panel to confirm auction state, quality score, range control, and trap risk.
6. Interpret the output inside broader market context.
🔍 Interpretation Guidelines
An upper trap does not guarantee a selloff. It means the auction high was probed and rejected back inside the range.
A lower trap does not guarantee a rally. It means the auction low was probed and rejected back inside the range.
Accepted movement does not guarantee continuation. It means price has held beyond the auction edge according to the script’s rule set.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed entry or exit signals.
It is not a standard ORB breakout strategy.
⚠️ Limitations & Transparency
Session settings matter. A poorly selected auction window can produce weak context.
Higher chart timeframes may not capture the opening auction precisely.
Low-liquidity markets may generate misleading wicks.
Gap-heavy markets may require wider interpretation.
The script is designed for intraday auction reading, not long-term chart analysis.
🧠 Market Context Notes
The opening auction is often useful because it reveals early participation, imbalance, and willingness to accept price outside the first range.
Failed extremes can matter because they show where early breakout attempts were rejected.
Acceptance can matter because it shows where the market was willing to continue trading beyond the auction edge.
🧾 Use Case Examples
If price breaks above the auction high but closes back inside the range with a strong upper wick, the script may mark UPPER AUCTION TRAP.
If price breaks below the auction low but closes back inside the range with a strong lower wick, the script may mark LOWER AUCTION TRAP.
If price closes above the auction high for the required number of bars, the script may mark ACCEPT UP.
If price closes below the auction low for the required number of bars, the script may mark ACCEPT DOWN.
🧱 System Philosophy
This script follows a behavior-first approach:
Auction first.
Edge reaction second.
Acceptance third.
Trap risk fourth.
The goal is to reduce blind breakout thinking and encourage structured opening-session interpretation.
🔐 Non-Promise Statement
No script can guarantee outcomes.
No auction edge, trap label, acceptance state, or quality score should be treated as certainty.
The output should always be interpreted with broader structure, liquidity, volatility, and personal risk rules.
📉 Risk Disclosure
Trading involves risk.
Markets can move against any interpretation.
This script is for educational and analytical purposes only.
Users are fully responsible for their own decisions.
📚 Educational Note
Use this script to study how the market behaves around the opening auction and whether early extremes are accepted or rejected.
Indicador
Liquidity Timeframe Stack Map [AGPro Series]Liquidity Timeframe Stack Map
🧠 Core Idea
Are lower-timeframe liquidity sweeps aligned with the higher-timeframe liquidity shelf, or are they fighting the broader structure?
📌 Overview / What it does
Liquidity Timeframe Stack Map is a multi-timeframe liquidity context tool built to compare current-chart sweep behavior with higher-timeframe liquidity shelves.
The script maps the latest confirmed higher-timeframe upper and lower liquidity shelves, detects local buy-side and sell-side sweeps, evaluates wick-based reaction quality, and converts the result into a readable stack state.
It does not predict price direction, automate trades, or claim that every sweep will create a reversal. It is designed as a structured market context and visualization tool.
🎯 Purpose & Design Philosophy
This script was built to solve a common liquidity-reading problem:
A lower-timeframe sweep can look important by itself, but its meaning changes when it happens near a higher-timeframe shelf.
The goal is to help traders separate aligned liquidity reactions from isolated local noise. The script supports a context-first mindset: read the shelf, read the sweep, then judge whether the reaction is aligned or conflicting.
⚡ Why This Script Is Different
Most liquidity tools focus on detecting a sweep, stop run, equal high, or equal low.
This script does NOT treat every sweep as equally important.
Instead, it compares the local sweep against a higher-timeframe liquidity framework and classifies whether the move is a stack alignment, a stack conflict, or a neutral shelf interaction.
⚙️ Methodology
1. Higher-Timeframe Shelf Detection
The script reads confirmed pivot structure from the selected higher timeframe and builds active upper and lower liquidity shelf zones.
2. Local Sweep Detection
The chart timeframe is used as the lower-timeframe layer. Local buy-side and sell-side sweeps are detected when price takes a recent pivot level and closes back through it.
3. Reaction Evaluation
The script evaluates wick reaction quality after the sweep. Stronger wick rejection or reclaim behavior produces a higher reaction quality score.
4. Stack Classification
The script checks whether the local sweep occurred near the relevant higher-timeframe shelf. If the sweep and shelf context align, the script marks an HTF Buy Stack or HTF Sell Stack. If the sweep fights the broader shelf context, it marks a Stack Conflict.
5. Visual Output
The result is displayed through HTF shelf zones, sweep markers, stack labels, right-side tags, alerts, and a compact AG Pro panel.
🗺️ How to Read the Chart
Upper HTF Liquidity Shelf = the active higher-timeframe upper liquidity reference.
Lower HTF Liquidity Shelf = the active higher-timeframe lower liquidity reference.
Buy-Side Sweep marker = price swept a local upper liquidity reference and closed back below it.
Sell-Side Sweep marker = price swept a local lower liquidity reference and closed back above it.
HTF Buy Stack label = a sell-side sweep reacted near the lower HTF shelf with enough reaction quality.
HTF Sell Stack label = a buy-side sweep reacted near the upper HTF shelf with enough reaction quality.
Stack Conflict label = the local sweep behavior is not cleanly aligned with the broader HTF shelf context.
Panel = summarizes stack state, stack score, HTF shelves, LTF sweep state, reaction quality, next context, and invalidation reference.
🚦 Signals & States
• HTF BUY STACK → sell-side liquidity was swept near the lower higher-timeframe shelf with a qualifying reaction.
• HTF SELL STACK → buy-side liquidity was swept near the upper higher-timeframe shelf with a qualifying reaction.
• STACK CONFLICT → local sweep behavior is fighting or confusing the broader shelf context.
• LOWER SHELF → price is interacting with the lower HTF shelf area, but no full stack event is active.
• UPPER SHELF → price is interacting with the upper HTF shelf area, but no full stack event is active.
• NEUTRAL → no active shelf alignment or conflict is detected.
🔔 Alerts Logic
Alerts trigger when a new major stack condition appears.
• HTF Buy Stack Alignment → a sell-side sweep aligns with the lower higher-timeframe liquidity shelf.
• HTF Sell Stack Alignment → a buy-side sweep aligns with the upper higher-timeframe liquidity shelf.
• Liquidity Stack Conflict → the local sweep direction conflicts with the broader higher-timeframe shelf context.
• HTF Liquidity Shelf Touch → price enters either active higher-timeframe shelf zone.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when these elements align:
• Price is near an active higher-timeframe shelf
• Local liquidity is swept
• The candle closes back through the swept level
• Wick reaction quality is strong
• The panel state and chart label agree
When these elements do not align, the script treats the context as neutral or conflicting instead of forcing a directional interpretation.
📊 When to Use
• Multi-timeframe liquidity analysis
• Swing and intraday market preparation
• Smart-money-style structure review
• Sweep and reclaim evaluation
• Context checks before interpreting local reactions
• Markets where higher-timeframe levels matter
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy lower timeframes
• Markets with unreliable wick structure
• Situations where the selected higher timeframe is not meaningful
• Assets with large gaps or inconsistent session data
• Moments when a single local candle should not be over-interpreted
🎛️ Key Inputs
• Higher Timeframe Shelf → selects the timeframe used to build the broad liquidity shelves.
• HTF Shelf Pivot Length → controls how strict the higher-timeframe shelf structure is.
• LTF Sweep Pivot Length → controls how local sweep references are detected.
• Shelf Zone Width ATR → adjusts the visual thickness of HTF shelf zones.
• Max Shelf Width % Range → caps shelf thickness relative to the distance between the upper and lower HTF shelves, keeping the visual structure clean on wide timeframes.
• Near Shelf Distance ATR → controls how close a sweep must be to a shelf to count as aligned.
• Reaction Quality Threshold → sets the minimum wick reaction required for a strong stack event.
• Stack Score Smoothing → smooths the panel score for cleaner interpretation.
• Visual settings → control shelves, equilibrium line, sweep markers, event labels, right-side tags, and font sizes.
• Show Sweep Marker Letters → adds optional BS / SS text to local sweep markers. The default publication view keeps this disabled for a cleaner chart.
• Event Label Mode → Premium labels only strong HTF stack alignments. Detailed also labels stack conflicts.
• Adaptive Label Layout → automatically shortens and separates shelf labels when higher timeframes compress the HTF shelf cluster.
• Event Label Offset ATR → moves stack event labels farther from candles and shelf-center labels. HTF Sell Stack labels are pushed above the upper shelf zone, while HTF Buy Stack labels are pushed below the lower shelf zone to reduce overlap on publication screenshots.
• Right-side tags use adaptive positioning so the STACK tag avoids crowding the HTF UPPER and HTF LOWER tags when price is near a shelf.
🖥️ Interface & Visual Design
The interface is built around a clear visual hierarchy:
HTF shelves show the broader liquidity map.
Sweep markers show local liquidity events.
Stack labels show important alignment or conflict moments.
The AG Pro panel compresses the current state into a fast, readable decision-support summary.
🧪 Practical Usage Workflow
1. Start with the panel state.
2. Check where price is relative to the HTF upper and lower shelves.
3. Look for a recent buy-side or sell-side sweep marker.
4. Read the event label only if the sweep happened near the relevant shelf.
5. Use Reaction Q and Stack Score to judge whether the context is clean or weak.
6. Interpret the result inside the broader market structure.
🔍 Interpretation Guidelines
HTF Buy Stack does not mean price must go up. It means a sell-side sweep reacted near a lower higher-timeframe shelf with enough quality to deserve attention.
HTF Sell Stack does not mean price must go down. It means a buy-side sweep reacted near an upper higher-timeframe shelf with enough quality to deserve attention.
Stack Conflict is often more useful as a warning than as a signal. It tells the trader that the local sweep and broader shelf context are not cleanly aligned.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed entry or exit signals.
It does not claim that every liquidity sweep will reverse.
⚠️ Limitations & Transparency
Higher-timeframe pivot shelves are confirmed after structure develops, so they are not instant future levels.
Different chart timeframes may create different local sweep readings.
Very volatile markets may generate fast shelf touches without clean reactions.
Low-liquidity symbols may produce misleading wick behavior.
The selected higher timeframe should match the trader’s actual analysis horizon.
🧠 Market Context Notes
Liquidity analysis is strongest when local behavior is interpreted inside a broader structure.
A sweep near a meaningful higher-timeframe shelf can carry more information than a random sweep in the middle of a range.
This script is designed to make that distinction visible.
🧾 Use Case Examples
When price sweeps local sell-side liquidity near the lower HTF shelf and closes back above the swept level, the script may mark HTF BUY STACK if reaction quality is strong enough.
When price sweeps local buy-side liquidity near the upper HTF shelf and closes back below the swept level, the script may mark HTF SELL STACK if reaction quality is strong enough.
When a local sweep appears away from the relevant higher-timeframe shelf, the script may classify the move as neutral or conflicting.
🧱 System Philosophy
The script follows a context-first AGPro approach:
Structure first.
Liquidity second.
Reaction third.
Decision support last.
It is designed to reduce isolated signal thinking and encourage multi-timeframe interpretation.
🔐 Non-Promise Statement
No script can guarantee outcomes.
No shelf, sweep, score, or label should be treated as certainty.
The output should always be combined with broader market context and personal risk rules.
📉 Risk Disclosure
Trading involves risk.
Markets can move against any interpretation.
This script is for educational and analytical purposes only.
Users are fully responsible for their own decisions.
📚 Educational Note
Use this script to study how lower-timeframe liquidity behavior changes when it is read against higher-timeframe structure.
Indicador
Body Close Break Planner [AGPro Series]TITLE
Body Close Break Planner
🧠 Core Idea
Did price break structure with real body-close acceptance, or was the move only a wick event with weak commitment?
📌 Overview / What it does
Body Close Break Planner is built to evaluate whether a structure break is being accepted with real candle-body commitment. Instead of reacting to every wick beyond a prior high or low, the script focuses on closes that actually establish acceptance beyond the rail.
The script maps the body break rail, an acceptance pocket, a retest shelf, a failure rail, and a first target-room reference. It also adds event labels, right-side tags, and a compact AG Pro panel that summarizes the quality of the active break with a 0-100 Body Break Score.
This script does not predict trend continuation, automate entries, or treat every breakout as valid. It is a rule-based analytical and visualization tool that helps users separate real body-close structure acceptance from weaker noise-driven break attempts.
🎯 Purpose & Design Philosophy
This script was built to solve a very common structural problem: many breakout candles look convincing in the moment, but the move fails because the market never achieved real closing acceptance beyond the level.
The tool was designed for traders who want to evaluate whether a break has genuine body-based commitment, whether the first retest is constructive, and where the structure fails if acceptance is lost.
The mindset behind the script is selective, disciplined, and evidence-based. It supports traders who want to read acceptance quality rather than react to every temporary excursion beyond a level.
⚡ Why This Script Is Different
Most breakout tools focus on level crossing, wick penetration, or generic break-and-retest behavior.
This script does NOT treat every breach of structure as a meaningful breakout.
Instead, it asks whether the move closed through structure with enough body commitment, whether price is still being accepted beyond the rail, whether the retest shelf improves the setup, and whether the move still has room before it becomes extended or fails.
⚙️ Methodology
1. Context Detection
The script maps recent structure highs and lows, then checks whether price closes beyond them with enough candle-body commitment and range expansion.
2. Reference Mapping
Once a valid body-close break is confirmed, the script locks the broken rail, builds an acceptance pocket, marks a retest shelf, and defines a failure line plus a first target-room reference.
3. Reaction Evaluation
Price is then reviewed against the body-break rail and the retest shelf. The script checks whether the move is still accepted, whether the retest improves the structure, or whether the breakout falls back through the failure boundary.
4. Visual Output
The final output includes the acceptance pocket, body-break rail, retest shelf, failure rail, room line, event labels, right-side tags, and dashboard panel.
🗺️ How to Read the Chart
Zones:
The acceptance pocket represents the active post-break area where structure acceptance is being judged.
Labels:
Labels identify new bullish or bearish body-close breaks, accepted structure, retest-ready behavior, target review, and failed breaks.
Colors:
Teal represents stronger constructive break behavior.
Pink represents bearish or failed context.
Gold represents review areas such as target-room interaction.
Indigo represents the main body-break rail.
Panel:
The panel summarizes the active break type, the Body Break Score, current acceptance quality, available room, and the current action state.
🚦 Signals & States
• Bull Break → A bullish body-close structure break has been detected.
• Bear Break → A bearish body-close structure break has been detected.
• Body Accepted → Price is still being accepted beyond the broken structure rail.
• Retest Ready → Price interacted with the retest shelf constructively and the setup quality improved.
• Target Review → The first projected room reference has been reached and context should be reassessed.
• Failed → Price moved back through the failure boundary and the break is no longer structurally clean.
• Wait Break → No valid active body-close break exists.
• Expired → The break is too old to remain active within the current framework.
🔔 Alerts Logic
Alerts can trigger when a new bullish or bearish body-close break is detected, when structure remains accepted, when a retest shelf strengthens the setup, when target room is reached, or when the break fails.
Alerts are attention markers only. They highlight structural events inside the script logic. They are not trade instructions, automated entries, or guarantees of follow-through.
🧩 Confluence Logic
The context becomes stronger when multiple conditions align together.
For example, a structure break with a strong body ratio, clean range expansion, stable hold beyond the break rail, and a constructive retest shelf interaction is much stronger than a shallow close that immediately falls back into the old range.
When body commitment, breakout range, retest quality, and available room align together, the context becomes structurally more reliable.
📊 When to Use
• Breakout or breakdown environments where close quality matters
• Markets with clean price structure and readable swing levels
• Crypto, forex, indices, and liquid stocks
• 1H, 4H, and 1D chart review
• Situations where wick-only breaks create repeated false positives
⚠️ When NOT to Use
• Illiquid markets with distorted price prints
• Extremely noisy sessions with poor candle quality
• Very low-range environments where closes carry little structural information
• Symbols dominated by gaps or erratic price jumps
• Conditions where the market repeatedly overshoots levels without clean follow-through
🎛️ Key Inputs
• Structure Lookback → Controls how recent highs and lows are mapped
• Minimum Range Ratio → Controls how much expansion is required before a break qualifies
• Minimum Body / Range → Filters out weak closes and wick-dominant candles
• Close Buffer ATR → Controls how far beyond structure the close must finish
• Acceptance Pocket ATR → Controls the depth of the post-break pocket
• Retest Shelf Buffer → Controls how shelf interactions are interpreted
• Failure Buffer ATR → Controls where the active break becomes invalid
• Visual Settings → Control labels, panel location, theme, font size, and optional chart styling
🖥️ Interface & Visual Design
The interface is designed to answer one question quickly: is this break actually being accepted?
The panel creates a clean information hierarchy so the user can understand break state, score, room, and current action without reading every chart element manually. The chart layer keeps the acceptance pocket, body-break rail, failure line, and room reference readable without overwhelming candles.
The visual intent is professional, premium, and publication-friendly rather than decorative.
🧪 Practical Usage Workflow
1. Read the panel to confirm whether a valid body-close break is active
2. Check the body-break rail and acceptance pocket
3. Evaluate whether price is simply holding or whether the retest shelf improved the structure
4. Review room to the target reference and distance to failure
5. Use labels and tags as context markers, not as direct commands
🔍 Interpretation Guidelines
A stronger score suggests better body commitment, healthier range expansion, and more reliable post-break structure.
A Body Accepted state means price is still holding beyond the broken rail, but it does not automatically mean the move is early or low-risk.
A Retest Ready state suggests the market pulled back in a controlled way and defended the structure more convincingly.
A Target Review state suggests that the first projected room objective has already been reached and the context should be reassessed rather than assumed to continue indefinitely.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an automated trading system.
This script does not place orders.
This script does not guarantee continuation, retest success, target reach, or profitability.
⚠️ Limitations & Transparency
This script is rule-based and depends on the quality of the underlying market structure.
Different timeframes can produce very different break quality profiles. In high-volatility or low-liquidity conditions, candle closes may appear meaningful while still failing quickly. In some markets, wick behavior may remain important even when the body-close break model is intentionally strict.
Outputs should always be interpreted within broader market context rather than in isolation.
🧠 Market Context Notes
Body-close acceptance often matters most around obvious swing highs, swing lows, range edges, and post-compression expansion points.
A wick beyond structure can attract attention, but a true close beyond structure often tells a more reliable story about commitment. Even so, not every accepted break becomes a trend. Some become retest traps, and some run directly into higher-timeframe resistance or support.
🧾 Use Case Examples
Example 1:
Price closes above a well-defined swing high with a strong body and good expansion. The script marks a bull break, builds the acceptance pocket, and later upgrades the context when the retest shelf holds.
Example 2:
Price breaks below a swing low with body commitment, but then quickly closes back through the failure boundary. The script marks the break as failed, signaling that the downside acceptance did not hold.
Example 3:
A strong body-close break remains accepted and quickly reaches the first target-room line. The script marks target review, reminding the user to reassess efficiency and extension.
🧱 System Philosophy
AGPro Series tools are built as decision-support frameworks, not generic signal generators.
The philosophy here is to reward quality over noise: stronger closes, cleaner acceptance, clearer structure, and more readable post-break behavior.
🔐 Non-Promise Statement
This script does not promise certainty.
It does not promise that a body-close break will continue, hold, retest cleanly, or reach its projected room. It only organizes the structure so the user can evaluate the break with more discipline and clarity.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly, and any analytical tool can become less reliable under shifting volatility, liquidity, or structural conditions. Users remain fully responsible for their own decisions, execution, and risk management.
This script is for educational and analytical purposes only. It does not provide financial advice.
📚 Educational Note
This tool is most effective when combined with broader market structure, liquidity awareness, and disciplined trade management.
It is designed to improve interpretation quality, not to replace critical thinking.
Indicador
Volume Spike Aftershock Planner [AGPro Series]Volume Spike Aftershock Planner
🧠 Core Idea
After a volume spike, is price actually defending the impulse, absorbing it, or losing control completely?
📌 Overview / What it does
Volume Spike Aftershock Planner is designed to evaluate what happens after an abnormal volume expansion candle appears on the chart. Instead of stopping at the spike itself, the script studies the post-impulse behavior and organizes that structure into a readable decision-support framework.
The script maps a spike anchor, an active aftershock band, a failure boundary, and a target-room reference. It also produces contextual labels, right-side price tags, and a compact information panel that summarizes the current aftershock condition with a rule-based score.
This script does not attempt to predict the next candle, automate entries, or generate guaranteed continuation signals. It is an analytical visualization tool that helps users judge whether the spike is still being respected, partially absorbed, or fully invalidated.
🎯 Purpose & Design Philosophy
This script was built to solve a common gap in volume analysis.
Most traders can see when volume suddenly expands. The harder question is what to do with that information after the impulse bar closes. A large volume candle can lead to continuation, rejection, absorption, or complete failure, and those outcomes do not deserve the same interpretation.
This tool helps traders who want a more structured way to read post-spike behavior. It supports a patient, evidence-based mindset by focusing on participation quality, impulse defense, failure thresholds, and available room rather than hype or prediction.
⚡ Why This Script Is Different
Most volume tools focus on spike detection, raw histogram expansion, or one-bar climax alerts.
This script does NOT stop at identifying unusual participation.
Instead, it tracks the aftershock environment that forms after the spike, measures whether price is holding the impulse anchor, maps when the move is being absorbed, and highlights when the context has either matured or failed. The result is not just a volume event marker, but a structured framework for interpreting what the spike still means.
⚙️ Methodology
1. Context Detection
The script scans for abnormal volume participation and range expansion relative to recent behavior. It also reviews body quality so that weak, indecisive candles are filtered more carefully.
2. Reference Mapping
Once a valid spike is confirmed, the script establishes a spike anchor and builds an aftershock band around that reference. It also defines a failure boundary and a room projection.
3. Reaction Evaluation
Price is then evaluated relative to the anchor and surrounding rails. The script checks whether the impulse is being defended, fading back through the anchor, or failing beyond the allowed structure.
4. Visual Output
The final output includes the aftershock band, anchor reference, room line, failure line, event labels, right-side tags, optional bar coloring, and a dashboard panel that summarizes the current state.
🗺️ How to Read the Chart
Zones:
The aftershock band represents the active post-spike area where the market is being evaluated. It is the main structure zone for interpreting whether the impulse still matters.
Labels:
Labels mark important contextual events such as bull spike, bear spike, holding behavior, absorbed behavior, target review, and failure.
Colors:
Teal highlights constructive bullish behavior or defended impulse structure.
Pink highlights bearish structure, invalidation, or failed context.
Gold highlights review areas such as absorption or target-room interaction.
Indigo highlights the spike anchor reference.
Panel:
The panel summarizes the spike state, the Aftershock Score, participation quality, available room, and the current action state.
🚦 Signals & States
• Bull Spike → A bullish high-participation impulse anchor has been detected.
• Bear Spike → A bearish high-participation impulse anchor has been detected.
• Holding → Price is still defending the impulse structure after the spike.
• Aftershock Ready → The post-spike condition is strong enough to deserve active attention.
• Absorbed → Price has moved back through the anchor and the impulse is losing control.
• Target Review → The projected first room objective has been reached and context should be reassessed.
• Failed → The active aftershock structure has broken down beyond the allowed limit.
• Wait Spike → No valid active spike context is currently available.
• Expired → The spike is too old to remain actionable within the current framework.
🔔 Alerts Logic
Alerts can trigger when a new bullish or bearish spike is detected, when price begins to hold the impulse, when the aftershock condition becomes ready, when the move becomes absorbed, when target room is reached, or when the context fails.
These alerts are attention markers only. They highlight a structural event inside the script logic. They are not trade instructions, automated entries, or guarantees of follow-through.
🧩 Confluence Logic
The context becomes stronger when multiple conditions align at the same time.
For example, a high relative-volume spike with strong candle expansion, defended anchor structure, stable participation decay, and clear room beyond the band creates a much stronger environment than a spike that immediately collapses back through its reference level.
This confluence logic is what separates a meaningful aftershock structure from a noisy one-bar event.
📊 When to Use
• Markets with reliable volume behavior
• Crypto pairs with clean participation swings
• Stocks and indices with readable impulse candles
• Breakout or breakdown follow-through evaluation
• Continuation review after a strong reaction candle
• 1H, 4H, and 1D chart studies where impulse quality matters
⚠️ When NOT to Use
• Illiquid symbols with distorted or unreliable volume
• Extremely noisy low-range environments
• Symbols where volume feed quality is poor
• Isolated one-bar anomalies with no structural follow-through
• Extreme volatility conditions where impulse rails become unstable too quickly
🎛️ Key Inputs
• Relative Volume Length → Controls the participation baseline used for spike comparison.
• Minimum Relative Volume → Controls how large the volume expansion must be before the candle qualifies as a spike.
• Minimum Range Ratio → Controls how much price expansion is required.
• Minimum Body Ratio → Filters out weak spike candles with poor body commitment.
• Aftershock Band ATR → Controls the depth of the active aftershock zone.
• Failure Buffer → Controls how far price can move before the spike idea is considered broken.
• Minimum Ready Score → Controls how strict the script is before showing stronger actionable states.
• Visual Settings → Control labels, panel location, theme, font size, and optional chart styling.
🖥️ Interface & Visual Design
The visual design is built around clarity at first glance.
The panel gives a fast structural summary without forcing the user to inspect every line manually. The chart layer uses premium contrast and a clear hierarchy so the aftershock band, anchor, failure boundary, and room references remain readable without overwhelming the candles.
The goal is not decoration. The goal is clean interpretation under live market conditions.
🧪 Practical Usage Workflow
1. Read the panel to understand the current spike state and score.
2. Check whether a valid spike anchor and aftershock band are active.
3. Evaluate whether price is holding, absorbed, or failing relative to the anchor.
4. Review available room and decide whether the current context is mature, early, or already extended.
5. Use labels and tags as structured context markers, not as automatic commands.
🔍 Interpretation Guidelines
Treat the script as a structured reading framework.
A stronger score suggests that the spike had better participation, cleaner range expansion, and more stable post-spike structure. A weaker score suggests that the move may be losing informational value.
An absorbed state does not mean reversal is guaranteed. It means the original impulse is no longer being defended as cleanly as before.
A target-review state does not mean the move must stop. It means the first projected room objective has already been reached and the user should reassess the context rather than assuming endless continuation.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a financial advice tool.
It is not an automated trading system.
It is not a broker integration.
It does not place orders.
It does not guarantee continuation, reversal, or profitability.
⚠️ Limitations & Transparency
This script is rule-based and depends on the quality of the underlying market data.
Timeframe changes can materially alter how spikes, bands, and room projections appear. High-volatility environments can also reduce the stability of post-spike structures. In thin or distorted markets, volume expansion may look meaningful while carrying very little analytical value.
The script should always be interpreted in broader market context rather than in isolation.
🧠 Market Context Notes
Volume spikes are often strongest when they appear at meaningful structure transitions, liquidity shifts, or expansion points where the market is forced to reveal intent.
That said, not every spike represents sustainable conviction. Some are exhaustion bursts, some are absorption events, and some are temporary reactions inside a larger opposing structure. The aftershock behavior is often more important than the spike itself.
🧾 Use Case Examples
Example 1:
Price breaks above a local range with a large bullish volume surge. The script marks a bull spike, price holds above the anchor, and the panel shifts into a stronger aftershock state. This suggests the impulse still deserves attention.
Example 2:
Price prints a large bearish impulse, but then quickly moves back through the anchor. The script shifts into an absorbed condition, signaling that the original downside impulse is losing control.
Example 3:
A high-volume move expands sharply, then reaches the target-room area. The script marks target review, reminding the user to reassess the move rather than assuming continuation is still efficient.
🧱 System Philosophy
AGPro Series tools are designed as decision-support frameworks, not signal vending machines.
The philosophy is simple: map structure clearly, make states readable, reduce noise, and help the user think better around live price behavior.
🔐 Non-Promise Statement
This script does not promise certainty.
It does not promise that a volume spike will continue, reverse, hold, or fail in any predetermined way. It simply organizes the available structure so the user can evaluate the situation with more clarity.
📉 Risk Disclosure
Trading and investing involve risk.
Market conditions can change quickly, and any analytical tool can produce outputs that become invalid under new volatility, liquidity, or structural conditions. Users remain fully responsible for their own decisions, risk management, and execution.
This script is provided for educational and analytical purposes only. It is not financial advice.
📚 Educational Note
This tool is most useful when treated as a market-reading assistant.
The best results usually come from combining it with broader structure analysis, liquidity awareness, and disciplined risk management rather than using it as a standalone trigger system.
Indicador
Indicador
