Volume Trap Reversal Planner [AGPro Series]Volume Trap Reversal Planner
🧠 Core Idea
Did a volume spike trap one side of the market and reverse with enough confirmation to deserve attention?
📌 Overview / What it does
Volume Trap Reversal Planner is a chart-first reversal planning tool built around high-volume trap behavior.
Instead of treating every volume spike or wick sweep as a reversal signal, the script checks whether price expands through a recent reference, prints unusual relative volume, fails to hold the move, recovers back through the reference, and then confirms with a follow-through candle.
The output includes volume trap pockets, reclaim rails, risk edges, target-room bands, compact event labels, alerts, and a clean AGPro decision panel. It does not predict price, automate trades, or claim that every trap will reverse.
🎯 Purpose & Design Philosophy
The script was built for traders who want to separate meaningful high-volume trap events from ordinary noisy spikes.
Many reversal tools focus only on a wick, a candle pattern, or a support/resistance touch. This planner focuses on the decision layer after a volume trap forms: whether the trap is confirmed, where the risk edge sits, where target-room review begins, and what the next action state should be.
The design supports a structured review mindset: identify the trap, wait for confirmation, monitor the risk edge, and read the context through a 0-100 score instead of reacting to a single candle.
⚡ Why This Script Is Different
Most tools focus on volume spikes as standalone events or classify every sweep as a reversal attempt.
This script does NOT operate as a generic stop-run scanner, a broad liquidity sweep map, or a simple volume climax labeler.
Instead, it combines relative volume, wick sweep behavior, close recovery, confirmation candle quality, follow-through, risk edge placement, and target-room context into one planner-style reversal model.
⚙️ Methodology
1. Context Detection
The script builds a rolling high/low reference range and watches for unusual volume expansion near those references.
2. Trap Mapping
When price sweeps beyond the reference with elevated volume and recovers back inside, the script maps the volume trap pocket.
3. Reversal Evaluation
The planner evaluates wick quality, recovery strength, confirmation candle structure, follow-through distance, and the active risk edge.
4. Visual Output
The result is translated into a 0-100 reversal score, a next-action state, on-chart labels, risk/target guides, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = volume trap pockets created by a high-volume sweep and recovery.
Labels = trap watch, reversal ready, trap failed, or target review states.
Colors = bull-side reversals use teal, bear-side reversals use pink, watch states use amber, and review/target context uses indigo.
Panel = current trap side, volume spike multiple, reversal score, risk edge, and next action.
🚦 Signals & States
• VOL TRAP WATCH → a high-volume trap candidate formed and needs confirmation.
• REVERSAL READY → the trap received confirmation and reached the required score.
• TRAP FAILED → price closed beyond the risk edge and the active trap context weakened.
• TARGET REVIEW → price reached the target-room review band for the active plan.
🔔 Alerts Logic
Alerts trigger when a volume trap watch appears, when reversal confirmation reaches the required score, when the active trap fails through the risk edge, or when price reaches the target-room review band.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when volume spike quality, wick sweep behavior, close recovery, confirmation candle structure, and follow-through align in the same direction.
The score is intentionally multi-factor so a single dramatic candle does not dominate the interpretation.
📊 When to Use
• 4H charts for the cleanest public visual balance
• Markets with reliable volume data
• High-volume reactions around recent highs or lows
• Reversal review after failed breakout or failed breakdown attempts
• Active intraday or swing charts where trap behavior is visible
⚠️ When NOT to Use
• Very low-liquidity symbols
• Markets with unreliable or missing volume data
• Extremely noisy ranges where every candle sweeps both sides
• News-driven volatility where candle structure can distort normal context
🎛️ Key Inputs
• Trap Reference Lookback → controls the rolling high/low range used for trap detection.
• Volume Spike RVOL → adjusts how much relative volume is required.
• Sensitivity → changes sweep, wick, and volume selectivity.
• Confirmation Mode → controls how strict the confirmation candle must be.
• Risk / Target Logic → controls risk edge buffers and target-room bands.
• Visual Settings → control zones, rails, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around a clean AGPro panel and chart-first visual hierarchy.
Trap pockets show where the volume trap occurred. Labels identify the current state without overcrowding the chart. Risk and target guides make the output easier to interpret as a planning tool rather than a raw signal board.
🧪 Practical Usage Workflow
1. Read the panel and check the active trap side.
2. Inspect the volume trap pocket and reclaim rail.
3. Wait for reversal confirmation instead of reacting to the spike alone.
4. Compare the current state with the risk edge and target-room band.
5. Interpret the score within broader market context.
🔍 Interpretation Guidelines
A high score means the trap structure, volume spike, recovery, and confirmation are aligned more cleanly.
A watch state means the event is still developing.
A failed state means the active trap context has weakened or invalidated according to the script's rules.
Use the output as structured context, not as a standalone decision.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed reversal signal
• Not a generic liquidity sweep scanner
⚠️ Limitations & Transparency
Volume quality varies by symbol, exchange, and asset class.
Different timeframes may produce different trap pockets and confirmation states.
High volatility can make traps appear and fail quickly.
The script is rule-based and cannot know news, order flow intent, execution quality, or broader discretionary context.
🧠 Market Context Notes
Volume traps often matter most when they occur at obvious participation points, such as recent highs, recent lows, failed breakouts, or failed breakdowns.
The strongest use case is not the spike itself. The strongest use case is the sequence after the spike: recovery, confirmation, risk edge, and follow-through.
🧾 Use Case Examples
When price sweeps below a recent low on elevated volume, closes back above the reference, and confirms upward within the allowed window, the planner can mark a bullish reversal context.
When price sweeps above a recent high on elevated volume, fails to hold, and confirms downward, the planner can mark a bearish reversal context.
🧱 System Philosophy
Volume Trap Reversal Planner belongs to the AGPro planner-style workflow: detect the event, score the evidence, define the risk edge, map the review zone, and guide the next chart-reading step.
🔐 Non-Promise Statement
No trap, score, label, or alert can guarantee a reversal.
No script can provide certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and market interpretation.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the script to study how high-volume failed moves behave after sweeping recent references. The most useful insights come from comparing confirmed traps, failed traps, and ignored spikes across different markets and timeframes.
Indicator
Trend Re-Entry Planner [AGPro Series]Trend Re-Entry Planner
🧠 Core Idea
Is an active trend pullback creating a clean re-entry planning context, or is the reset becoming too risky?
📌 Overview / What it does
Trend Re-Entry Planner is a chart-first trend continuation planning tool designed to evaluate pullbacks inside an active trend structure. The default profile is tuned for 1H charts, where re-entry pockets, trigger candles, invalidation edges, and target-room context usually remain more readable.
The script builds a re-entry pocket from the current impulse range, scores the quality of the pullback, maps a trend defense line, shows an invalidation edge, and estimates target-room context. The goal is to help users judge whether a pullback is becoming organized enough for review or whether the trend context should be rebuilt.
It does not predict price, automate entries, or turn every pullback into a signal. It is a rule-based planning framework for evaluating trend re-entry structure.
🎯 Purpose & Design Philosophy
This script was built for traders who already track trend continuation but want a cleaner way to decide whether a pullback is worth attention.
Many trend tools show direction. Many pullback tools mark a reaction. This script focuses on the planning layer between those two ideas: trend side, pullback depth, reset quality, trigger behavior, target room, risk edge, and next action.
The design supports a disciplined workflow: evaluate context first, then decide whether the setup is ready, confirmed, invalidated, or still waiting.
⚡ Why This Script Is Different
Most tools focus on trend direction, moving average crosses, or broad pullback labels.
This script does NOT clone SuperTrend pullback grading, generic trend continuation signals, or low-volume pullback zones.
Instead, it uses an EMA trend stack and impulse-based re-entry pocket to build a planning view around the current pullback. The output is not just a marker. It is a decision panel with a 0-100 re-entry score, pullback depth, risk edge, target-room context, and next-action state.
⚙️ Methodology
1. Context Detection
The script identifies active bullish or bearish trend structure using an EMA stack and directional slope.
2. Reference Mapping
It maps the current impulse range and builds a concept-native re-entry pocket from that range.
3. Reaction Evaluation
The engine scores trend slope, pullback depth, reset quality near the mid EMA, trigger candle behavior, and target-room availability.
4. Visual Output
The script displays the re-entry pocket, invalidation edge, target-room guide, event labels, sparse context labels, and a premium AG Pro planning panel.
🗺️ How to Read the Chart
Zones = the re-entry pocket and target-room area used for planning context.
Labels = READY, CONFIRMED, INVALIDATED, FOLLOW-THROUGH, and sparse context states.
Colors = teal for bullish continuation context, pink for bearish or invalidation context, yellow for watch/review states, and indigo for target-room or follow-through emphasis.
Panel = the compact decision dashboard showing trend side, re-entry score, pullback depth, risk edge, and action.
🚦 Signals & States
• WATCH → the pullback is developing but still needs confirmation or cleaner structure.
• READY → the re-entry context has enough quality for closer review.
• CONFIRMED → a qualifying trigger candle appears after the pullback context improves.
• FOLLOW-THROUGH → the confirmed context produces a stronger continuation marker.
• INVALIDATED → price crosses the active invalidation edge and the plan should be rebuilt.
🔔 Alerts Logic
Alerts trigger when the script detects READY, CONFIRMED, INVALIDATED, or FOLLOW-THROUGH states.
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 context becomes stronger when trend slope, pullback depth, mid-EMA reset quality, trigger candle behavior, and target-room availability align.
The script intentionally requires multiple conditions instead of labeling every trend pullback as meaningful.
📊 When to Use
• 1H charts with active directional structure
• Directional markets with clear trend structure
• Pullbacks after a visible impulse move
• Continuation review workflows
• Trend-following plans where risk edge and target room matter
⚠️ When NOT to Use
• Low-liquidity symbols with unreliable price movement
• Extremely choppy markets with frequent trend-stack flips
• News-driven volatility where pullback structure changes too quickly
• Markets where the active impulse range is stale or unclear
🎛️ Key Inputs
• Sensitivity → adjusts how selective the re-entry score model is.
• Planning Profile → keeps the default behavior tuned for hourly re-entry planning or allows manual/higher-timeframe adjustment.
• Impulse Lookback → controls the range used to build the re-entry pocket.
• Re-Entry Depth settings → define the shallow, ideal, and deep areas of the pocket.
• Thresholds → control WATCH, READY, and CONFIRMED state requirements.
• Visual settings → control zones, EMA stack, labels, panel theme, panel location, and font sizes.
🖥️ Interface & Visual Design
The interface is built around a clean AG Pro panel and chart-first planning visuals.
The re-entry pocket and target-room guide are intentionally restrained so price remains readable. Labels are limited and spaced to keep the chart informative without becoming crowded.
The first panel row uses the standard AGPro merged blue header format.
🧪 Practical Usage Workflow
1. Read the panel to identify trend side and current action.
2. Check whether price is interacting with the re-entry pocket.
3. Evaluate the score, pullback depth, and risk edge.
4. Wait for READY or CONFIRMED state before treating the context as review-worthy.
5. Rebuild the plan if the invalidation edge is crossed.
🔍 Interpretation Guidelines
Think in terms of planning quality, not certainty.
A higher score means the current pullback has more constructive re-entry characteristics according to the script's rule set. A lower score means the pullback is less organized, has poor target room, lacks a clear trigger, or has moved too close to invalidation.
Use the script as a structure-reading tool within broader market context.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not guaranteed signals
• Not a SuperTrend pullback clone
• Not a generic support/resistance zone map
⚠️ Limitations & Transparency
The script is rule-based and depends on visible chart data.
Timeframe differences, volatility shifts, low liquidity, and sudden news events can change how re-entry structure appears.
The score reflects the internal model only. It does not know future order flow, future liquidity, or future market intent.
🧠 Market Context Notes
Trend re-entry quality is usually clearer when a market has directional structure, a readable impulse, and enough room before nearby obstacles.
When a trend is mature, overly extended, or choppy, the same pullback behavior may carry less useful information.
🧾 Use Case Examples
When price pulls into the re-entry pocket during a bullish EMA stack and then prints a constructive trigger candle, the script may shift from WATCH to READY or CONFIRMED.
When price crosses the invalidation edge, the script marks the context as INVALIDATED so the user can rebuild the plan instead of forcing the old structure.
🧱 System Philosophy
AGPro planning tools are designed to turn chart structure into a clearer decision workflow.
This script follows that philosophy by focusing on context, readiness, risk edge, and next action rather than simple signal output.
🔐 Non-Promise Statement
No script can guarantee continuation, reversal, profit, or accuracy.
This tool provides structured context only. Users should combine it with their own analysis, timeframe review, and risk management process.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, position sizing, trade management, and risk control.
This script does not provide financial advice and does not guarantee trading outcomes.
📚 Educational Note
Trend Re-Entry Planner is intended to help users study how pullbacks behave inside active trend structure and how planning context can be organized more clearly.
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
Candle Expansion Readiness [AGPro Series]Candle Expansion Readiness
🧠 Core Idea
Is the current candle expansion meaningful enough to monitor, or is it only a noisy wide candle?
📌 Overview / What it does
Candle Expansion Readiness is a chart-first candle quality planner built to evaluate whether an active expansion candle has enough structure to deserve attention.
Instead of treating every wide candle as important, the script studies body efficiency, wick control, relative volume, ATR-normalized expansion, recent range behavior, and close location. These components are converted into a 0-100 Expansion Readiness Score with a clear state: READY, WATCH, FADE RISK, or WAIT.
The script produces expansion candle labels, a forward follow-through box, risk edge, target guide, failure/fade states, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that an expansion candle will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want a cleaner way to judge expansion candles before reacting to them.
The gap it fills is practical: many candle tools mark a candle after it appears, but they do not explain whether that candle is efficient, supported, close-positioned, and monitorable. Candle Expansion Readiness turns that moment into a structured planning question.
The design supports a decision-first workflow: read the candle quality, check whether follow-through is developing, identify the risk edge, and decide whether the context deserves more attention.
⚡ Why This Script Is Different
Most tools focus on large candles, volume spikes, engulfing patterns, institutional candle labels, or general breakout signals.
This script does NOT clone Institutional Candle Detector, does not classify candles into institutional taxonomies, does not build an absorption system, and does not act as a generic breakout-volume tool.
Instead, it evaluates the current expansion candle as a readiness event. The output is not a trade command. It is a planning state that helps users separate monitorable expansion from weak, noisy, or fading candle behavior.
⚙️ Methodology
1. Context Detection
The script reads the active candle side from candle direction and close behavior, or lets the user force bullish or bearish readiness mode.
2. Reference Mapping
It maps the expansion candle, risk edge, follow-through window, and target guide.
3. Reaction Evaluation
The model scores body efficiency, wick control, relative volume, ATR expansion, recent range expansion, and directional close location.
4. Visual Output
The result appears through compact labels, candle glow, a forward follow-through box, risk edge, target guide, deterministic alerts, and the AGPro planning panel.
🗺️ How to Read the Chart
Zones = the follow-through box shows the monitored area from the expansion risk edge toward the target guide. Its label is centered inside the box.
Labels = compact markers show READY, WATCH, DOWNGRADE, CONFIRMED, INVALID, or FADED context.
Colors = green highlights stronger bullish readiness or confirmation, pink highlights bearish or invalidated context, amber highlights caution, and indigo highlights watch behavior.
Panel = the panel summarizes Candle Efficiency, Volume Support, Expansion Score, Follow-Through, and Action.
🚦 Signals & States
• READY → candle expansion quality is strong enough to monitor.
• WATCH → candle quality is improving but confirmation is incomplete.
• FADE RISK → the candle expanded, but wick or close behavior is weak.
• CONFIRMED → follow-through reached the active target guide.
• INVALIDATED → price crossed the active risk edge.
• FADED → the follow-through window expired without confirmation.
• WAIT → no strong enough expansion context is active.
🔔 Alerts Logic
Alerts trigger when the planner enters READY state, downgrades from READY or WATCH, crosses the active risk edge, confirms at the target guide, or fades after the follow-through window.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The readiness state becomes stronger when body efficiency, close location, relative volume, ATR expansion, and wick control align on the same candle.
When those elements align and the follow-through box remains active without risk-edge violation, the candle context becomes cleaner. When the score is high but follow-through fails, the planner intentionally downgrades the context instead of ignoring the failure.
📊 When to Use
• Active intraday or swing charts where candle expansion matters.
• Breakout attempts where candle quality needs review.
• Continuation moves that require follow-through monitoring.
• Reversal attempts where the trader wants to know whether the impulse candle is efficient or noisy.
• Liquid symbols with reliable OHLC and volume data.
⚠️ When NOT to Use
• Very low-liquidity markets with unreliable candles.
• Extremely noisy sessions where wide candles fail repeatedly.
• Symbols with poor or missing volume data if volume support is central to your workflow.
• News-driven spikes where normal candle-quality rules may lose relevance.
• As a standalone entry system without broader market context.
🎛️ Key Inputs
• Sensitivity → controls how strict the readiness model is.
• Expansion Lookback → compares the current candle to recent range behavior.
• READY Threshold → minimum 0-100 score required for READY state.
• Confirmation Mode → controls whether close quality alone is enough or whether volume/edge confirmation is required.
• Follow-Through Bars → defines how long the script monitors the active expansion.
• Risk Edge Buffer ATR → moves the invalidation reference slightly beyond the candle edge.
• Visual settings → control boxes, risk edge, target guide, candle glow, labels, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The panel gives the current decision state without becoming a crowded dashboard. The follow-through box creates a clean visual planning area, while compact labels keep the chart active without burying price candles.
The first panel row follows the AGPro merged blue header standard and shows only the script name.
🧪 Practical Usage Workflow
1. Read the Expansion Score and Action row.
2. Check whether the candle is READY, WATCH, or FADE RISK.
3. If READY appears, inspect the follow-through box and risk edge.
4. Watch whether price confirms, fades, or invalidates.
5. Interpret the result within your broader structure, liquidity, and risk plan.
🔍 Interpretation Guidelines
Think of the script as a candle expansion planner, not a signal caller.
A READY candle deserves attention because its structure is cleaner than average. A WATCH candle needs more evidence. A FADE RISK candle warns that expansion exists, but the candle quality is not clean. INVALIDATED and FADED states are part of the workflow because failed expansion is useful information.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not an institutional candle detector.
• Not an order block, fair value gap, or support/resistance map.
⚠️ Limitations & Transparency
• Timeframe differences can change how expansion candles appear.
• Volatility spikes can temporarily distort candle-quality readings.
• Volume data may differ by exchange, broker, symbol, and feed.
• Follow-through is evaluated through a fixed monitoring window.
• Market conditions can shift after a READY candle appears.
🧠 Market Context Notes
Candle expansion is most useful when interpreted with liquidity, structure, volatility, and location.
The script focuses on the candle itself and the immediate follow-through plan. Traders should still consider broader trend context, nearby levels, session behavior, and event risk.
🧾 Use Case Examples
When a bullish candle closes near its high with strong body efficiency and relative volume, the script may mark READY and project a follow-through box above the risk edge.
When a wide candle has heavy wick behavior and poor close location, the script may flag FADE RISK instead of treating the candle as clean expansion.
When a READY candle fails back through its risk edge, the active plan becomes INVALIDATED.
🧱 System Philosophy
AGPro tools are designed to support structured chart reading. The goal is to convert market behavior into clean, rule-based context that helps traders think more clearly.
Candle Expansion Readiness follows that philosophy by turning a single expansion candle into a monitored planning state.
🔐 Non-Promise Statement
No script can provide certainty.
This tool organizes candle expansion context, but it does not guarantee continuation, reversal, profit, or any specific market outcome.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution, position sizing, and risk management.
Nothing in this script or description is financial advice.
📚 Educational Note
Use the script to study how clean expansion candles behave across different symbols and timeframes. The value is in comparing candle quality, follow-through, and failure behavior over time.
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
