Range Rejection Planner [AGPro Series]Range Rejection Planner
🧠 Core Idea
Is price rejecting a range edge with enough quality to monitor back toward the midline?
📌 Overview / What it does
Range Rejection Planner is a chart-first range reaction decision engine built to evaluate whether price is rejecting the active range edge with enough structure to deserve attention.
The script maps one relevant range edge, a focused edge-reaction zone, wick rejection behavior, close-back-inside quality, midline room, invalidation shelf, failure risk, event labels, alerts, and a clean AGPro planning panel. These components are converted into a 0-100 Rejection Score and a clear next-action state.
It does not predict price movement, automate trades, draw a full support/resistance library, or guarantee that a range edge will hold. Its purpose is to organize the range-edge rejection review process with practical risk and midline context.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate range-edge reactions without turning the chart into a crowded level map.
Many range tools show boundaries, fills, or breakout markers, but they often stop before answering the practical planning question: did price actually reject the edge, is there room back to the midline, and where does the idea fail?
The design philosophy is simple: a range-edge rejection is only useful when the edge interaction, wick response, close-back-inside behavior, midline room, and failure shelf can be read together.
⚡ Why This Script Is Different
Most tools focus on drawing support/resistance zones, marking every range touch, or highlighting breakouts.
This script does NOT clone Support Resistance Reaction Map, does not build a multi-level S/R inventory, and does not act as a broad breakout or break-retest scanner.
Instead, it focuses on one active range and one active edge. The main output is not a buy/sell signal. It is a planning state that helps users decide whether the edge rejection deserves review, whether midline room exists, and whether failure risk is rising.
⚙️ Methodology
1. Context Detection
The script builds an active range from previous bars and identifies whether price is interacting with the upper or lower edge.
2. Reference Mapping
It maps the relevant edge zone, the range midline, and an invalidation shelf beyond the rejected edge.
3. Reaction Evaluation
The model scores edge proximity, wick rejection, close-back-inside quality, relative volume response, midline room, and active range quality.
4. Visual Output
The result appears as a centered range-edge zone, a midline review path, guide lines, compact state labels, alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the active range-edge zone shows the relevant upper or lower boundary being evaluated. The zone label is centered inside the shape.
Midline Path = the projected review area between the rejected edge and the range midline. It helps show whether there is enough room for interpretation.
Labels = compact markers show EDGE WATCH, REJECT READY, MIDLINE REVIEW, MIDLINE HIT, or FAILURE RISK context.
Colors = teal supports lower-edge rejection context, pink supports upper-edge rejection context, amber highlights review states, and indigo marks midline references.
Panel = the panel summarizes Range Edge, Rejection Score, Midline Room, Failure Risk, and Action.
🚦 Signals & States
• EDGE WATCH → price is probing a range edge and early rejection conditions are developing.
• REJECT READY → range-edge rejection quality reached the selected score threshold.
• MIDLINE REVIEW → an active rejection context is being monitored toward the range midline.
• MIDLINE HIT → price reached the active range midline after a rejection context.
• FAILURE RISK → price crossed the invalidation shelf beyond the rejected edge.
• RANGE WAIT → a range exists, but the edge interaction is not strong enough yet.
🔔 Alerts Logic
Alerts trigger when the planner enters EDGE WATCH, REJECT READY, MIDLINE REVIEW, MIDLINE HIT, or FAILURE RISK.
Each alert is an attention marker. Alerts are not trade instructions, entry commands, exit commands, or automated strategy rules.
🧩 Confluence Logic
The strongest context appears when several conditions align:
Range edge probe + strong rejection wick + close back inside the range + supportive relative volume + meaningful room back to the midline + a clear invalidation shelf.
When these components weaken, the planner can stay in EDGE WATCH, return to RANGE WAIT, or shift into FAILURE RISK.
📊 When to Use
• During range-bound markets where edge reactions matter
• When price probes the upper or lower boundary of a recent range
• When evaluating whether an edge rejection has enough midline room
• When a trader wants risk and invalidation context around a range reaction
• On liquid symbols where wicks, volume, and range boundaries are readable
⚠️ When NOT to Use
• Extremely low-liquidity symbols with unreliable wicks or volume
• Very noisy micro-timeframes where range edges shift too often
• News-driven volatility spikes that distort normal range behavior
• Strong trend expansion where range rejection is no longer the main context
• Situations where the user expects automatic buy/sell signals
🎛️ Key Inputs
• Range Edge Mode → chooses Auto, Upper Edge Rejection, or Lower Edge Rejection.
• Active Range Lookback → controls the previous-bar range used for edge evaluation.
• Range Edge Zone ATR → controls the width of the focused edge-reaction zone.
• Close-Back-Inside ATR → defines how much price should close back inside after probing an edge.
• Invalidation Shelf ATR → controls the failure-risk reference beyond the rejected edge.
• REJECT READY Threshold → sets the minimum 0-100 score for the strongest rejection state.
• Label and Panel Font Size → controls visual readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The active edge zone gives the main visual reference. The midline path shows the review area. The invalidation shelf defines where the rejection context becomes weaker. The panel provides a compact decision summary without replacing the chart.
The AGPro panel follows the standard first row format: one merged blue title row containing only the script name.
🧪 Practical Usage Workflow
1. Read the panel state and Rejection Score.
2. Check which range edge is active.
3. Review the wick rejection and close-back-inside context.
4. Compare the midline room with the invalidation shelf.
5. Treat alerts as attention markers, then evaluate broader market context.
🔍 Interpretation Guidelines
Think in terms of rejection quality, not prediction.
A stronger score means multiple range-reaction conditions are aligned. A weaker score means the edge interaction may be early, noisy, too close to the midline, or vulnerable to failure.
Failure Risk does not forecast a breakout. It means the active rejection context has crossed its rule-based failure shelf and should be reviewed.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a generic support/resistance map
• Not a full range breakout scanner
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, range, wick, volatility, and volume behavior.
Timeframe changes can alter the active range, score, edge zone, midline room, and invalidation shelf. Volatility spikes can temporarily distort range boundaries. Symbols with unreliable volume may produce weaker participation readings.
Outputs should always be interpreted with broader market structure, liquidity conditions, and independent risk planning.
🧠 Market Context Notes
Range-edge rejection is most useful when the market is respecting a bounded structure and still has meaningful space toward the middle of the range.
If price starts expanding beyond the edge, this tool intentionally shifts attention from rejection quality toward failure risk instead of calling continuation or reversal with certainty.
🧾 Use Case Examples
When price probes above the active range high, prints a strong upper wick, closes back inside, and still has clear room toward the midline, the planner may classify the context as REJECT READY.
When price touches the lower edge but closes weakly, lacks wick response, or sits too close to the midline, the planner may remain in EDGE WATCH or RANGE WAIT.
When price crosses the invalidation shelf beyond the rejected edge, the planner marks FAILURE RISK for review.
🧱 System Philosophy
AGPro planning tools are designed to help traders make a decision, not simply see another signal.
This script follows that philosophy by turning range rejection into a practical decision question:
Is the edge interaction valid?
How strong is the rejection?
Where is the midline reference?
Where is the failure shelf?
What should I review now?
🔐 Non-Promise Statement
No script can remove uncertainty.
No state, score, label, zone, line, or alert guarantees a future market outcome.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and no script can eliminate uncertainty.
Users are responsible for their own analysis, risk management, and decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how range edges behave across different markets and timeframes. The most useful reading comes from comparing the edge zone, wick response, midline room, failure shelf, panel state, and broader market context together.
Indicator

Trap Failure Planner [AGPro Series]Trap Failure Planner
🧠 Core Idea
Is the trap thesis itself failing and handing control back through the edge?
📌 Overview / What it does
Trap Failure Planner is a chart-first control-return planner for traders who study trap behavior, failed participation, false break recovery, and post-trap execution readiness.
Instead of only marking the first trap or false break, the script watches the second step: after a trap thesis appears, does that thesis keep control, or does price return through the trap edge with enough quality to matter? It produces a 0-100 Failure Score, trap thesis zones, control-return labels, risk-edge guides, target-guide references, alerts, and a compact AG Pro planning panel.
It does not predict future price, automate entries, or claim that a control return must continue. Its role is to organize one specific decision question with clean visual structure.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between first-touch trap markers and practical trade review.
Many tools stop when price runs a level and closes back inside. That can be useful, but traders still need to know whether the trap thesis survives after the first reaction. Trap Failure Planner focuses on that later decision point: is the trap still in control, or did the other side reclaim the edge?
The design supports a planner mindset. It helps traders evaluate state, score, risk edge, target context, and next action without turning the chart into a crowded signal board.
⚡ Why This Script Is Different
Most tools focus on the first false break, sweep, trap label, or reclaim back inside a range.
This script does NOT try to become another false-break trap detector, inducement scanner, liquidity grab detector, stop-hunt map, order block map, or generic support / resistance zone tool.
Instead, it focuses on the failure of the trap thesis itself. The workflow begins only after a trap thesis exists, then waits for control to return through the edge with persistence, follow-through, volume response, and acceptance quality.
That makes it a second-stage trap failure planner, not a first-stage trap detector.
⚙️ Methodology
1. Context Detection
The script builds recent upper and lower trap-thesis rails from prior price action and normalizes behavior with ATR.
2. Reference Mapping
When price probes beyond a rail and closes back inside, the script maps a trap thesis zone between the rail and the probe extreme.
3. Reaction Evaluation
The planner tracks whether price returns through the trap edge within the failure window. The 0-100 model evaluates false break behavior, close recovery, follow-through, volume spike, control-return persistence, and level acceptance.
4. Visual Output
Qualified events print Trap Failed labels, retain the centered trap zone, and project risk-edge and target-guide references.
🗺️ How to Read the Chart
Zones = the active trap thesis area between the control edge and the probe extreme.
Labels = trap thesis states, sparse testing states, and confirmed Trap Failed events.
Colors = teal for bullish control-return context, pink for bearish control-return context, yellow for testing states, indigo for target guides, and red for risk edges.
Panel = the AG Pro summary showing Trap State, Failure Score, Control Shift, Risk Edge, and Action.
🚦 Signals & States
• Upper Trap Thesis → price probed above the upper rail and closed back inside; the planner watches whether that trap thesis survives.
• Lower Trap Thesis → price probed below the lower rail and closed back inside; the planner watches whether that trap thesis survives.
• Return Test → price is challenging the trap edge, but the score or close-count requirement is not complete yet.
• Bull Control Return → an upper trap thesis failed and control returned back above the edge.
• Bear Control Return → a lower trap thesis failed and control returned back below the edge.
🔔 Alerts Logic
Alerts trigger when upper or lower trap thesis states appear and when qualified bull or bear control-return events are confirmed.
High-score alerts require the event score to meet the selected alert threshold.
Alerts are attention markers only. They are not trade instructions, entry commands, or outcome guarantees.
🧩 Confluence Logic
The score becomes stronger when the trap thesis probe is clean, price returns through the trap edge, the return holds for the required close count, follow-through expands, volume rises relative to baseline, and the close location supports the control-return side.
When these components align, the trap failure context becomes cleaner. When they do not align, the script stays in watch, return-test, or reset mode.
📊 When to Use
• Markets with visible trap and failed-participation behavior
• False break structures where the first trap thesis may fail
• Breakout or breakdown attempts that get rejected, then reclaim control again
• Range-edge reviews where traders need a second-stage decision layer
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro timeframes with erratic wicks
• News spikes where structure changes too quickly
• Charts where recent rails are not meaningful planning references
🎛️ Key Inputs
• Planner Side → choose Auto, Bull Return Only, or Bear Return Only.
• Trap Thesis Lookback → controls the rolling reference rails used for trap thesis detection.
• Failure Window Bars → defines how long a trap thesis remains active before reset.
• Control Return Closes → defines how many closes beyond the edge are required for confirmation.
• Minimum Failure Score → controls how selective confirmed Trap Failed labels are.
• Control Return Buffer ATR → controls how much acceptance beyond the edge is required.
• Risk / Target Settings → control planning guide placement.
• Visual Settings → control zones, guides, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The panel is built for fast review: state first, score second, control shift third, then risk and action.
The trap thesis zone includes centered text so the chart remains readable without extra floating explanations.
Labels are compact, offset away from candles, and controlled by cooldown and maximum-visible settings.
🧪 Practical Usage Workflow
1. Read the panel to identify whether a trap thesis is active or already failed.
2. Check the trap thesis zone and the edge being tested.
3. Review the Failure Score and Control Shift rows.
4. Use the Risk Edge and target guide as planning references.
5. Confirm the event inside broader market context.
🔍 Interpretation Guidelines
Think in terms of control, not prediction.
A trap thesis label means price created a possible trap context. A Trap Failed label means that thesis lost control according to the script rules. A higher score means the failure was cleaner across the model components, not that the next move is guaranteed.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a false-break trap detector clone
• Not an inducement scanner
• Not a liquidity grab detector
• Not a support / resistance zone scanner
• Not an order block or fair value gap map
⚠️ Limitations & Transparency
Trap behavior depends on timeframe, liquidity, spread, volatility, and market context.
The script uses a deterministic ruleset. It cannot know news context, hidden order flow, participant intent, or whether a control return will continue.
More aggressive settings may show more events but also more noise. More conservative settings may improve selectivity while reducing frequency.
🧠 Market Context Notes
Trap thesis failure often becomes more meaningful when it aligns with broader structure, volatility expansion, session context, or liquidity behavior.
The script is designed to organize that review, not replace it.
🧾 Use Case Examples
When price probes above a recent upper rail, closes back inside, and later returns above that edge with persistence and follow-through, the planner can mark Bull Control Return if the score is strong enough.
When price probes below a recent lower rail, closes back inside, and later returns below that edge with acceptance, the planner can mark Bear Control Return.
🧱 System Philosophy
AGPro decision tools are built to reduce chart ambiguity by turning raw price events into structured review states.
Trap Failure Planner follows that philosophy by separating the first trap thesis from the later question of whether that thesis actually survives.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No script can guarantee direction, continuation, reversal, or profit.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, position sizing, and interpretation.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use this script to study what happens after a trap thesis forms. The key question is not only whether price created a trap, but whether that trap can continue to defend control.
Indicator

Opening Pullback Planner [AGPro Series]Opening Pullback Planner
🧠 Core Idea
Is the first pullback after the open constructive, failing, or too stale to plan around?
📌 Overview / What it does
Opening Pullback Planner is a session pullback decision tool built around the first meaningful retracement after the opening drive. Instead of treating the open as only a breakout moment, it waits for the drive reference to lock, then maps the pullback area where continuation quality can be evaluated.
The script produces an opening pullback box, continuation trigger, failure line, target-room guide, 0-100 continuation score, risk-edge reading, compact event labels, alerts, and a clean AG Pro planning panel.
It does not predict price direction, automate trades, or mark every opening range breakout. Its purpose is to organize the pullback phase after the opening drive so traders can judge whether the first reset is constructive, failing, invalidated, or no longer worth attention.
🎯 Purpose & Design Philosophy
Many session tools focus on the first opening break, the opening range, or the first impulse. The problem is that a strong open often becomes difficult to plan only after price pulls back.
Opening Pullback Planner was built to fill that gap. It helps traders who study intraday continuation, first-pullback behavior, session execution, and risk-defined planning after the initial move.
The design philosophy is simple: lock the opening drive, map the first pullback box, evaluate recovery quality, define the failure line, and keep the next action readable without turning the chart into a crowded signal board.
⚡ Why This Script Is Different
Most tools focus on opening range breakouts, first-drive strength, fixed session boxes, or generic pullback signals.
This script does NOT clone Opening Drive Quality, does NOT act as an ORB breakout tool, and does NOT draw generic support/resistance zones.
Instead, it focuses on the first pullback after the opening drive. It asks whether the pullback is deep enough to matter, shallow enough to preserve structure, recovering with acceptable close quality, holding a measurable failure line, and offering enough target room for continued review.
⚙️ Methodology
1. Context Detection
The script builds an opening reference from either a fixed session window or the first bars of the day. This creates the drive structure that the pullback plan will use.
2. Reference Mapping
After the opening reference locks, the script maps a drive-native pullback box, continuation trigger, failure line, and target-room guide.
3. Reaction Evaluation
The engine evaluates pullback depth, close recovery, relative volume, volatility fit, room-to-risk, and drive quality to create a 0-100 continuation score.
4. Visual Output
The chart shows the pullback box with centered text, continuation and failure references, target-room guide, compact event labels, optional markers, and the AG Pro panel.
🗺️ How to Read the Chart
Opening Pullback Box = the first pullback review area derived from the locked opening drive.
Continuation Trigger = the level price must reclaim or break after the pullback for continuation context to strengthen.
Failure Line = the invalidation reference where the active pullback plan loses structural integrity.
Target Guide = a projected target-room reference based on the opening drive range.
Labels = event markers for drive retain, pullback test, constructive recovery, trigger readiness, pullback risk, failure line, stale plan, and target check.
Colors = teal for bullish continuation context, pink for bearish or invalid context, amber for caution, and indigo for structural emphasis.
Panel = the decision layer showing Pullback State, Drive Side, Continuation Score, Risk Edge, and Action.
🚦 Signals & States
• DRIVE RETAIN → the opening drive quality is strong enough to map a pullback plan.
• PULLBACK TEST → price has entered the opening pullback box.
• CONSTRUCTIVE → pullback depth and recovery quality are acceptable inside the model.
• TRIGGER READY → price has moved through the continuation trigger after a valid pullback.
• PULLBACK RISK → the pullback is becoming too deep, slow, or weak for clean continuation review.
• FAILURE LINE → the active pullback plan has lost structural integrity.
• PULLBACK STALE → the first pullback plan did not resolve inside the review window.
• TARGET CHECK → price reached the projected target-room guide.
🔔 Alerts Logic
The script includes alerts for:
• Opening Pullback Plan Armed → a qualified opening drive mapped the first pullback plan.
• Opening Pullback Test → price is testing the pullback box.
• Constructive Opening Pullback → the pullback is recovering constructively.
• Opening Pullback Continuation Trigger → the continuation trigger is active after the pullback.
• Opening Pullback Failure Line Broken → the plan has broken its failure reference.
• Opening Pullback Plan Expired → the first pullback plan became stale before confirmation.
• Opening Pullback Target Check → price reached the target-room guide.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when the opening drive has acceptable quality, the first pullback reaches the planned box without violating the failure line, recovery closes improve, volume does not collapse during recovery, and target room remains clean.
The context becomes weaker when the pullback is too deep, recovery is poor, the plan takes too long to resolve, or price violates the failure line.
📊 When to Use
• Intraday session planning after the opening move.
• First-pullback continuation review.
• Daily chart review when the higher-timeframe fallback is enabled.
• Markets where the opening drive often creates a useful early reference.
• Stocks, indices, futures, crypto, or FX charts where the selected opening session is meaningful.
• Review workflows where risk edge and target room need to be visible.
⚠️ When NOT to Use
• Very low-liquidity markets.
• Extremely noisy opens with unstable spreads.
• News-driven bars that distort the opening reference.
• Higher timeframes where session pullback structure is not meaningful.
• Markets where the selected opening window does not represent real participation.
🎛️ Key Inputs
• Opening Reference Mode → chooses between a fixed session window and first bars of day.
• Opening Drive Window → defines the drive reference used before pullback mapping begins.
• Higher Timeframe Fallback → keeps daily, weekly, and monthly charts visually useful by mapping broader opening references.
• Sensitivity → adjusts how strict the planner is with pullback recovery and score requirements.
• Constructive Score Threshold → controls when constructive pullback labels can appear.
• Pullback Box Shallow / Ideal / Deep → define the preferred retracement area.
• Continuation Trigger Buffer ATR → adjusts the trigger line beyond the drive extreme.
• Failure Line Buffer ATR → adjusts the invalidation reference beyond the pullback box.
• Target Guide Range Multiple → controls the projected target-room guide.
• Visual settings → control box, lines, labels, markers, projection, label limits, and font size.
• Panel settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is chart-first and decision-focused. The main visual object is one opening pullback box with centered state text, supported by a continuation trigger, failure line, and target guide.
The panel follows the AGPro public-release standard with one merged blue header row containing only the script name. The five panel rows are Pullback State, Drive Side, Continuation Score, Risk Edge, and Action.
Labels are compact, capped, and offset away from candles so the chart stays active without becoming crowded.
🧪 Practical Usage Workflow
1. Let the opening reference lock.
2. Read the panel to see whether the drive retained enough quality.
3. Watch whether price tests the opening pullback box.
4. Evaluate the continuation score, recovery state, risk edge, and failure line.
5. Treat alerts and labels as review prompts, not instructions.
🔍 Interpretation Guidelines
A strong continuation score means the pullback is controlled, recovering cleanly, preserving the failure line, and keeping useful room to the projected target guide.
A constructive label means the first pullback is behaving better inside the model. It does not mean continuation must occur.
A failure-line label means the plan has lost the structure it needed for this specific pullback framework.
The best use comes from combining the panel state with broader market context, liquidity, volatility, higher-timeframe structure, and personal risk rules.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a generic support/resistance map.
• Not an order block or FVG scanner.
• Not an Opening Drive Quality clone.
• Not a full opening range breakout system.
⚠️ Limitations & Transparency
Timeframe selection affects the opening reference and the pullback box. A 5-minute chart and a 15-minute chart can produce different plans.
Session definitions matter. The selected opening window should match the asset and market being studied.
Higher-timeframe fallback mode is a broader chart-reference layer. It should be read as a weekly, monthly, or yearly opening-pullback framework rather than a literal intraday open.
Volatility changes can expand or compress risk, target, and pullback behavior.
Low liquidity, abnormal spreads, and high-impact news can reduce the usefulness of any opening pullback model.
🧠 Market Context Notes
The first pullback after the open can be useful because it tests whether the opening move still has sponsorship. A shallow pullback may show strength but offer limited risk clarity. A deep pullback may offer a better reset but also higher failure risk.
This script keeps that decision visible by separating drive retention, pullback quality, continuation trigger, failure line, and target room.
🧾 Use Case Examples
When price locks a bullish opening drive, pulls back into the mapped box, holds above the failure line, and recovers toward the continuation trigger, the panel may shift toward a constructive or ready state.
When price enters the pullback box but keeps closing weakly or pushes beyond the deep boundary, the planner may mark pullback risk.
When price breaks the failure line, the opening pullback plan is no longer structurally intact inside this model.
🧱 System Philosophy
Opening Pullback Planner follows the AGPro Series decision-engine approach: a script should help the trader evaluate validity, strength, risk, target room, and next action instead of only printing another signal.
The tool is built to make one session behavior easier to read: the first pullback after the opening drive.
🔐 Non-Promise Statement
No script can provide certainty.
No opening pullback model can guarantee continuation, reversal, or profitability.
This script provides structured context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use this script as an educational planning and visualization tool. The strongest use comes from reading the first opening pullback together with broader market structure, liquidity, volatility, and personal risk rules.
Indicator

Expansion Failure Planner [AGPro Series]Expansion Failure Planner
🧠 Core Idea
Did volatility expansion create real travel, or did it fail back inside the prior structure?
📌 Overview / What it does
Expansion Failure Planner is a public-free PulseWire indicator built to evaluate failed volatility expansion attempts. It detects when price expands beyond a recent range edge, then tracks whether the move produces meaningful travel or quickly loses the edge.
The script produces a failed expansion corridor, expansion-edge guide, risk shelf, return-to-range target guide, compact state labels, alerts, and a clean AG Pro planning panel. It does not predict future price direction or automate trade decisions.
🎯 Purpose & Design Philosophy
This script was built for traders who do not only want to see that volatility expanded. They want to know whether the expansion still has quality, whether failure risk is rising, and what context should be reviewed next.
The design supports a decision-first workflow: identify the expansion attempt, measure failure risk, review target room, and decide whether the context deserves attention.
⚡ Why This Script Is Different
Most volatility tools focus on expansion, squeeze release, or breakout continuation.
This script does NOT act as a generic breakout signal, generic S/R zone, or continuation-only volatility map.
Instead, it focuses on one narrow question: did the expansion fail before producing real travel?
⚙️ Methodology
1. Context Detection
The script defines a prior range and watches for a volatility expansion attempt beyond that range edge.
2. Reference Mapping
It stores the expansion edge, expansion extreme, prior range midpoint, and return-to-range target area.
3. Reaction Evaluation
The planner scores failed travel using ATR expansion, close-back-inside behavior, missing follow-through, volume response, and range re-entry quality.
4. Visual Output
It draws the failed expansion corridor, expansion edge, risk shelf, return target, compact labels, and a premium AG Pro panel.
🗺️ How to Read the Chart
Zones = the failed expansion corridor between the original edge and the expansion extreme.
Labels = expansion attempts, failure-ready states, watch states, hold states, and reset context.
Colors = teal for upside expansion attempts, pink for downside expansion attempts, yellow for watch context, and indigo for edge/hold review.
Panel = the preferred viewing timeframe, current expansion state, 0-100 failure risk, reclaim status, target room, and next action.
🚦 Signals & States
• UP EXP / DN EXP → a volatility expansion attempt has been detected.
• UP FAIL / DN FAIL → the expansion failed back inside the prior structure with enough score.
• WATCH → failure risk is developing but confirmation is incomplete.
• HOLD → expansion is still holding beyond the edge.
• RESET / NO FAIL → the active failure window expired or real travel invalidated the failure context.
🔔 Alerts Logic
Alerts trigger when expansion failure reaches ready status, when watch context develops, when expansion holds beyond the edge, or when the failure window resets.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The strongest context appears when ATR expansion, edge loss, missing follow-through, range re-entry, and participation align. When these components agree, the failure risk score increases.
📊 When to Use
• After volatility expansion attempts
• Around range-edge probes
• During breakout failure review
• When a move expands but does not travel
• When price quickly returns inside prior structure
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro ranges
• News-driven candles with abnormal gaps
• Markets where volume data is unreliable
• Charts where the prior range is not structurally meaningful
🎛️ Key Inputs
• Sensitivity → changes how strict the failure model is.
• Prior Range Lookback → defines the structure used for expansion reference.
• Expansion Bar ATR → controls how large a candle must be to qualify.
• Required Real Travel ATR → defines how much progress the expansion should produce.
• Confirmation Mode → controls close/volume/strict confirmation.
• Visual Settings → control corridor, guides, labels, projection, and label size.
• Panel Settings → control panel visibility, location, theme, font size, and best-viewed timeframe guidance.
🖥️ Interface & Visual Design
The panel is designed as a compact planning cockpit. The first row uses the AGPro merged blue header standard, while the remaining rows show best-viewed timeframe guidance, state, score, reclaim status, target room, and action.
The visual hierarchy keeps the chart readable: one active corridor, clear guide lines, and controlled labels.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check whether price is above or below the expansion edge.
3. Review the failed expansion corridor.
4. Compare failure risk with target room.
5. Use alerts as attention markers, not decisions.
🔍 Interpretation Guidelines
Think in terms of failed travel, not prediction. A high score means the script detected stronger failure characteristics. A low score means expansion may still be holding, or failure evidence is not strong enough.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a generic breakout indicator
• Not a generic support/resistance zone map
⚠️ Limitations & Transparency
• Timeframe differences can change expansion and failure structure.
• Volatility spikes can distort ATR-based scoring.
• Volume quality varies by market.
• Fast markets can move beyond the corridor before confirmation.
• Outputs should be interpreted within broader market context.
🧠 Market Context Notes
Expansion failure often matters when volatility appears strong but cannot create distance. This script focuses on that transition point between momentum attempt and failed travel.
🧾 Use Case Examples
When price expands above a range, stalls quickly, closes back inside the edge, and fails to build distance, the planner can mark an upside expansion failure.
When price expands below a range, loses downside follow-through, and re-enters the structure, the planner can mark a downside expansion failure.
🧱 System Philosophy
AGPro tools are built to reduce chart ambiguity by turning raw market events into structured decision context.
🔐 Non-Promise Statement
No indicator can provide certainty. This script provides rule-based context only.
📉 Risk Disclosure
Trading involves risk. Users are responsible for their own decisions. This script does not provide financial advice or guaranteed trading outcomes.
📚 Educational Note
Use the script as a structured learning and review tool for expansion failure behavior, failed travel, and volatility response.
Indicator

Momentum Pullback Continuation [AGPro Series]Momentum Pullback Continuation
🧠 Core Idea
Is a momentum pullback resetting cleanly for continuation, or is the move losing its execution quality?
📌 Overview / What it does
Momentum Pullback Continuation is a chart-first continuation planner built for traders who review momentum-driven trends after a controlled pullback.
The script maps a momentum reset pocket, continuation trigger line, invalidation rail, target-room corridor, state labels, alerts, and a clean AGPro planning panel. It converts trend support, momentum slope, pullback depth, close recovery, volume behavior, and target room into a 0-100 Continuation Score.
The default publication preset is 1H-focused. Higher timeframes can be tested from the inputs, but the strongest intended use case is hourly momentum pullback review.
It does not predict price, automate entries, or turn every trend pullback into a signal. It is a structured decision tool for evaluating whether the current momentum reset deserves closer review.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between basic momentum readings and practical continuation planning.
Many traders can see that momentum exists, but the harder question is whether the pullback is resetting in a controlled way or damaging the continuation structure. This planner focuses on that decision layer.
The design supports a disciplined workflow: identify the active momentum side, inspect the reset pocket, evaluate the score, locate the invalidation rail, compare target room, and read the next-action state.
⚡ Why This Script Is Different
Most tools focus on momentum oscillators, moving-average direction, divergence events, or generic continuation labels.
This script does NOT clone Hidden Divergence Continuation Zones, Trend Continuation Quality, Structural Momentum Oscillator, ROC Momentum Shift Map, or a generic pullback signal map.
Instead, it treats the pullback as a planning event. The main output is not a buy/sell marker. It is a momentum reset decision state with score, risk edge, target-room context, and action guidance.
⚙️ Methodology
1. Context Detection
The script identifies bullish or bearish momentum context using an EMA stack, normalized trend slope, and smoothed rate-of-change pressure.
2. Reference Mapping
It builds a concept-native Momentum Reset Pocket around the active trend support area, then maps a continuation trigger line, invalidation rail, and target-room guide.
3. Reaction Evaluation
The score model evaluates momentum slope, pullback depth, trend support, close recovery, volume behavior, and available target room.
4. Visual Output
The chart shows the reset pocket, target-room corridor, trigger and risk guides, compact event labels, sparse context labels, alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Reset Pocket = the area where a momentum pullback is expected to stabilize before continuation can be reviewed.
Trigger Line = the fast continuation reference that price needs to recover after the reset.
Invalidation Rail = the planning line where the active reset context is considered lost.
Target-Room Corridor = the forward planning area between current price and the target-room guide.
Labels = RESET, WATCH, READY, WEAK, and INVALID attention markers.
Colors = teal marks bullish continuation context, pink marks bearish continuation context, amber marks weak or caution states, indigo marks watch/target-room context, and red marks invalidation.
Panel = summarizes Momentum State, Pullback Quality, Continuation Score, Risk Edge, and Action.
🚦 Signals & States
• RESET → price has interacted with the momentum reset pocket.
• WATCH → the reset is developing, but recovery or score quality is not complete.
• READY → momentum, pullback depth, recovery, volume context, and target room align strongly enough for structured review.
• WEAK → the pullback is too deep, low quality, or not recovering well enough.
• INVALID → price has crossed the invalidation rail and the active reset context should be rebuilt.
🔔 Alerts Logic
Alerts trigger when READY, WATCH, WEAK RESET, or INVALID states appear.
Each alert is an attention marker tied to the rule-based state engine. Alerts are not trade instructions and do not guarantee that continuation will occur.
🧩 Confluence Logic
The continuation context becomes stronger when trend support, positive momentum slope, controlled pullback depth, clean close recovery, acceptable volume behavior, and target-room availability align.
The script intentionally requires multiple conditions instead of labeling every pullback inside a trend as meaningful.
📊 When to Use
• Directional markets with visible momentum pressure
• 1H charts and nearby intraday momentum review
• Trend continuation review workflows
• Pullbacks after a clear momentum impulse
• Situations where risk edge and target room matter before acting
• Markets where volume and close behavior are readable enough to support context
⚠️ When NOT to Use
• Low-liquidity symbols with unreliable candles or volume
• Extremely choppy markets with frequent trend-side flips
• News-driven volatility where reset structure changes too quickly
• Very flat markets where momentum pressure is absent
• Instruments where the active pullback is far beyond the mapped risk edge
🎛️ Key Inputs
• Continuation Side → selects Auto, Bullish Only, or Bearish Only evaluation.
• Timeframe Profile → keeps the default script behavior focused on 1H charts, with optional broader intraday or all-timeframe testing.
• Sensitivity → adjusts how strict the momentum reset model is.
• EMA settings → define trigger, reset, and support references.
• Momentum ROC settings → control the internal momentum pressure reading.
• Reset Pocket Width → changes how wide the reset area is around trend support.
• READY / WATCH Score → sets state thresholds.
• Visual settings → control zones, guide lines, labels, panel theme, panel location, and font sizes.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first and practical.
The reset pocket and target-room corridor provide the main visual planning structure. Labels are compact and spaced with cooldown controls. The AGPro panel uses a single merged blue header row and focuses only on the core decision fields.
🧪 Practical Usage Workflow
1. Read the panel Momentum State.
2. Check whether price is interacting with the Momentum Reset Pocket.
3. Compare Pullback Quality and Continuation Score.
4. Locate the Risk Edge and Target-Room Corridor.
5. Use the Action row to decide whether the context is READY, still WATCH, weak, invalid, or only worth scanning.
🔍 Interpretation Guidelines
Think of the script as a continuation readiness map, not a command system.
A higher score means the active momentum pullback matches the script's internal definition of cleaner continuation structure. A lower score means one or more components are missing, such as trend support, recovery quality, volume context, or target room.
The invalidation rail is a planning boundary for the active context. It is not a guaranteed stop level and should not replace the user's own risk process.
🚫 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 does not provide guaranteed signals.
This script does not replace independent confirmation, position sizing, or risk management.
⚠️ Limitations & Transparency
Momentum continuation behavior changes across symbols, sessions, and timeframes.
The default 1H Focus profile intentionally suppresses active labels, zones, and alerts outside the intended hourly review window.
Low-liquidity markets can distort volume behavior and reset quality.
High volatility can widen risk edges and reduce target-room clarity.
Sideways conditions can create repeated resets without clean continuation.
No rule-based script can fully account for sudden news, spread changes, slippage, or discretionary execution constraints.
🧠 Market Context Notes
Momentum pullbacks are often more useful when the broader trend remains intact, the pullback is controlled rather than impulsive against trend, and the recovery candle shows clear close quality.
The best reads usually come from alignment between structure, momentum, volume, volatility, and clean forward room.
🧾 Use Case Examples
When price pulls into the reset pocket during bullish momentum and then recovers the trigger line with a stronger score, the script can mark READY for continuation review.
When price enters the pocket but momentum slope fades and pullback depth becomes excessive, the script can mark WEAK RESET.
When price crosses the invalidation rail, the active reset context is treated as lost and should be rebuilt.
🧱 System Philosophy
AGPro tools are built around structured interpretation.
The goal is not to create more chart noise. The goal is to turn visible market behavior into a cleaner decision framework: context, quality, risk, target room, and next action.
🔐 Non-Promise Statement
No script can provide certainty.
No score guarantees continuation.
The output should be interpreted as structured context, not as a promise of future price movement.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, confirmation, position sizing, and decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how momentum resets behave across different symbols and timeframes. Over time, compare READY, WATCH, WEAK RESET, and INVALID states to understand which environments produce cleaner continuation structure.
Indicator

[ A L P H A X ] Momentum FlowAlphaX Momentum Flow — 4-Color MACD Histogram, Divergence Detection, Squeeze Breakout, Zero Line Cross Markers & Live Dashboard
AlphaX Momentum Flow is a professional-grade MACD oscillator rebuilt from the ground up in Pine Script v6 under the AlphaX visual system. It takes the classic MACD framework and extends it with four additional signal layers — divergence detection, histogram squeeze breakout, zero line cross markers, and a real-time live dashboard — all presented through a clean, clutter-free visual design that eliminates the label noise common in most enhanced MACD indicators. Every signal is confirmed on bar close with zero repainting.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📸 Visual Overview
AlphaX Momentum Flow showing the 4-color histogram, MACD and signal lines, cross dots, zero line triangles, divergence ring markers, squeeze background flash, and the live dashboard
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔬 The MACD Engine
At the core of AlphaX Momentum Flow is the standard MACD calculation — fast EMA minus slow EMA, smoothed by a signal line, with the histogram representing the gap between them. The defaults (12 / 26 / 9) match the classic configuration used across most trading platforms, so the indicator is immediately familiar and directly comparable to any standard MACD setup.
What separates Momentum Flow from a plain MACD is everything built on top of that core — the visual system, the additional signal layers, and the live dashboard that synthesizes everything into a single readable state panel.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 4-Color Histogram
The histogram uses four distinct colors to communicate not just direction but momentum quality at a glance — telling you whether the current move is building or fading before the MACD line has even crossed.
Bright green (bull bright) — histogram is above zero and expanding. Bullish momentum is actively building. The strongest bullish histogram state.
Dim green (bull dim) — histogram is above zero but contracting. Bullish momentum exists but is beginning to fade. Watch for a potential cross or reversal.
Bright red (bear bright) — histogram is below zero and expanding downward. Bearish momentum is actively building. The strongest bearish histogram state.
Dim red (bear dim) — histogram is below zero but contracting back toward zero. Bearish momentum exists but is weakening. A potential reversal or cross may be forming.
Reading the histogram in 4-color mode gives you earlier warning of momentum shifts than waiting for a MACD/signal line cross — a transition from bright to dim in either direction is the first sign that the current move is losing energy.
4-color mode can be toggled off to display the histogram in a single neutral color if you prefer the classic look.
4-color histogram in action — bright colors marking strong momentum phases, dim colors showing early fading
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
〇 Signal Line Cross Dots
When the MACD line crosses the signal line, a filled circle is plotted directly on the signal line at the cross bar:
Bright green dot — MACD crossed above signal. Bullish momentum shift.
Bright red dot — MACD crossed below signal. Bearish momentum shift.
Cross dots are placed on the signal line rather than the histogram, keeping them visually separated from the histogram bars and easy to spot even during busy market conditions. They are confirmed on bar close only — no repainting.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▲ Zero Line Cross Markers
When the MACD line crosses above or below zero, a small triangle is plotted directly on the zero line:
▲ Green triangle — MACD crossed above zero. Macro bullish bias confirmed — the fast EMA has moved above the slow EMA.
▼ Red triangle — MACD crossed below zero. Macro bearish bias confirmed.
Zero line crosses are more significant than signal line crosses. A signal line cross tells you momentum is shifting within the current trend. A zero line cross tells you the macro trend itself has changed — price is now on the other side of its moving average equilibrium. Use zero line crosses to set your directional bias and signal line crosses to time entries within that bias.
Markers are pinned exactly on the zero line — no floating labels, no clutter.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Divergence Detection
AlphaX Momentum Flow detects both bullish and bearish divergence automatically, confirmed on bar close with zero repainting.
Bullish Divergence — price makes a lower low over the lookback window while the MACD makes a higher low at the same time, and MACD is currently below zero. This combination signals that selling pressure is weakening even though price is still falling — a classic early warning of a potential reversal upward.
Bearish Divergence — price makes a higher high over the lookback window while the MACD makes a lower high at the same time, and MACD is currently above zero. This signals that buying pressure is weakening even though price is still rising — an early warning of a potential reversal downward.
Divergence is marked with a distinctive ring marker — a larger outer circle with a dark center — plotted directly on the MACD line at the divergence bar. The ring design is intentionally distinct from the smaller, filled cross dots so you can differentiate the two signal types instantly without reading any text.
Two additional guards keep divergence signals meaningful:
Bullish divergence only fires when MACD is below zero — divergence from within bearish territory is structurally more significant than divergence above the zero line
Bearish divergence only fires when MACD is above zero — same logic in reverse
The divergence lookback window is configurable from 5 to 50 bars.
Divergence ring markers on the MACD line — larger ring shape clearly distinguishes them from the cross dots
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ Histogram Squeeze Breakout
The Squeeze detector monitors the histogram for periods of compression — when the bars are getting progressively smaller in absolute terms, momentum is coiling and a breakout move is building. When the compression resolves and the histogram begins expanding again, the squeeze breakout fires.
How the squeeze is detected:
The absolute value of the histogram is tracked over the squeeze lookback window
When the recent minimum absolute histogram value is very small relative to the broader historical range — below 15% of the recent high-low range — the market is in a squeeze state
The squeeze breakout signal fires on the first bar where the histogram was in a squeeze state on the prior bar and is now actively expanding in a clear direction
A bullish squeeze breakout fires when the histogram is above zero and expanding
A bearish squeeze breakout fires when the histogram is below zero and expanding
The signal is deliberately designed to mark the start of the new move rather than the quiet period before it. The squeeze period itself is shown in the dashboard as ● COILING so you can see compression building in real time, and the moment it resolves the dashboard switches to ⚡ BULL SQUEEZE or ⚡ BEAR SQUEEZE .
Visually, the squeeze breakout is shown as a single-bar background flash — the pane background briefly highlights in green or red at the breakout bar only, then returns to normal. This is clean and unambiguous — no labels stacking on the histogram, no text overlapping other signals.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎨 Bias Background Tint
When both the MACD line and the histogram agree on direction — both above zero for bullish, both below zero for bearish — a very subtle, persistent background tint is applied to the oscillator pane. Green for confirmed bull bias, red for confirmed bear bias, invisible when conditions are mixed or uncertain.
The tint is set at near-full transparency so it never competes with the histogram or lines visually — it is purely an ambient cue that tells you the overall momentum alignment without requiring you to actively check both values.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 Live Dashboard
The dashboard gives you a real-time text readout of every MACD state in a compact panel — no need to read individual values off the chart manually. Eight rows update on every bar close:
MACD — live MACD line value, green when above zero, red when below
SIGNAL — live signal line value
HISTOGRAM — live histogram value, green when positive, red when negative
HIST MOM — histogram momentum state: ▲ EXPANDING or ▼ FADING, reflecting whether the current histogram bar is larger or smaller than the previous one
BIAS — overall momentum bias: ▲ BULL (both MACD and histogram positive), ▼ BEAR (both negative), ▲ WEAK BULL or ▼ WEAK BEAR when they disagree. Highlighted in green or red when a strong bias is active.
CROSS — shows ▲ BULL CROSS or ▼ BEAR CROSS when a signal line cross occurred on the current bar, highlighted in the corresponding color, otherwise — NONE
SIGNAL — shows the highest-priority active special signal: ◆ BULL DIVERGENCE, ◆ BEAR DIVERGENCE, ⚡ BULL SQUEEZE, ⚡ BEAR SQUEEZE, ● COILING (squeeze building but not yet broken), or — NONE
Dashboard position is configurable — Top Right, Top Left, Bottom Right, or Bottom Left.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ Key Features
📊 4-color histogram — bright/dim bull and bear shading shows momentum direction AND quality simultaneously
〇 Signal line cross dots — filled circles on the signal line, bull green and bear red, confirmed on bar close
▲ Zero line cross markers — small triangles pinned at zero, marking macro trend shifts cleanly with no floating labels
◆ Divergence detection — bullish and bearish divergence with configurable lookback, marked with distinctive ring markers on the MACD line
⚡ Squeeze breakout detection — compression period monitoring with a single-bar background flash on breakout, no labels
🎨 Bias background tint — subtle ambient pane color when MACD and histogram both confirm the same direction
📋 Live 8-row dashboard — MACD, signal, histogram values, histogram momentum, bias state, cross status, and special signal — all updating in real time
🔔 10 alert conditions — individual alerts for every signal type plus combined any-bull and any-bear alerts
✅ Zero repainting — all signals confirmed on bar close only
🎨 Full AlphaX visual theme — yellow-green for bullish, red for bearish, dark background dashboard, consistent across all chart elements
⚙ Fully configurable — all MACD periods, source, display toggles, divergence lookback, and squeeze sensitivity adjustable from the settings panel
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙ Settings Reference
MACD Settings
Fast Length — EMA period for the fast moving average (default: 12)
Slow Length — EMA period for the slow moving average (default: 26)
Signal Length — SMA period for the signal line smoothing (default: 9)
Source — price source used for all calculations (default: close)
Display
Show MACD Line — toggle the MACD line on or off
Show Signal Line — toggle the signal line on or off
Show Histogram — toggle the histogram bars on or off
Histogram 4-Color Mode — toggle between 4-color momentum shading and single neutral color
Show Bias Background Tint — toggle the ambient pane tint when bias is confirmed
Signals
Show Signal Cross Dots — toggle cross dot markers on the signal line
Show Zero Line Cross Markers — toggle triangle markers at the zero line
Show Divergence Markers — toggle divergence ring markers on the MACD line
Divergence Lookback — number of bars to look back for divergence comparison (default: 14, range: 5–50)
Show Squeeze Breakout Markers — toggle squeeze breakout background flash
Squeeze Lookback (bars) — number of bars to measure histogram compression over (default: 5, range: 3–20)
Dashboard
Show Dashboard — toggle the live dashboard panel on or off
Position — placement of the dashboard (Top Right, Top Left, Bottom Right, Bottom Left)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔔 Alert Conditions
Bull Signal Cross — MACD crossed above signal line
Bear Signal Cross — MACD crossed below signal line
Bull Zero Line Cross — MACD crossed above zero
Bear Zero Line Cross — MACD crossed below zero
Bullish Divergence — price lower low with MACD higher low below zero
Bearish Divergence — price higher high with MACD lower high above zero
Bullish Squeeze Breakout — histogram expanding bullish after compression
Bearish Squeeze Breakout — histogram expanding bearish after compression
Any Bull Signal — fires on any of the four bullish events above
Any Bear Signal — fires on any of the four bearish events above
All alert messages include {{ticker}} and {{interval}} placeholders for webhook integration.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 How to Read AlphaX Momentum Flow — Step by Step
Step 1 — Set your directional bias from the zero line
MACD above zero → macro bullish bias. Prioritize long setups and look for bullish signal line crosses and bullish divergence.
MACD below zero → macro bearish bias. Prioritize short setups and look for bearish signal line crosses and bearish divergence.
A zero line cross triangle tells you the moment the bias has officially flipped.
Step 2 — Read histogram momentum for timing
Bright color = momentum actively building in that direction. The strongest bars to align entries with.
Dim color = momentum fading. Not the time to chase — a cross or reversal may be forming.
Watch for dim → bright transitions as early momentum re-acceleration signals.
Step 3 — Use signal line crosses for entry timing
A green dot on the signal line during a bullish bias (MACD above zero) is a confirmation entry signal — momentum is re-aligning with the macro trend.
A red dot during a bearish bias is the equivalent for shorts.
Cross dots that occur against the zero line bias (e.g., a red cross dot while MACD is above zero) are counter-trend signals — treat them with more caution or use them only for partial exits.
Step 4 — Watch for divergence as early reversal warning
A ◆ ring marker on the MACD line means price and momentum are disagreeeing — one of them is about to correct toward the other.
Bullish divergence below zero is one of the highest-probability reversal setups on this indicator — price is making new lows but the selling force is measurably weakening.
Do not act on divergence alone — wait for a signal line cross or zero line cross to confirm the reversal is beginning.
Step 5 — Act on squeeze breakouts for impulsive move entries
When the dashboard shows ● COILING, momentum is compressing. A larger move is building.
When the pane flashes and the dashboard switches to ⚡ BULL SQUEEZE or ⚡ BEAR SQUEEZE, the compression has resolved — the new move is starting.
Squeeze breakouts are particularly powerful when they occur after a zero line cross — compressed momentum breaking out in the direction of a fresh macro bias shift.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
👥 Who This Is For
📈 MACD users who want more information without more clutter — every enhancement adds insight through visual design, not text labels stacking on the chart
🥇 Momentum traders on any instrument or timeframe — works on forex, gold, indices, crypto, and equities across all timeframes
🧠 Traders who use MACD for trend confirmation — the zero line cross markers and bias tint make the macro trend state immediately obvious without reading numbers
🔍 Traders who rely on divergence — automated detection with a clean ring marker removes the manual scanning process
⚡ Breakout traders — the squeeze detector gives early warning when momentum is coiling before an impulsive move
🔔 Alert-driven traders — 10 alert conditions cover every signal type with clean webhook-ready messages
📋 Traders who want a live status readout — the dashboard replaces manual value checking with a real-time state panel
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📝 Notes
All signals are confirmed on bar close — Momentum Flow does not repaint. Signals visible on historical bars will not move or disappear.
The divergence detector compares the current bar's close and MACD value against the lowest or highest values seen in the lookback window. Increasing the lookback produces fewer but more structurally significant divergence signals. Decreasing it produces more frequent signals on smaller swings.
The squeeze sensitivity is controlled by the Squeeze Lookback setting. Shorter lookback = more squeeze signals on minor compressions. Longer lookback = only major compression periods qualify.
The MACD line color changes dynamically based on whether it is above or below the signal line — green when above, red when below — giving an additional at-a-glance view of cross state beyond the dot markers.
Default MACD settings (12 / 26 / 9) are the universal standard. They work well across all timeframes and instruments without adjustment. Modify them only if you have a specific reason based on your instrument's volatility profile.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠ 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 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 want more from their MACD — without more noise on their chart. Indicator

Swing Retest Quality [AGPro Series]Swing Retest Quality
🧠 Core Idea
Is the active swing retest clean enough to treat as valid context, or is the pullback too weak, too deep, or too hard to plan?
📌 Overview / What it does
Swing Retest Quality is a chart-first swing retest planner built to evaluate pullbacks into an active swing leg.
The script maps a focused swing retest pocket, defense line, target-room zone, compact labels, deterministic alerts, and a clean AGPro panel. It converts swing clarity, retest depth, wick rejection, close response, and volume support into a 0-100 Retest Quality score.
It does not predict future price movement, automate entries, print buy/sell commands, or replace broader market context. Its purpose is to help traders judge whether a swing retest has enough structure to deserve attention.
🎯 Purpose & Design Philosophy
This script was built for traders who evaluate pullbacks, retests, and continuation structure but want a more disciplined way to judge retest quality.
Many tools show structure levels or retest markers without answering the practical planning question: is this retest clean, defended, and readable enough to review?
The design philosophy is simple: a retest is not useful just because price touches a level. It becomes useful when the swing reference is clear, the pullback depth is controlled, the response is readable, and risk/target context can be mapped.
⚡ Why This Script Is Different
Most tools focus on support/resistance touches, break-and-retest markers, BOS/CHOCH events, or broad supply/demand zones.
This script does NOT clone Break-Retest Quality, does not require a structure break first, does not map order blocks, does not create a generic S/R zone map, and does not become a broad swing scanner.
Instead, it evaluates one active swing leg and asks whether the pullback into that swing has enough quality to be treated as valid context. The main output is not a trade command. It is a planner state: VALID RETEST, WATCH, DEFENSE REVIEW, LOST, or WAIT.
⚙️ Methodology
1. Context Detection
The script detects confirmed swing highs and lows, then identifies the active bull or bear swing leg.
2. Reference Mapping
It builds a concept-native retest pocket inside the active swing, adds a defense line behind the swing origin, and projects a target-room zone toward the swing terminal.
3. Reaction Evaluation
The model scores swing clarity, retest depth, wick rejection, close response, and optional volume support.
4. Visual Output
The result is displayed through a centered retest pocket, centered target-room zone, defense guide, swing leg, compact labels, alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the retest pocket shows where a pullback into the active swing leg is being evaluated. The target-room zone shows the available room back toward the swing terminal or extension guide.
Labels = compact event labels mark pocket tests, hold retests, watch states, room reviews, and defense-loss events.
Colors = teal marks cleaner bull-side retest context, pink marks bear-side or lost-defense context, amber marks caution/review, and indigo marks watch/transition context.
Panel = the panel summarizes Retest Quality, Swing Side, Defense State, Risk Room, and Action.
🚦 Signals & States
• VALID RETEST → the active swing retest is holding with enough quality and room for review.
• WATCH → the retest context is improving, but confirmation is incomplete.
• DEFENSE REVIEW → price has tested the pocket, but quality, response, or room is not strong enough.
• LOST → price has crossed the defense line and the swing context should be rebuilt.
• WAIT → no active swing retest context is strong enough yet.
🔔 Alerts Logic
Alerts trigger when price touches the swing retest pocket, when a valid swing retest appears, when a watch state appears, when target room becomes limited, and when the defense line is lost.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The strongest context appears when a clear swing leg is followed by a controlled retest depth, visible wick rejection, a constructive close response, supportive relative volume, and enough target room relative to the defense line.
When these components align, the Retest Quality score improves and the state can move from WATCH to VALID RETEST.
📊 When to Use
• During pullbacks inside a clear directional swing
• When price is retesting a prior swing leg rather than breaking a new structure level
• When planning continuation context around a readable defense line
• When comparing whether a pullback is clean enough to monitor or too weak to trust
• On liquid symbols where pivots, candles, and volume behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with irregular candles
• Extremely noisy micro-timeframes
• News-driven spikes where swing structure becomes distorted
• Markets where volume is unreliable and should not affect scoring
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Swing Pivot Length → controls how confirmed swing highs and lows are detected.
• Max Swing Age → controls how long a swing leg remains active.
• Shallow / Deep Pocket Depth → controls the retest pocket inside the swing leg.
• Ideal Retest Depth → defines the preferred pullback depth for stronger scoring.
• Defense Buffer ATR → controls the defense line behind the swing origin.
• Minimum Target Room ATR → defines how much room is preferred before VALID state.
• Label and Panel Font Size → controls chart labels, centered zone text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The retest pocket gives the main visual story. The defense line defines where the swing context becomes weak. The target-room zone shows whether the pullback still has practical room to evaluate.
The AGPro panel uses a merged blue title row and a compact decision hierarchy so the user can read state, quality, risk, and next action quickly.
🧪 Practical Usage Workflow
1. Read the panel state and Retest Quality score.
2. Check whether price has touched the swing retest pocket.
3. Review the defense line and target-room zone.
4. Evaluate whether the label says HOLD, WATCH, ROOM REVIEW, or DEFENSE LOST.
5. Compare the retest with broader trend, liquidity, volatility, and timeframe context.
🔍 Interpretation Guidelines
Think in terms of retest quality, not prediction.
A stronger score means multiple structural conditions are aligned. A weaker score means the swing may be unclear, the pullback may be too shallow or too deep, the response may be weak, or target room may be limited.
The script helps organize the review process. It does not decide for the user.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a Break-Retest Quality clone
• Not a BOS/CHOCH scanner
• Not a generic support/resistance zone map
• Not a supply/demand, order block, or FVG map
⚠️ Limitations & Transparency
• Pivot-based swing references depend on the selected Swing Pivot Length.
• Scores can vary across symbols, sessions, and timeframes.
• Volume support depends on exchange-provided volume data.
• Fast, news-driven movement can distort retest depth and defense readings.
• In Live Updating mode, active-bar values can change before the bar closes.
🧠 Market Context Notes
Swing retests are most useful when the broader chart has readable structure.
Liquidity, volatility, trend maturity, and higher-timeframe context can all affect whether a retest should be treated as meaningful. The script provides a structured review layer, not a complete trading system.
🧾 Use Case Examples
When a bull swing is clear and price pulls back into the retest pocket, a HOLD RETEST label with a strong score indicates that the pullback response is clean enough to review.
When price touches the pocket but target room is too limited, ROOM REVIEW highlights that the structure may be readable but planning space is constrained.
When price crosses the defense line, DEFENSE LOST indicates that the active swing context should be rebuilt.
🧱 System Philosophy
Swing Retest Quality follows the AGPro decision-engine approach: map the context, score the quality, show the risk reference, show the target room, and summarize the next action without issuing trade commands.
🔐 Non-Promise Statement
No indicator can provide certainty.
The script does not guarantee that a retest will hold, continue, reverse, or produce any specific outcome.
📉 Risk Disclosure
Trading involves risk.
Users are 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
Use the script as a structured retest-review framework. The best results come from combining the panel, zones, labels, and alerts with broader chart context and disciplined risk evaluation.
Indicator

Acceptance Breakout Planner [AGPro Series]Acceptance Breakout Planner
🧠 Core Idea
Did price truly accept beyond the breakout level, or did it only tag the level and fail to hold?
📌 Overview / What it does
Acceptance Breakout Planner is a chart-first breakout decision tool designed to evaluate what happens after price moves beyond a key rolling reference edge.
Instead of treating every breakout as meaningful, the script measures close persistence, time beyond the level, retest-hold behavior, range distance, candle quality, volume support, and failure shelf risk. It converts that evidence into a 0-100 Acceptance Score and a clear next-action state.
The script produces an acceptance band, a failure shelf, a target-room guide, controlled chart labels, alerts, and a clean AGPro planning panel. It does not predict price movement, automate execution, or claim that acceptance will continue.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between a simple breakout marker and a full trade-management system.
Many traders can see when price crosses a level. The harder question is whether price is spending enough time beyond that level to deserve attention, or whether the break is only a low-commitment tag.
The design supports a planner mindset: observe the break, measure acceptance, watch the failure shelf, and review the next state with structure instead of reacting to a single candle.
⚡ Why This Script Is Different
Most breakout tools focus on the moment price crosses a level.
This script does NOT function as a generic breakout signal, volume-spike detector, consolidation breakout box, Donchian channel tool, or broad break-retest scanner.
Instead, it focuses on post-break acceptance quality. The key question is not simply "did price break?" The key question is "did price remain accepted beyond the broken reference long enough to reduce tag-only risk?"
This keeps the script separate from Breakout Volume Quality, Consolidation Breakout Quality, Break-Retest Quality, Price Acceptance Profile, and reference-specific breakout tools in the AGPro catalog.
⚙️ Methodology
1. Context Detection
The script maps rolling upper and lower reference edges from prior bars. These references are used only as breakout acceptance anchors.
2. Reference Mapping
When price closes beyond a reference edge by an ATR-adjusted buffer, the planner starts an active acceptance sequence.
3. Reaction Evaluation
The active sequence is scored through close persistence, time beyond the level, acceptance-band retests, candle quality, relative volume support, and distance from the failure shelf.
4. Visual Output
The chart shows an acceptance band, a failure shelf, a target-room guide, compact state labels, and a panel that summarizes acceptance score, time beyond, break side, failure risk, and action.
🗺️ How to Read the Chart
Acceptance Band = the zone around the broken level where price should hold if acceptance is developing.
Failure Shelf = the invalidation context behind the broken level. A close through this shelf means the breakout acceptance sequence needs review.
Target Room = a projected planning guide based on the prior reference range. It is not a forecast or promised target.
Labels = compact event markers such as BULL BRK, BEAR BRK, WATCH, HOLD, ACCEPT, TAG, RISK, and REJECT.
Colors = teal supports constructive acceptance, pink marks rejection or failure pressure, yellow marks caution, and indigo marks active watch states.
Panel = a compact decision view showing Acceptance Score, Time Beyond, Break Side, Failure Risk, and Action.
🚦 Signals & States
• BULL BRK → price closed beyond the upper reference and started an acceptance review.
• BEAR BRK → price closed beyond the lower reference and started an acceptance review.
• WATCH → acceptance evidence is improving but is not mature yet.
• HOLD → price revisited the acceptance band and held beyond the broken reference.
• ACCEPT → close persistence, score quality, and time beyond the level reached the accepted state.
• TAG → the sequence is active, but close persistence is still weak after the review window.
• RISK → acceptance is not mature and the failure shelf is becoming more relevant.
• REJECT → price closed through the failure shelf after the breakout sequence.
🔔 Alerts Logic
Alerts trigger when a new acceptance break starts, when accepted state appears, when a retest hold is detected, when failure risk rises, or when price rejects through the failure shelf.
Alerts are attention markers. They are not trade instructions, automation commands, or certainty statements.
🧩 Confluence Logic
The strongest acceptance context appears when several conditions align:
• price closes beyond the broken reference more than once
• the acceptance band holds during a retest
• candle structure remains directional
• failure shelf distance remains healthy
• volume support is present without being the only reason for the score
When these elements align, the Acceptance Score rises and the state becomes easier to interpret.
📊 When to Use
• Breakout review after price crosses a visible range edge
• Markets where one-bar breakout tags are common
• Trend continuation attempts that need acceptance confirmation
• Range expansion moves where the trader wants to separate holding behavior from weak level pokes
• Chart review workflows that need a clear post-break next-action state
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable candles
• Very noisy symbols where reference edges are constantly pierced
• News-driven volatility where ATR buffers may become unstable
• Situations where the user expects automatic trade entries
• Markets where volume data is missing and volume support is treated as less useful
🎛️ Key Inputs
• Break Side → controls whether the planner evaluates bullish breaks, bearish breaks, or both.
• Reference Lookback → defines the prior-bar range used to map breakout reference edges.
• Close Beyond Level ATR → controls how far beyond the level price must close before a sequence starts.
• Acceptance Band ATR → controls the retest-hold zone around the broken level.
• Failure Shelf ATR → controls the invalidation context behind the broken level.
• Minimum Beyond Closes → controls how much close persistence is required before acceptance can mature.
• ACCEPTED Threshold → sets the minimum 0-100 score for accepted state.
• Label / Panel Controls → adjust visual density, placement, theme, and font size.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first. The acceptance band and failure shelf show the current structure, while labels mark only meaningful state changes.
The panel uses the AGPro standard: a single blue merged header row, compact rows, clear state colors, adjustable location, adjustable theme, and normal font size by default.
The visual hierarchy is intentionally restrained so the chart looks active without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel to see the current Acceptance Score and action state.
2. Check whether price is holding beyond the broken reference or drifting back into the band.
3. Watch the failure shelf to understand whether the breakout is losing acceptance.
4. Review labels only as context markers, not as standalone decisions.
5. Confirm the broader market context before acting on any chart interpretation.
🔍 Interpretation Guidelines
Think of the script as a post-break acceptance reviewer.
A higher Acceptance Score means the breakout has stronger evidence of persistence according to the script model. A lower score means the move may still be early, weak, or vulnerable to failure.
The most useful reading is the relationship between time beyond the level, retest behavior, and failure shelf distance.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not guaranteed signals
• Not a generic support/resistance map
• Not a consolidation breakout box tool
• Not a pure volume breakout detector
• Not a full break-retest scanner
⚠️ Limitations & Transparency
Breakout acceptance is sensitive to timeframe, volatility, liquidity, and symbol behavior.
The reference edges are rolling and can change as older bars leave the lookback window.
ATR-based buffers can expand or contract during volatile market conditions.
Relative volume may be less useful on symbols with limited or inconsistent volume data.
🧠 Market Context Notes
Acceptance after a breakout is often more useful than the initial break itself.
A level tag shows that price reached a reference. Acceptance shows whether price can keep spending time beyond that reference.
This distinction is the core purpose of the planner.
🧾 Use Case Examples
When price closes above a reference edge and then holds the acceptance band on a later retest, the script may shift from watch context toward stronger acceptance.
When price breaks a reference but quickly returns through the failure shelf, the script marks rejection context instead of treating the break as mature.
When price remains beyond the level but does not build enough persistence, the script can show TAG ONLY or FAILURE RISK.
🧱 System Philosophy
Acceptance Breakout Planner follows the AGPro decision-engine approach:
It does not ask users to react to a raw signal.
It organizes the chart into quality, state, risk, target-room context, and next-action review.
🔐 Non-Promise Statement
No script can remove uncertainty from markets.
No state, score, label, band, shelf, or alert guarantees future price behavior.
📉 Risk Disclosure
Trading involves risk.
This script is for educational and analytical use only.
It does not provide financial advice, investment advice, trade instructions, or guaranteed outcomes.
Users remain responsible for their own decisions, risk management, and market evaluation.
📚 Educational Note
Use the script to study the difference between a breakout tag and breakout acceptance.
The strongest value comes from comparing the planner state with broader structure, volatility, liquidity, and personal execution rules.
Indicator

Reclaim Breakout Planner [AGPro Series]Reclaim Breakout Planner
🧠 Core Idea
Is a recently broken structural level being lost and reclaimed in a way that creates a valid breakout planning area?
📌 Overview / What it does
Reclaim Breakout Planner is a chart-first breakout planning tool built around structural pivot reclaim behavior. It detects when price breaks beyond a confirmed pivot level, temporarily moves back through that broken level, and then closes back on the breakout side with measurable acceptance quality.
The script produces a 0-100 Acceptance Score, an active Reclaim State, an Acceptance Pocket, a Risk Edge, a Target Corridor, controlled chart labels, and a compact AG Pro panel. The goal is to help traders organize reclaim context after a structural breakout attempt.
This script does not predict price direction, automate trades, or mark every pivot as important. It filters for a specific sequence: structural level break -> temporary level loss -> reclaim close -> planning state.
🎯 Purpose & Design Philosophy
Many breakout tools stop after price crosses a level. Many retest tools treat any return to the level as meaningful. This script was built for the narrower question that often matters after a breakout: did price briefly lose the broken level and then reclaim it with enough quality to deserve attention?
It is designed for traders who want a cleaner decision-support layer around breakout acceptance, not another crowded support/resistance map. The mindset is planning first: evaluate validity, score quality, locate risk, estimate target room, and decide whether the context deserves monitoring.
⚡ Why This Script Is Different
Most tools focus on the breakout candle or the retest touch.
This script does NOT clone VWAP Reclaim Quality, Previous Day Sweep & Reclaim, EMA reclaim maps, session VWAP reaction tools, or a simple breakout retest readiness model.
Instead, it focuses on structural pivot reclaim after a level is briefly lost. The reclaim must come from a confirmed pivot break, a temporary move back through the broken level, and a close back on the breakout side. That creates a distinct reclaim-planning workflow rather than a generic level scanner.
⚙️ Methodology
1. Context Detection
The script identifies confirmed pivot highs and pivot lows as structural levels. These levels are not VWAP, previous-day highs/lows, session anchors, order blocks, or fixed support/resistance zones.
2. Breakout Arming
When price closes beyond a pivot level by an ATR-normalized amount, the planner arms a reclaim watch. A bullish watch begins after a close above resistance. A bearish watch begins after a close below support.
3. Reclaim Evaluation
The script waits for price to temporarily lose the broken level and then close back through it. It scores the event using reclaim close distance, retest depth, volume support, trend alignment, and wick rejection.
4. Visual Output
Accepted reclaims create an Acceptance Pocket, Risk Edge, Target Corridor, event labels, sparse context labels, and panel state. The visuals are designed to stay readable without leaving the chart empty.
🗺️ How to Read the Chart
Acceptance Pocket = the reclaimed structural level area where the breakout side is being tested.
Risk Edge = the failed-side reference beyond the pocket. It is a planning boundary, not a trading instruction.
Target Corridor = a projected review area based on the reclaim risk distance and the selected R multiple.
Labels = compact event and context markers such as Bull Reclaim, Bear Reclaim, Retest Watch, and Failed Reclaim. Target Review labels are optional because the target corridor already marks the review area.
Colors = bullish reclaim context uses teal, bearish reclaim context uses pink, caution/watch states use gold or indigo, and risk/failure context uses red.
Panel = shows Reclaim State, Acceptance Score, Risk Edge, Target Room, and Action.
🚦 Signals & States
• Scan Structure → no active reclaim plan exists yet.
• Bull Retest Watch → price broke above a structural pivot and is waiting for a valid reclaim sequence.
• Bear Retest Watch → price broke below a structural pivot and is waiting for a valid reclaim sequence.
• Acceptance Watch → reclaim exists, but the score is not strong enough for the highest planning state.
• Plan Review → reclaim quality is strong enough to monitor as structured planning context.
• Risk Edge Test → price is testing the failed-side boundary.
• Failed Reclaim → the active reclaim plan closed beyond the risk edge.
• Target Review → price reached the projected target corridor area.
🔔 Alerts Logic
Bullish Reclaim Breakout Plan triggers when a bullish structural reclaim is accepted and the score is above the alert threshold.
Bearish Reclaim Breakout Plan triggers when a bearish structural reclaim is accepted and the score is above the alert threshold.
Reclaim Risk Edge Failed triggers when an active reclaim plan closes beyond the risk edge.
Reclaim Target Corridor Reached triggers when price reaches the projected target corridor.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when a confirmed pivot breakout, temporary level loss, reclaim close, supportive volume, trend alignment, and wick rejection appear together. The score compresses those components into one readable 0-100 Acceptance Score.
📊 When to Use
• After structural breakouts where price returns to the broken level
• During trending or transitioning markets where reclaim behavior matters
• When evaluating whether a breakout level is being accepted after a brief failure
• When a trader needs risk edge and target-room context around a reclaim sequence
⚠️ When NOT to Use
• Very low-liquidity symbols with unreliable volume and erratic candles
• Extremely noisy ranges where pivots form too frequently
• News-driven candles where ATR-normalized structure can be distorted
• Markets where price is far from any meaningful structural pivot
🎛️ Key Inputs
• Reclaim Side → selects Auto, Bullish Only, or Bearish Only.
• Pivot Strength → controls how selective structural levels are.
• Minimum Break Close ATR → defines how far beyond the pivot price must close before a reclaim watch is armed.
• Minimum Level Loss ATR → requires price to temporarily move back through the broken level before reclaim evaluation.
• Acceptance Pocket ATR → controls the visual and logical reclaim pocket size.
• Retest Window Bars → controls how long the reclaim watch remains valid.
• Risk Edge Buffer ATR → adjusts the failed-side planning boundary.
• Target Corridor R Multiple → controls the projected target review area.
• Label and Panel Settings → control chart label density, optional target review labels, font size, panel location, and panel theme.
🖥️ Interface & Visual Design
The interface is intentionally compact. The chart carries the main decision layer through acceptance pockets, risk edges, target corridors, and event labels. The panel acts as a quick readout for state, score, risk, target room, and next action.
The first panel row follows the AGPro style with a merged blue title row. Label density is controlled by cooldown and maximum visible label settings so the chart remains premium and readable.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check whether the planner is scanning, watching a retest, or showing an accepted reclaim.
3. Inspect the Acceptance Pocket and Risk Edge.
4. Compare the Acceptance Score with the active state.
5. Use the Target Corridor as a review area, not as a guaranteed objective.
🔍 Interpretation Guidelines
A high score means the reclaim sequence is cleaner under the script's rules. It does not mean the market must continue.
A weak score means the reclaim lacks enough acceptance quality, volume support, trend alignment, or wick rejection.
A failed reclaim means the planning structure has weakened and should be re-evaluated in broader market context.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a VWAP reclaim tool
• Not a previous-day sweep reclaim script
• Not a generic support/resistance map
• Not an order block or FVG scanner
⚠️ Limitations & Transparency
Timeframe selection affects pivot behavior. Lower timeframes may create more reclaim sequences, while higher timeframes may produce fewer but more important structural levels.
Volatility can widen pockets and risk edges. During extreme volatility, reclaim signals can appear later or fail faster.
Volume quality may be less reliable on markets where reported volume is synthetic, incomplete, or inconsistent.
🧠 Market Context Notes
Reclaim behavior often matters when a market tests whether a broken level is becoming accepted. A clean reclaim can show that a breakout area is still being defended. A failed reclaim can show that the attempted breakout lost structure.
The script treats that behavior as planning context, not certainty.
🧾 Use Case Examples
When price closes above a pivot high, dips back below the broken level, then closes back above it with rejection wick and supportive volume, the planner may create a bullish reclaim plan.
When price closes below a pivot low, trades back above the broken level, then closes back below it with rejection behavior, the planner may create a bearish reclaim plan.
🧱 System Philosophy
AGPro tools are designed to help traders organize context, not chase isolated signals. This script follows that principle by turning reclaim behavior into a structured planning workflow with score, state, risk edge, target room, and action text.
🔐 Non-Promise Statement
No script can guarantee continuation, reversal, or future price behavior. Reclaim structure can fail, especially in fast, illiquid, or news-driven markets.
📉 Risk Disclosure
Trading involves risk. This script is for educational and analytical use only. It does not provide financial advice, investment advice, or guaranteed trading outcomes. Users remain responsible for their own decisions.
📚 Educational Note
Use the script to study how reclaimed structural levels behave across symbols, timeframes, and volatility environments. The best use is disciplined observation, comparison, and context building.
Indicator

Gap Continuation Planner [AGPro Series]TITLE
Gap Continuation Planner
🧠 Core Idea
Is the active gap being accepted for continuation, or is it losing the structure needed for a clean plan?
📌 Overview / What it does
Gap Continuation Planner is a chart-first gap planning tool built to evaluate what happens after a gap appears. Instead of treating every gap as an automatic fill candidate, it asks whether price is accepting the gap edge, following through away from the gap, and preserving a measurable defense line.
The script produces a gap defense zone, a continuation corridor, an acceptance edge, a defense line, a target guide, compact labels, alerts, and a clean AGPro decision panel. The panel converts the live context into a 0-100 continuation score, fill-risk reading, and next-action state.
It does not predict future price, automate trades, or tell the user to buy or sell. It organizes observable gap behavior into a more disciplined continuation-planning framework.
🎯 Purpose & Design Philosophy
This script was built for traders who do not want to reduce every gap to a simple fill-or-fade idea.
Many gaps initially look strong, but the important question is whether the market continues to accept the gap after the first reaction. Gap Continuation Planner focuses on that middle layer: gap acceptance, follow-through, volatility load, defense quality, fill pressure, and forward room.
The design supports a planner mindset. The goal is to slow the decision process down and review whether the structure is valid enough to deserve attention.
⚡ Why This Script Is Different
Most gap tools focus on gap detection, gap fill percentage, or historical gap zones.
This script does NOT work as a generic gap-fill reaction tool, support/resistance map, imbalance catalog, or automatic signal generator.
Instead, it treats the latest gap as a continuation planning object. The model studies whether price is accepting the continuation side of the gap, whether follow-through is developing, whether the defense line remains intact, whether fill risk is rising, and whether there is enough forward room for the plan to remain clean.
⚙️ Methodology
1. Context Detection
The script detects classic opening gaps, wick gaps, body-separation gaps, and controlled continuation launch windows when adaptive mode is enabled.
2. Reference Mapping
Each accepted gap creates a gap defense zone, an acceptance edge, a defense line, and a target guide.
3. Reaction Evaluation
The engine scores gap size, open acceptance, follow-through, volatility load, fill risk, and forward room.
4. Visual Output
The chart displays a centered gap-zone label, a centered continuation-corridor label, event labels, planner lines, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = the detected gap defense area.
Continuation corridor = the forward planning area between the accepted gap edge and target guide.
Acceptance edge = the side of the gap that price should hold for continuation structure to remain stronger.
Defense line = an ATR-buffered invalidation reference beyond the far side of the gap.
Labels = state changes such as new gap, acceptance watch, continuation ready, defense review, or failed acceptance.
Colors = bullish continuation context uses teal, bearish continuation context uses pink, watch states use indigo, and caution states use amber.
Panel = summarizes gap state, continuation score, defense line, fill risk, and next action.
🚦 Signals & States
• New Gap → a fresh gap continuation window has been detected.
• Acceptance Watch → price is holding the continuation side of the gap, but follow-through still needs confirmation.
• Continuation Ready → the gap has stronger acceptance, follow-through, room, and risk structure.
• Defense Test → price is retesting the gap edge or defense area.
• Fill Risk → the gap is being penetrated enough to reduce continuation quality.
• Gap Failed → the active gap has lost continuation acceptance.
🔔 Alerts Logic
Alerts trigger when a new gap continuation window appears, when the gap reaches READY state, when acceptance watch begins, when defense review becomes relevant, or when gap acceptance is lost.
Alerts are attention markers. They are not trade instructions and do not guarantee that continuation will occur.
🧩 Confluence Logic
The strongest continuation context appears when gap size, gap-edge acceptance, follow-through distance, stable volatility, low fill pressure, and enough forward room align.
When these elements align, the continuation score improves. When fill pressure rises or volatility becomes too hot, the score weakens.
📊 When to Use
• After opening gaps in stocks, indices, futures, or session-based markets
• During continuation attempts after a strong gap
• When reviewing whether a gap is holding acceptance or losing structure
• Around breakout continuation sessions where risk and target references need to be visible
⚠️ When NOT to Use
• Extremely low-liquidity markets
• Very noisy or overlapping session opens
• News-driven gaps with unstable spreads
• Markets where volume and session structure behave unusually
• Environments where price is already far beyond a reasonable risk reference
🎛️ Key Inputs
• Sensitivity → adjusts how strict the gap and score requirements are.
• Gap Mode → controls whether the script reads classic gaps only or adaptive continuation windows.
• Acceptance Bars → changes how many bars must hold the continuation side of the gap.
• Follow-Through ATR → controls the preferred travel away from the gap edge.
• Defense Buffer → sets the ATR spacing for the defense line.
• Forward Room Lookback → helps estimate whether nearby structure limits continuation room.
• Minimum Continuation Score → sets the READY threshold.
• Visual settings → control zones, corridors, lines, labels, object limits, and panel appearance.
• Show Failed / Stale Objects → controls whether old failed corridors remain visible. It is disabled by default for a cleaner publication view.
🖥️ Interface & Visual Design
The interface is built for quick planner-style review. The chart carries the structural map, while the panel provides the decision summary.
The first panel row follows the AGPro merged blue header standard. The remaining rows focus only on the practical planning fields: state, score, defense, fill risk, and action.
The visual hierarchy is intentionally restrained so the gap, corridor, and labels are readable without turning the chart into a crowded signal map.
By default, failed or stale gap objects are hidden after they lose live planning value. Event labels remain available so the chart keeps context without carrying too many old failed boxes.
🧪 Practical Usage Workflow
1. Read the panel state and continuation score.
2. Check whether price is holding the gap acceptance edge.
3. Review the continuation corridor and target guide.
4. Compare fill risk against the defense line.
5. Use alerts as review markers, not execution commands.
6. Confirm the context with broader market structure, liquidity, and personal risk rules.
🔍 Interpretation Guidelines
A high continuation score means the active gap has stronger structure inside this model. It does not mean the move must continue.
Low fill risk supports continuation structure. Rising fill risk means price is starting to challenge the gap.
The defense line is a planning reference. It is not a guaranteed stop level and should not replace the user's own risk process.
Continuation corridors are visual planning areas, not promised target zones.
🚫 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 does not provide guaranteed signals.
This script does not replace independent confirmation, risk management, or execution discipline.
⚠️ Limitations & Transparency
Gap behavior varies heavily across asset classes, sessions, and timeframes.
Adaptive launch windows can help continuous markets, but they should still be interpreted as structured gap-like planning areas rather than classic exchange-session gaps.
High volatility can make defense and target references wider.
Low liquidity can distort gap quality, label timing, and fill-risk readings.
No rule-based script can fully account for news, slippage, spread changes, or sudden liquidity shifts.
🧠 Market Context Notes
Gap continuation is often more meaningful when it aligns with trend pressure, session participation, volatility structure, and clean forward room.
A gap is not important simply because it exists. It becomes more useful when price accepts one side of it and maintains a measurable defense structure.
🧾 Use Case Examples
When price gaps up, holds above the gap edge, and the continuation score improves, the script can help review whether the gap is being defended.
When price gaps down and repeatedly rejects back below the gap edge, the panel can help evaluate bearish continuation structure.
When fill risk rises quickly, the script highlights that the gap may be losing acceptance rather than continuing cleanly.
🧱 System Philosophy
AGProLabs tools are built around structured interpretation. The goal is not to add more signals to the chart. The goal is to turn market behavior into a cleaner review process.
Gap Continuation Planner follows that approach by converting a raw gap into a measurable planning object.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No score can guarantee continuation.
No planner can replace the trader's responsibility to manage risk.
📉 Risk Disclosure
Trading involves risk.
This script is provided for educational and analytical use only.
It does not provide financial advice, investment advice, trading advice, or guaranteed outcomes.
Users remain responsible for their own decisions, risk management, position sizing, and execution.
📚 Educational Note
The strongest use of this tool is to study whether a gap is being accepted or rejected as structure develops. It is designed to support review, patience, and disciplined interpretation.
Indicator

Session Range Expansion Planner [AGPro Series]Session Range Expansion Planner
🧠 Core Idea
Is the session expanding from balance into a valid range extension, or is the break still too weak to trust as context?
📌 Overview / What it does
Session Range Expansion Planner is a 1H-focused intraday execution-readiness tool built around one clear workflow: define the early-session balance, track expansion beyond that range, and score whether the move has enough acceptance, volume support, volatility fit, and target room to deserve attention.
The script produces a session range box, accepted target-room bands, acceptance/rejection context, alerts, and a premium AGPro panel with a 0-100 planner score. The default visual preset is optimized for 1H and lower charts. Higher intraday charts such as 4H are intentionally kept clean by default.
It does not predict the next candle, automate entries, or issue buy/sell commands. It organizes session behavior into a structured decision layer so the user can evaluate the setup within their own plan.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between simple session boxes and generic breakout indicators.
Most tools show where the session range is. Fewer tools explain whether the break from that range is actually being accepted, whether participation supports it, and whether there is usable room beyond the range.
Session Range Expansion Planner supports a planning mindset: define balance first, wait for expansion, check acceptance, evaluate room, then decide whether the context is worth further review.
⚡ Why This Script Is Different
Most session tools focus on marking opens, coloring sessions, or printing a breakout label as soon as price crosses a high or low.
This script does NOT act as a generic session high/low map, generic support/resistance tool, or broad session reaction scanner.
Instead, it treats the first part of the session as a balance structure and asks whether the later expansion has enough quality to become actionable context. The decision layer is built around acceptance bars, volume support, ATR regime, obstacle distance, and target-room quality.
⚙️ Methodology
1. Context Detection
The script reads the selected intraday session and builds an initial balance range from the first user-defined number of bars.
2. Reference Mapping
The session balance high and low become the only active expansion boundaries. The tool does not use PDH, PDL, weekly open, order blocks, FVGs, or generic swing zones.
3. Reaction Evaluation
When price breaks beyond the balance range, the engine measures acceptance closes, volume support, ATR regime quality, break distance, and nearby obstacle room.
4. Visual Output
The script displays a centered session range label, directional expansion labels, target-room band, acceptance/rejection labels, alerts, and a premium panel with score and next-action state.
🗺️ How to Read the Chart
Session Range Box = the early-session balance area.
Expansion Labels = the side where price first expands beyond the balance high or low.
Target-Room Band = the projected room beyond the broken boundary after expansion has been accepted, scaled by session range or ATR.
Acceptance Labels = confirmation that price has sustained closes beyond the range for the configured number of bars.
Rejection Labels = warning that price has failed back through the broken boundary.
Colors:
• Teal = upside expansion context
• Pink = downside expansion context
• Amber = neutral, warning, or rejection context
• Indigo = AGPro visual accent and target-room support
Panel = the decision cockpit showing planner score, session range, expansion side, acceptance, room score, and next action.
🚦 Signals & States
• Range Set → the initial balance window has completed.
• Expansion Up → price expanded above the session balance high.
• Expansion Down → price expanded below the session balance low.
• Accepted → the expansion held beyond the range for the required acceptance bars.
• Rejection Risk → price failed back through the broken boundary.
• Room Check Reached → price reached the projected target-room area.
🔔 Alerts Logic
Alerts trigger when:
• Upside range expansion is detected
• Downside range expansion is detected
• Expansion becomes accepted
• Rejection risk appears after expansion
Alerts are attention markers. They are not trade instructions and should be interpreted together with broader market context.
🧩 Confluence Logic
The strongest context appears when expansion direction, sustained acceptance, volume support, balanced ATR regime, and clean target room align at the same time.
When those conditions stack together, the planner score rises and the panel moves toward a review-ready state.
📊 When to Use
• 1H intraday charts with clear session behavior
• Opening balance or early-session range workflows
• Breakout quality review
• Volatility expansion planning
• Session continuation evaluation
The script is most useful when a trader wants to know whether a session range break is actually being accepted, not just whether a line was crossed.
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy micro timeframes
• Markets with unreliable volume
• Sessions with irregular trading hours
• News-driven candles where range expansion is disorderly
In weak conditions, reduce sensitivity or require stricter acceptance.
🎛️ Key Inputs
• Session Timezone → defines how the selected session is interpreted.
• Expansion Session → sets the active intraday window. The default full-day session is designed to work cleanly on crypto and other 24-hour symbols.
• Visual Timeframe Preset → controls which intraday timeframes show chart objects. The default is 1H and lower because 4H session expansion charts can become too compressed.
• Balance Window Bars → controls how many early-session bars define the range.
• Acceptance Bars → defines how much sustained closing behavior is required.
• Sensitivity → adjusts how fast the script recognizes expansion.
• Confirmation Mode → controls wick, close, or strict acceptance confirmation.
• Minimum Planner Score → sets the score threshold for review-ready context.
• ATR Length → controls volatility normalization and label spacing.
• Obstacle Lookback → estimates nearby structure that may reduce room quality.
• Target Room Multiplier → controls the projected target-room distance.
• Visual Settings → control range boxes, centered range label limit, rails, accepted target-room band, minimum visual score, optional expansion labels, optional room-check labels, optional range-set labels, label size, and object limits.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is chart-first. The range box and target-room band carry the main visual story, while labels explain state transitions only when meaningful events occur.
The panel is intentionally compact. It gives a fast read of expansion quality without forcing the user to decode many separate plots.
The first panel row follows the AGPro standard: a single merged blue header row with only the script name.
🧪 Practical Usage Workflow
1. Apply the script to an intraday chart.
2. Confirm the correct session and timezone.
3. Let the initial balance window complete.
4. Watch for expansion beyond the balance high or low.
5. Check whether acceptance bars confirm sustained behavior.
6. Read the planner score and room score.
7. Use the next-action state as context for your own execution plan.
🔍 Interpretation Guidelines
A clean expansion is not just a break beyond the range. It should show acceptance, participation, reasonable volatility, and enough room before nearby obstruction.
Low scores usually mean the break is early, unsupported, too noisy, too extended, or too close to an obstacle.
The best use is comparative: review which sessions and symbols repeatedly produce clean accepted expansions versus weak false breaks.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a buy/sell command system
• Not a generic support/resistance map
• Not an order block, FVG, or liquidity sweep scanner
⚠️ Limitations & Transparency
Session behavior can vary across assets, timeframes, exchanges, and trading hours.
ATR regime and volume support are rule-based approximations, not certainty models.
On very low timeframes, labels may appear more frequently. On higher intraday timeframes, fewer but more meaningful events are expected.
Markets can expand cleanly and still reverse later. The tool measures context quality, not future certainty.
🧠 Market Context Notes
Session range expansion often becomes more meaningful when it is read together with broader trend, liquidity, volatility, and higher-timeframe structure.
The script deliberately stays focused on session balance and expansion quality. Users can combine it with their own broader framework without duplicating other AGPro tools.
🧾 Use Case Examples
When price breaks above the session range, holds above the balance high for the required acceptance bars, and room score remains strong, the panel may shift into review-ready continuation context.
When price breaks the range but quickly closes back inside the balance, the script marks rejection risk and the panel moves away from continuation review.
🧱 System Philosophy
AGPro tools are built to help traders organize context into clear decision layers.
Session Range Expansion Planner follows that philosophy by turning a common intraday event into a structured planning process: balance, expansion, acceptance, room, action.
🔐 Non-Promise Statement
No script can guarantee future price movement.
The score is a structured context model, not a certainty model.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and historical session behavior does not guarantee future outcomes.
Users are responsible for their own decisions, risk management, and position sizing.
This script is provided for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the script to study how different markets expand from early-session balance. The most valuable insight is not a single label, but the repeated relationship between range quality, acceptance, room, and market context.
Indicator

Opening Drive Quality [AGPro Series]Opening Drive Quality
🧠 Core Idea
Is the first directional drive of the session strong enough to plan around, or is it already losing execution quality?
📌 Overview / What it does
Opening Drive Quality is a session execution planner that evaluates the first directional drive after the market opens. It studies the opening drive channel, early follow-through, pullback acceptance, risk-line integrity, and target-room structure in one clean decision framework.
The script produces a 0-100 quality score, a clear next-action state, an opening drive channel, a pullback acceptance zone, an invalidation risk line, target guide, compact chart labels, alerts, and a premium AGPro panel.
It does not predict price direction, automate trades, or mark every opening range breakout. Its purpose is to help traders evaluate whether the early session drive has enough structure, acceptance, and risk clarity to deserve attention.
🎯 Purpose & Design Philosophy
The script was built for traders who need more than an opening range box or a simple breakout marker. The first session move often sets the tone, but the useful question is not only whether price moved. The useful question is whether that move produced clean follow-through, controllable risk, and a meaningful pullback area.
Opening Drive Quality fills that gap by turning the opening move into a structured planning map. It supports traders who study session execution, intraday momentum, and pullback planning without relying on generic signals.
The design philosophy is simple: evaluate the quality of the first drive, define the risk line, project the pullback acceptance zone, and make the next state readable at a glance.
⚡ Why This Script Is Different
Most tools focus on opening range breakouts, session boxes, fixed kill zones, or failed-break signals.
This script does NOT try to clone a generic ORB tool, a kill-zone session engine, or an opening range failure map.
Instead, it focuses on the quality of the first directional drive itself. It asks whether the drive has real thrust, whether follow-through appears after the drive locks, whether price accepts a pullback zone, where the risk line sits, and what the next planning state should be.
⚙️ Methodology
1. Context Detection
The script builds the opening drive from either a fixed session window or the first bars of a new day. This keeps the tool useful across regular-market assets and 24/7 markets.
2. Reference Mapping
After the drive locks, the script maps the opening drive channel, pullback acceptance zone, invalidation risk line, and target-room guide. These references come from the opening drive structure, not from generic support and resistance pivots.
3. Reaction Evaluation
The engine scores drive thrust, close location, range expansion, optional relative volume, follow-through distance, pullback behavior, and risk-line integrity.
4. Visual Output
The chart shows the active drive channel, projected pullback zone, risk line, target guide, state labels, and a compact panel with the key planning reads.
🗺️ How to Read the Chart
Opening Drive Channel = the locked first directional drive of the session.
Pullback Acceptance Zone = the area where a controlled pullback can be evaluated after a valid drive.
Risk Line = the invalidation line derived from the drive base, pullback zone, and ATR buffer.
Target Guide = a projected target-room reference based on the opening drive range.
Labels = compact markers for drive lock, follow-through, pullback acceptance, weak drive, risk break, and target check.
Colors = teal for bullish drive context, pink for bearish drive context, amber for review states, and indigo for structural emphasis.
Panel = the decision layer showing Drive Side, Follow-Through, Pullback Quality, Risk Line, and Action.
🚦 Signals & States
• DRIVE Q → the opening drive has locked and received a 0-100 quality score.
• FOLLOW Q → the drive has produced directional follow-through after locking.
• PULLBACK ACCEPTED → price is reacting constructively inside the projected pullback acceptance zone.
• WEAK DRIVE → follow-through has not developed inside the review window.
• RISK BROKEN → the active drive has violated its invalidation line.
• TARGET CHECK → price has reached the projected target-room guide.
🔔 Alerts Logic
The script includes alerts for:
• Opening Drive Quality Locked → a qualified opening drive has completed.
• Drive Follow-Through → directional extension appears after the drive locks.
• Pullback Accepted → price reacts inside the projected pullback acceptance zone.
• Risk Line Broken → price violates the active drive risk line.
• Target Guide Reached → price reaches the projected target-room guide.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when opening drive thrust, close location, session volatility, relative volume, follow-through, and pullback acceptance align.
The context becomes weaker when the opening drive locks with poor thrust, cannot extend, pulls back too deeply, or breaks the risk line.
📊 When to Use
• Intraday session planning.
• Opening-drive analysis after the first market push.
• Markets where the opening session often defines early direction.
• Pullback planning after a strong first drive.
• Session review where risk line and target-room context matter.
⚠️ When NOT to Use
• Very low-liquidity markets.
• Extremely noisy opens with unstable spreads.
• News-driven bars where the first drive is unusually distorted.
• Assets where the selected opening session is not meaningful.
• Higher timeframes where the opening drive window has no practical session context.
🎛️ Key Inputs
• Opening Drive Mode → chooses first bars of day or a fixed session window. First Bars Of Day is the default so the chart loads with visible drive structure across more symbols.
• Opening Drive Session → defines the drive-building window.
• Tracking Session → defines when follow-through and pullback logic remains active.
• Minimum Quality Threshold → controls when stronger planning labels appear.
• Follow-Through ATR → defines the extension needed for follow-through confirmation.
• Pullback Acceptance Depth → controls the projected pullback zone depth.
• Risk Line Buffer ATR → adjusts the invalidation line beyond the drive structure.
• Target Guide Multiple → controls the projected target-room guide.
• Panel / Label Settings → control panel location, theme, font size, label size, visible label count, minimum label quality, label cooldown, and optional compact plot markers.
🖥️ Interface & Visual Design
The interface is built around a clean AGPro panel and chart-first planning visuals. The panel uses a single merged blue header row with only the script name, then five practical rows: Drive Side, Follow-Through, Pullback Quality, Risk Line, and Action.
The chart uses one opening drive channel, one pullback acceptance zone, one risk line, one target guide, and compact labels. The goal is a premium session-planning view without clutter.
🧪 Practical Usage Workflow
1. Read the panel after the opening drive locks.
2. Check whether the drive side and score show a valid planning context.
3. Watch follow-through quality after the drive locks.
4. Evaluate whether price pulls back into the acceptance zone constructively.
5. Use the risk line and target guide as planning references, not automatic decisions.
🔍 Interpretation Guidelines
A strong score means the opening drive has better structure, cleaner close location, stronger volatility context, and better follow-through support.
A pullback acceptance label means price is reacting inside the projected drive-based zone. It does not mean price must continue.
A risk-line break means the original drive plan has lost structural integrity and should be reassessed.
The most useful interpretation comes from combining the panel state with broader market context, liquidity, and timeframe alignment.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not an auto-trading system.
• Not guaranteed signals.
• Not a generic support and resistance mapper.
• Not a clone of an ORB breakout tool.
• Not a kill-zone timing dashboard.
• Not an opening range failure scanner.
⚠️ Limitations & Transparency
Timeframe selection affects the opening drive shape. A 5-minute chart and a 15-minute chart can produce different drive channels.
Volatility changes can expand or compress the pullback zone and risk line.
Session definitions matter. The selected opening window should match the asset being studied.
High-impact news, abnormal spreads, and low liquidity can reduce the reliability of the opening drive map.
🧠 Market Context Notes
Opening drives are most useful when liquidity is active and the first session push creates a clear directional reference. A clean drive does not guarantee continuation, but it can create a structured area for evaluating pullback acceptance and invalidation.
The script intentionally keeps its references tied to the opening drive. It avoids pivot maps, order block language, broad S/R zones, and generic failed-break logic.
🧾 Use Case Examples
When price locks a strong bullish opening drive, extends beyond the channel, and then pulls back into the acceptance zone without breaking the risk line, the panel may shift toward a constructive planning state.
When price locks a drive but cannot create follow-through inside the review window, the script can mark the drive as weak and shift the action state toward bias reduction.
When price violates the risk line, the original opening drive plan is no longer structurally intact inside this model.
🧱 System Philosophy
Opening Drive Quality follows the AGPro decision-engine philosophy: a script should help the trader evaluate validity, strength, risk, target room, and next state instead of only printing another signal.
The tool is designed to make the opening session easier to interpret through structured references and clean visual hierarchy.
🔐 Non-Promise Statement
No script can provide certainty.
No opening drive model can guarantee continuation, reversal, or profitability.
This script provides structured context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use this script as an educational planning and visualization tool. The strongest use comes from reading the opening drive together with broader market structure, liquidity, volatility, and personal risk rules.
Indicator

Breakout Retest Readiness [AGPro Series]Breakout Retest Readiness
🧠 Core Idea
Is the post-breakout retest being accepted with structure, or is the breakout losing quality at the risk edge?
📌 Overview / What it does
Breakout Retest Readiness is a chart-first planning tool built to evaluate what happens after a confirmed breakout and after price starts interacting with the retest pocket.
The script maps the broken structure level, builds a retest pocket around it, places a risk-edge shelf beyond the pocket, and projects a target-room guide for context. It then scores the active retest environment with a 0-100 Acceptance Score and displays a clear next-action state in the AG Pro panel.
This script does not predict continuation. It does not automate entries. It is designed to organize post-breakout retest context so traders can review acceptance, rejection, risk edge, and plan quality in a cleaner way.
🎯 Purpose & Design Philosophy
Most breakout tools focus on the moment price crosses a level. In practice, many useful decisions happen after the break, when price returns toward the broken level and either accepts it or fails around it.
This script was built for traders who want a structured retest planning layer rather than another basic breakout marker. It supports a patient workflow: wait for structure, observe the pocket, evaluate acceptance, and review risk before reacting.
The design philosophy is simple: the chart should answer what state the retest is in, how strong the acceptance context is, where risk is being tested, and what the next review step should be.
⚡ Why This Script Is Different
Most tools focus on detecting a breakout or grading the first retest as a standalone signal.
This script does NOT try to clone a classic break-retest quality grader, and it does not print simple buy or sell commands.
Instead, it works as a post-breakout readiness planner. It arms a retest pocket after a confirmed breakout, waits for price to interact with that pocket, evaluates acceptance versus rejection, tracks the risk edge, and keeps the next-action state visible in the panel.
The difference is the decision layer. The script is less about saying "a retest happened" and more about answering whether the active retest environment is constructive enough to keep reviewing.
⚙️ Methodology
1. Context Detection
The script identifies a confirmed break beyond recent structure using a prior high or prior low reference. The breakout must clear the structure by an ATR-normalized buffer so minor pokes are filtered.
2. Reference Mapping
After a valid break, the script stores the breakout line, builds a retest pocket around it, places an invalidation shelf beyond the broken level, and projects a target-room guide from the prior structure range.
3. Reaction Evaluation
When price interacts with the retest pocket, the script evaluates breakout quality, retest depth, wick rejection, volume change, and trend agreement. These components combine into a 0-100 Acceptance Score.
4. Visual Output
The chart shows the active retest pocket, breakout line, risk edge, target guide, compact event labels, and the AG Pro panel. The panel summarizes retest state, acceptance score, breakout quality, risk edge, and action.
🗺️ How to Read the Chart
Retest Pocket = the zone around the broken structure level where price is being evaluated after the breakout.
Breakout Line = the structure level that was crossed and now anchors the retest plan.
Risk Edge = the invalidation shelf beyond the retest pocket. It is a planning reference, not a stop recommendation.
Target Guide = a target-room marker projected from the prior range. It is context only, not a forecast.
Labels = compact state markers such as ARMED, TEST, ACCEPT, REJECT, RISK EDGE, or EXPIRE.
Colors = bullish retest plans use the AGPro teal tone, bearish plans use the AGPro pink tone, watch states use indigo or amber, and risk conditions use red.
Panel = the main decision interface showing retest state, acceptance score, breakout quality, risk edge, and next action.
🚦 Signals & States
• Breakout Armed → a breakout retest plan has been created after price cleared structure.
• Testing Pocket → price is interacting with the active retest pocket and acceptance is being evaluated.
• Accepted Retest → the retest has held the pocket with enough acceptance quality to deserve review.
• Rejected Retest → the retest has failed around the pocket and quality has weakened.
• Risk Edge Hit → price has moved beyond the mapped risk shelf.
• Expired → the retest window aged out before a constructive interaction.
🔔 Alerts Logic
Alerts are available for breakout plan arming, retest pocket interaction, accepted retest readiness, rejected retest or risk-edge pressure, and expired retest plans.
Each alert is an attention marker. Alerts do not represent trade instructions, guaranteed outcomes, or automated strategy decisions.
🧩 Confluence Logic
The strongest acceptance context appears when the breakout quality, retest depth, wick rejection, volume behavior, and trend agreement support the same side.
When these components align, the retest score improves. When the pocket is too deep, volume behavior is poor, trend context disagrees, or the risk edge is pressured, the readiness state weakens.
📊 When to Use
• After clean breakouts from recent structure
• During trend continuation review
• When price returns toward a broken level
• When the trader wants to separate constructive retests from weak post-break reactions
• On liquid symbols where structure, volume, and candle behavior are readable
⚠️ When NOT to Use
• Extremely low-liquidity instruments
• Highly noisy lower timeframes
• News-driven volatility spikes
• Markets with no clear structure reference
• Situations where the breakout level is too close to major external obstruction
🎛️ Key Inputs
• Breakout Structure Lookback → controls the prior structure reference used for breakout detection.
• Maximum Bars To Retest → controls how long the script waits for the retest pocket to matter.
• Sensitivity → adjusts how strict the breakout and acceptance model should be.
• Minimum Acceptance Score → defines the score needed before accepted readiness can appear.
• Retest Pocket Width ATR → controls the width of the post-breakout pocket.
• Invalidation Shelf ATR → controls the mapped risk-edge distance beyond the broken level.
• Target Guide Range Multiple → controls the forward target-room guide.
• Visual Settings → control pockets, lines, labels, label density, label size, and forward rendering.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is built around a clean AG Pro panel and one main chart object family: the retest pocket.
The pocket label is centered inside the zone so the active state is visible without needing extra clutter. The breakout line, invalidation shelf, and target guide create a simple visual hierarchy: level, risk, and room.
Labels are intentionally compact and controlled by cooldown and maximum-visible settings so the chart remains active without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Locate the active retest pocket.
3. Check whether price is testing, accepting, rejecting, or pressing the risk edge.
4. Compare the Acceptance Score with the breakout quality.
5. Use the action row as a review prompt, not as an instruction.
🔍 Interpretation Guidelines
The Acceptance Score should be read as context quality, not certainty.
A higher score means the current retest has cleaner structural behavior under the script's rules. A lower score means the retest is less constructive, too deep, poorly supported, or not aligned with trend context.
The Risk Edge matters because a retest can look acceptable for a few bars and still lose structure if price pushes beyond the invalidation shelf. The panel keeps that condition visible.
🚫 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 does not provide guaranteed signals.
This script is not a generic support and resistance map.
This script is not a clone of a first-retest grading tool.
⚠️ Limitations & Transparency
The script is rule-based and depends on the selected lookback, timeframe, and market structure.
Different symbols can produce different retest behavior. Lower timeframes may show more noise. Higher timeframes may produce fewer but stronger events.
Volatility changes can affect pocket size, risk-edge distance, and event frequency. Users should interpret every output within broader market context.
🧠 Market Context Notes
Breakout retests are most useful when structure is clear, liquidity is sufficient, and price has enough room to continue without immediate obstruction.
Volume behavior can add context, but volume data quality varies across markets. When volume is unreliable, the script treats that component more neutrally.
The retest pocket is not a guaranteed support or resistance zone. It is a structured review area around the broken level.
🧾 Use Case Examples
When price breaks above recent structure and later returns to the pocket with a controlled pullback, the script can mark the retest as Testing Pocket or Accepted Retest depending on score quality.
When price breaks below structure but quickly pushes back above the pocket and pressures the mapped risk edge, the script can mark rejection or risk-edge pressure.
When a breakout never returns to the pocket within the selected time window, the script can expire the plan instead of keeping old context alive.
🧱 System Philosophy
AGPro tools are designed to support structured chart reading. The goal is not to add more random signals, but to turn market behavior into clearer states, cleaner context, and better review discipline.
Breakout Retest Readiness follows that philosophy by turning a common post-breakout question into a visible planning workflow.
🔐 Non-Promise Statement
No script can confirm future price direction with certainty.
This tool organizes retest context. It does not promise continuation, reversal, profit, or accuracy.
📉 Risk Disclosure
Trading involves risk.
All outputs from this script are educational and analytical in nature.
Users are responsible for their own decisions, risk management, position sizing, and market interpretation.
This script does not provide financial advice.
📚 Educational Note
Use the script to study how breakouts behave after price returns to the broken level. The most useful insight is often not the breakout itself, but how the market reacts when the level is tested again.
Indicator

Compression Breakout Readiness [AGPro Series]Compression Breakout Readiness
🧠 Core Idea
Is compression mature enough for a breakout watch state, or is the range still early, noisy, or structurally weak?
📌 Overview / What it does
Compression Breakout Readiness is a chart-first breakout planning tool designed to evaluate whether a compressed range has developed enough maturity to deserve active attention.
Instead of printing a generic breakout signal, the script studies range contraction, ATR compression, pivot tightening, volume dry-up, directional side bias, invalidation-edge distance, and projected breakout room. These components are converted into a 0-100 Readiness Score and a clear next-action state.
The script produces an active compression box, breakout watch corridor, invalidation edge, target guide, compact state labels, alerts, and a clean AGPro planning panel. It does not predict direction, automate execution, or guarantee that a breakout will follow through.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate the quality of compression before reacting to a breakout attempt.
Many breakout tools only mark the moment price crosses a level. The more useful planning question often comes earlier: is the range actually tight, mature, quiet, and biased enough to watch, or is the structure still too loose?
The design supports a decision-first workflow: identify compression, measure readiness, check risk edge, review the watch side, then decide whether the chart deserves attention.
⚡ Why This Script Is Different
Most tools focus on squeeze dots, breakout arrows, generic consolidation boxes, or simple high/low range breaks.
This script does NOT act as a generic squeeze indicator, a choppiness filter, a support/resistance mapper, or a direct buy/sell signal generator.
Instead, it evaluates compression maturity before and around the breakout edge. The main output is not a trade command. It is a readiness state that helps the user separate READY WATCH conditions from early, neutral, overheated, or invalidated compression contexts.
⚙️ Methodology
1. Context Detection
The script maps the active compression range and evaluates whether current volatility and range width are contracting relative to their baselines.
2. Reference Mapping
It builds the compression box, active breakout watch corridor, invalidation edge, and target guide from the current structure.
3. Reaction Evaluation
The model scores range contraction, ATR compression, pivot tightening, volume dry-up, side bias, and compression age. It also checks whether the invalidation edge is too tight, too wide, or balanced.
4. Visual Output
The result is shown through centered zone text, compact chart labels, clean edge lines, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Compression Box = the active range being evaluated for breakout readiness.
Breakout Watch Corridor = the planning area beyond the active compression edge.
Invalidation Edge = the opposite-side reference used to judge risk context.
Labels = compact state markers such as READY WATCH, WATCH, EDGE REVIEW, PREMATURE, HOT RISK, and INVALID EDGE.
Colors = teal for bullish watch context, pink for bearish or invalid context, amber for caution, and indigo for watch/neutral emphasis.
Panel = the panel summarizes Compression Age, Readiness Score, Expansion Side, Risk Edge, and Action.
🚦 Signals & States
• READY WATCH → compression is mature, biased, and risk edge distance is balanced enough for active review.
• WATCH → compression is developing, but at least one readiness component remains incomplete.
• EDGE REVIEW → price has moved beyond the compression edge and the user should verify the close and broader context.
• PREMATURE → compression has not lasted long enough to build strong maturity.
• HOT RISK → volatility has expanded too aggressively for clean readiness interpretation.
• NO BIAS → compression exists, but the directional side is not clear enough in Auto mode.
• INVALID EDGE → price crossed the active invalidation edge and the prior context may need reset.
🔔 Alerts Logic
Alerts trigger when the planner enters READY WATCH, WATCH, EDGE REVIEW, HOT RISK, or INVALID EDGE state.
These alerts are attention markers. They are not trade instructions, entry signals, broker actions, or automated strategy commands.
🧩 Confluence Logic
The strongest readiness state appears when multiple components align:
Range contraction + ATR compression + pivot tightening + volume dry-up + directional side bias + balanced risk edge.
When those components improve together, the score can rise toward READY WATCH. If volatility becomes too hot, risk becomes distorted, or the active edge fails, the state downgrades.
📊 When to Use
• Before evaluating a possible breakout setup
• During narrow ranges where volatility is compressing
• Around coiling structures that need maturity review
• When comparing whether one compression range is cleaner than another
• On liquid symbols where range, ATR, and volume behavior are meaningful
⚠️ When NOT to Use
• Extremely low-liquidity markets
• Highly noisy micro-timeframes
• News-driven volatility spikes
• Symbols with unreliable or missing volume data
• Situations where the user wants a simple breakout arrow or automated trade signal
🎛️ Key Inputs
• Breakout Watch Side → selects Auto, Bullish Watch, or Bearish Watch evaluation.
• Compression Lookback → defines the active range used for readiness scoring.
• ATR Baseline → controls volatility compression comparison.
• Volume Dry-Up Length → evaluates whether participation is contracting inside compression.
• Minimum Compression Age → controls how mature a range must be before stronger readiness states appear.
• READY / WATCH Thresholds → adjust how selective the planner is.
• Visual settings → control compression box, breakout corridor, range edges, invalidation edge, projection length, labels, and candle tint.
• Panel settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The compression box uses centered text so the user can read score and age directly inside the structure. The breakout corridor provides a clean forward planning reference without filling the chart with many competing levels.
The AGPro panel uses a single merged blue header row and a compact five-row decision layout. Label and panel font sizes are adjustable, with Normal as the default.
🧪 Practical Usage Workflow
1. Read the panel Readiness Score and Action.
2. Check whether the compression box is mature or premature.
3. Review the Expansion Side and breakout watch corridor.
4. Compare the Risk Edge with the visible structure.
5. Treat labels and alerts as review prompts, not trade commands.
🔍 Interpretation Guidelines
A higher score means the script sees stronger compression maturity according to its rule set.
READY WATCH does not mean price must break out. It means the compression context is organized enough to deserve attention.
WATCH means the structure may be developing but is not fully mature.
HOT RISK and INVALID EDGE are caution states. They warn that the range may no longer be clean enough for the same readiness read.
🚫 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 signals.
It is not a generic squeeze indicator.
It is not a choppiness dashboard.
It is not a support/resistance scanner.
It is not a direct breakout entry tool.
⚠️ Limitations & Transparency
Compression quality depends on the selected lookback, timeframe, volatility baseline, and market condition.
Volume dry-up may be less reliable on symbols with inconsistent exchange volume.
Fast volatility expansion can quickly change the readiness state.
Different timeframes can show different compression ranges and side-bias context.
The script is rule-based and should be interpreted as an analytical planning layer, not as certainty.
🧠 Market Context Notes
Compression by itself is not enough.
A useful breakout watch context also needs maturity, reduced noise, a readable side, and a practical invalidation edge.
This script keeps those elements visible so users can review breakout readiness before reacting emotionally to a candle crossing a range edge.
🧾 Use Case Examples
When a range contracts, ATR falls below baseline, volume dries up, and side bias becomes clear, the planner may move toward WATCH or READY WATCH.
When price pushes beyond the edge while readiness is acceptable, the script can mark EDGE REVIEW so the user can verify the close and broader context.
When ATR expands too aggressively before structure is mature, the planner can show HOT RISK instead of treating every move as a clean breakout context.
🧱 System Philosophy
Compression Breakout Readiness follows the AGPro Series decision-engine approach:
Context first.
Readiness before reaction.
Risk edge before target guide.
Attention markers instead of promises.
🔐 Non-Promise Statement
No script can remove uncertainty.
No state, score, label, alert, box, corridor, or line should be interpreted as guaranteed market direction.
📉 Risk Disclosure
Trading involves risk.
All decisions remain the responsibility of the user.
This script is for educational and analytical chart review only and does not provide financial advice.
📚 Educational Note
Use the script to study how compression matures, weakens, breaks, or invalidates around range edges. The strongest reading comes from combining the panel state with the visible chart structure and broader market context.
Indicator

[ A L P H A X ] Structure Flow ProAlphaX Structure Flow Pro — Market Structure Engine, HPZ Order Blocks, Fair Value Gaps, Liquidity Sweeps, Equal Highs/Lows & SMC Confluence Signals
AlphaX Structure Flow Pro is a professional-grade Smart Money Concepts indicator built on a pivot-driven market structure engine that detects swing highs and lows in real time, identifies Market Structure Breaks with momentum Z-score validation and Body-Confirmed Breaks, discovers and scores Order Blocks using a proprietary High Probability Zone algorithm, maps Fair Value Gaps and Liquidity Sweeps as they form, identifies Equal Highs and Lows as liquidity pools, and synthesizes every active condition into a tiered SMC Confluence Score — all displayed on a live dashboard with 15+ alert conditions. Designed for traders who operate within the institutional Smart Money framework on any liquid instrument and timeframe.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📸 Visual Overview
Full chart view showing Market Structure swing lines, MSB/BMS labels, HPZ Order Blocks with POC lines, FVG zones, Liquidity Sweep markers, Equal High/Low connections, SMC tiered entry labels, and the live Dashboard panel on XAUUSD
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔬 The Market Structure Engine — How It Works
At the core of AlphaX Structure Flow Pro is a real-time pivot-based swing detection system that continuously tracks confirmed swing highs and swing lows using a configurable lookback window. Every confirmed pivot is labeled, connected, and used as the structural reference for all break logic downstream.
Each confirmed pivot produces:
A dotted swing line connecting the current and previous swing high or swing low — a live map of whether price is building higher highs and higher lows, or lower highs and lower lows
Small compact H and L labels at every swing point to mark the structural sequence clearly
From these pivots, the engine monitors two distinct types of structural break — each progressively more powerful than the last:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1 ─ Market Structure Break (MSB)
A confirmed close beyond the last tracked swing high or low, validated by a Momentum Z-Score filter . The Z-Score measures how many standard deviations the current bar's price change sits above or below its 50-bar mean. Only breaks where momentum is statistically significant above your configured threshold are accepted — low-conviction wicks, slow grinds, and false closes through structure are automatically ignored.
When a valid MSB fires:
A horizontal line is drawn from the breached pivot to the current bar, anchored at the exact structural level
An MSB ▲ or MSB ▼ label appears at the midpoint of that line
The breached swing level is reset so the engine never double-fires on the same break
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2 ─ Break of Market Structure (BMS)
A stricter and more powerful structural confirmation. In addition to closing beyond the pivot, BMS requires the breaking candle to have a body-to-range ratio above 50% — the break must be driven by a full-bodied candle, not a wick spike. BMS fires as a compact BMS label when it occurs without a simultaneous MSB, giving you a clear visual distinction between a momentum-confirmed break and a body-confirmed break.
How to read them together:
MSB — momentum is statistically significant but the candle body is below 50% — a valid break, treat it with context
BMS — the candle closed through structure with conviction — higher-probability structural shift
When both fire simultaneously, only the MSB label is shown as it already captures the event
Together, MSB and BMS form the structural backbone from which all Order Block discovery, FVG anchoring, and SMC Confluence scoring is triggered.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 Order Block Engine with HPZ Scoring
Every Market Structure Break triggers an automatic search backward through the preceding candles to identify the originating Order Block — the last candle moving against the direction of the break before price impulsed away. For a bullish MSB the engine finds the last bearish candle within the lookback window. For a bearish MSB it finds the last bullish candle.
Each discovered Order Block is assigned a Quality Score from 0 to 100 built from four independent factors:
Momentum Strength
The absolute magnitude of the Momentum Z-Score at the time of the MSB. Stronger impulsive moves away from the OB produce higher scores — a zone that launched a 3-sigma move ranks far above one that launched a 0.5-sigma drift.
Volume Percentile
The current bar's volume ranked against its last 100 bars using percentile rank. High-volume structural breaks indicate institutional participation — OBs discovered on high-volume breaks score significantly higher.
Candle Body Ratio
The proportion of the breaking candle that is body versus wick. A full-bodied impulsive candle away from the OB signals conviction. A wick-heavy or indecision candle signals a weaker origin.
OB Size Relative to ATR
The Order Block's height measured against the current 14-period ATR. Compact, well-defined OBs close to 1 ATR score proportionally — excessively large or tiny zones are naturally discounted.
These four factors are combined into the final Quality Score displayed on every OB label. Zones that score above your configured HPZ Threshold (default 75%) are promoted to High Probability Zones ⬡ and rendered with a brighter border and a distinct ⬡HPZ badge — the highest-conviction institutional zones on your chart.
HPZ Order Blocks rendered with enhanced borders and ⬡HPZ badge — standard OBs shown with dimmer styling for instant visual hierarchy
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Order Block Management
Active Order Blocks are not static — AlphaX Structure Flow Pro manages every zone dynamically bar by bar:
Live extension — every active, unmitigated OB extends its right edge forward to the current bar automatically, keeping your zones current at all times
Point of Control (POC) line — a dashed line at the exact midpoint of every OB, showing the most important price level within the zone
Mitigation detection — when price trades into the OB (low below OB bottom for bullish, high above OB top for bearish), the zone is marked as mitigated and dimmed to neutral gray
Historical mode — mitigated OBs remain visible on the chart dimmed for reference, letting you study how price reacted after mitigation
Present mode — mitigated OBs are deleted automatically, keeping the chart clean with only live unmitigated zones visible
Extend Broken OBs — optionally continue extending mitigated zones for up to 50 bars after mitigation for post-mitigation analysis
Overlap filtering — optionally hide new OBs that overlap existing active zones, preventing zone clustering in congested areas
OB Reliability tracker — the dashboard shows a live percentage of how many total OBs have been mitigated versus left untouched, giving you a real-time measure of how well price is respecting the zones on your current instrument and timeframe
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 Fair Value Gaps (FVG)
AlphaX Structure Flow Pro detects Fair Value Gaps — three-candle imbalances where price moved so fast that the market left an unfilled gap between candle one's high/low and candle three's low/high.
Bullish FVG — candle three's low is above candle one's high — an upward gap in price action that the market may return to fill
Bearish FVG — candle three's high is below candle one's low — a downward gap
A minimum FVG size filter (ATR × your configured factor) prevents micro-gaps from cluttering the chart — only imbalances of meaningful size relative to current volatility are plotted.
Each FVG is drawn as a shaded box that extends forward bar by bar. When price trades back into the gap, the box is marked as filled and dimmed to neutral, stopping its extension. The dashboard tracks how many FVGs remain unfilled at all times, and the SMC Confluence engine uses unfilled FVGs above and below price as draw-on-liquidity targets when scoring entry signals.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ Liquidity Sweeps
A Liquidity Sweep is one of the most important Smart Money patterns — institutions engineer price to run stop-loss liquidity beyond obvious highs or lows, then reverse sharply. AlphaX Structure Flow Pro identifies these events in real time.
Bullish Sweep — the candle's low breaks below the lowest low of the recent lookback window but the candle closes back above that level as a bullish close. Stops below recent lows were hunted, liquidity was absorbed, and price reversed upward.
Bearish Sweep — the candle's high breaks above the highest high of the recent lookback window but the candle closes back below that level as a bearish close. Stops above recent highs were hunted.
Each sweep is marked with a compact ⚡ label at the wick extreme. Sweeps feed directly into the SMC Confluence scoring system — a bullish sweep adds 20 points to the Bull SMC Score because it signals smart money accumulation, and a bearish sweep adds 20 points to the Bear SMC Score for the same reason in reverse.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
〰 Equal Highs and Equal Lows (EQH / EQL)
Equal Highs and Equal Lows are areas where price has printed two swing highs or two swing lows at nearly the same level — these levels represent clusters of resting stop-loss orders and are prime targets for institutional liquidity sweeps.
AlphaX Structure Flow Pro detects EQH and EQL automatically by comparing consecutive confirmed pivots. When two swing highs are within your configured ATR-scaled tolerance of each other, an EQH label and dotted connection line are drawn. When two swing lows match, an EQL label appears.
The ATR-scaled tolerance ensures the detection adapts to current market volatility — what counts as "equal" on a calm Asian session is different from a high-volatility London open, and the indicator adjusts automatically.
Equal Highs and Equal Lows marked with purple dotted lines — clear visual identification of stop-hunt targets above and below current price
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧠 SMC Confluence Scoring System
Every signal in AlphaX Structure Flow Pro feeds into a real-time SMC Confluence Engine that evaluates all active conditions simultaneously and produces a score from 0 to 100 for both the bullish and bearish side. Only scores that meet your configured minimum threshold generate a visible entry label — weak, ambiguous, or isolated setups never reach the chart.
Bull SMC Score Factors:
Market Structure Break (30 points) — an MSB bull fires adds 30 points as the core structural trigger. A BMS bull without simultaneous MSB adds 20 points.
Liquidity Sweep (20 points) — a bullish sweep on the current bar adds 20 points — smart money has absorbed sell-side liquidity
Near Bullish HPZ Order Blocks (up to 18 points) — two or more unmitigated bullish HPZ OBs within 2 ATR of price adds 18 points. One HPZ OB nearby adds 10 points.
Bearish FVG Draw on Liquidity (up to 10 points) — two or more unfilled bearish FVGs above price (magnets drawing price upward) adds 10 points. One adds 5 points.
Momentum Z-Score confirmation (up to 12 points) — strong upward momentum (Z > 2.0) adds 12 points. Moderate (Z > 1.0) adds 7. Mild (Z > 0.5) adds 3.
Volume ratio (up to 8 points) — volume spike (×2.0) adds 8, high volume (×1.3) adds 5, above average (×1.0) adds 2
Candle body (up to 6 points) — a bullish close with body ratio above 60% adds 6 points. Any bullish close adds 3.
Penalties — strong downward momentum (Z < −1.0) deducts 10 points. Two or more nearby bearish HPZ OBs deduct 8 points.
Bear SMC Score Factors are the exact mirror of the above, applied in reverse for all bearish conditions.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Signal Tiers and Entry Labels
Every signal that clears the minimum SMC score threshold is classified into one of three tiers based on its final score:
S-Tier — score ≥ 70. Maximum confluence. All major factors aligned. The highest-confidence setups the engine produces.
A-Tier — score 55–69. Strong confluence with most major factors present.
B-Tier — score at or above your minimum threshold but below 55. Valid setup with meaningful confluence but fewer confirming factors.
Entry labels appear directly on the chart with the tier and score displayed:
▲ S-SMC (82) — bullish S-tier signal with a score of 82
▼ A-SMC (61) — bearish A-tier signal with a score of 61
Label color intensity reflects the tier — S-tier labels use the brightest bull or bear color, A-tier uses the primary color, B-tier uses the dimmed shade. This gives you instant visual priority — your eyes go to the brightest labels first.
A configurable Signal Cooldown prevents back-to-back signals within a set number of bars, eliminating label spam during fast-moving structural events.
S-tier and A-tier entry labels appearing below bars during bullish SMC confluence — label brightness reflects confidence tier at a glance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🗓 Session Ranges
AlphaX Structure Flow Pro includes a full Session Range overlay for the four major trading sessions — London, New York, Tokyo, and Sydney — each independently toggleable with customizable colors and time windows.
Session boxes draw in real time as the session opens, expanding their high and low dynamically as price prints new extremes within the session. The session label updates its position to stay centered above the range. Each session closes when its time window ends, leaving the completed range as a permanent reference box for that period.
Use session ranges to:
Identify the high and low of a session as key liquidity targets for sweeps
Determine whether an MSB or OB formation occurred during a high-liquidity or low-liquidity window
Spot the London or New York open as a structural break origin
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 Live Dashboard
The AlphaX Structure Flow Pro dashboard gives you a complete real-time readout of every active market condition in a compact panel — no need to visually scan the chart for each element individually.
Market Structure section:
MSB STATUS — shows whether a Bull MSB, Bear MSB, or no MSB is active on the current bar
BMS (BODY) — shows whether a body-confirmed structural break is active
MOMENTUM Z — current Z-score reading with direction label (STRONG / MODERATE / MILD / FLAT) and raw value
Order Blocks section:
ACTIVE OBs — total count of unmitigated Order Blocks currently on the chart
HPZ OBs — count of active High Probability Zone OBs, highlighted when any are present
OB RELIABILITY — live percentage of total OBs that have been mitigated since the indicator started tracking — your real-time measure of how well structure is being respected
Liquidity & Imbalance section:
LIQ SWEEP — shows whether a Bull or Bear liquidity sweep is active on the current bar
OPEN FVGs — count of unfilled Fair Value Gaps currently active
DRAW ON LIQ — shows whether price has unfilled FVGs drawing it upward, downward, or on both sides
SMC Confluence section:
BULL SMC SCORE — current bullish confluence score with tier label (S-TIER / A-TIER / B-TIER / LOW)
BEAR SMC SCORE — current bearish confluence score with tier label
HPZ PROXIMITY — shows whether price is near a Bull HPZ zone, Bear HPZ zone, both sides, or neither
Market Conditions section:
VOLUME — current volume classified as SPIKE / HIGH / NORMAL / DRY with the live ×ratio
ATR (14) — current 14-period ATR value in price terms
CANDLE BODY — current candle body ratio classified as STRONG / MODERATE / WEAK with percentage
Active Signal section:
SIGNAL — shows the active entry signal direction and tier, or NONE — the single most important row if you need a quick status check
Dashboard position (Top Left / Top Right / Bottom Left / Bottom Right) and text size (Tiny / Small / Normal / Large) are fully configurable.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠ Identifying Low-Quality Conditions — When NOT to Trade
Knowing when to stay out is just as important as knowing when to enter. AlphaX Structure Flow Pro gives you clear signals that the market is not in a tradeable condition:
How to identify unfavorable conditions:
No MSB or BMS on the dashboard — if the MSB STATUS row shows NONE, there is no confirmed structural trigger. No structural break means no Order Block discovery, and no SMC signals should be acted on.
Bull and Bear SMC Scores both show LOW — when neither side can build enough confluence to reach even B-tier, the market is either ranging, choppy, or lacking institutional participation. Wait for a clear dominant side to emerge.
OB RELIABILITY is very high (above 80–90%) — when nearly every OB is being quickly mitigated, price is not respecting structure and the market is in a sweep-and-reverse or noise regime. Reduce position size or stand aside.
No SMC entry labels appearing — the confluence engine is running on every bar. If no labels are printing even after MSB events, the filters are doing their job blocking low-quality setups. Do not lower the threshold to force signals — wait for real confluence.
DRAW ON LIQ shows BOTH SIDES — unfilled FVGs above and below simultaneously means price is in the middle of a contested range with equal magnets in both directions. No clean directional edge exists.
MOMENTUM Z reads FLAT on the dashboard — flat momentum at a structural level often means a failed break rather than a true MSB. Treat these events with extra caution.
What to do during unfavorable conditions:
Wait for a clean MSB or BMS to set the directional bias before considering any entry
Look for one dominant side in the SMC Confluence section — both Bull and Bear scores being low simultaneously is a ranging signal
Watch for a liquidity sweep followed immediately by an MSB in the same direction — that sequence is one of the highest-probability SMC setups and will produce a strong confluence score when it fires
Consider switching to a higher timeframe to find cleaner structure — if the current timeframe is printing rapid alternating MSBs, the higher timeframe trend will show you the dominant direction
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 How to Trade with AlphaX Structure Flow Pro — Step by Step
Step 1 — Read the Dashboard
Check MSB STATUS and BMS — is there a live structural break?
Check Bull and Bear SMC Scores — is one side clearly dominant with a B-tier or higher score?
Check DRAW ON LIQ — are unfilled FVGs pulling price in one clear direction?
If no clear dominant side and no MSB → do not trade. Wait for structure.
Step 2 — Identify the Structural Trigger
An MSB ▲ or BMS bull sets your bullish directional bias
An MSB ▼ or BMS bear sets your bearish directional bias
Do not enter blindly on the MSB label alone — use it to set context, then wait for a tiered SMC signal to confirm
Step 3 — Enter on a Tiered SMC Signal
Wait for a ▲ SMC or ▼ SMC label to appear with a tier of B or higher
Prioritize S-tier and A-tier signals — these have the most factors aligned
Check that an unmitigated HPZ Order Block is nearby in the direction of the trade — HPZ proximity is displayed on the dashboard in real time
Place your stop loss beyond the most recent swing low (for longs) or swing high (for shorts), or just beyond the relevant OB's outer edge
Step 4 — Use FVGs and OBs as Targets and Re-Entry Zones
Unfilled FVGs in the direction of the trade are natural draw-on-liquidity targets — they show you where price is likely being pulled toward
Mitigated OBs (shown dimmed in Historical mode) mark areas where price has already visited and absorbed — useful as reference for prior institutional activity
If price pulls back into an unmitigated bullish OB without triggering a new bearish MSB, that is a potential re-entry zone aligned with the original structural break
Step 5 — Monitor for Structural Invalidation
If an opposing MSB fires after your entry, the structure has shifted — close or reduce your position
If the SMC Score for your trade direction drops to LOW on the dashboard without a new signal, momentum is fading
A liquidity sweep against your position that does not produce a reversal SMC signal is a warning — tighten your stop
Step 6 — Watch for Equal Highs/Lows as Exit Targets
EQH levels above price during a bull trade are natural exit zones — institutions often sweep equal highs as final liquidity grabs before reversal
EQL levels below price during a bear trade serve the same purpose
Consider taking partial profit as price approaches an EQH or EQL level, then hold the remainder for a potential sweep and continuation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚡ Key Features
🔬 Pivot-based market structure engine with configurable swing lookback — tracks confirmed swing highs and lows in real time
📈 MSB detection with Momentum Z-Score validation — filters out low-conviction structural breaks statistically
💪 BMS detection with candle body ratio confirmation — only full-bodied closes through structure qualify
📦 Order Block discovery anchored to every MSB — automatically finds the originating institutional candle
⬡ Proprietary HPZ Quality Score (0–100) — four-factor scoring system promotes the highest-conviction zones to High Probability Zone status
📍 Point of Control line on every Order Block — shows the midpoint of the zone for precision entries
🔄 Dynamic OB management — live extension, mitigation detection, Historical and Present display modes, overlap filtering, and broken OB extension
📊 Fair Value Gap detection with ATR-scaled minimum size filter — bullish and bearish imbalances mapped and tracked until filled
⚡ Liquidity Sweep detection — wick-beyond plus close-inside logic identifies institutional stop hunts in real time
〰 Equal Highs and Equal Lows detection with ATR-scaled tolerance — automatic identification of resting liquidity pools
🧠 Multi-factor SMC Confluence Scoring Engine — synthesizes structure, sweeps, HPZ OBs, FVG draw, momentum, volume, and candle body into a single 0–100 score per side
🏆 Three-tier signal classification — S-Tier (≥70), A-Tier (55–69), B-Tier (threshold to 54) with color-coded label intensity
⏱ Signal cooldown timer — configurable minimum bars between signals to eliminate label spam
✅ Optional volume confirmation filter — require minimum volume ratio before any signal fires
🗓 Four-session range overlay — London, New York, Tokyo, and Sydney each independently toggleable with custom colors and time windows
📋 Live 7-section dashboard — MSB/BMS status, momentum Z, OB counts, HPZ proximity, FVG draw direction, SMC scores, volume, ATR, and active signal — all in one panel
🎨 Fully customizable color theme — 13 configurable colors covering bull, bear, neutral, FVG, sweep, EQL, and dashboard elements
🔔 15+ alert conditions — MSB bull/bear, BMS bull/bear, S/A/B-tier bull signals, S/A/B-tier bear signals, any SMC signal, bull/bear sweeps, bull/bear FVGs, and MSB + HPZ confluence alerts
⚙ Fully configurable — every lookback, threshold, score, toggle, color, and session window adjustable from the settings panel
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙ Settings Reference
Market Structure
Pivot Lookback — bars on each side required to confirm a swing high or low (default: 7, range: 3–21)
MSB Momentum Z-Score — minimum standard deviation threshold for a valid Market Structure Break (default: 0.5)
Show MSB Lines & Labels — toggle visibility of MSB/BMS lines and labels
Show Structure Swings — toggle visibility of swing lines and H/L pivot labels
Detect Break of Market Structure (BMS) — enable or disable body-confirmed structural break detection
Order Blocks
Max Active OBs — maximum number of unmitigated Order Blocks kept on the chart at once (default: 10)
OB Lookback (candles) — how many candles back the engine searches for the originating OB after an MSB (default: 10)
Extend Broken OBs — continue extending mitigated OBs for up to 50 bars after mitigation
Hide Overlapping OBs — skip new OBs that overlap existing active zones
Display Mode — Historical (keep mitigated OBs dimmed) or Present (delete mitigated OBs automatically)
HPZ Threshold Score (%) — minimum quality score required for HPZ promotion (default: 75%)
Show OB Point of Control — toggle the midpoint POC dashed line on Order Blocks
Liquidity & Imbalance
Show Fair Value Gaps — toggle FVG detection and display
Min FVG Size (ATR × factor) — minimum gap size as a multiple of ATR to qualify as a valid FVG (default: 0.05)
Show Liquidity Sweeps — toggle sweep detection and ⚡ markers
Sweep Lookback (bars) — lookback window for determining the recent high/low that is swept (default: 20)
Show Equal Highs / Lows — toggle EQH and EQL detection and display
EQL Tolerance (ATR × factor) — how close two pivots must be to qualify as equal, scaled to ATR (default: 0.1)
Smart Money Confluence (SMC)
Enable SMC Confluence Engine — master toggle for the scoring system and all entry labels
Min SMC Score to Signal — minimum confluence score required to display an entry label (default: 30)
Signal Cooldown (bars) — minimum bars between consecutive signals in the same direction (default: 3)
Require Volume Confirmation — only fire signals when volume ratio meets the minimum threshold
Min Volume Ratio — minimum volume-to-SMA ratio required when volume filter is enabled (default: 0.7)
Sessions
Show Session Ranges — master toggle for the session overlay
London / New York / Tokyo / Sydney — independently toggle each session with configurable time window and color
Dashboard
Show Dashboard — toggle the dashboard panel on or off
Position — Top Left / Top Right / Bottom Left / Bottom Right
Size — Tiny / Small / Normal / Large
Appearance
Label Size — controls the size of all MSB, BMS, sweep, EQH/EQL, and entry labels (Tiny / Small / Normal)
Colors
Bull Primary / Bright / Dim — three shades of the bullish color family for OBs, labels, and signals
Bear Primary / Bright / Dim — three shades of the bearish color family
Neutral / Neutral Light — colors for mitigated zones and inactive states
Text Light — color for dashboard row labels
Dashboard Background — background color of the dashboard panel
FVG Bull / Bear Color — colors for bullish and bearish Fair Value Gap zones
Liquidity Sweep Color — color for sweep ⚡ labels
Equal Hi/Lo Color — color for EQH and EQL lines and labels
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔔 Alert Conditions
Bull Market Structure Break — fires on every bullish MSB
Bear Market Structure Break — fires on every bearish MSB
Bull Break of Market Structure (Body Close) — fires on every bullish BMS
Bear Break of Market Structure (Body Close) — fires on every bearish BMS
S-Tier Bull SMC Signal — bullish signal with score ≥ 70
A-Tier Bull SMC Signal — bullish signal with score 55–69
B-Tier Bull SMC Signal — bullish signal below 55 but above minimum threshold
S-Tier Bear SMC Signal — bearish signal with score ≥ 70
A-Tier Bear SMC Signal — bearish signal with score 55–69
B-Tier Bear SMC Signal — bearish signal below 55 but above minimum threshold
Any SMC Signal — fires on any bullish or bearish signal regardless of tier
Bull Liquidity Sweep — wick below recent lows with bullish close
Bear Liquidity Sweep — wick above recent highs with bearish close
Bullish Fair Value Gap — new bullish FVG formed
Bearish Fair Value Gap — new bearish FVG formed
Bull MSB + HPZ Confluence — bullish MSB with at least one nearby unmitigated HPZ OB
Bear MSB + HPZ Confluence — bearish MSB with at least one nearby unmitigated HPZ OB
All alert messages include {{ticker}} and {{interval}} placeholders for clean webhook and bot integration.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 Recommended Settings by Use Case
The default configuration is tuned for intraday trading on liquid instruments including XAUUSD, forex majors, and indices on M1 to M15 timeframes.
For tighter, higher-conviction signals:
Increase Min SMC Score to 45–55 — only S-tier and strong A-tier setups fire
Enable Require Volume Confirmation and set Min Volume Ratio to 1.0–1.3
Increase Pivot Lookback to 9–12 for larger, more significant swing points
Set HPZ Threshold to 80% to tighten HPZ qualification
For more signals and aggressive scalping:
Reduce Min SMC Score to 20–25
Reduce Signal Cooldown to 1–2 bars
Reduce Pivot Lookback to 3–5 for faster swing detection
Keep Volume Confirmation off
For higher timeframes (H1, H4, Daily):
Increase Pivot Lookback to 10–15
Increase OB Lookback to 15–20
Increase Min SMC Score to 40–50
Increase Sweep Lookback to 30–50
For ranging or news-driven markets:
Enable Hide Overlapping OBs to reduce zone clutter
Switch Display Mode to Present to keep only live zones visible
Monitor DRAW ON LIQ on the dashboard — if both sides show FVGs, avoid directional trades
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
👥 Who This Is For
🥇 Smart Money Concepts traders — built specifically around the MSB → OB → FVG → Sweep framework that institutional-style traders use
📉 Forex and Gold traders — fully applicable to XAUUSD, forex majors and minors, and all liquid currency pairs
📊 Index traders — works on US30, NAS100, SPX500, DAX, and all major equity indices
🧠 Systematic and rule-based traders — the confluence scoring system provides a quantitative, objective framework rather than purely subjective visual reads
📈 Traders who want one complete SMC system — structure, OBs, FVGs, sweeps, EQH/EQL, sessions, scoring, and dashboard in a single indicator rather than layering five separate tools
⚠ Traders who struggle with overtrading — the minimum score filter, cooldown, and volume gate physically prevent low-quality signals from reaching the chart
🔔 Alert-driven traders and bot operators — 17 alert conditions with clean webhook-ready message formatting cover every meaningful event the indicator can detect
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📝 Notes
Session range features use the time zone of each configured session string — set your London and New York session times to match your chart's time zone if ranges appear offset
The Momentum Z-Score is calculated over a 50-bar rolling window — on very short histories or immediately after a chart loads, early bars may have lower Z-Score values until the window fills
OB Reliability percentage starts from zero when the indicator first loads and builds over time as OBs are discovered and mitigated — it is most meaningful after a full session of price action
The SMC Confluence Engine evaluates conditions on bar close — all signals are non-repainting and confirmed on the closed bar
With max_boxes_count, max_lines_count, and max_labels_count each set to 500 and max_bars_back at 500, on very low timeframes with extended chart history the oldest visual elements may be automatically removed by PulseWire's rendering limits — this is a platform constraint, not an indicator limitation
The HPZ proximity check uses a 2 ATR radius around the current close price — zones further away than 2 ATR are not counted in the SMC score even if they are unmitigated and visible on the chart
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠ 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 demand structure, confluence, and precision from their Smart Money analysis. Indicator

Indicator

Gap Fill Reaction Planner [AGPro Series]Gap Fill Reaction Planner
🧠 Core Idea
Is this gap reaction actually ready for planning, or is it just another rectangle on the chart?
📌 Overview / What it does
Gap Fill Reaction Planner is a planner-style price action tool built around gap fill behavior, reaction quality, and execution readiness. Instead of simply drawing gap zones, it evaluates whether the active gap reaction has enough structure to become a measurable plan.
The script detects gap support and gap resistance zones, tracks fill progress, classifies reaction state, and converts the active setup into a 0-100 readiness score. It also maps a live entry reference, invalidation level, target projection, and estimated R multiple so the user can review the structure as a plan rather than as an isolated signal.
It does not automate trades, predict future price, or replace independent analysis. Its purpose is to organize gap reaction context into a cleaner decision framework.
🎯 Purpose & Design Philosophy
This script was built to move beyond passive gap marking. A normal gap indicator can show where a gap exists, but it does not answer the questions that matter before a trade idea is considered:
Is the reaction valid?
How strong is the setup?
Where is the invalidation?
Where is the target?
What should the trader watch next?
Gap Fill Reaction Planner was designed for traders who want a structured workflow around opening gaps, continuous-market reaction bands, partial fills, full fills, rejection behavior, and acceptance risk. The mindset is not "take every gap." The mindset is "measure the reaction first."
⚡ Why This Script Is Different
Most gap tools focus on detection. They draw every gap, imbalance, or separation zone and leave the decision process to the user.
This script does NOT act as a generic gap highlighter, generic support/resistance map, or broad imbalance catalog.
Instead, it treats each gap as a planning object. Every active zone is evaluated through fill depth, reaction state, volatility context, participation, age, and structural validity. The panel then translates that context into readiness, next action, invalidation, target, and risk/reward information.
That planner layer is the difference. The script helps the user decide whether a gap reaction deserves attention, not merely whether a gap exists.
⚙️ Methodology
1. Context Detection
The script first searches for gap reaction zones. It prioritizes classic open-to-previous-close gaps, then supports adaptive reaction bands for continuous markets where clean opening gaps may be rare.
2. Reference Mapping
Each detected zone receives a fixed-length rectangular band. The zone is not dragged forward forever; it remains anchored to its origin so old structures do not distort the current chart. Thin zones are displayed with a minimum visual height so the chart keeps a cleaner, more professional planning layer.
3. Reaction Evaluation
The engine tracks fill percentage, partial fill, full fill, rejection, and acceptance. Rejection behavior is treated differently from simple fill behavior because a filled gap and a rejected gap communicate different planning context.
4. Planner Scoring
The readiness score combines gap size, fill quality, reaction behavior, volatility participation, and recency. The score is normalized from 0 to 100.
5. Risk / Target Projection
For the active planner zone, the script calculates an invalidation reference beyond the far side of the gap and projects a target using the selected R multiple.
6. Visual Output
The chart shows gap zones, centered zone labels, optional fill progress, planner labels, and active plan levels. The panel summarizes the decision state.
🗺️ How to Read the Chart
Zones
Gap Support zones represent upward gap reactions that may act as support-style planning areas.
Gap Resistance zones represent downward gap reactions that may act as resistance-style planning areas.
Zone Labels
Focused zones can display a centered label showing the zone role, state, and readiness score. This keeps the chart readable without turning every historical zone into a text cluster.
Colors
Bullish planner context uses the AGPro green state color.
Bearish planner context uses the AGPro pink state color.
Neutral or unfinished context uses restrained secondary colors.
Panel
The panel shows readiness, next action, plan side, gap size, fill/state, invalidation, target/R, and bias.
Plan Levels
When an active planner zone exists, the script can display entry reference, invalidation, and target lines.
🚦 Signals & States
• Fresh → A new gap zone exists but has not reached meaningful fill depth.
• Partial Fill → Price has returned into the gap enough to begin reaction monitoring.
• Rejected → Price filled part of the gap and then closed back away from the zone.
• Full Fill → The gap has reached the full-fill threshold and becomes more neutral.
• Accepted → Price closed beyond the far boundary of the gap, meaning the zone has lost its original reaction role.
• Planner Ready → A rejection setup reached the configured readiness threshold.
🔔 Alerts Logic
New Gap Support Zone
Triggers when a bullish gap support planning zone is created.
New Gap Resistance Zone
Triggers when a bearish gap resistance planning zone is created.
Gap Partial Fill
Triggers when a tracked zone reaches the partial-fill threshold.
Gap Full Fill
Triggers when a tracked zone reaches the full-fill threshold.
Gap Planner Ready
Triggers when a rejection setup reaches the readiness score threshold.
Gap Acceptance
Triggers when price accepts beyond the far side of the gap.
Alerts are attention markers and workflow prompts. They are not trade instructions.
🧩 Confluence Logic
The planner score becomes stronger when multiple conditions align:
• The gap has enough ATR-normalized size
• Fill depth is meaningful but not exhausted
• Reaction behavior confirms away from the zone
• Current volatility and participation support the reaction
• The zone is recent enough to remain relevant
When these pieces align, the gap becomes a stronger planning candidate.
📊 When to Use
• After large opening gaps
• During pullbacks into gap support or gap resistance
• Around partial fill and rejection behavior
• In trending markets where gaps create reaction shelves
• In volatile markets where gap fill behavior matters
• On crypto and FX charts where adaptive reaction bands may help continuous-market analysis
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro timeframes
• Market conditions where spread, slippage, or data quality is poor
• When the chart is moving too fast for structured planning
• When a trader has not defined broader market context
🎛️ Key Inputs
Detection Mode
Controls whether the script uses only classic open gaps or adaptive reaction bands.
Minimum Gap Size
Filters out small gaps using ATR normalization.
Readiness Threshold
Defines the minimum score required for a planner-ready label.
Target Multiple (R)
Projects the target from the current reference price using the invalidation distance.
Invalidation Buffer
Adds ATR-based spacing beyond the far side of the gap zone.
Zone Right Extension
Controls how far each zone projects from its origin.
Panel / Label Settings
Control panel visibility, panel theme, panel location, and font sizes.
🖥️ Interface & Visual Design
The interface is built for quick decision review. The panel provides the planner summary, while the chart emphasizes the most important structural elements: premium-height zones, focused centered labels, action labels, and active plan levels.
The visual hierarchy is intentionally clean. Zones explain context, labels explain state, and the panel explains what to do next from an analytical standpoint.
🧪 Practical Usage Workflow
1. Read the panel readiness score.
2. Check whether the next action is monitor, wait, plan, or stand aside.
3. Review the active gap zone and its centered label.
4. Compare fill percentage with the reaction state.
5. Review invalidation and target levels.
6. Confirm the idea with broader market context before acting.
🔍 Interpretation Guidelines
A high score does not mean certainty. It means the gap reaction has stronger planning structure.
A partial fill means price has started interacting with the gap, but reaction quality still matters.
A rejection state is more meaningful when it occurs with strong score, clean invalidation, and acceptable target distance.
An accepted zone should usually be treated as a failed reaction context rather than an active planning area.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not an automated trading system.
This script is not a financial advice tool.
This script does not provide guaranteed outcomes.
This script does not replace risk management, trade review, or independent confirmation.
⚠️ Limitations & Transparency
Gap behavior can change significantly across symbols and timeframes.
Continuous markets may produce fewer classic opening gaps, which is why the script includes adaptive detection modes.
Volatility expansion can make targets and invalidation levels wider.
Low-liquidity environments may reduce the reliability of reaction labels and score readings.
No rule-based tool can fully account for news events, sudden liquidity shifts, or execution quality.
🧠 Market Context Notes
Gap reactions are often more useful when they are read together with trend structure, volatility, session behavior, and liquidity context. A gap zone is not automatically important because it exists. It becomes more useful when price returns to it, reacts clearly, and produces a measurable planning structure.
🧾 Use Case Examples
When price returns into a Gap Support zone and rejects upward with a high readiness score, the panel can help review whether invalidation and target structure are measurable.
When price fills a Gap Resistance zone and accepts above it, the script marks the context as acceptance rather than treating the zone as a still-valid resistance area.
When the panel shows low readiness, the script is communicating that the structure may exist visually but is not yet a strong planner candidate.
🧱 System Philosophy
AGProLabs tools are built around structured interpretation. The goal is not to add more noise to the chart. The goal is to convert raw market behavior into a cleaner decision framework that traders can review with discipline.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No score can guarantee a result.
No planner can replace the trader's responsibility to manage risk.
📉 Risk Disclosure
Trading involves risk. This script is provided for educational and analytical use only. It does not provide financial advice, investment advice, or guaranteed trading outcomes. Users remain responsible for their own research, risk management, position sizing, and execution decisions.
📚 Educational Note
The best use of this script is not to chase every gap. The best use is to slow the decision process down, measure the reaction, and decide whether the setup is structured enough to deserve attention.
Indicator

Hidden Divergence Continuation Zones [AGPro Series]Hidden Divergence Continuation Zones
🟦 Overview
Hidden Divergence Continuation Zones is a focused trend-continuation indicator built around one specific market behavior: hidden divergence that forms during a structured pullback inside an existing directional move.
Most divergence tools are built to search for reversals. They scan regular bullish and bearish divergence, print many labels, and often mix every oscillator event into the same visual map. This script intentionally takes a narrower lane. It does not try to be a general divergence scanner. It looks only for hidden bullish and hidden bearish divergence, because hidden divergence is most useful when the question is not "is the trend ending?" but "is the trend trying to continue after a controlled pullback?"
The result is a cleaner continuation framework:
- confirmed price swing structure
- RSI momentum displacement
- EMA and DMI trend filtering
- ATR-normalized quality scoring
- lower-intensity HDC Watch labels
- forward continuation pockets
- swing connectors
- trigger labels
- compact AGPro dashboard
The purpose is to make hidden continuation structure visible without filling the chart with every possible divergence mark.
🔹 What Makes This Different
This script is separated from both common public divergence tools and our existing AGPro divergence family by design.
It is not a multi-oscillator regular divergence stack. It does not score RSI, MACD, CCI, MFI, and OBV together. That lane is already covered by broader stack-style divergence tools.
It is not an OBV pressure divergence map. It does not study price-versus-participation disagreement through cumulative volume pressure.
It is not a trend dashboard with divergence added as a side feature.
Hidden Divergence Continuation Zones focuses on a single continuation workflow:
1. Confirm that the market has an active directional side.
2. Wait for a valid pullback swing.
3. Compare the new swing against the previous swing.
4. Accept only hidden divergence that supports continuation.
5. Draw a forward pocket from the continuation pivot.
6. Track whether price later triggers from that structure.
That narrow scope is the edge. The script is designed to avoid visual noise and avoid conceptual overlap.
🧭 Core Logic
Bullish hidden continuation:
- the trend filter must support a bullish continuation environment
- price must form a confirmed higher low
- RSI must form a lower low against that higher price low
- the two compared swings must be separated by enough bars
- the structure must be large enough relative to ATR
- the RSI displacement must clear the minimum threshold
- the final continuation score must pass the display threshold
Bearish hidden continuation:
- the trend filter must support a bearish continuation environment
- price must form a confirmed lower high
- RSI must form a higher high against that lower price high
- the two compared swings must be separated by enough bars
- the structure must be large enough relative to ATR
- the RSI displacement must clear the minimum threshold
- the final continuation score must pass the display threshold
The script uses confirmed pivots, so events appear only after the pivot is structurally available. This keeps the logic stable and prevents premature labels from appearing on incomplete swings.
📐 Continuation Score
Each qualified setup is graded with a 0 to 100 continuation score.
The score combines:
- ADX strength above the selected minimum
- ATR-normalized distance between the compared swings
- RSI displacement between the two pivot points
- whether the pullback sits in a continuation-relevant EMA area
- whether the fast and slow EMA structure remains aligned
The default thresholds are designed to keep the chart selective. Normal qualified events are shown as HDC+ or HDC-. Stronger events are shown as PRIME HDC+ or PRIME HDC-.
Lower-intensity confirmed hidden divergence candidates can also be displayed as HDC WATCH labels. These marks are intentionally softer: they add visual context and keep the chart informative, but they do not create continuation pockets or trigger tracking unless the full continuation threshold is reached.
🧩 Continuation Pockets
When a hidden continuation event qualifies, the script projects a forward pocket from the pivot area.
These pockets are not generic support and resistance boxes. They are continuation context zones tied directly to the hidden divergence pivot. Their job is to preserve the important pullback area on the chart after the label appears, so the user can see where the continuation structure was created.
Pocket height is ATR-based, which helps the zones adapt across symbols and timeframes. The number of visible pockets is capped, so older structures are automatically removed and the chart remains clean.
🎯 Trigger Labels
After a hidden divergence pocket is created, the script monitors a limited trigger window.
For bullish continuation, a trigger is printed only when price confirms above the pivot candle reference with the selected ATR buffer.
For bearish continuation, a trigger is printed only when price confirms below the pivot candle reference with the selected ATR buffer.
This keeps the workflow organized:
- hidden divergence creates the continuation pocket
- the pocket defines the structure
- the trigger label marks follow-through from that structure
⚙️ Dashboard
The AGPro panel is built for quick reading:
- Oscillator: current RSI value
- Trend Side: bullish continuation, bearish continuation, or neutral
- Swing Quality: none, building, qualified, or prime
- Continuation Score: latest event score
- Active Pocket: current pocket state and freshness
The first panel row follows the AGPro standard: one merged blue header row with only the script title. Panel location, panel theme, label font size, and panel font size are all adjustable from settings.
🧪 Practical Reading
A clean bullish continuation sequence usually looks like this:
1. Trend Side shows Bull Continuation.
2. Price pulls back and forms a confirmed higher low.
3. RSI makes a lower low at that swing.
4. A continuation pocket appears below/around the pullback area.
5. A trigger label appears only if price follows through during the trigger window.
A clean bearish continuation sequence usually looks like this:
1. Trend Side shows Bear Continuation.
2. Price pulls back and forms a confirmed lower high.
3. RSI makes a higher high at that swing.
4. A continuation pocket appears above/around the pullback area.
5. A trigger label appears only if price follows through during the trigger window.
The best use case is structured trend continuation study, especially when a trader wants to separate controlled pullbacks from random oscillator divergence noise.
🔍 Key Inputs
Trend Continuation Filter:
- Fast EMA Length
- Slow EMA Length
- EMA Slope Lookback
- DMI Length
- ADX Smoothing
- Minimum ADX
Hidden Divergence Engine:
- RSI Length
- Confirmed Pivot Length
- Minimum Pivot Separation
- Minimum Price Swing (ATR)
- Minimum RSI Displacement
- Minimum Continuation Score
- Prime Score Threshold
- Show HDC Watch Labels
- Watch Label Score
Continuation Pockets:
- Show Continuation Pockets
- Pocket Extension Bars
- Pocket Height (ATR)
- Maximum Visible Pockets
- Trigger Window Bars
- Trigger Buffer (ATR)
Visual Layout:
- EMA Backbone
- Swing Connectors
- Event Labels
- Same-Side Label Cooldown
- Label Offset
- Label Font Size
- Maximum Visible Labels
- Maximum Visible Connectors
Panel:
- Show Panel
- Panel Location
- Panel Theme
- Panel Font Size
🟣 Design Notes
The visual design is intentionally restrained:
- no regular divergence clutter
- no multi-oscillator table overload
- no unnecessary signal spam
- no permanent background wash
- no oversized dashboard
- no generic zone engine detached from the core concept
The chart should stay readable while still feeling active and premium. Swing connectors explain where the hidden divergence came from. Pockets preserve the continuation area. Labels are offset from candles and controlled by cooldown settings.
✨ Summary
Hidden Divergence Continuation Zones is built for traders who want a cleaner way to study trend continuation through hidden divergence.
Instead of asking whether every oscillator disagreement matters, this tool asks a more specific question:
Is there a confirmed hidden divergence pullback inside a real trend, and did that structure create a continuation pocket worth tracking?
That focused question is what keeps the script distinct, lightweight, and visually clean.
Indicator

Market Structure Trend Matrix [BigBeluga]Market Structure Trend Matrix is a comprehensive technical analysis framework engineered for traders who demand precision in identifying market regimes and trend expansions. By integrating automated Market Structure (MS) detection with volatility-adjusted risk parameters, this indicator provides a systematic roadmap for navigating complex price action.
The tool focuses on the Change of Character (ChoCh) —the critical moment when a previous trend structure breaks and a new directional bias begins.
🔵 ARCHITECTURE & CORE LOGIC
Automated Structure Mapping: The engine uses a sophisticated pivot-detection algorithm (MS Length) to scan for institutional-grade swing highs and lows. It ignores minor retail noise, drawing structural lines only when significant supply or demand zones are breached.
The ChoCh Engine: When price crosses a recent pivot high or low, the indicator prints a "ChoCh" label. This represents a fundamental shift in market sentiment, signaling that the current trend has likely terminated and a new cycle has begun.
Infinite Expansion Targets: One of the most advanced features of the Matrix is its ability to project sequential, infinite targets. These levels are not static; they are calculated using Average True Range (ATR) multipliers, meaning they expand and contract based on current market volatility.
Volatility-Anchored Trailing Stop: To ensure professional-grade risk management, the indicator plots a dynamic ATR Trailing Stop . This line acts as a "ratchet" mechanism—it moves closer to price during the trend expansion but stays firm during minor pullbacks, providing a clear exit point if the trend truly fails.
🔵 ADVANCED FEATURES & UPDATES
Target History Control: This latest version includes a Show History toggle. You can choose to keep the chart clean by only displaying the Active Target , or you can enable history to see a visual record of every target hit during the trend, complete with historical percentage labels.
Dynamic Trailing Stop Visibility: The Show Trailing Stop feature allows you to toggle the visibility of the ATR stop line and its associated background fill, giving you full control over the visual "weight" on your workspace.
Percentage Profit Labels: Every time price reaches an expansion target, the script automatically plots a label showing the percentage gain from the initial ChoCh entry point.
Volatility-Adjusted Spacing: Both the trailing stop and the target steps use ATR-based calculations. This ensures that the indicator remains effective across all asset classes—from volatile Cryptocurrencies to stable Forex pairs.
🔵 HOW TO INTERPRET THE MATRIX
Bullish State (Green Matrix): Activated when price breaks above a major Pivot High. The indicator projects upward expansion targets and maintains a trailing stop below the price.
Bearish State (Pink Matrix): Activated when price breaks below a major Pivot Low. The indicator projects downward targets and maintains a trailing stop above the price.
The Target Cascade: As price hits a target, the indicator instantly projects the next level. If price continues to expand, you will see a "cascade" of dashed lines, each representing a deeper extension into the trend.
🔵 APPLICATION IN TRADING
Scalping & Day Trading: Set the Market Structure Length to a lower value (e.g., 5-8) to capture fast intraday pivots and expansion moves on 1m or 5m charts.
Swing Trading: Use a higher length (e.g., 15-20) to identify macro structure shifts on Daily or H4 timeframes, allowing the ATR targets to guide your long-term profit-taking.
Risk-Reward Management: The distance between the ChoCh Entry and the ATR Trailing Stop provides an objective risk measurement, while the sequential targets provide clear reward milestones.
Filtering False Breaks: By using an ATR Multiplier for the trailing stop, the Matrix avoids many of the common "whipsaws" found in standard trend-following systems.
🔵 CONCLUSION
Market Structure Trend Matrix is more than a signal tool; it is a visual framework for objective decision-making. By anchoring your trading to structural pivots and volatility-based targets, you remove the guesswork from trend following. Whether you are looking for a clean "ChoCh" entry or a systematic way to trail your profits during a massive expansion, the Trend Matrix provides the data and clarity required to trade like a professional. Indicator

Swap Engine - Pair Rotation (Z-Score) [AGPro Series]Swap Engine - Pair Rotation (Z-Score)
🔷 OVERVIEW
Swap Engine - Pair Rotation (Z-Score) transforms the log-ratio between two correlated crypto assets into a disciplined tier ladder decision framework. Rather than signalling single-asset direction, the engine measures how stretched one pair has become relative to its rolling mean and proposes rotation between the two assets when the spread reaches statistically meaningful extremes. Every decision is evaluated on confirmed Engine TF bar close, keeping suggestions non-repainting under the configured execution model.
🟣 UNIQUE EDGE
Unlike single-symbol mean-reversion or trend indicators, this engine treats the ratio itself as the tradable variable and pairs it with a full operational stack: a tiered exposure ladder (T0 to T3), an Integrity Gate that blocks entries when the pair relationship deteriorates, a Trend Regime filter that respects persistent one-sided moves, and a confirm-first execution model that converts raw signals into auditable decisions. A dedicated Signal Quality score (Q 0-100) and Integrity Score (IN 0-100) make every suggestion inspectable, not a black box.
🟢 METHODOLOGY
The engine fetches the closing price of Pair A and Pair B on the chosen Engine TF, computes the log-ratio L = ln(A / B), then derives a rolling z-score using user-defined lookback length. Entry thresholds (Z1, Z2, Z3) define the three tiers of exposure; exit thresholds (hysteresis) define when each tier is scaled back. A cost filter requires the expected mean-reversion edge to exceed a configurable multiple of estimated roundtrip cost before any entry is allowed. The Integrity Gate continuously validates rolling return correlation, ratio drift, and spread-volatility expansion, halting new entries when the pair relationship degrades.
🟡 SIGNALS & ALERTS
Each signal renders as a clearly tagged label on chart showing the action type (ENTRY / EXIT), source tier, target tier, direction (A->B or B->A), z-score snapshot, delta %, and Reason Code. Alerts are provided for: entry and exit events per direction, pending lifecycle (created, confirmed, skipped, expired), trend regime activation edges, duplicate suppression, and configuration warnings. All alerts fire on Engine TF bar close to remain consistent with the visible suggestions.
⚙️ KEY INPUTS
Pair A / Pair B: the two assets to rotate between (same quote currency recommended).
Engine TF: timeframe used for all ratio, z-score, and decision logic (240 / 4H default).
Lookback: bars used for rolling mean and standard deviation.
Entry Z1/Z2/Z3, Exit Z1/Z2/Z3: tiered thresholds for scaling in and out.
Tier Sizing (T1 / T2 / T3 %): rotation size per tier as a percentage of the active pool.
Trade Profile: preset gate behavior (Conservative, Balanced, Aggressive, Volatile Alt, High-Cost, Custom).
Integrity Gate: correlation, drift, and volatility expansion filter with configurable minimum score.
Execution Model: ASSUME (auto-advance), CONFIRM (pending + manual commit), or SIGNAL_ONLY (display only).
🔵 HOW TO USE
Start on the default BTCUSDT vs ETHUSDT pair on 4H Engine TF with the Balanced profile. Keep the chart timeframe equal to or lower than the Engine TF (the script warns otherwise). Watch the status panel for the current tier, direction, confidence strip (Q / IN / PH), and next action preview. In CONFIRM mode, a PENDING card appears when a signal fires; increase CONFIRM +1 to commit the rotation state, or SKIP +1 to discard. Use the Trade Profile dropdown to tighten or loosen effective gates without changing your base inputs.
🟠 LIMITATIONS & TRANSPARENCY
This is an indicator, not a strategy; no orders are placed and no backtest statistics are produced. Signals reflect statistical extremes in the pair's log-ratio and do not guarantee mean reversion. Performance depends heavily on pair selection - assets with persistent trends, broken correlation, or structural regime changes can cause extended adverse periods. The Integrity Gate mitigates but does not eliminate this risk. Costs, slippage, tax, and execution details are the user's responsibility; the Min Edge x filter is an estimate, not a realized-cost guarantee. Always validate on your own pair, timeframe, and account conditions before relying on any suggestion.
🔴 RISK DISCLOSURE
Trading and rotating between crypto assets involves substantial risk, including loss of capital. Past or simulated behavior of the ratio does not guarantee future results. This tool is shared for educational and analytical purposes only and does not constitute financial, investment, or trading advice. Users are solely responsible for their own decisions and should consult a qualified professional before committing capital. Indicator

Svopex SessionsSvopex Sessions
Overview
Svopex Sessions is a customizable multi-session indicator that visualizes the four major global trading sessions — Tokyo, London, New York, and Sydney — directly on your chart. It is designed for intraday traders, scalpers, and swing traders who rely on session-based volatility, liquidity patterns, and inter-session price behavior (such as the London–New York overlap or the Asian range breakout).
Each session can be displayed as boxes, background zones, a timeline strip, or colored candles, giving you the flexibility to match your preferred chart aesthetic without clutter.
Key Features
Four fully configurable sessions (Tokyo, London, New York, Sydney), each with its own:
Custom time range
Independent timezone selector
DST (Daylight Saving Time) toggle for markets that observe it
Custom color and on/off switch
Custom label text
Four display modes selectable from a single dropdown:
Boxes — classic session high/low rectangles
Zones — colored background shading
Timeline — compact session strip at the bottom of the chart
Candles — session-colored bars
Session analytics built in:
Change (Pips) — measured either as session high-to-low range or open-to-close move
Change (%) — same two measurement options
Both metrics update live and are displayed inside the session label
Session levels:
Session 0.5 Level — the midpoint (equilibrium) of each session, often used as a dynamic support/resistance
Open/Close Line — a line tracking price from session open to current close
Workflow helpers:
Merge Overlaps — automatically merges adjacent sessions (e.g. Tokyo into London, London into New York) to avoid overlapping boxes during transition periods
Hide Weekends — excludes Saturday/Sunday bars from session calculations
Lookback (Days) — limits how far back sessions are plotted to keep the chart light and responsive
Appearance controls for box border width and style (solid / dashed / dotted), line style, label size, label visibility, and box background fill.
Built-in alerts:
Session open (Tokyo / London / New York / Sydney)
New session high
New session low
Recommended Use
Intraday timeframes (1m – 1h) for best accuracy — the script automatically restricts itself to intraday charts.
Forex, indices, crypto, and futures — session-based analysis is especially relevant for FX majors and index futures, where liquidity rotates with the opening bell of each financial center.
Combine with volatility or volume tools to identify session breakouts, range expansions, and reversal zones.
Settings Reference
Sessions group — enable/disable each session, set time, timezone, DST, and color.
Additional Tools and Settings — change metrics, merge behavior, lookback, display type, and measurement source.
Appearance — fine-tune visual style (borders, line styles, label size, background fill).
Notes
DST is handled via a manual toggle per session. Because global markets don't switch to/from DST on the same dates, you have explicit control instead of a single global switch.
The indicator is capped at 500 boxes, 500 lines, and 500 labels (Pine Script limits). If you plot a long lookback with all sessions enabled, older drawings may be dropped — reduce the Lookback (Days) value if needed.
Tokyo is set to Asia/Tokyo (Japan does not observe DST), but the timezone field is free-form, so you can repurpose any session for a different market (e.g., Frankfurt, Hong Kong, Singapore). Indicator

Fixed Range Control Box [AGPro Series]Fixed Range Control Box
🔹 Overview
Fixed Range Control Box isolates a single high-conviction price range on your chart and classifies who is in control inside it. The tool draws one clean hero box around the most recent structural range, places a volume-weighted Control Line inside it, and tracks state transitions in real time: Inside, Upper, Lower, or Failed. When price structurally breaks the box, the range freezes, locking the reference so you can study the aftermath without visual drift.
Four range-definition modes are available — Pivot, Lookback, Compression, and Manual-Date — so the tool adapts to discretionary range traders, systematic rotation traders, and anyone who wants a fixed reference zone for backtesting or journaling.
🔸 Unique Edge
Most range tools on PulseWire draw many boxes and leave the user to guess which one matters. Fixed Range Control Box is built around a different philosophy: one range, one story, one decision. The hero box is the visual focus; historical ranges fade into the background; the Control Line tells you which side of the range is winning the statistical argument.
Three design choices separate this from standard range-box scripts:
- Volume-weighted Control Line. Rather than dropping a midpoint line, the Control Line is computed from the volume-weighted typical price across the life of the range, with an edge-fallback to midpoint if the line drifts too close to either boundary. This produces a structurally meaningful reference instead of a geometric one.
- Retrospective fill on range rebuild. When a new range is committed, the script walks back through the range window and retroactively computes touch count, hold quality, and the Control Line. You see a fully-formed box with accurate statistics the moment it appears, not an empty box that slowly populates.
- Freeze-on-failure. When price closes beyond the range and the state transitions to Failed, the box locks at the break bar. No more drifting endpoints on broken structures — the reference stays where the story ended.
🔷 Methodology
The script cycles through four stages on every bar:
1. Range detection. Depending on the selected mode, the script looks for a qualifying range: confirmed swing pivots (Pivot), rolling highest/lowest (Lookback), short-ATR over long-ATR compression (Compression), or a user-defined date window (Manual). Gating rules — minimum lifespan, minimum width percentage, and a failed-state cooldown — prevent rapid re-triggers on noisy conditions.
2. Commit and retrospective fill. Once a range qualifies, the script snapshots the old range into history, installs the new one, and walks back through the window to compute the Control Line, touch count, and hold quality in a single pass. No warm-up period.
3. State machine. Each confirmed bar feeds the state machine. Strict logic requires bar closes on one side of the Control Line for the configured number of bars before switching to Upper or Lower; a close beyond either range boundary transitions to Failed.
4. Rendering. On the last bar, the hero box, Control Line, origin marker, and state badge are rebuilt from scratch. Historical ranges persist as muted boxes up to a configurable cap.
🔶 Signals & Alerts
Three alert conditions cover the full range lifecycle:
- New Control Box. Fires once per bar close when a new range is committed.
- Line Reclaimed (Bull or Bear). Fires when state transitions into Upper or Lower control, confirming directional bias inside the range.
- Control Failed. Fires once when price closes beyond the range and the box is frozen.
All alerts use alert() calls with once-per-bar-close frequency.
🔹 Key Inputs
- Range Mode — Auto-Pivot, Auto-Lookback, Auto-Compression, or Manual-Date.
- Pivot Length / Lookback Bars / Compression Window — window controls for each detection mode.
- Min Range Lifespan / Min Range Width % — structural filters to suppress micro-ranges.
- Failed Cooldown — bars to wait after a broken range before searching for a new one.
- Strict Control Logic + Reclaim Confirmation — governs how the Control Line state machine transitions.
- Visual controls — fade old boxes, max boxes kept, show state badge, show range origin, future projection bars, panel and label font sizes.
🔸 How to Use
1. Start on your primary timeframe and select the Range Mode that matches your style: Pivot for discretionary swing structures, Lookback for mechanical windows, Compression for auto-locking onto consolidations, Manual-Date for backtesting a specific episode.
2. Tune Min Range Width % and Min Range Lifespan so only structurally meaningful ranges appear.
3. Read the panel top-down: Mode confirms what you are tracking, Control tells you which side of the Control Line is winning, Range Age and Touches describe maturity and confluence, Hold Quality summarizes how cleanly price has respected the range, and State shows the live classification.
4. Use alerts to monitor the range lifecycle without staring at the chart.
🔻 Limitations & Transparency
- This is an analytical tool, not a strategy. It does not generate buy or sell recommendations and does not compute entries, stops, or targets.
- Past range behavior does not forecast future range behavior. Structural breaks can occur at any time.
- In very thin or illiquid markets, the volume-weighted Control Line can drift toward a boundary; the edge-fallback defaults to midpoint to protect against degenerate cases.
- Auto-Compression mode requires sufficient ATR history; expect a warm-up period on very recent symbols.
- The script is overlay-only and does not access other timeframes.
🔶 Risk Disclosure
Nothing in this script constitutes financial advice. Trading involves substantial risk of loss and is not suitable for every investor. Always do your own research and manage risk appropriately. Indicator

Volume Shelf Reaction Map [AGPro Series]Volume Shelf Reaction Map
🔷 OVERVIEW
Volume Shelf Reaction Map is a structural price-action tool that identifies horizontal zones where volume has historically stacked — "volume shelves" — and classifies, in real time, how price reacts each time it returns to them. Instead of showing a static S/R line, it answers a sharper question: when price revisits this level, does it hold, get reclaimed, get rejected, or lose the level entirely? Fresh shelves (never revisited) are visually separated from reused ones, so the chart communicates not just where the levels are, but which ones still carry unused participation behind them.
🧭 UNIQUE EDGE
Most support/resistance and volume tools stop at drawing a zone. This script adds a reaction-state layer on top of shelf detection:
• Five reaction states per shelf: TOUCH, HELD, RECL (reclaimed), REJ (rejected), LOST
• Fresh vs Reused classification — shelves that have already been tested at least once are faded, so untouched structural levels stand out immediately
• Sticky state logic — a shelf keeps its reaction color until a new transition actually occurs, preventing flicker between bars
• Passive-window coloring — shelves whose last reaction is older than the user-defined active window fade to the neutral accent color, keeping old/stale levels visible without dominating the chart
• Strongest-shelf-only reaction tags with cooldown — reaction labels are printed only for the highest-strength shelf and only on actual state transitions, producing a clean chart even on long histories
The result is a volume-aware reaction map rather than a crowded S/R overlay.
🧪 METHODOLOGY
1. Pivot detection — standard pivot highs and lows over a configurable pivot length act as shelf candidates.
2. Volume qualification — each pivot bar is checked against a rolling 20-bar volume average; bars above the Volume Filter multiplier contribute extra weight to shelf strength.
3. ATR-based clustering — candidates within a configurable ATR multiple of an existing shelf are merged using a touches-weighted mean price, stabilizing the shelf location as evidence accumulates.
4. Confirmation — a shelf must reach the Minimum Touches threshold before it is rendered; weak candidates are pruned after one-third of the lookback window.
5. State machine — on every confirmed bar, a shelf's reaction is updated against the prior close's side (support vs resistance context), using an ATR-scaled buffer to distinguish genuine holds and losses from noise.
6. Ranking and rendering — on the last bar, shelves are sorted by strength; only the top N are drawn, with fresh shelves rendered solid and reused shelves rendered thinner and faded.
🔔 SIGNALS & ALERTS
Three alert types, each debounced per shelf so the same state cannot spam consecutive bars:
• Shelf Touched — price range intersects a confirmed shelf for the first time since its last transition
• Shelf Respected — price HELDs, RECLs, or REJs at a shelf (reaction in favor of the shelf)
• Shelf Lost — price closes through a shelf with the required ATR buffer
Reaction tags on the chart (HELD / RECL / REJ / LOST) are printed only for the strongest shelf and only on a true state transition, with a user-adjustable cooldown for historical cleanliness.
⚙️ KEY INPUTS
Shelf Detection
• Lookback Window (bars) — how far back the pivot scan reaches
• Pivot Strength — bars required on each side of a pivot
• Cluster Distance (x ATR) — how tightly nearby pivots merge
• Minimum Touches — confirmation threshold
Filters & Cleanup
• Volume Filter (x average) — participation threshold for strength weighting
• Show Fresh Shelves Only — hide already-revisited shelves
• Max Shelves to Display — cap visible shelves for chart cleanliness
• Fade Reused Shelves — dim reused shelves so fresh ones stand out
• Reaction Sensitivity (x ATR) — ATR buffer used by the state machine
• Active Window (bars) — how recently a reaction must have occurred to show in full color
Visuals
• Label & Panel Size — Tiny / Small / Normal / Large (default: Normal)
• Show Reaction Tags — toggle on-chart state labels
• Tag Cooldown (bars) — minimum bars between tags on the same shelf
Panel
• Show Info Panel, Panel Location (6 anchors), Panel Theme (Dark / Light)
Alerts
• Shelf Touched, Shelf Respected, Shelf Lost
🧰 HOW TO USE
1. Add the indicator to any liquid symbol and timeframe. Volume-aware markets (crypto, index futures, major FX) and timeframes from 15m upward tend to produce the most structured shelves.
2. Start with defaults. The Active Window of 30 bars is a reasonable middle-ground; reduce it on intraday charts (around 20) or raise it on daily/weekly (30–60).
3. Read the panel:
• Active Shelves — how many of the eligible shelves are currently drawn
• Strongest Shelf — the top-ranked shelf by strength
• Current State — live reaction state of the top shelf
• Fresh / Reused — how the displayed shelves split between untested and already-tested levels
4. Use fresh shelves as higher-quality reaction candidates; treat reused shelves as context, not primary triggers.
5. Combine the HELD / RECL / REJ / LOST reactions with your own trigger logic (e.g. break-retest, liquidity sweeps, momentum shifts). This script is a location and reaction tool — not a standalone trade system.
🧱 LIMITATIONS & TRANSPARENCY
• This indicator describes historical structure and live reactions; it does not forecast price direction.
• Pivot-based detection requires the Pivot Strength window to complete on both sides, so fresh pivots appear with a natural lag equal to the pivot length.
• On very low-volume symbols or illiquid timeframes, shelves may be sparse or unstable.
• The state machine is bar-close based; intrabar wicks can temporarily intersect a shelf without changing its state until the bar confirms.
• Max drawing limits (max_lines_count, max_labels_count, max_boxes_count) are set to 120; extremely long histories combined with large lookbacks may drop the oldest drawings.
⚠️ RISK DISCLOSURE
This script is provided for educational and analytical purposes only. It is not a strategy, not a buy/sell signal generator, and not financial advice. Trading involves substantial risk of loss. Past behavior of levels, volume, or reactions does not guarantee future outcomes. Always apply your own risk management, position sizing, and independent judgment. The author and AGProLabs accept no responsibility for decisions made based on this indicator. Indicator
