Reaction Follow-Through Planner [AGPro Series]Reaction Follow-Through Planner
🧠 Core Idea
Did the first reaction actually create follow-through, or did price only bounce and fade?
📌 Overview / What it does
Reaction Follow-Through Planner is a decision-oriented overlay that evaluates what happens after price produces an initial reaction around a confirmed swing reference.
Instead of only marking the reaction itself, the script opens a structured follow-through window, measures progress, tracks defense of the reaction zone, defines invalidation, estimates target room, and converts the context into a 0-100 planner score.
It produces reaction zones, follow-through tracks, continuation markers, failed-reaction labels, risk/target guide lines, and a compact AGPro panel. It does not predict future price, place trades, automate execution, or claim that any reaction must continue.
🎯 Purpose & Design Philosophy
This script was built for traders who already understand that a reaction candle is not enough.
Many charts show a wick, bounce, rejection, hold, or local response, but the real question comes after that first response: did the market follow through with clean progress, participation, and defended invalidation?
The design philosophy is simple: treat reaction analysis as a planning workflow. The script helps organize the reaction into strength, follow-through, invalidation, room, and next action.
⚡ Why This Script Is Different
Most reaction tools focus on finding the reaction candle, drawing the level, or scoring the first response.
This script does NOT clone a rejection-block detector, a support/resistance reaction map, or a generic pivot reaction score.
Instead, it starts after the first reaction appears. It tracks whether that reaction can defend its zone, produce directional progress, maintain follow-through, and offer enough room before the context becomes stale or failed.
⚙️ Methodology
1. Context Detection
The engine tracks confirmed swing reaction references and waits for price to interact with them.
2. Reference Mapping
When the first response is accepted, the script builds a reaction zone from the first response candle and defines an invalidation edge beyond the defended area.
3. Reaction Evaluation
The script grades the initial reaction candle using close defense, wick defense, body participation, and direction agreement.
4. Follow-Through Tracking
During the tracking window, the model measures best directional progress, next-bar response, volume support, adverse excursion, time decay, and whether the invalidation edge remains defended.
5. Visual Output
The chart displays reaction zones, follow-through tracks, target room, invalidation guides, continuation markers, failed-reaction labels, and a clean AGPro planner panel.
🗺️ How to Read the Chart
Zones = the defended first-reaction area that should remain intact for the follow-through case to stay valid.
Follow-through track = the movement path from the reaction close toward the current follow-through position.
Invalidation guide = the price edge where the reaction context is considered failed by the script logic.
Target room guide = the nearby structure or ATR-based room estimate used to judge whether the reaction still has space.
Labels = optional reaction start markers, follow-through continuation, or failed-reaction context. Start labels and failed-reaction X markers are disabled by default, while failed-reaction labels use a separate low cap for a cleaner publication view.
Colors = teal for bullish reaction continuation, pink for bearish reaction continuation, gold for weak or stalled contexts, and indigo for higher-quality follow-through.
Panel = the current reaction strength, follow-through state, invalidation level, room estimate, and next action.
🚦 Signals & States
• Bull Reaction Watch → a bullish reaction window is active, but follow-through still needs progress.
• Bear Reaction Watch → a bearish reaction window is active, but follow-through still needs progress.
• Bull Follow-Through → bullish follow-through reached the planner threshold.
• Bear Follow-Through → bearish follow-through reached the planner threshold.
• No Follow-Through → the reaction stayed defended but did not generate enough progress inside the tracking window.
• Failed Reaction → price closed beyond the reaction invalidation edge.
🔔 Alerts Logic
Alerts are attention markers, not trade instructions.
New Bull Reaction Window triggers when a bullish first-response window opens.
New Bear Reaction Window triggers when a bearish first-response window opens.
Bull Follow-Through Ready triggers when bullish follow-through reaches the score and progress thresholds.
Bear Follow-Through Ready triggers when bearish follow-through reaches the score and progress thresholds.
Reaction Failed triggers when price closes beyond the active invalidation edge.
🧩 Confluence Logic
The strongest context appears when reaction strength, next-bar progress, volume response, wick defense, and room all align.
When the reaction candle is strong but follow-through is weak, the panel will usually remain in watch or no-follow-through mode.
When follow-through progresses but invalidation is too close or room is limited, interpretation should stay cautious.
📊 When to Use
• After a visible reaction from a swing high or swing low reference.
• During retest, hold, rejection, or continuation planning.
• When you want to separate first-response reactions from reactions that actually continue.
• On symbols and timeframes with enough liquidity for clean candle structure.
⚠️ When NOT to Use
• Extremely low-liquidity markets where reaction candles are unreliable.
• Very noisy micro timeframes with erratic wicks.
• News-driven volatility where invalidation and room can shift quickly.
• Situations where the user expects automatic entries or guaranteed outcomes.
🎛️ Key Inputs
• Swing Reaction Lookback → controls how selective the reaction references are.
• First Response Mode → controls how strict the first reaction filter is.
• Follow-Through Track Bars → controls how long the script evaluates continuation after the reaction.
• Minimum Planner Score → sets the threshold for continuation-ready context.
• Invalidation Buffer → controls how far beyond the reaction zone the invalidation edge sits.
• Fallback Target Room → estimates room when no clean opposite structure is nearby.
• Visual settings → control zones, optional start labels, outcome labels, failed-reaction label cap, optional failed markers, guides, density, and panel layout.
🖥️ Interface & Visual Design
The interface is built around a clean AGPro panel and chart-first visuals.
The panel gives the decision summary. The chart shows the defended reaction zone, follow-through track, invalidation edge, target room, and state labels.
The visual hierarchy is intentionally restrained: enough labels to make the chart alive, but not so many that the reaction workflow becomes noisy.
🧪 Practical Usage Workflow
1. Read the panel to see whether a reaction window is active.
2. Check the reaction zone and invalidation edge.
3. Watch whether the follow-through track expands away from the zone.
4. Compare the score with available target room.
5. Treat alerts as review prompts, not execution commands.
🔍 Interpretation Guidelines
A strong reaction is not automatically a strong follow-through.
A clean follow-through usually needs directional progress, defended invalidation, supportive participation, and enough remaining room.
If the panel says No Follow-Through, the reaction may still be interesting visually, but the script did not detect enough post-reaction continuation quality.
If the panel says Failed Reaction, the original reaction context is no longer valid according to the script rules.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a replacement for risk management.
• Not a generic support/resistance map.
• Not a rejection-block scanner.
⚠️ Limitations & Transparency
The script is rule-based and depends on confirmed swing references, ATR normalization, volume baselines, and selected sensitivity settings.
Different timeframes can produce different reaction windows.
High volatility can expand invalidation distance and reduce room quality.
Low-liquidity markets can create misleading wick behavior.
🧠 Market Context Notes
Reaction follow-through is strongest when the first response is supported by participation and clean progress away from the defended zone.
It is weaker when price reacts but stalls near the zone, repeatedly revisits invalidation, or lacks target room.
The script is designed to help traders think in terms of reaction quality, not certainty.
🧾 Use Case Examples
When price reacts from a swing low and the next bars defend the reaction zone with rising progress, the planner may shift from Bull Reaction Watch to Bull Follow-Through.
When price rejects a swing high but immediately reclaims the invalidation edge, the planner may mark Failed Reaction.
When price bounces but fails to expand before the tracking window expires, the panel may show No Follow-Through.
🧱 System Philosophy
The AGPro approach favors decision engines over simple signal indicators.
This script follows that philosophy by turning a reaction into a structured review process: strength, follow-through, invalidation, room, and action.
🔐 Non-Promise Statement
No score guarantees continuation.
No alert confirms a profitable outcome.
No visual state should be treated as certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, position sizing, and market interpretation.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use this script to study how reactions behave after the first response.
The goal is to improve interpretation discipline, not to replace a complete trading plan.
Indicator
Reversal Confirmation Planner [AGPro Series]Reversal Confirmation Planner
🧠 Core Idea
Is a reversal actually confirming, or is it still only an early reaction?
📌 Overview / What it does
Reversal Confirmation Planner is a chart-first planning tool built to separate early reversal reactions from structured confirmation context.
The script detects sweep or wick-rejection reactions around recent swing references, then evaluates whether the reaction develops into a cleaner confirmation plan. It maps a confirmation pocket, invalidation edge, target-room band, compact event labels, alerts, and a clean AG Pro decision panel.
It does not predict reversals, automate entries, or scan every classical reversal pattern. The goal is to help traders organize the confirmation phase: reaction quality, confirmation close, momentum turn, volume support, room, invalidation, and next action.
🎯 Purpose & Design Philosophy
This script was built for traders who do not want to treat every wick, sweep, or counter-move as a valid reversal.
Many reversal tools mark the first reaction. This planner waits for structure. It asks whether price has moved from reaction into confirmation, whether momentum is turning, whether volume supports the shift, and whether the active plan has enough room before the next projected guide.
The design supports a decision-making workflow. It does not ask the user to chase every signal. It helps the user decide whether the reversal context is still early, building, confirming, confirmed, failed, expired, or already testing its room.
⚡ Why This Script Is Different
Most reversal tools focus on detecting a pattern, labeling a wick, or marking every possible counter-trend reaction.
This script does NOT behave like a broad reversal-pattern scanner, double-top/double-bottom detector, head-and-shoulders module, 1-2-3 map, wedge detector, Turtle Soup map, liquidity sweep tool, or generic support/resistance zone script.
Instead, it works as a confirmation planner. The core workflow is reaction → confirmation pocket → invalidation edge → target-room context → next-action state. This keeps the public concept narrow, useful, and clearly separate from other AGPro reversal tools.
⚙️ Methodology
1. Context Detection
The script watches for bullish or bearish reversal reactions using sweep behavior, wick rejection, candle close location, and prior directional context.
2. Reference Mapping
Once a reaction qualifies, the planner creates a confirmation line, confirmation pocket, invalidation edge, and target-room guide.
3. Reaction Evaluation
The model scores sweep or rejection quality, confirmation progress, momentum turn, volume support, and available room.
4. Visual Output
The chart shows the active confirmation pocket, centered target-room band, risk/target guide lines, compact labels, alert conditions, and an AG Pro panel with the current decision state.
🗺️ How to Read the Chart
Confirmation Pocket = the area between the reaction reference and the confirmation close line.
Invalidation Edge = the level beyond the reaction extreme where the active confirmation plan is considered failed by the script rules.
Target-Room Band = a projected planning zone that shows whether the reversal has enough forward room relative to the active risk distance.
Labels = compact state markers such as REACTION, CONFIRMING, CONFIRMED, FAILED, EXPIRED, ROOM TESTED, or PLAN.
Colors = teal supports bullish reversal planning, pink supports bearish reversal planning, amber marks developing context, indigo marks target-room context, and red marks invalidation or failed confirmation.
Panel = summarizes Reversal Stage, Confirmation Score, Invalidation, Room, and Action.
🚦 Signals & States
• REACTION → an early sweep or rejection is active, but confirmation is not complete.
• BUILDING → the context is improving, but the confirmation close is not fully qualified.
• CONFIRMING → price is testing or closing through the confirmation line with sufficient structure to review.
• CONFIRMED → the confirmation score and close behavior meet the script threshold.
• ROOM TESTED → the projected target-room guide has been reached after confirmation.
• FAILED → the active plan violated its invalidation edge.
• EXPIRED → the reaction did not confirm within the selected confirmation window.
🔔 Alerts Logic
The script includes alerts for bullish reaction, bearish reaction, bullish confirmation, bearish confirmation, failed confirmation, and high-quality confirmation.
Alerts trigger when the internal rule conditions are met. They are attention markers for chart review, not trade instructions, automated entries, or guaranteed reversal signals.
🧩 Confluence Logic
The strongest confirmation context appears when multiple layers align:
• A clear sweep or rejection reaction forms.
• Price progresses through the confirmation pocket.
• Momentum begins to turn in the reaction direction.
• Volume support is not weak.
• The target-room band offers enough room relative to invalidation distance.
When these layers align, the confirmation score becomes stronger. When one or more layers are weak, the state usually remains reaction, building, expired, or failed.
📊 When to Use
• After visible sweep or rejection behavior.
• During possible reversal transitions after directional extension.
• Around swing references where confirmation matters more than the first wick.
• 4H swing-review charts, where the default label spacing and confirmation pockets usually have the cleanest visual balance.
• Daily charts when the user wants fewer but more selective reversal confirmation states.
• In markets where traders want to compare reaction quality, invalidation, and room before acting.
• For discretionary review of crypto, forex, indices, equities, and commodities on liquid charts.
⚠️ When NOT to Use
• Extremely low-liquidity symbols with unreliable wicks or volume.
• Very noisy micro-timeframes where reaction candles are unstable.
• News spikes or extreme volatility events where confirmation levels can be crossed erratically.
• Charts where the user expects a complete reversal-pattern scanner.
• Situations where the user wants automated trade execution.
🎛️ Key Inputs
• Confirmation Mode → controls whether labels and alerts wait for bar close or update live.
• Swing Reference Length → defines the recent swing references used for sweep-based reactions.
• Sensitivity → adjusts how selective the reaction model is.
• Confirmation Window Bars → limits how long a reaction can wait for confirmation.
• Minimum Reaction Score → controls the quality required before tracking a candidate.
• CONFIRMED Threshold → controls the minimum 0-100 score required for confirmed state.
• Preferred Room / Risk → adjusts how much forward room is preferred relative to invalidation distance.
• Visual settings → control pockets, bands, guide lines, labels, panel position, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around a premium chart-first workflow.
The confirmation pocket and target-room band are concept-native visuals, not generic support/resistance zones. Their labels are centered inside the boxes for cleaner chart reading.
The default visual preset is tuned for 4H-style swing review: enough labels to keep the chart informative, but enough spacing to avoid a crowded reversal scanner look.
The AG Pro panel uses a compact structure with one merged blue title row and five decision rows. It is designed to show only the current planning context without turning the chart into a dashboard-heavy script.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check whether the chart is showing REACTION, BUILDING, CONFIRMING, CONFIRMED, FAILED, or EXPIRED.
3. Review the confirmation pocket and invalidation edge.
4. Compare target-room context against the room/risk readout.
5. Use alerts as review prompts, not as trade instructions.
🔍 Interpretation Guidelines
Treat the first reaction as incomplete information.
A higher score means the reaction has developed more confirmation structure according to the script rules. It does not mean the reversal must continue.
A failed or expired state is also useful information. It tells the user that the reaction did not confirm cleanly under the selected rules.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a broad reversal-pattern scanner.
• Not a full liquidity sweep system.
• Not a generic support/resistance zone tool.
⚠️ Limitations & Transparency
All outputs are rule-based and depend on the selected inputs, timeframe, and symbol behavior.
Swing references confirm with natural delay. Wick structure can be noisy on low-liquidity symbols. Volume quality varies across markets. Fast volatility can cause reactions to confirm and fail quickly.
The confirmation score is an internal comparison model. It is useful for reading this script's framework, but it is not an objective probability model.
🧠 Market Context Notes
Reversal confirmation is strongest when price reacts from a meaningful extension, then follows through with cleaner close behavior and improving participation.
The script is intentionally focused on the confirmation phase. It does not attempt to map every higher-timeframe structure, order block, fair value gap, harmonic pattern, or reversal formation.
🧾 Use Case Examples
When price sweeps below a recent swing low, closes back above it, then starts progressing through the confirmation pocket, the planner may shift from REACTION to BUILDING or CONFIRMING.
When price confirms but the room/risk readout is weak, the user can see that the reversal may be structurally less attractive inside this framework.
When price violates the invalidation edge before confirmation, the planner marks the context as FAILED instead of leaving the reaction visually ambiguous.
🧱 System Philosophy
The AGPro approach is to build decision engines, not decorative signal boards.
This script focuses on one clear question: did the reversal reaction earn confirmation, or is it still only a reaction?
🔐 Non-Promise Statement
No script can confirm future price movement with certainty.
This tool provides structured context, not guarantees.
📉 Risk Disclosure
Trading involves risk.
This script is for educational, analytical, and chart-review purposes only. It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users remain responsible for their own decisions, risk management, position sizing, and broader market analysis.
📚 Educational Note
Use the planner to study how reactions mature, fail, expire, or confirm under consistent rules. The value is in disciplined interpretation, not in treating any single label as a complete trading system.
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
Initial Balance Break Planner [AGPro Series]Initial Balance Break Planner
🧠 Core Idea
Is the Initial Balance break being accepted, or is it becoming vulnerable to failure back inside the balance?
📌 Overview / What it does
Initial Balance Break Planner is an intraday session planning tool built around the first major balance of the trading session. It maps a configurable Initial Balance window, tracks the first break beyond that balance, and evaluates whether that break has enough quality to deserve structured review. The default showcase workflow is designed for intraday charts up to 60 minutes.
The script produces a locked Initial Balance box, break review labels, acceptance labels, failure-risk labels, failed-IB markers, target rails, and an invalidation reference. The panel summarizes the active state through IB State, Break Side, Acceptance Score, Failure Risk, and Action.
It does not predict future price movement, automate trades, or tell the user what to buy or sell. It is a rule-based decision-support overlay for reading Initial Balance behavior with more structure.
🎯 Purpose & Design Philosophy
This script was built to solve a common intraday problem: many traders can see that price broke the first balance, but they still need a cleaner way to judge whether that break is accepted, stretched, weak, or vulnerable.
The tool is designed for traders who use session structure, Initial Balance concepts, intraday breakouts, and structured risk review. Its purpose is not to create another simple breakout signal. Its purpose is to turn the Initial Balance break into a practical planning framework.
The design philosophy is simple: map the balance, evaluate the break, show the risk, project the planning rails, and keep the next action readable.
⚡ Why This Script Is Different
Most opening-range tools focus on basic breakout direction, raw high/low levels, or target projections.
This script does NOT clone ORB Quality or Opening Range Failure Zones. ORB Quality is focused on opening range breakout quality and drive continuation. Opening Range Failure Zones is focused on failed opening range probes and reclaim zones.
Instead, Initial Balance Break Planner focuses on the post-IB decision layer: is the first Initial Balance break accepted, does the retest response support the break, where is the invalidation reference, where are the target rails, and what should the trader review next?
⚙️ Methodology
1. Context Detection
The script builds the Initial Balance from a configurable session window. The default uses the first 60 minutes of the New York regular session.
2. Reference Mapping
Once the IB window ends, the script locks the IB high, IB low, and midpoint. The box remains centered with an internal state label so the chart stays visually clear.
3. Reaction Evaluation
After the first break, the planner scores the setup using:
• IB width
• Break close quality
• Retest response
• Relative volume support
• Volatility fit
4. Visual Output
The chart displays break labels, acceptance labels, risk-review labels, failed-IB markers, target rails, and an invalidation rail. The panel converts the model into a compact next-action state.
🗺️ How to Read the Chart
The Initial Balance box represents the first session balance selected by the user.
Break labels show when price closes beyond the IB edge with enough buffer to start review.
Acceptance labels appear when the break has enough score, enough confirmation time, and controlled failure risk.
Failure-risk labels warn that the break is weakening or returning back inside the balance.
Target rails show measured planning references from the broken IB edge.
The invalidation rail marks the area where the break begins losing acceptance quality.
Panel colors summarize the current state:
• Teal → stronger acceptance or constructive long-side context
• Pink → bearish break side or failed context
• Amber → watch, risk review, or unresolved state
• Indigo / blue → active planning context
🚦 Signals & States
• IB READY → the Initial Balance has locked and the planner is ready to track the first break
• BREAK UP REVIEW → price closed beyond the upper IB edge and long-side review has started
• BREAK DOWN REVIEW → price closed beyond the lower IB edge and short-side review has started
• RETEST HOLD → price retested the broken IB edge without clearly losing it
• ACCEPTED → the break met the acceptance threshold with controlled failure risk
• RISK REVIEW → the break is not yet accepted and failure vulnerability is rising
• FAILED IB → price failed back inside the Initial Balance with elevated weakness context
🔔 Alerts Logic
Alerts trigger when the script detects:
• A bullish IB break review
• A bearish IB break review
• Bullish IB acceptance
• Bearish IB acceptance
• Failure-risk review
• Failed return back inside the IB
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The strongest context appears when the break close is clean, the IB width is balanced, volume is supportive, volatility is not overheated, and the retest response holds the broken edge.
When these elements align, the Acceptance Score improves and the panel can move from Observe Retest into Review Long or Review Short.
📊 When to Use
• Intraday markets with clear session structure
• 1-minute to 60-minute charts
• Index, futures, FX, and liquid crypto sessions
• Initial Balance breakout review
• Session expansion planning
• Post-break retest evaluation
• Risk and target planning after the first session balance breaks
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy micro timeframes
• Markets with poor session definition
• Events with abnormal volatility spikes
• Symbols where volume data is unreliable and should not be weighted heavily
• Higher timeframes where the selected IB session has little practical meaning
• 4H, daily, weekly, or monthly charts where a one-session Initial Balance cannot be mapped cleanly
🎛️ Key Inputs
• Initial Balance Window → defines the balance-building period
• Tracking Session → defines when break review can update
• Sensitivity → adjusts how selective the planner is
• Acceptance Lookback → controls the review window after the first break
• Minimum Acceptance Score → sets the threshold for accepted-break states
• Confirmation Mode → chooses confirmed-bar behavior or live updating
• Break Buffer ATR → controls how far price must close beyond the IB edge
• Retest Response Buffer ATR → controls retest tolerance around the broken edge
• Failure Buffer ATR → controls how quickly returning inside the IB raises risk
• Target Rail Multiples → control measured target references
• Max Visible IB Boxes → controls how many recent balance boxes stay on the chart
• Max Visible Labels → controls how many recent event labels stay on the chart
• Show IB Ready Labels → optionally displays a readiness label when the Initial Balance locks
• Visual Settings → control labels, box count, rail projection, and spacing
• Panel Settings → control panel visibility, location, theme, and font size
🖥️ Interface & Visual Design
The script uses a chart-first design. The Initial Balance box is the main anchor, and the centered box label keeps the active state visible without requiring a large dashboard.
Event labels are deliberately compact and offset away from candles. Target rails and invalidation rails are projected only after a break, so the chart remains clean during the balance-building phase.
The AG Pro panel uses a single merged blue header row and five compact rows so the user can quickly scan state, side, score, risk, and action.
🧪 Practical Usage Workflow
1. Read the panel after the Initial Balance locks.
2. Wait for price to break one IB edge.
3. Check whether the break receives a clean score or moves into risk review.
4. Watch the broken edge for retest behavior.
5. Use the target rails and invalidation rail as planning references.
6. Interpret the result within broader market context.
🔍 Interpretation Guidelines
The Acceptance Score is a quality score, not a prediction. Higher scores mean the break has better internal structure according to the script's rules.
Failure Risk is a warning layer. It rises when price loses acceptance quality, moves back inside the IB, shows weak close behavior, or lacks participation.
The Action row is the most practical summary. It helps the user decide whether the environment is still building, waiting, reviewing, accepted, vulnerable, or better left alone.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a generic ORB breakout system
• Not Opening Range Failure Zones
• Not a broad support/resistance or order-block map
⚠️ Limitations & Transparency
Initial Balance behavior changes across symbols, sessions, and timeframes. A 60-minute IB on one market may behave differently from the same window on another market.
Relative volume can be less useful on symbols where reported volume is incomplete or inconsistent.
Fast news events, thin liquidity, and unusual volatility can reduce the usefulness of any session-break model.
The script evaluates rule-based context only. It cannot know future order flow or guarantee what price will do next.
🧠 Market Context Notes
Initial Balance analysis is most useful when the session has a meaningful opening phase and a clear expansion phase.
A clean break usually needs more than a line cross. The break should show location, acceptance, participation, and controlled risk.
A weak break can still travel further, and a strong break can still fail. The script is designed to help structure the review, not remove uncertainty.
🧾 Use Case Examples
When price breaks above the IB high, receives a strong acceptance score, holds the broken edge on retest, and keeps failure risk low, the panel may move into Review Long.
When price breaks below the IB low but quickly returns back inside the balance with weak close quality, the panel may move into Failure Watch or Failed Back In.
When the IB is too wide, volatility is unstable, and the break lacks volume support, the planner can remain cautious even if price has crossed the edge.
🧱 System Philosophy
The AGPro Series approach is built around decision structure, not raw signal output.
Initial Balance Break Planner follows that philosophy by combining a visible session reference with a score, risk layer, target references, and a next-action panel.
The goal is to make the chart easier to interpret without making the chart crowded.
🔐 Non-Promise Statement
This script does not provide certainty.
It does not guarantee that an accepted break will continue or that a vulnerable break will reverse.
All outputs should be interpreted as structured analytical context.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution, and risk management.
This script is not financial advice and does not provide guaranteed trading outcomes.
📚 Educational Note
Initial Balance analysis can help traders study how a session moves from balance into expansion, but it should always be combined with broader market structure, liquidity, volatility, and personal execution rules.
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
Range Escape Planner [AGPro Series]Range Escape Planner
🧠 Core Idea
Is price escaping a mature range with enough quality to monitor, or is the move still vulnerable to failure?
📌 Overview / What it does
Range Escape Planner is a chart-first breakout quality and trade planning tool built around mature range escape behavior.
Instead of printing a generic breakout signal, the script maps the active range boundary, projected escape corridor, invalidation edge, target guide, obstruction room, follow-through quality, and retest behavior. These components are converted into a 0-100 Escape Score and a clear next-action state.
The script produces a range boundary box, escape corridor, risk/target guide lines, compact labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that a range escape will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate breakout quality after price leaves a mature range.
Many breakout tools identify the break itself but stop before answering the practical planning questions: is the range mature, is the close beyond the boundary strong enough, is volatility expanding constructively, is there clean room, and where is the failure reference?
The design philosophy is simple: a range escape is only useful when it has maturity, confirmation, room, and a readable invalidation edge.
⚡ Why This Script Is Different
Most tools focus on basic range breaks, box breakouts, session opening ranges, or simple breakout markers.
This script does NOT clone Darvas Box Breakout Quality, does NOT rebuild an ORB model, and does NOT act as a generic consolidation breakout signal.
Instead, it treats the move as a planning problem. The main output is not a buy or sell command. It is a structured state that helps users separate VALID ESCAPE, ESCAPE WATCH, RANGE READY, OBSTRUCTION, FAILED, and WAIT RANGE conditions.
⚙️ Methodology
1. Context Detection
The script maps the prior range from previous bars and checks whether price is still inside, near an edge, or closing beyond the boundary.
2. Reference Mapping
It draws the mature range, escape edge, invalidation edge, projected target guide, and older swing obstruction room.
3. Reaction Evaluation
The model scores range maturity, close beyond range, volatility expansion, follow-through, retest quality, and obstruction room.
4. Visual Output
The result is displayed through centered zone labels, compact event labels, guide lines, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the range box shows the active mature range. The escape corridor shows the projected planning path from the broken boundary toward a target guide. Zone text is centered inside the boxes.
Labels = compact markers identify RANGE READY, ESCAPE WATCH, VALID ESCAPE, RETEST HOLD, OBSTRUCTION, and FAILED context.
Colors = green highlights cleaner long-side escape quality, pink highlights short-side or failure risk, amber highlights review conditions, and indigo highlights watch or mature-range context.
Panel = the panel summarizes Escape Score, Range Age, Confirmation, Obstruction, and Action.
🚦 Signals & States
• RANGE READY → the range is mature and price is near an escape edge.
• ESCAPE WATCH → price has escaped the range, but follow-through or retest confirmation is still incomplete.
• VALID ESCAPE → the escape has stronger score alignment, follow-through or retest support, and acceptable obstruction context.
• RETEST HOLD → price retested the escape edge and held outside the prior range.
• OBSTRUCTION → the escape is active, but older structure may limit clean room.
• FAILED → price returned through the escape edge and the escape context is no longer clean.
• WAIT RANGE → no mature range escape context is active.
🔔 Alerts Logic
Alerts trigger when the planner detects RANGE READY, New Range Escape, ESCAPE WATCH, VALID ESCAPE, RETEST HOLD, OBSTRUCTION REVIEW, or FAILED ESCAPE conditions.
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 range is mature, price closes beyond the range boundary, volatility expands constructively, candle follow-through improves, the broken edge holds on retest, and obstruction room remains acceptable.
When these components align, the Escape Score improves and the state can progress from RANGE READY to ESCAPE WATCH or VALID ESCAPE.
📊 When to Use
• During range breakout and range expansion review
• 4H and multi-hour swing charts where the range structure has enough space to breathe
• After price has spent time inside a defined range
• When evaluating whether a breakout has clean follow-through
• When a trader needs a visible invalidation edge and target-room reference
• On liquid markets where ATR, range, and swing structure are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles
• Extremely noisy micro-timeframes
• Very compressed intraday charts where labels and range boxes can crowd the price action
• News-driven spikes where price gaps far beyond the range
• Markets where older swing structure is too messy to define clean obstruction room
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Planning Side → controls Auto, Long Escape, or Short Escape mode.
• Range Lookback → controls how the prior range boundary is mapped.
• Minimum Range Age → defines how mature the range should be before stronger scoring.
• Minimum Close Beyond Edge ATR → controls how far price must close beyond the boundary before an escape registers.
• Follow-Through ATR → defines stronger post-escape movement beyond the edge.
• Retest Tolerance ATR → controls how close price can revisit the broken boundary and still count as a hold.
• Obstruction Lookback → controls how older swing structure is checked for clean room.
• Label and Panel Font Size → controls chart labels, centered box text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The range box defines the active decision area. The escape corridor shows the forward planning path. The invalidation, target, and obstruction lines add context without turning the chart into a crowded signal board.
The AGPro panel provides a compact decision summary with a merged blue title row and clear state hierarchy.
🧪 Practical Usage Workflow
1. Read the panel state and Escape Score.
2. Check whether the range is mature enough.
3. Review the escape corridor and edge line.
4. Check confirmation, retest behavior, and obstruction room.
5. Treat alerts as attention markers, then evaluate broader market context.
🔍 Interpretation Guidelines
Think in terms of escape quality, not prediction.
A stronger score means multiple structural conditions are aligned. A weaker score means the escape may be premature, poorly confirmed, obstructed, too noisy, or already failed.
OBSTRUCTION is especially important because a range can break cleanly while nearby older structure still limits practical room.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a Darvas Box clone
• Not an ORB model
• Not a generic support/resistance zone map
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, range, and older swing structure.
Timeframe differences can change how range maturity and escape quality appear. Volatility spikes can distort the score. Thin markets can create false escape or failure behavior.
Outputs should always be interpreted with broader market structure, liquidity, and risk context.
🧠 Market Context Notes
Range escape behavior is most useful when a readable balance area exists before expansion.
An escape with no follow-through may still be early. An escape with immediate obstruction may require extra caution. An escape that returns through the broken edge is treated as failed context, not as a new opposite prediction.
🧾 Use Case Examples
When price closes beyond a mature range, volatility expands from normal conditions, the candle holds beyond the edge, and older obstruction room is clean, the planner may classify the move as VALID ESCAPE.
When price breaks the boundary but quickly returns through the edge, the planner may classify the context as FAILED.
When price escapes but older swing structure is immediately ahead, the planner may show OBSTRUCTION even if the score is otherwise improving.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning a range breakout into a structured planning question: is the escape mature, confirmed, readable, and supported by clean room?
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, or follow-through.
This tool provides structured visual context and rule-based attention markers. It does not provide certainty.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and no script can remove 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 mature ranges resolve, how escape quality changes after the first break, and how obstruction room affects the readability of breakout continuation.
Indicator
Expansion Target Planner [AGPro Series]Expansion Target Planner
🧠 Core Idea
After expansion is confirmed, where is the reasonable target band, how clean is the path, and what should be reviewed next?
📌 Overview / What it does
Expansion Target Planner is a chart-first risk-target planning tool designed to evaluate the target area after a confirmed range expansion.
Instead of drawing a generic target line or copying a measured-move pattern, the script studies the prior range edge, current ATR, continuation pressure, recent structure obstacles, volatility state, and an invalidation shelf behind the move. It then converts that context into a 0-100 Target Quality score and a clear next-action state.
The output is a practical planning workflow: an expansion target band, invalidation shelf, target midpoint guide, path obstruction marker, compact chart labels, alert conditions, and a clean AGPro decision panel. It does not predict the future, automate decisions, or guarantee that any target band will be reached.
🎯 Purpose & Design Philosophy
This script was built for traders who need a cleaner way to evaluate expansion targets after price has already shown confirmation.
Many tools focus on finding a breakout, drawing an equal measured move, or plotting fixed take-profit levels. This tool fills a different gap: it asks whether the next target area is reasonable, whether the path is blocked, and whether the invalidation reference still supports the plan.
The design supports a disciplined target-review mindset. It helps users separate a clean expansion path from a stretched, obstructed, expired, or invalidated plan.
⚡ Why This Script Is Different
Most tools focus on measured moves, ABCD projections, fixed target ladders, or generic breakout confirmation.
This script does NOT become a measured-move projection tool, ABCD pattern detector, take-profit ladder, auto trading system, or generic support/resistance map.
Instead, it builds one active expansion target plan after confirmation and evaluates the quality of that plan. The core output is not a trade command. It is a planning state that helps users review whether the target band, invalidation shelf, volatility, and structure path still make sense.
⚙️ Methodology
1. Context Detection
The script identifies whether price has confirmed expansion beyond a prior range edge. Users can keep the side on Auto or force Long Expansion / Short Expansion.
2. Reference Mapping
Once confirmation appears, the script locks an active target plan. It maps the expansion anchor, ATR-adjusted target distance, target band, invalidation shelf, and recent pivot-based path obstacle.
3. Reaction Evaluation
The script scores the plan using expansion strength, ATR projection fit, nearby structure, continuation pressure, volume support, trend support, and volatility state.
4. Visual Output
The chart displays the active target band, invalidation shelf, guide lines, obstruction marker, event labels, alerts, and AGPro panel state.
🗺️ How to Read the Chart
Zones = the forward target band and the invalidation shelf behind the expansion.
Labels = the current target planning state, such as TARGET READY, WATCH, OBSTRUCTED, TARGET HIT, or INVALID REVIEW.
Colors = green/teal supports cleaner bullish expansion quality, pink marks bearish or risk states, yellow marks caution or obstruction, and indigo is used as a neutral planning accent.
Panel = the compact decision view showing Expansion Side, Target Band, Invalidation, Target Quality, and Action.
🚦 Signals & States
• TARGET READY → the target band has acceptable quality and the path is clean enough for review.
• WATCH → target context is improving, but not enough conditions are aligned yet.
• OBSTRUCTED → a recent structure obstacle sits between current price and the target band.
• TARGET HIT → price has interacted with the active target band.
• INVALID REVIEW → price has crossed the invalidation shelf and the plan should be reviewed.
• EXPIRED → the active plan has spent too many bars without completing.
🔔 Alerts Logic
Alerts trigger when the active target state changes into an important review condition.
• Target Ready alert → target quality moves into a stronger review state.
• Target Watch alert → target context improves but remains incomplete.
• Path Obstructed alert → a structure obstacle blocks the target path.
• Target Band Touched alert → price reaches the active target band.
• Invalidation Review alert → price crosses the invalidation shelf.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The Target Quality score improves when expansion confirmation, ATR projection fit, continuation pressure, volume support, volatility state, and open structure path align.
When the target distance is reasonable, the close is efficient, volume supports the move, and no nearby obstacle blocks the path, the context becomes stronger.
📊 When to Use
• After confirmed range expansion
• During breakout continuation review
• When evaluating whether a target area is too close, too far, or structurally blocked
• When a trader wants target context without a fixed take-profit ladder
• During volatility expansion phases where target planning matters more than another signal
⚠️ When NOT to Use
• Very low-liquidity markets
• Extremely noisy sideways chop
• News-driven spikes where ATR and structure become unstable
• Markets with unreliable volume if volume support is central to your process
• Any situation where the user expects automatic trade instructions
🎛️ Key Inputs
• Expansion Side → Auto, Long Expansion, or Short Expansion planning.
• Prior Range Lookback → defines the range edge used for confirmation.
• Confirmation Break ATR → controls how far beyond the range edge price must close.
• Range Projection Multiple → adjusts how much prior range width contributes to the target distance.
• ATR Projection Multiple → adjusts how much current volatility contributes to the target distance.
• Target Band Width ATR → controls the visual width of the target band.
• Invalidation Shelf Lookback → defines the reference shelf behind the expansion.
• TARGET READY / WATCH thresholds → control how selective the state engine is.
• Visual settings → control target band, shelf, guide lines, obstruction marker, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one active target plan.
The target band is displayed forward on the chart with centered text. The invalidation shelf is shown behind the move so the risk reference is visible without turning the script into a generic support/resistance tool.
The panel follows the AGPro public-release standard with one merged blue header row containing only the script name. The layout is compact and designed for quick reading during live chart review.
🧪 Practical Usage Workflow
1. Read the panel to identify the active Expansion Side and Target Quality.
2. Check whether the target band is clean or obstructed.
3. Review the invalidation shelf behind the expansion.
4. Use labels and alerts as attention markers.
5. Confirm the broader market context with your own process.
🔍 Interpretation Guidelines
Treat the target band as a planning area, not a guaranteed destination.
A higher Target Quality score means the target plan is cleaner according to the script rules. It does not mean the move must continue.
An OBSTRUCTED state does not mean price cannot move through the obstacle. It means the path contains structure that deserves review.
An INVALID REVIEW state means the active shelf has been crossed and the plan context has changed.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a measured-move projection system
• Not an ABCD pattern scanner
• Not a take-profit ladder
⚠️ Limitations & Transparency
• Timeframe differences can change expansion quality and target distance.
• Volatility shifts can make a previously clean target band less useful.
• Recent structure may not capture every important higher-timeframe obstacle.
• Volume-based scoring can be less useful on symbols with unreliable volume.
• No rule-based tool can fully account for news, liquidity shocks, or sudden regime changes.
🧠 Market Context Notes
Expansion targets are more useful when the market has already shown range release and the target path is not immediately blocked by nearby structure.
Liquidity, volatility, and structure should be read together. A target band can look reasonable by distance but still become lower quality if the path is obstructed or volatility becomes overheated.
🧾 Use Case Examples
When price closes beyond a prior range edge with strong close location and the target path is open, the script may show TARGET READY.
When price expands but a recent pivot sits directly between current price and the target band, the script may show OBSTRUCTED.
When price crosses the invalidation shelf behind the plan, the script may show INVALID REVIEW.
🧱 System Philosophy
AGPro Series tools are designed to support structured decision review, not emotional signal chasing.
This script follows that philosophy by focusing on target quality, invalidation context, and next-action state rather than a simple directional signal.
🔐 Non-Promise Statement
No target band is certain.
No score guarantees continuation.
No alert should be treated as a trade instruction.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, position sizing, risk controls, and market interpretation.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use this tool to study how target quality changes after expansion confirmation.
The strongest value comes from comparing the target band, obstruction marker, invalidation shelf, and broader market context together.
Indicator
Impulse Follow-Through Quality [AGPro Series]Impulse Follow-Through Quality
🧠 Core Idea
Did the impulse receive enough follow-through to remain valid?
📌 Overview / What it does
Impulse Follow-Through Quality is a chart-first momentum expansion planner built to evaluate what happens after a strong impulse candle appears.
Instead of treating every strong candle as a standalone signal, the script starts a follow-through review window and measures whether price extends, pauses constructively, pulls back too deeply, reaches a target-room guide, or crosses a failure rail. These elements are converted into a 0-100 Impulse Quality score and a clear next-action state.
The script produces an impulse highlight, follow-through box, failure rail, measured target guide, compact labels, alerts, and a clean AGPro planning panel. It does not predict continuation, automate trades, or guarantee that momentum will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to separate a meaningful impulse from a candle that only looks strong for one bar.
Many momentum tools focus on the impulse itself. The practical question often comes after that candle: does the move attract follow-through, or does it begin to fail? This planner fills that gap by turning the post-impulse phase into a readable decision process.
The design supports a patient review mindset: identify the impulse, watch the follow-through window, evaluate pullback depth, check target room, and review the failure rail before reacting.
⚡ Why This Script Is Different
Most tools focus on strong candles, volume spikes, momentum bursts, or basic continuation labels.
This script does NOT act as a Volume Climax Detector, does NOT rebuild an Institutional Candle Detector, and does NOT reduce the chart to a simple buy/sell momentum signal.
Instead, it evaluates what happens after the impulse. The key output is not the candle itself. The key output is the follow-through quality state: IMPULSE, WAIT FT, FT WATCH, VALID FT, PULLBACK RISK, WEAK FT, FAILED, or TARGET REVIEW.
⚙️ Methodology
1. Context Detection
The script detects qualified bullish or bearish impulse candles using ATR-normalized range, body efficiency, close location, trend context, and participation.
2. Reference Mapping
Once an impulse qualifies, the script maps the impulse origin, follow-through box, failure rail, and target-room guide.
3. Reaction Evaluation
The model evaluates follow-through progress, closes beyond the impulse close, retracement depth, participation support, target room, and whether price crosses the failure rail.
4. Visual Output
The result is displayed through an impulse highlight, centered follow-through box label, failure rail, target guide, compact labels, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Impulse Highlight = the latest qualified impulse leg that starts the review window.
Follow-Through Box = the active planning area between the impulse close and the measured target-room guide. Its label is centered inside the box.
Failure Rail = the practical invalidation reference behind the impulse. It is an analytical line, not a stop order.
Target Guide = a measured target-room reference based on the impulse range.
Labels = compact state markers for impulse start, constructive follow-through, weak follow-through, pullback risk, failure rail review, and target review.
Colors = teal supports constructive long-side follow-through, pink supports short-side or failure context, amber marks review risk, and indigo marks watch states.
Panel = summarizes Impulse Quality, Follow-Through, Pullback Risk, Target Room, and Action.
🚦 Signals & States
• IMPULSE → a qualified impulse candle has started a review window.
• WAIT FT → the impulse exists, but follow-through is not confirmed yet.
• FT WATCH → follow-through conditions are improving but not strong enough for the highest state.
• VALID FT → follow-through quality is constructive according to the rule set.
• PULLBACK RISK → retracement depth is elevated inside the impulse range.
• WEAK FT → the follow-through window is aging without enough progress.
• FAILED → price crossed the failure rail behind the impulse.
• TARGET REVIEW → price reached the measured target-room guide and context should be reviewed.
🔔 Alerts Logic
Alerts can trigger when a new impulse starts, follow-through becomes constructive, follow-through enters watch state, the move weakens, pullback risk rises, price crosses the failure rail, or price reaches the target-room guide.
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 a clean impulse candle is followed by measurable progress, multiple closes beyond the impulse close, controlled retracement depth, supportive participation, and readable target room.
When these components weaken, the planner can shift toward WAIT FT, FT WATCH, PULLBACK RISK, WEAK FT, or FAILED.
📊 When to Use
• After strong momentum candles where continuation quality matters.
• During trend continuation attempts that need follow-through review.
• After breakout or expansion bars where a one-bar move may be misleading.
• On liquid symbols where ATR, candle structure, and volume behavior are readable.
• When you want a post-impulse planning map instead of another raw momentum signal.
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles or unreliable volume.
• Extremely noisy micro-timeframes where impulse candles appear too frequently.
• News-driven spikes where one-bar expansion can distort the model.
• Markets with large gaps that make ATR and failure-rail references less useful.
• Situations where the user expects guaranteed continuation or automated trade signals.
🎛️ Key Inputs
• Follow-Through Side → controls Auto, Long Follow-Through, or Short Follow-Through mode.
• Minimum Impulse ATR → changes how large a candle must be before review begins.
• Minimum Body Efficiency → controls how clean the impulse body must be.
• Minimum Edge Close → controls how near the candle must close to its directional edge.
• Follow-Through Window → controls how many bars are used to judge early continuation.
• Required Progress ATR → defines preferred movement after the impulse close.
• Maximum Pullback Ratio → controls when retracement depth becomes elevated risk.
• Failure Rail Buffer ATR → adjusts the analytical failure rail behind the impulse.
• Visual settings → control the impulse highlight, follow-through box, failure rail, target guide, labels, panel visibility, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The impulse highlight gives the origin. The follow-through box gives the active planning area. The failure rail and target guide define the practical review frame.
The AGPro panel provides a compact decision summary with a merged blue title row, adjustable panel location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Read the panel Impulse Quality score and Action.
2. Check the impulse highlight and the direction of the follow-through box.
3. Review whether price is extending beyond the impulse close.
4. Compare pullback depth with the failure rail.
5. Use the target guide as a context-review reference, not as a guarantee.
6. Treat alerts as attention markers inside broader analysis.
🔍 Interpretation Guidelines
Think in terms of follow-through quality, not prediction.
A higher score means the impulse has more constructive continuation characteristics according to the script's rule set. A weaker score means the move may be aging, retracing too deeply, lacking progress, or crossing its failure reference.
VALID FT does not mean price must continue. FAILED does not mean the market cannot recover later. The states organize the review process.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not an auto-trading system.
• Not a guaranteed signal tool.
• Not a buy/sell signal service.
• Not a Volume Climax Detector.
• Not an Institutional Candle Detector.
• Not a generic momentum oscillator.
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price action, ATR, candle structure, selected inputs, and volume behavior.
Different timeframes can produce different impulse and follow-through readings. Volatility spikes can temporarily distort the score. Symbols with unreliable volume may produce weaker participation readings.
Outputs should always be interpreted with broader market structure, liquidity, and trader-defined risk controls.
🧠 Market Context Notes
Impulse candles are only useful when the market confirms or rejects them through follow-through.
A clean impulse that receives controlled extension may deserve more attention than a larger candle that immediately retraces. A smaller impulse can also become meaningful when the follow-through window stays organized.
🧾 Use Case Examples
When price prints a strong bullish impulse, closes near the high, then follows through with multiple closes above the impulse close while pullback depth remains controlled, the planner may classify the move as VALID FT.
When an impulse appears but price fails to extend, retraces deeply, or crosses the failure rail, the planner may shift toward WEAK FT, PULLBACK RISK, or FAILED.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning impulse follow-through into a structured planning question: did the move receive enough confirmation, progress, and risk clarity to remain worth reviewing?
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, breakout success, or outcome.
This tool provides structured visual context and rule-based attention markers. It does not provide certainty.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly, and no script can remove uncertainty.
Users are responsible for their own analysis, risk management, position sizing, and trading decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how strong candles behave after they appear, how follow-through quality changes across timeframes, and how pullback depth affects the readability of momentum continuation.
Indicator
Range Expansion Risk Planner [AGPro Series]Range Expansion Risk Planner
🧠 Core Idea
Does a range expansion offer clean room, or is price moving into immediate failure risk?
📌 Overview / What it does
Range Expansion Risk Planner is a chart-first breakout quality and risk-planning tool built for one specific moment: price has left a defined range, and the trader needs to understand whether the expansion has enough structure to deserve attention.
Instead of printing generic breakout signals, the script maps the source range, freezes the broken edge, builds an expansion runway, tracks a failure rail, estimates target room, evaluates retest behavior, and converts those conditions into a 0-100 planner score.
The script produces a source range box, expansion runway, failed-expansion review band, risk/target rails, full-state labels, deterministic alerts, and a clean AGPro panel. It does not predict future price movement, automate execution, or guarantee that a breakout will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate range expansion quality after price leaves a structure, not simply react to the first candle outside the range.
Many tools mark breakouts, draw range boxes, or highlight volatility expansion. The gap is the planning layer after the break: Is the source range mature? Was the expansion candle strong enough? Did price close clearly beyond the edge? Is the retest accepted or weak? Is there enough room before the next target-side reference?
The design supports a decision-first workflow. It helps users separate a clean range expansion from a weak release, blocked room, failed expansion, or early unconfirmed movement.
⚡ Why This Script Is Different
Most tools focus on breakout arrows, range highs/lows, volatility spikes, or support/resistance zones.
This script does NOT become a generic range breakout signal, a generic S/R zone map, a squeeze indicator, or a target predictor.
Instead, it evaluates the quality of the expansion plan after the range edge is broken. The main output is not a trade command. It is a planning state that helps the user decide whether the current expansion is CLEAN, on REVIEW, waiting for retest, blocked by room risk, or failing back into the source range.
⚙️ Methodology
1. Context Detection
The script maps the active source range using a user-defined lookback and detects whether price has closed beyond the upper or lower edge with enough ATR-normalized distance.
2. Reference Mapping
When a qualified expansion appears, the script freezes the source range, the broken edge, the failure rail, and the target-room marker so the plan can be reviewed consistently.
3. Reaction Evaluation
The model scores range maturity, expansion candle quality, close beyond edge, retest quality, target-room distance, and failure-rail distance.
4. Visual Output
The result is displayed through a source range box, expansion runway, failed-expansion band, risk/target rails, full-state event labels, alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the source range shows where the expansion came from. The expansion runway shows the path between the broken edge and the target-room marker. The failed-expansion band shows the area where the release may be losing structure.
Labels = full-state markers show Range Expansion, Clean Expansion, Expansion Review, Retest Accepted, Failed Expansion, Target Room Reached, Failure Risk, or Range Watch context.
Colors = teal highlights cleaner bullish expansion, pink highlights bearish or failed contexts, amber highlights review/risk states, and indigo highlights watch or target-edge states.
Panel = the panel summarizes Range Maturity, Expansion Risk, Room Risk, Confirmation, and Action.
🚦 Signals & States
• CLEAN EXPANSION → range expansion quality is strong enough to deserve active review.
• REVIEW → expansion context is developing, but confirmation or target room is incomplete.
• WAIT RETEST → price has expanded, but the broken edge has not yet been accepted clearly.
• ROOM BLOCKED → target-side room is limited relative to the current risk structure.
• FAILURE RISK → price is back inside the range or close to the failed-expansion area.
• FAILED → price crossed the failure rail and the prior expansion plan should be reviewed.
• TARGET EDGE → price reached the active target-room marker.
• RANGE WATCH → the range is mature enough to monitor, but no qualified expansion is active yet.
🔔 Alerts Logic
Alerts trigger when the planner enters clean expansion, review state, retest accepted state, failed-expansion warning, or target-room reached state.
These alerts are attention markers only. They are not trade instructions, entry signals, automated strategy commands, or guaranteed outcomes.
🧩 Confluence Logic
The strongest context appears when a mature source range releases with a strong expansion candle, price closes clearly beyond the edge, target-side room remains open, the failure rail is not too far away, and the broken edge receives constructive retest behavior.
When those components align, the planner score improves and the action state becomes cleaner.
📊 When to Use
• After price leaves a clear range
• During breakout-review workflows
• When comparing whether a release has enough room to justify attention
• When price retests the broken range edge
• On liquid symbols where ATR, range, and volume behavior are readable
• Especially on 4H swing charts, where range release, retest behavior, failure risk, and target-room context remain visually readable
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes
• News-driven candles that distort the range edge
• Markets with frequent gaps or unreliable volume
• Situations where the user expects a simple buy/sell signal
🎛️ Key Inputs
• Expansion Side → controls Auto, Long Expansion, or Short Expansion planning.
• Sensitivity → changes how selective the range maturity and edge-close requirements are.
• Source Range Lookback → defines the range used before expansion.
• ATR Length → normalizes failure rail, label spacing, expansion distance, and room risk.
• Retest Review Bars → controls how long an edge retest can improve confirmation quality.
• Target-Side Obstacle Lookback → searches for older target-side references before using the measured target.
• CLEAN / REVIEW Scores → adjust how strict the state model is.
• Visual settings → control boxes, runway, rails, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one primary decision path: source range → expansion runway → failure rail → target room.
The panel uses the AGPro public-release standard with one merged blue header row containing only the script name. It keeps the decision fields readable without turning the chart into a crowded dashboard.
Labels keep full professional state names, are offset away from candles, and are limited by cooldown and max-visible controls.
🧪 Practical Usage Workflow
1. Read the panel action state.
2. Check whether the source range was mature enough before expansion.
3. Review the expansion runway and target-room marker.
4. Check whether price accepted the broken edge or moved back into failure risk.
5. Use alerts as attention markers, then evaluate the broader market context.
🔍 Interpretation Guidelines
A higher score means the model sees better alignment between source range quality, expansion candle quality, edge close, retest behavior, and target room.
CLEAN EXPANSION does not mean a trade must be taken. It means the expansion structure is clean enough to deserve active review.
REVIEW means the release may be developing, but the user should check confirmation and room quality before treating it as clean.
FAILED and FAILURE RISK are caution states. They help identify when an expansion is losing structure after leaving the range.
🚫 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 does not replace user judgment, risk management, or broader market analysis.
⚠️ Limitations & Transparency
Timeframe differences can change how range maturity, retests, and target-room references appear.
Volatility changes can widen failure rails or reduce clean target room.
Fast market conditions can move from CLEAN to FAILED quickly if price returns into the source range.
The script is rule-based and should be interpreted as an analytical planning layer, not as certainty.
🧠 Market Context Notes
Range expansion quality is not only about breaking the edge. A cleaner expansion usually needs a readable source range, a decisive close beyond the edge, enough room before obstruction, and a failure reference that is not too wide.
The planner is most useful when it prevents users from treating every breakout as equal.
🧾 Use Case Examples
When price closes beyond a mature range and the target-room marker remains far enough away, the planner may move into REVIEW or CLEAN EXPANSION.
When price retests the broken edge and holds outside the range, confirmation can improve.
When price closes back through the failure rail, the planner marks FAILED so the old expansion idea is not treated as clean anymore.
🧱 System Philosophy
Range Expansion Risk Planner follows the AGPro Series decision-engine approach:
Context first.
Risk before reaction.
Structure before signal.
Attention markers instead of promises.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No score, state, label, alert, range box, runway, or rail 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 this script to study how range expansions develop, how broken edges behave after release, and how failure risk can be organized visually before making discretionary decisions.
Indicator
Decision Point Planner [AGPro Series]Decision Point Planner
🧠 Core Idea
Is price sitting at a decision point that deserves review, patience, or rejection?
📌 Overview / What it does
Decision Point Planner is a chart-first risk planning tool built to evaluate whether the current price area is meaningful enough to deserve attention.
The script maps one active decision point from structure shelf, balance edge, or trend backbone context, then scores the area using location quality, reaction candle behavior, volume support, trend context, available room, and invalidation distance. The output is a 0-100 Decision Score, a clear next-action state, a decision zone, an invalidation shelf, a target-room corridor, compact labels, alerts, and a premium AGPro panel.
It does not predict price direction, automate execution, or print direct buy/sell signals.
🎯 Purpose & Design Philosophy
This script was built for traders who want to know whether the chart is actually at a meaningful decision area or simply moving through noise.
Many tools show levels, zones, or signals in isolation. Decision Point Planner focuses on a narrower planning question: if price is near a decision reference, is the reaction strong enough, is risk still balanced, and is there enough room before the next obstacle?
The design supports a patient planning mindset: identify the point, read the reaction, check room and invalidation, then decide what deserves attention.
⚡ Why This Script Is Different
Most tools focus on plotting many support/resistance levels or marking every reaction.
This script does NOT create a generic S/R map, order-block scanner, FVG map, or prediction engine.
Instead, it selects one active decision reference and turns it into a planning workflow: Decision Score, Zone Type, Reaction State, Room/Risk, and Next Action.
⚙️ Methodology
1. Context Detection
The script detects the active planning side automatically using trend context and range location, or the user can force Long Context or Short Context.
2. Reference Mapping
It compares three decision references: the latest structure shelf, the active balance edge, and the trend backbone. The closest relevant reference becomes the active decision point.
3. Reaction Evaluation
It evaluates whether price is touching or approaching the zone, whether the candle shows a valid reaction, whether volume supports the reaction, whether trend context agrees, and whether room and invalidation remain balanced.
4. Visual Output
It displays a decision zone, invalidation shelf, target-room corridor, compact chart labels, alerts, and a clean AGPro panel.
🗺️ How to Read the Chart
Decision Zone = the current area where price is being evaluated as a decision point.
Invalidation Shelf = the reference beyond the zone that marks rejection in this rule set.
Target-Room Corridor = the available forward room toward the nearest obstacle or a minimum room guide.
Labels = compact attention markers showing ACTION, WAIT, PATIENCE, REJECTED, ROOM, or D POINT context.
Colors = teal and pink show active directional context, amber shows caution, indigo shows wait/reaction context, and blue is reserved for the AGPro panel header.
Panel = summarizes Decision Score, Zone Type, Reaction State, Room Risk, and Action.
🚦 Signals & States
• ACTION REVIEW → the decision point has enough score, reaction, room, and risk quality to deserve closer review.
• WAIT REACTION → price is near the decision point, but the reaction is still incomplete.
• PATIENCE → the area is active but quality, room, or risk is not clean enough yet.
• REJECTED → price crossed the invalidation shelf for the active decision point.
• STAND BY → price is not close enough to the active decision reference.
🔔 Alerts Logic
• Decision Point Action Review → triggers when the state enters ACTION REVIEW.
• Decision Point Wait Reaction → triggers when price is near the point but reaction is incomplete.
• Decision Point Patience → triggers when the active point requires patience or broader confirmation.
• Decision Point Room Limited → triggers when the point is active but forward room is limited.
• Decision Point Rejected → triggers when price crosses the active invalidation shelf.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
Decision quality improves when location, reaction candle behavior, volume support, trend context, target room, and invalidation distance align.
The strongest read appears when price is near the decision zone, the reaction candle is efficient, volume is supportive, trend context agrees, room is open, and risk distance is balanced.
📊 When to Use
• Around pullbacks where price is near a meaningful planning reference.
• During breakout or continuation preparation when the next reaction matters.
• Near range edges or balance transitions where patience is required.
• When comparing whether a setup deserves review or should remain on watch.
• On liquid markets where ATR, volume, and recent structure are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable volume and candles.
• Highly noisy micro-timeframes where decision references change too frequently.
• News-driven volatility spikes where ATR and candle ranges expand abnormally.
• Charts where the user expects automatic buy/sell signals.
• As a standalone reason to enter or exit a trade.
🎛️ Key Inputs
• Planning Side → selects Auto, Long Context, or Short Context.
• Decision Range Lookback → defines the planning range and target-room obstacle.
• Structure Shelf Pivot Length → controls how strict the structure shelf reference is.
• Decision Reach ATR → controls how close price must be to the active point before review.
• Decision Zone Half-Width ATR → controls the vertical size of the decision zone.
• Target Room and Invalidation Inputs → define room quality and balanced risk distance.
• Visual Settings → control zones, shelves, corridor, labels, panel location, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The script uses one active decision zone, one invalidation shelf, and one target-room corridor instead of filling the chart with many competing zones. Labels are compact, offset away from candles, and controlled with cooldown and maximum-visible settings.
The panel follows the AGPro publication layout with a single merged blue title row, adjustable location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Read the panel state and Decision Score.
2. Check the active decision zone and zone type.
3. Evaluate the reaction label and candle behavior.
4. Compare target-room corridor and invalidation shelf.
5. Treat alerts as review markers and confirm the broader market context.
🔍 Interpretation Guidelines
A higher Decision Score means the active decision point has stronger alignment inside the script's rule set. It does not mean price must move in the planned direction.
ACTION REVIEW means the area deserves attention, not automatic execution.
WAIT REACTION means the location may be important but the reaction is not complete.
REJECTED means the active invalidation shelf was crossed in this rule set.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a buy/sell signal service.
• Not a generic support/resistance zone map.
• Not an order-block or FVG scanner.
⚠️ Limitations & Transparency
Decision quality depends on the selected lookback, pivot length, ATR behavior, volume reliability, and timeframe.
Different markets can produce different reference behavior. High volatility can widen invalidation distance. Low volatility can compress target room. Small timeframes may produce more frequent state changes.
The script is rule-based and should be interpreted as an analytical planning layer inside broader market context.
🧠 Market Context Notes
A decision point is useful only when it connects location, reaction, risk, and room.
The same visual area can be weak if reaction is poor, volume is absent, target room is blocked, or invalidation is too tight or too wide.
This script organizes those checks into one readable decision layer.
🧾 Use Case Examples
When price pulls back toward the decision zone and the panel moves from WAIT REACTION to ACTION REVIEW, the area may deserve closer review.
When price touches the zone but the panel shows Room Limited, the user can recognize that the nearby path is obstructed.
When price crosses the invalidation shelf, the script marks the active decision point as rejected inside its rule set.
🧱 System Philosophy
Decision Point Planner follows the AGPro decision-engine approach:
Context first.
Risk before reaction.
Room before confidence.
Attention markers instead of promises.
🔐 Non-Promise Statement
No script can guarantee direction, continuation, reversal, or outcome.
This tool provides structured chart context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk controls, position sizing, and trading decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use the script to study how decision quality changes as price moves closer to or away from active planning references.
The most useful reading comes from comparing the panel state with visible price reaction, room, and invalidation context.
Indicator
Indicator
Execution Window Planner [AGPro Series]Execution Window Planner
🧠 Core Idea
Where is the cleanest active price window for evaluating execution context?
📌 Overview / What it does
Execution Window Planner is a chart-first execution-readiness tool built to answer one practical question: is price currently sitting inside a clean review window, or is the context too early, too late, too stretched, or already invalidated?
The script maps an active execution window box, a risk edge, a target edge, compact state labels, and a premium AGPro panel. It converts window width, structure alignment, volatility fit, trend support, candle confirmation, and room-to-risk context into a transparent 0-100 Quality Score.
It does not predict price movement, automate orders, or issue buy/sell commands. The output is designed as an analytical planning layer for traders who want cleaner context before making their own execution decisions.
🎯 Purpose & Design Philosophy
This script was built for traders who already have a directional thesis but need a disciplined way to judge whether the current price area is actually usable for execution review.
Many tools show trend, signals, support/resistance, or zones. The missing piece is often the active decision window: the price area where risk is still definable, target room still exists, volatility is not distorted, and confirmation is not too weak.
The design philosophy is simple: execution quality should be evaluated through a defined window, not through excitement around a single candle.
⚡ Why This Script Is Different
Most tools focus on printing a signal, marking a generic support/resistance area, or showing a large multi-feature trading dashboard.
This script does NOT act as a full trading suite, signal service, position sizing tool, ICT/FVG map, order block map, or generic zone scanner.
Instead, it keeps one narrow purpose: identify and score the current execution window using risk edge, target edge, structure, volatility, trend support, and candle confirmation. The result is a focused decision layer rather than another broad indicator.
⚙️ Methodology
1. Context Detection
The script detects the active planning side automatically from trend structure, or lets the user force a long-bias or short-bias view.
2. Reference Mapping
It builds a risk edge from recent structure and a target edge from broader structure or ATR-adjusted room.
3. Window Construction
It creates an active execution window around the current trend reference, then limits that window between the risk edge and target edge.
4. Reaction Evaluation
It scores window width, structure alignment, volatility fit, trend support, and candle confirmation into a 0-100 Quality Score.
5. Visual Output
The chart displays the execution window box, risk/target edges, state labels, alerts, and a premium AGPro panel with the key decision fields.
🗺️ How to Read the Chart
Execution Window = the current price area where the script is evaluating execution context.
Risk Edge = the structure-based invalidation edge for the active window.
Target Edge = the nearest meaningful target-side reference or ATR-adjusted room marker.
Labels = the current window state, score tier, risk distance, and room-to-risk context.
Colors = teal for stronger bullish execution windows, pink for bearish or invalidation contexts, amber for forming/waiting states, and indigo for target-edge or transition states.
Panel = the fastest summary of window state, quality score, risk edge, target edge, and next action.
🚦 Signals & States
• ACTIVE → the execution window meets the quality threshold and confirmation filter.
• FORMING → the window is improving but still needs cleaner confirmation.
• WAIT → the context exists, but structure, volatility, room, or confirmation is not strong enough yet.
• BLOCKED → there is no clean execution window in the current context.
• TARGET EDGE → price has reached the mapped target-side reference and reaction quality should be evaluated.
• INVALIDATED → price closed beyond the active risk edge.
🔔 Alerts Logic
ACTIVE Window alerts trigger when the state upgrades into ACTIVE.
Downgrade alerts trigger when the active window weakens from a stronger previous state.
Risk Edge alerts trigger when price closes beyond the current risk edge.
Target Edge alerts trigger when price reaches the current target edge.
Alerts are attention markers only. They are not trading instructions.
🧩 Confluence Logic
The strongest execution-window context appears when several conditions align:
• Price remains inside the mapped execution window
• The risk edge is still structurally valid
• The target edge leaves enough room relative to risk
• Trend support agrees with the active side
• Candle structure confirms the same direction
• Volatility is close to its recent baseline
When these elements align, the Quality Score improves and the panel state becomes easier to interpret.
📊 When to Use
• When you already have a directional thesis and want to evaluate execution context
• During trend continuation setups where risk and target references remain clear
• Around pullback or reset areas where timing and risk quality matter
• Before reacting to a potential continuation candle
• When you want a cleaner planning layer instead of another simple signal indicator
⚠️ When NOT to Use
• During very low-liquidity conditions where candles print irregularly
• During high-noise chop where risk and target edges change too quickly
• During extreme volatility spikes where ATR context becomes distorted
• On symbols with poor price continuity or unreliable session behavior
• As a standalone reason to enter or exit a trade
🎛️ Key Inputs
• Setup Direction → Auto detects the active planning side, or the user can force Long Bias / Short Bias.
• Sensitivity → controls how selective the model is.
• Structure Lookback → controls how risk edge, target edge, and structure context are mapped.
• Minimum ACTIVE Score → defines the score threshold required for ACTIVE state.
• Confirmation Mode → controls how much trend and candle confirmation must align.
• Label Cooldown Bars → controls historical label density.
• Max Visible Labels → limits older state labels to keep the chart readable.
• Label Detail → Compact is the default clean publication view; Balanced and Full can show more risk/room context.
• Label Offset Strength / Lane Strength → smart placement controls that keep labels near price without burying them inside candles or pushing them too far away on higher timeframes.
• Panel Location / Theme / Font Size → controls the AGPro panel presentation.
• Label Font Size → controls all on-chart labels.
🖥️ Interface & Visual Design
The panel is designed as a compact decision dashboard, not a large command center. The first row uses the standard AGPro merged blue header row, and the remaining rows focus only on the information needed to evaluate the current execution window.
The chart visuals stay restrained: one active execution window, one risk edge, one target edge, a current quality tag, and moderate historical state labels. The goal is a premium, readable chart that does not feel empty but also avoids clutter.
🧪 Practical Usage Workflow
1. Read the panel state first.
2. Check whether price is inside or near the execution window.
3. Compare the risk edge and target edge.
4. Review the Quality Score and confirmation state.
5. Interpret labels as context markers, not as trade commands.
6. Confirm the broader market context with your own process.
🔍 Interpretation Guidelines
ACTIVE does not mean guaranteed continuation. It means the current window has passed the script's rule-based quality model.
FORMING means the setup may be developing, but the script does not yet see enough confirmation.
WAIT means the context may exist, but the window quality is not clean enough.
BLOCKED means the current chart does not offer a useful execution window under the selected settings.
TARGET EDGE means the chart has reached the mapped target-side reference, so reaction quality becomes more important than chasing the move.
INVALIDATED means the risk edge has been broken and the active window should be reset.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a full trading suite
• Not an ICT/FVG or order block map
• Not a generic support/resistance zone scanner
⚠️ Limitations & Transparency
Execution-window quality is rule-based and depends on the selected inputs, timeframe, symbol behavior, and available chart data.
Different timeframes can produce different risk and target edges because market structure changes with resolution.
Fast volatility expansion can make the current edge distances less stable.
Low-volume markets may produce weaker confirmation quality.
The script should be interpreted inside broader market context, not in isolation.
🧠 Market Context Notes
Execution quality is usually strongest when structure, volatility, and trend behavior are aligned.
If volatility expands too quickly, the window can become stretched even if direction looks strong.
If the target edge is too close, the setup may have limited room even when the trend looks clean.
If the risk edge is too far away, the setup may require too much tolerance relative to the available room.
🧾 Use Case Examples
When price pulls back toward the active trend reference, remains inside the execution window, and the risk edge is still structurally protected, the Quality Score may improve.
When price reaches the target edge after an ACTIVE window, the script can shift into TARGET EDGE state so the user can evaluate reaction behavior instead of treating the move as fresh.
When price closes beyond the risk edge, the window becomes INVALIDATED and the panel shifts to a reset-oriented state.
🧱 System Philosophy
Execution Window Planner follows the AGPro Series approach: build scripts that help traders make a decision, not just see another signal.
The script is intentionally narrow. It focuses on one practical question and keeps the chart output centered around that question.
🔐 Non-Promise Statement
No script can provide certainty.
No score guarantees future movement.
No alert should be treated as an instruction to trade.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution choices, risk management, and trading outcomes.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
The best use of this script is to study how execution context changes as price moves between risk edge, execution window, and target edge.
Use it as a structured planning aid, not as a replacement for your own market analysis.
Indicator
Exit Readiness Planner [AGPro Series]Exit Readiness Planner
🧠 Core Idea
Is the active move showing enough decay to prepare an exit review?
📌 Overview / What it does
Exit Readiness Planner is a chart-first trade management tool built to evaluate whether an active move is losing enough quality to deserve closer review. Its cleanest default use case is 4H swing-management review, where structure, target proximity, and decay are usually easier to read than on very small timeframes.
The script converts momentum decay, candle-efficiency loss, target proximity, volatility contraction, and reversal pressure into a 0-100 Exit Readiness Score. It produces an exit-pressure zone, target and risk-shift rails, exhaustion fade context, compact state labels, alerts, and a clean AGPro panel.
It does not predict price direction, automate exits, or print direct sell commands. Its purpose is to organize exit-review context while the user remains responsible for all decisions.
🎯 Purpose & Design Philosophy
Many traders plan entries carefully but review exits only after momentum has already faded. This script was built to make the exit-review question more structured.
It helps traders who manage active moves and want a cleaner way to monitor whether the move still has room, strength, and volatility support, or whether it is shifting into a review state.
The design supports a management mindset: read the current pressure, check remaining room, review exhaustion, then decide what deserves attention.
⚡ Why This Script Is Different
Most tools focus on take-profit ladders, trailing stops, or direct exit signals.
This script does NOT build a profit-target ladder, a Chandelier Exit clone, a stop-loss optimizer, or a buy/sell command system.
Instead, it asks a narrower decision question: is the active move showing enough decay, target proximity, or risk-shift pressure to prepare an exit review?
⚙️ Methodology
1. Context Detection
The script identifies the active move side using Auto Context, Long Move, or Short Move.
2. Reference Mapping
It maps target-side structure, remaining room, a fast trend reference, and an exit-pressure zone around the active target rail.
3. Reaction Evaluation
The model scores momentum decay, candle-efficiency loss, target proximity, volatility contraction, and reversal pressure.
4. Visual Output
The output appears as a forward exit-pressure zone, exhaustion fade band, compact labels, alert conditions, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the forward exit-pressure area near the active target rail.
Labels = clear attention markers such as EXIT REVIEW, EXIT WATCH, TARGET NEAR, RISK SHIFT, or PRESSURE EASED.
Colors = teal suggests calmer monitor context, amber suggests watch or target proximity, pink/red suggests stronger exit-review pressure.
Panel = summarizes Exit Pressure, Remaining Room, Exhaustion State, Risk Shift, and Action.
🚦 Signals & States
• EXIT REVIEW → the score and supporting conditions show stronger decay or pressure.
• EXIT WATCH → review context is developing but is not yet in the stronger review state.
• TARGET NEAR → price is close to the active target-side reference.
• RISK SHIFT → pressure appeared against the active move near the trend reference.
• MONITOR → exit pressure is not strong enough for active review attention.
🔔 Alerts Logic
• Exit Readiness Review → triggers when the planner enters Exit Review state.
• Exit Readiness Watch → triggers when watch context appears.
• Target Near → triggers when price becomes close to the active target rail.
• Risk Shift → triggers when pressure appears against the active move.
• Pressure Eased → triggers when active pressure returns to monitor context.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The strongest review context appears when momentum decay, candle-efficiency loss, target proximity, volatility contraction, and reversal pressure align.
When only one factor appears, the state may remain Watch or Monitor. When several factors align, the score can move toward Exit Review.
📊 When to Use
• During active trade management.
• Especially on 4H swing-management charts.
• When price is approaching a target-side reference.
• During trend moves that may be losing momentum.
• After strong directional candles begin to compress.
• On liquid symbols where ATR and pivot references are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable candles.
• News spikes where volatility changes too quickly.
• Very noisy micro-timeframes with unstable wick behavior.
• As a standalone reason to close a position.
• When the user has no broader trade plan or risk framework.
🎛️ Key Inputs
• Active Move Side → selects Auto Context, Long Move, or Short Move.
• Sensitivity → controls how quickly decay and pressure affect the score.
• Lookback → defines the structure window for target references and room.
• Exit Review Score → sets the threshold for the stronger review state.
• Exit Watch Score → sets the lower attention threshold.
• Visual Settings → control zones, rails, fade bands, labels, optional move-side prefixes, optional micro markers, panel visibility, theme, location, and font sizes.
🖥️ Interface & Visual Design
The interface is chart-first and built around one primary visual object: the exit-pressure zone.
The panel uses the AGPro publication layout with a single merged blue title row, adjustable location, adjustable theme, and adjustable font size.
Labels use clear full-text state names, offset from candles, and are controlled by cooldown and maximum-visible settings to keep the chart active without becoming crowded. Move-side prefixes and tiny micro markers are available but disabled by default for a cleaner 4H publication preset.
🧪 Practical Usage Workflow
1. Read the panel Action state.
2. Check the Exit Pressure score.
3. Review the remaining room to the active target rail.
4. Compare the exhaustion state with candle behavior.
5. Treat alerts and labels as review prompts, not trade commands.
🔍 Interpretation Guidelines
A high score means the script sees more exit-review pressure according to its rules. It does not mean price must reverse.
Target Near means remaining room is compressed relative to ATR. It does not mean the target must hold.
Risk Shift means pressure appeared against the active move. It should be interpreted with timeframe, volatility, and broader structure.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a sell-signal service.
• Not a take-profit ladder.
• Not a trailing-stop strategy.
⚠️ Limitations & Transparency
Exit-readiness behavior depends on the selected lookback, ATR length, target pivot length, sensitivity, timeframe, and market condition.
Low volatility can make target proximity more frequent. High volatility can widen references and delay review states. Small timeframes can produce more frequent state changes.
The script is rule-based and should be read as an analytical management layer inside a broader plan.
🧠 Market Context Notes
An active move can remain valid while still deserving review.
Exit readiness is not the same as bearish or bullish prediction. It is a structured way to notice when the move may be losing quality, nearing a reference, or showing pressure against the active side.
🧾 Use Case Examples
When price approaches the target rail and candle efficiency falls, the planner may move from Monitor to Exit Watch.
When target proximity, momentum decay, and reversal pressure align, the planner may mark Exit Review.
When pressure eases and the move regains quality, the script can return to Monitor.
🧱 System Philosophy
Exit Readiness Planner follows the AGPro decision-engine approach:
Context before reaction.
Review before emotion.
Attention markers instead of commands.
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, target behavior, or exit timing.
This tool provides structured chart context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk controls, position sizing, and trading decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use the script to study how exit-review pressure changes as momentum fades, room compresses, volatility contracts, and pressure appears against the active move.
Indicator
Reward Room Analyzer [AGPro Series]Reward Room Analyzer
🧠 Core Idea
Does the chart offer enough clean reward room before the next major obstacle?
📌 Overview / What it does
Reward Room Analyzer is a chart-overlay planning tool designed to evaluate whether the current price area has enough practical space before the next meaningful obstacle.
Instead of projecting a take-profit ladder or calculating position size, the script studies the distance from current price to the nearest target-side obstacle, the opposite invalidation reference, room-to-risk ratio, trend support, clean-air structure, and volatility fit. These inputs are converted into a 0-100 Reward Room Score with a clear state such as Open Room, Watch Room, Thin Room, Blocked Path, Risk Heavy, or No Room.
The script produces a forward reward room corridor, nearest obstacle rail, invalidation reference rail, compact chart labels, alert conditions, and a clean AGPro planning panel. It does not predict price movement, automate execution, or promise that any target will be reached.
🎯 Purpose & Design Philosophy
This script was built to solve a common planning problem: a setup can look attractive, but the path ahead may already be blocked by nearby structure, poor room-to-risk, or excessive invalidation distance.
Reward Room Analyzer helps traders review the quality of the space ahead before treating a setup as actionable. It supports a planner mindset: check the available room, identify the obstacle, compare room against risk, and then decide whether the chart deserves more attention.
It is designed for traders who care about trade planning, target path quality, risk awareness, and cleaner decision structure rather than another generic signal marker.
⚡ Why This Script Is Different
Most tools focus on drawing take-profit levels, R-multiple ladders, Fibonacci extensions, or basic risk/reward boxes.
This script does NOT build a TP ladder, position-size calculator, profit tracker, or entry signal system.
Instead, it asks a narrower decision question: is there enough clean reward room before the next obstacle, or is the path already too thin, blocked, or risk-heavy?
⚙️ Methodology
1. Context Detection
The script selects the active target side using Auto Side, Long Room, or Short Room. Auto Side weighs trend support and available room.
2. Reference Mapping
It maps confirmed obstacle pivots, the nearest target-side rail, the opposite invalidation reference, and ATR-normalized reward room.
3. Reaction Evaluation
It scores the room using distance to obstacle, room-to-risk ratio, clean-air structure, trend agreement, risk distance, and volatility fit.
4. Visual Output
It displays the active reward corridor, centered corridor label, obstacle/invalidation rails, compact labels, alerts, and an AGPro panel.
🗺️ How to Read the Chart
Reward Room Corridor = the forward space between current price and the nearest target-side obstacle.
Nearest Obstacle Rail = the first meaningful structural barrier in the selected target direction.
Invalidation Reference = the opposite-side reference used to estimate risk distance.
Labels = compact state markers showing the current reward-room condition and score.
Colors = teal and indigo suggest stronger room quality, amber suggests caution, and pink/red suggests weak or blocked room.
Panel = summarizes reward score, reward room, obstacle, room-to-risk, target side, and next action.
🚦 Signals & States
• Open Room → reward room is wide enough, room-to-risk is acceptable, and risk is not excessive.
• Watch Room → context is acceptable but not strong enough for the open-room state.
• Thin Room → the nearest obstacle is too close.
• Blocked Path → room-to-risk is weak relative to the invalidation reference.
• Risk Heavy → invalidation distance is too large compared with the available room.
• No Room → conditions are not strong enough for planning attention.
🔔 Alerts Logic
• Open Reward Room → triggers when the script enters the Open Room state.
• Watch Reward Room → triggers when watchable room appears without reaching Open Room.
• Blocked Reward Path → triggers when room-to-risk becomes structurally blocked.
• Thin Reward Room → triggers when the nearest obstacle is too close.
• Risk Heavy Room → triggers when invalidation distance is heavy relative to room.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
Reward room quality improves when the target-side distance, room-to-risk ratio, clean-air structure, trend agreement, balanced risk distance, and stable volatility align.
The strongest read appears when the corridor is visibly open and the panel confirms sufficient room with a strong score.
Indicator
Trade Location Quality [AGPro Series]Trade Location Quality
🧠 Core Idea
Is price in a clean trade location, or is it too close to obstruction, invalidation, or noisy range edges?
📌 Overview / What it does
Trade Location Quality is a chart-overlay risk-location planner designed to evaluate whether the current price area is practical for setup review.
The script measures range position, nearby obstruction rails, ATR-normalized risk distance, target room, trend support, and volatility fit. These inputs are combined into a 0-100 Location Quality Score with a clear state such as Clean Location, Watch Location, Obstructed, Danger Close, Risk Wide, or Poor Location.
It produces a forward location window, target/risk rails, compact event labels, alert conditions, and a premium AGPro panel. It does not predict price direction, automate execution, or print direct buy/sell commands.
🎯 Purpose & Design Philosophy
This script was built to solve a common planning problem: a setup may look interesting, but the trade location may still be weak because price is too stretched, too close to the next obstacle, or too close to invalidation.
The goal is to help traders think in terms of location quality before reacting to a setup. It supports a planning mindset: check context, evaluate room, review risk, then decide whether the area deserves attention.
It is designed for traders who want a clean decision layer rather than another generic signal marker.
⚡ Why This Script Is Different
Most tools focus on detecting a level, zone, breakout, or signal.
This script does NOT build a premium/discount map, OTE model, generic support/resistance scanner, order-block map, or prediction engine.
Instead, it asks a narrower planning question: is the current location clean enough to evaluate, or is the chart already blocked by risk, obstruction, or poor range position?
⚙️ Methodology
1. Context Detection
The script identifies the active evaluation side using either Auto Context, Long Context, or Short Context. Auto Context follows the trend-support basis.
2. Reference Mapping
It maps the recent range, nearest obstruction rails, opposite-side risk rail, estimated invalidation reference, and ATR-normalized room.
3. Reaction Evaluation
It scores location quality using range position, target room, risk distance, trend support, and volatility fit.
4. Visual Output
It displays a forward location window, target/risk rails, state labels, alerts, and a compact AGPro panel.
🗺️ How to Read the Chart
Location Window = the current area where price location is being evaluated.
Target Obstruction Rail = the nearest meaningful obstacle in the evaluation direction.
Risk Rail = the opposite-side reference used to estimate invalidation distance.
Labels = compact state markers showing the current planner condition and score.
Colors = teal and indigo suggest stronger quality, amber suggests caution, and pink/red suggests weak or risky location.
Panel = summarizes score, state, range position, obstruction distance, risk state, and next action.
🚦 Signals & States
• Clean Location → location score is strong, room is sufficient, and risk distance is balanced.
• Watch Location → context is acceptable but not strong enough for the clean-location state.
• Obstructed → price is too close to the next target-side obstruction rail.
• Danger Close → invalidation is too close for a balanced location read.
• Risk Wide → invalidation is too far away, making the location less efficient.
• Poor Location → score and context are not strong enough for planning attention.
🔔 Alerts Logic
• Clean Location → triggers when the script enters the Clean Location state.
• Obstructed Location → triggers when price becomes too close to the next obstruction rail.
• Risk Location Warning → triggers when risk distance becomes too tight or too wide.
• Watch Location → triggers when a watchable location context appears without reaching Clean Location.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
Location quality improves when range position, target room, balanced risk distance, trend support, and stable volatility align.
The strongest read appears when the score is high and the panel also shows enough obstruction distance with a balanced risk state.
📊 When to Use
• During setup planning before reacting to a signal.
• Around pullbacks where risk and target room matter.
• During trend continuation review when price may be clean or already stretched.
• Before breakout or reversal evaluation when nearby obstruction can change the quality of the idea.
• On liquid markets where ATR and pivot references are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable candles.
• Highly noisy periods where rails change too frequently.
• Extreme volatility spikes where ATR-based distance can expand rapidly.
• Charts where the user has no broader context for directional evaluation.
• As a standalone reason to enter or exit a trade.
🎛️ Key Inputs
• Evaluation Context → selects Auto, Long, or Short planning context.
• Location Lookback → defines the recent structure window.
• Obstruction Pivot Length → controls how strict obstruction rails are.
• Minimum Clean Score → sets the quality threshold for Clean Location.
• Minimum Target Room ATR → controls how much room must exist before the next obstruction.
• Risk Buffer Inputs → define what counts as too close or too wide.
• Visual Settings → control compact or detailed labels, rails, location window, panel visibility, theme, location, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The location window shows the active evaluation area without filling the chart with many competing zones. The obstruction rails provide practical reference points. The default labels use compact state tags, while hover tooltips retain the deeper score, room, risk, and action context. Cooldown and maximum-visible settings keep the chart active but not crowded.
The panel follows the AGPro publication layout with a single merged blue title row, adjustable location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Read the panel score and state.
2. Check whether target-side room is open or obstructed.
3. Review whether risk distance is balanced, too close, or too wide.
4. Compare the location window with broader market context.
5. Treat alerts and labels as attention markers, not decisions.
🔍 Interpretation Guidelines
A high score means the location is cleaner relative to the script's rule set. It does not mean price must move in the evaluated direction.
An obstructed state means room is limited before the next nearby reference. It does not mean price cannot break through that area.
A risk warning means the current location is less balanced for planning. It should be interpreted with timeframe, volatility, and broader structure.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a buy/sell signal service.
• Not a premium/discount or OTE zone engine.
• Not a generic support/resistance zone scanner.
⚠️ Limitations & Transparency
Location quality depends on the selected lookback, pivot length, volatility profile, and timeframe.
Different markets can produce different rail behavior. High volatility may widen risk distance. Low volatility may compress target room. Small timeframes may produce more frequent state changes.
The script is rule-based and should be read as a planning tool inside broader analysis.
🧠 Market Context Notes
Trade location is not only about where price is. It is also about what sits nearby.
A location can look attractive but still be weak if there is not enough clean room before the next obstruction. A location can also be risky if invalidation is too close or too far for the current volatility environment.
This script organizes those conditions into a single readable decision layer.
🧾 Use Case Examples
When price pulls back inside a trend and the score improves while risk remains balanced, the chart may deserve closer review.
When price is near a target-side rail and the panel shows Obstructed, the user can recognize that nearby room is limited.
When volatility expands and risk distance becomes too wide, the script can mark the location as less efficient for planning.
🧱 System Philosophy
Trade Location Quality follows the AGPro decision-engine approach: the script should help the user evaluate context, quality, risk, room, and next action without promising an outcome.
The goal is not to add another signal. The goal is to improve the quality of the planning process.
🔐 Non-Promise Statement
No script can guarantee direction, continuation, reversal, or outcome.
This tool provides structured chart context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk controls, position sizing, and trading decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use the script to study how trade location changes as price moves closer to risk, target, obstruction, and range edges. The most useful reading comes from comparing the panel state with the visible chart context.
Indicator
Choppiness Setup Planner [AGPro Series]Choppiness Setup Planner
🧠 Core Idea
Is this choppy market still a no-trade environment, or has it matured into a valid setup with defined risk, invalidation, and targets?
📌 Overview / What it does
Choppiness Setup Planner is a planner-style overlay built for one of the most common decision problems in technical analysis: what should a trader do when price is trapped inside a choppy range, but pressure starts building near the edge?
The script detects no-trade chop conditions, builds a decision range around the active structure, scores setup quality from 0 to 100, and turns a mature range release into a clear planning map with invalidation and target levels. Instead of only saying "the market is choppy," it answers whether the setup is still avoidable, preparing, weak, valid, active, or invalidated.
The cleanest visual use case is higher-timeframe planning. Weekly and daily charts allow the full range-to-plan lifecycle to breathe: no-trade structure, preparation, release, target, and invalidation can all be read without the chart feeling crowded.
It does not automate execution, predict future price, or replace personal trade selection. It is an analytical planner designed to organize context, risk, and next-action state directly on the chart.
🎯 Purpose & Design Philosophy
This script was built because many market-state tools show information without helping the user make a decision. A Choppiness Index value, ADX filter, or range box can be useful, but those outputs often stop before the practical question: what now?
Choppiness Setup Planner fills that gap by connecting chop detection with a structured planning workflow. It is intended for discretionary traders, breakout traders, and range-to-expansion traders who want to avoid low-quality noise while preparing for stronger releases from mature ranges.
The design philosophy is simple: first protect attention, then qualify the setup, then map risk only when the structure deserves it.
⚡ Why This Script Is Different
Most tools focus on detecting chop, drawing a box, or marking a breakout.
This script does NOT act like a generic signal indicator, generic support/resistance tool, or simple Choppiness Index panel.
Instead, it turns a choppy market into a decision sequence:
1. Detect the no-trade environment.
2. Track range age and pressure.
3. Grade setup validity with a 0-100 score.
4. Define the next action state.
5. Map invalidation and targets only after a valid release.
That makes the script closer to a decision engine than a visual marker. It is also intentionally separated from manual position planners: users do not enter their own position parameters. The script derives its planning levels from the detected chop range and the release quality model.
⚙️ Methodology
1. Context Detection
The engine blends Choppiness Index, directional weakness, path efficiency, range tightness, wick noise, and volatility behavior to determine whether the market is inefficient enough to qualify as a no-trade chop environment.
2. Reference Mapping
When chop persists long enough, the script builds a decision range around the active structure. This range is not a generic support/resistance zone; it is a planning container for the current no-trade condition.
3. Reaction Evaluation
The script evaluates whether pressure is improving through range age, chop release, ADX lift, path-efficiency improvement, ATR lift, edge pressure, candle body quality, close quality, and optional volume participation.
4. Visual Output
The chart displays the no-trade ribbon, decision range box, centered zone label, preparation markers, valid plan markers, weak-release markers, invalidation level, target levels, and a compact AGPro planner panel.
🗺️ How to Read the Chart
Zones represent the active no-trade decision range. A centered label inside the box shows whether the structure is still a no-trade zone or has moved into preparation mode.
Labels represent state changes. PREP marks a mature range with improving setup quality. PLAN UP and PLAN DN mark valid releases. SKIP marks a release that happened but failed the minimum plan-quality threshold. T1, T2, and INVALID track the active plan lifecycle.
Colors follow the AGPro state palette. Teal is used for stronger upside planning states, pink for downside or invalidation states, amber for caution and no-trade states, and indigo for preparation/readiness.
The panel shows Setup Quality, Next Action, Chop / Ready, Range Age, Invalidation, and Targets.
🚦 Signals & States
• Avoid: Chop → the market is inefficient and still belongs in no-trade mode.
• Prepare: Edge Watch → the range has matured and internal readiness is improving.
• Skip: Low Quality → price released from the range, but the quality score was not strong enough.
• Track Upside Plan → upside release met the minimum valid plan score.
• Track Downside Plan → downside release met the minimum valid plan score.
• Manage: T1 Reached → the active plan reached its first target level.
• Review: T2 Reached → the active plan reached its second target level.
• Reset: Invalidated → the active plan crossed its invalidation level.
🔔 Alerts Logic
Alerts are available for preparation state, valid upside plan, valid downside plan, weak release, Target 1 reached, Target 2 reached, and invalidation.
Each alert is an attention marker. Alerts are not trade instructions, not automation rules, and not execution commands.
🧩 Confluence Logic
The setup becomes stronger when a mature chop range aligns with improving readiness, edge pressure, candle body participation, release distance, and optional volume participation.
When these components align, the script can convert the release into a valid plan. When price releases without enough score, the script marks the event as SKIP instead of treating every breakout as useful.
📊 When to Use
• Choppy markets where the user needs a no-trade filter.
• Weekly, daily, and 4H planning where range structure matters more than micro-noise.
• Mature ranges that may be preparing for expansion.
• Breakout-preparation workflows.
• Range-to-trend transition monitoring.
• Symbols where invalidation and target structure should be visible before acting.
⚠️ When NOT to Use
• Extremely illiquid markets with unreliable candles.
• Symbols where volume data is misleading, unless volume participation is disabled.
• News-driven spikes where a single candle can distort range logic.
• Very low timeframes with excessive spread noise.
• Scalping workflows that require rapid-fire signals instead of structural planning.
• Markets where the user has no broader context for trend, liquidity, or session behavior.
🎛️ Key Inputs
• Choppiness Length → controls the chop-detection backbone.
• Decision Range Length → controls how the active no-trade range is framed.
• Minimum Range Age → controls how long chop must persist before planning begins.
• Preparation Threshold → controls when the range moves from avoid mode to preparation mode.
• Minimum Valid Plan Score → controls how selective valid plan labels should be.
• Release Buffer ATR → controls how far price must move beyond the range boundary.
• Invalidation Buffer ATR → controls the distance behind the released boundary used for invalidation.
• Target 1 / Target 2 R Multiples → control target projection from the plan risk.
• Panel Location / Theme / Font Size → control the AGPro panel interface.
• Label Font Size / Cooldown / Maximum Visible Labels → control chart readability.
🖥️ Interface & Visual Design
The interface is designed around fast decision reading. The chart carries the range box, no-trade ribbon, centered zone label, event labels, and active risk/target levels. The panel summarizes the same workflow without becoming a large dashboard.
The first panel row follows the AGPro standard: one merged blue header row containing only the script name.
Visual density is intentionally moderate. The chart should not look empty, but it should also avoid crowded signal spam.
🧪 Practical Usage Workflow
1. Read the panel.
Check Setup Quality and Next Action first.
2. Check the decision range.
If the box says NO-TRADE, the structure is still inefficient. If it says PREP, the range is maturing.
3. Evaluate the release.
A valid PLAN label means the release met the quality threshold. A SKIP label means the release was not strong enough.
4. Review invalidation and targets.
When a plan is active, use the plotted levels to understand structure, not as automatic orders.
5. Confirm broader context.
Combine the planner output with trend, liquidity, timeframe, session, and personal execution rules.
For publication screenshots, higher-timeframe examples are usually the cleanest because they show the complete planning sequence without compressing labels and boxes into a noisy layout.
🔍 Interpretation Guidelines
Think in states, not isolated signals.
NO-TRADE protects attention.
PREP means the market is becoming more interesting.
PLAN means the release has enough structure to track.
SKIP means the release happened but did not earn quality.
INVALID means the plan lost its structural premise.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not auto trading.
It is not guaranteed signals.
It is not a strategy tester.
It is not a replacement for independent analysis.
⚠️ Limitations & Transparency
The script is rule-based and depends on selected inputs, timeframe, volatility, and available market data.
Different symbols and sessions can produce different behavior. Low liquidity, sudden volatility shocks, and abnormal gaps can reduce the usefulness of range-based planning.
Volume participation is optional because volume quality differs across markets and feeds.
🧠 Market Context Notes
Chop is not always weakness. Sometimes it is absorption, sometimes indecision, and sometimes simple noise. The script does not claim to know the cause. It organizes the observable structure so the user can decide whether the environment is worth attention.
🧾 Use Case Examples
When price spends several bars inside a tight inefficient range and the panel says Avoid: Chop, the script is acting as a no-trade filter.
When the range matures and the centered label changes to PREP, the script is showing that pressure has improved enough to monitor the edge.
When price releases and receives PLAN UP or PLAN DN, the script maps invalidation and targets from the structure.
When price releases but receives SKIP, the script is saying the event did not meet the model's quality threshold.
On weekly charts, a single valid plan can show the entire decision chain: range maturity, preparation, release, target reaction, and invalidation. This is the strongest showcase environment for the script.
🧱 System Philosophy
AGPro tools are built around structured decision support: define the condition, score the quality, map the relevant structure, and keep the chart readable.
Choppiness Setup Planner follows that philosophy by turning a noisy no-trade environment into a cleaner decision workflow.
🔐 Non-Promise Statement
No script can provide certainty.
No score guarantees follow-through.
No label guarantees an outcome.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, planned setups can fail, and losses can occur. This script is provided for educational and analytical use only. It does not provide financial advice or guaranteed trading outcomes. Users remain responsible for their own analysis, decisions, risk management, and execution.
📚 Educational Note
Use this script to study how choppy markets mature, how range releases differ in quality, and how invalidation and target logic can be organized visually before a decision is made. 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
Measured Move Projection Zones [AGPro Series]Measured Move Projection Zones
🔹 OVERVIEW
Measured Move Projection Zones is a premium price-action visualization tool built around one clear sequence: impulse, base, projection, and invalidation.
The script detects a qualified impulse leg, waits for a compact base range, then projects a measured-move target band from the base boundary. It also displays invalidation context, event labels, and a compact AGPro panel so the structure can be reviewed quickly on the chart.
The default profile is tuned for 1-hour charts, where measured-move structures need enough responsiveness to appear consistently while still avoiding low-quality micro-swings. The result is a clean projection map for traders who want structured continuation context without turning the chart into a dense extension grid.
This script is not designed to promise outcomes or mark every possible target. It is designed to make the measured-move workflow easier to see, compare, and audit.
🔹 WHAT MAKES IT DIFFERENT
Most projection tools start from a manual anchor, a generic extension grid, or a simple breakout distance. Measured Move Projection Zones is more selective.
It requires a directional impulse first. It then waits for a compact base. Only after the base qualifies does it create the projected target band and invalidation framework.
That sequence matters because it prevents the chart from becoming a collection of random forward boxes. The visual logic is always tied to a specific price-action chain:
Impulse leg -> base range -> projection band -> invalidation context.
The script also avoids the look of a traditional support/resistance map. The rectangles are not generic zones. They represent measured-move components: impulse body, base range, projected target band, and invalidation reference.
For public PulseWire presentation, the script is deliberately visual but controlled: moderated labels, visible structure boxes, no expired-label flood, and a compact panel that summarizes the current state.
🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS
This script stays in a narrow measured-move projection lane.
It does not overlap with ATR compression or volatility-map scripts because the core logic is not volatility contraction, expansion, or envelope behavior. ATR is only used for normalization, tolerance, and spacing.
It does not overlap with breakout-quality tools because it does not score a breakout event as the main product. Breakout beyond the base boundary only changes the measured-move state from armed to active.
It does not overlap with premium/discount or valuation-zone tools because it does not map equilibrium, discount, OTE, rebalance pockets, or fair value areas. Its target band is derived from an impulse leg and base boundary, not a valuation model.
It does not overlap with wedge, reversal, or pattern-scanner tools because it does not require converging rails, neckline behavior, double tops, double bottoms, head-and-shoulders logic, or multi-pattern classification.
It does not overlap with liquidity heatmap, bias dashboard, or volume-profile tools because it does not estimate liquidity fields, higher-timeframe directional bias, POC gravity, acceptance ladders, or volume shelves.
The differentiator is simple and specific: this is an impulse-base measured-move projection visualizer with target-band and invalidation context.
⚙️ METHODOLOGY
The methodology is built in stages:
1. Swing Confirmation
The script uses pivot confirmation to identify meaningful swing points. The default pivot setting is tuned for 1-hour chart rhythm.
2. Impulse Qualification
After a valid pivot sequence appears, the script measures the leg size in ATR units. The impulse must be large enough and must form within a reasonable bar window.
3. Base Validation
Once the impulse is confirmed, the script waits for a compact base range. The base must stay within a defined ATR height and avoid excessive retracement from the impulse end.
4. Projection Construction
When the base qualifies, the script projects a measured-move target band from the base boundary. The default multiplier is 1.00, representing a classic equal measured move.
5. Invalidation Context
The opposite side of the base receives an ATR-buffered invalidation guide. This does not create a trade command; it simply marks where the measured-move structure is no longer clean.
6. State Tracking
The setup moves through clear states: Waiting, Building Base, Armed, Projecting, Target Band, Invalidated, and Expired.
7. Visual Management
The script keeps a moderated amount of historical structure visible. Event labels are capped, expired labels are disabled by default, and the projection guide line is optional to keep the chart clean.
📊 PANEL
The AGPro panel is designed for quick structure review.
Panel rows include:
- State
- Direction
- Impulse Quality
- Projection Progress
- Target Distance
- Target Band
- Base Range
- Invalidation
The first panel row follows the AGPro public-release standard: one merged blue header row containing only the panel title.
Panel location is adjustable. Panel theme is adjustable. Panel font size is adjustable. The default size is Normal for a clean public-chart look.
🎛️ KEY INPUTS
1H Pivot Confirmation Length
Controls the swing confirmation used to anchor impulse legs. Lower values are more responsive. Higher values are more selective.
1H Minimum Impulse Size
Defines the minimum impulse strength in ATR units. The default is tuned to keep 1-hour charts active without accepting very small swings.
1H Base Range Bars
Controls how many bars are used to validate the post-impulse base. The default is shorter for hourly chart pacing.
1H Maximum Base Height
Limits how tall the base can be in ATR terms. This prevents wide ranges from being treated as clean measured-move bases.
1H Maximum Base Retracement
Controls how deeply price can retrace from the impulse end while still qualifying as a measured-move structure.
Measured Move Multiplier
Controls the projection distance. The default value of 1.00 represents an equal measured move.
1H Target Band Width
Controls the ATR-based visual tolerance around the projected target.
Invalidation Buffer
Places the invalidation guide beyond the opposite side of the base range.
1H Projection Bars
Controls how far the projected target band and base extension reach forward.
1H Projection Expiration
Controls how long an armed or active projection can remain open before it expires.
1H Event Label Retention
Controls whether the chart keeps a moderated history of event labels or only the latest event label.
1H Balanced Event Labels
Caps event labels so the chart remains informative but not overloaded.
Show Projection Guide Line
Optional dotted guide from the base boundary to the target band. Disabled by default on 1-hour charts to reduce diagonal clutter.
🔍 HOW TO READ IT
Waiting
No valid impulse-base sequence is active.
Building Base
An impulse has been detected and the script is watching for a compact base.
Armed
A valid base has formed. The projection framework is ready, and the target band is mapped forward.
Projecting
Price has moved beyond the base boundary and the measured-move structure is active.
Target Band
Price has interacted with the projected target band.
Invalidated
Price has closed beyond the invalidation guide, meaning the measured-move framework is no longer clean.
Expired
The projection did not complete within the selected expiration window.
Event labels provide a fast visual timeline. The boxes show where the measured structure came from, where the base formed, and where the projected band sits.
🧩 BEST USE CASES
This script is best used on 1-hour charts where traders want a clean view of impulse-base-continuation behavior.
Strong use cases include:
- Measuring continuation structures after a directional leg
- Comparing active projections against nearby price action
- Reviewing whether a base is compact enough to support a projection
- Mapping projected target zones without using a full extension grid
- Studying failed measured moves through invalidation labels and zones
- Creating cleaner screenshots for price-action review
The script can also be used on other timeframes, but the default settings were intentionally tuned around 1-hour structure density and visual balance.
🧠 VISUAL DESIGN PHILOSOPHY
The visual design is built around premium restraint.
The chart should not look empty, but it also should not look like every candle is receiving a signal. Measured Move Projection Zones keeps the main structural elements visible:
- Impulse boxes
- Base range boxes
- Projected target bands
- Invalidation zones or guides
- Moderated event labels
- Compact AGPro panel
Expired labels are disabled by default because they can quickly become noisy on hourly charts. Event labels are still preserved in a moderated amount so the chart has enough visual context.
The optional projection guide line is disabled by default because long diagonal lines can dominate a 1-hour screenshot. Users can enable it when they want a more explicit projection path.
The goal is a chart that looks structured, premium, and publication-ready while still being easy to read.
🔔 ALERTS
The script includes alert conditions for the core lifecycle events:
- Measured Move Armed
- Projection Active
- Target Band Interaction
- Projection Invalidated
- Projection Expired
These alerts are designed around structure states, not trade commands. They help users monitor when a measured-move framework forms, activates, interacts with the projected band, invalidates, or expires.
🔹 LIMITATIONS AND TRANSPARENCY
Measured Move Projection Zones is a structural visualization tool. It does not predict future price and does not claim that a projected target band will be reached.
Pivot-based swing logic confirms structure after the necessary bars have formed. This creates cleaner anchors, but it also means the script is not trying to label every move in real time before confirmation.
The target band is a measured projection derived from the impulse and base, not a certainty zone. Invalidation and expiration states are part of the design because failed measured moves are also useful information.
Settings matter. More aggressive inputs will create more structures. More conservative inputs will create fewer, cleaner structures.
✅ IDEAL USER
This script is ideal for traders who:
- Use 1-hour charts for price-action review
- Study impulse-base-continuation behavior
- Want measured-move target zones without a cluttered extension grid
- Prefer visual structure over heavy signal text
- Want a clean AGPro-style panel for quick state review
- Care about invalidation and failed projection context
- Need a public-chart-friendly tool that looks polished, focused, and easy to understand
Measured Move Projection Zones is built for users who want a disciplined projection framework on the chart: enough structure to be useful, enough restraint to stay premium. Indicator
Take Profit Planner [AGPro Series]Take Profit Planner
🎯 **Overview**
**Take Profit Planner ** is a precision exit-planning tool that transforms trade management from guesswork into a structured process. It builds a disciplined profit ladder around any trade idea — whether you are a scalper managing rapid exits or a swing trader stepping out of positions over days — and keeps the entire plan on one chart with live progress tracking.
Most traders agonize over entries and leave exits to improvisation. This tool flips that habit: define your anchor, choose your calculation style, and the script projects a complete multi-tier exit map with stop loss, position-sizing allocation, confluence scoring, and real-time hit tracking.
🪜 **What Makes It Different**
Unlike conventional take-profit indicators that plot a single ATR-based target or fixed R:R pair, this tool offers a **multi-layer exit architecture**:
▫️ **Three Calculation Modes** — Fibonacci Extensions, R-Multiples, or Hybrid Confluence in a single tool
▫️ **Three Anchor Sources** — Manual price inputs, auto pivot detection, or recent S/R zone anchoring
▫️ **Confluence Scoring** — In Hybrid mode, every target receives a ★ / ★★ / ★★★ rating based on how many independent level types (Fib, round number, pivot S/R) cluster at that price
▫️ **Position-Sizing Layer** — Allocate a custom percentage of your position to close at each tier, with automatic weighted P&L calculation
▫️ **Live Progress Tracking** — Visual hit confirmation (✓), realized vs expected profit, and a six-state status ladder: ACTIVE → PROGRESSING → IN PROFIT → NEAR COMPLETE → ALL TPs HIT → STOPPED OUT
🧠 **Methodology**
▫️ **Anchor Detection** — The script identifies a trade's origin (Swing) and entry point using one of three methods. Auto Pivot uses a confirmable `pivothigh`/`pivotlow` with configurable length. Auto S/R uses the most recent swing extremes as structural anchor points. Manual lets you input exact prices.
▫️ **Direction Inference** — LONG or SHORT is determined automatically from the geometry: Entry above Swing → LONG, Entry below Swing → SHORT. No manual flag needed.
▫️ **Stop-Loss Logic** — Three modes: ATR Multiple (volatility-adaptive), Swing Point (structural), or Fixed Percent (disciplined). In Manual anchor mode, you set the stop directly.
▫️ **Target Projection** — Fibonacci mode projects targets from the Anchor→Swing leg using standard extensions (1.272, 1.414, 1.618, 2.000, 2.618). R-Multiple mode multiplies the stop distance by risk factors (1R, 2R, 3R, 5R, 8R). Hybrid uses Fibonacci as base and scores confluence.
▫️ **Confluence Algorithm** — For each Fibonacci target, the script checks proximity to: (1) the nearest psychological round number within 0.15 ATR, (2) the most recent pivot high within 0.2 ATR, (3) the most recent pivot low within 0.2 ATR. Each alignment adds one point to the base Fibonacci score.
▫️ **Hit Detection** — On every confirmed bar, the script checks whether price crossed each un-hit target. Hits are persistent until the anchor changes by more than 1 ATR, at which point the plan resets.
🔔 **Signals & Alerts**
▫️ **TP Hit** — Fires once per bar when price touches a specific target. Alert message includes tier number, price, and direction.
▫️ **SL Hit** — Fires once when stop-loss is breached.
▫️ **All TPs Reached** — Fires once when the full ladder is completed.
All alerts are non-repainting and trigger only on confirmed bars.
🎛️ **Key Inputs**
▫️ **Calculation Mode** — Fibonacci Extensions, R-Multiples, or Hybrid Confluence
▫️ **Anchor Source** — Manual Price, Auto Pivot High/Low, or Auto Recent S/R
▫️ **Pivot Length** — Bars of confirmation for automatic pivot detection (default 10)
▫️ **Stop-Loss Mode** — ATR Multiple, Swing Point, or Fixed Percent
▫️ **Number of TP Tiers** — 2 to 7 (default 5)
▫️ **Fibonacci / R-Multiple Levels** — Fully customizable per tier
▫️ **Allocation %** — Position-sizing percentage per tier
▫️ **Zone Half-Width (ATR)** — Vertical thickness of target zones in ATR units
▫️ **Panel Location & Theme** — Six positions, Dark or Light theme
▫️ **Label & Panel Font Size** — Tiny, Small, Normal, Large
💡 **How to Use**
▫️ **Scalper Workflow (Fast Exits)** — Set Calculation Mode to R-Multiples, tier count to 3, allocations to 50 / 30 / 20. Use Auto Pivot with pivot length 5–8 on lower timeframes. Exit weighted-partials at each R-level.
▫️ **Swing Trader Workflow (Multi-Day Holds)** — Set Calculation Mode to Hybrid Confluence, tier count to 5, allocations to 20 / 20 / 25 / 20 / 15. Use Auto Pivot with length 10–15 on 4H or daily. Prioritize exits at ★★★ confluence targets.
▫️ **Discretionary Trader Workflow** — Set Anchor Source to Manual Price, enter your own Entry, Swing, and SL values. Choose Fibonacci mode for trend-based projections or Hybrid for confluence-weighted decisions.
▫️ **Position Management** — The Expected line in the panel shows total profit % if all active tiers are filled (weighted by allocation). The Realized line tracks booked profit as tiers fill. Use this to compare planned vs actual performance.
⚠️ **Limitations & Transparency**
▫️ This is a **planning and visualization tool**, not an entry signal generator. It assumes you already have a trade bias; it structures the exit.
▫️ **Auto-anchor modes** rely on confirmed pivots, which means the most recent plan updates a few bars after a fresh pivot forms. This is intentional to prevent repainting.
▫️ **Confluence scoring** is based on the current snapshot of pivot highs/lows and round numbers. As price moves and new pivots form, scores may change.
▫️ **Hit detection** uses bar highs/lows on confirmed candles only.
▫️ The tool does not know your actual fill prices, slippage, or spreads — expected and realized percentages assume exact execution at target prices.
🛡️ **Risk Disclosure**
Trading involves substantial risk of loss and is not suitable for every investor. The information provided by this indicator is for educational and informational purposes only and does not constitute financial advice, a trading recommendation, or a solicitation to buy or sell any asset. Past performance does not guarantee future results. Always perform your own analysis, define risk before entering any trade, and use proper position sizing. The author and AGProLabs accept no liability for trading decisions made using this tool.
🔓 **Open Source**
This script is published open-source under the Mozilla Public License 2.0. You are welcome to study the methodology, build on it, and contribute feedback. Indicator
Market Structure Navigator [JOAT]Market Structure Navigator
Introduction
Market structure is one of the most widely discussed concepts in technical analysis, yet most tools that attempt to visualize it reduce swing highs and swing lows to single price points. In practice, price rarely reverses at a precise tick level — it reacts within a zone , which may span several ATR units depending on the instrument and timeframe. This distinction matters: treating a level as a point rather than a zone leads to false breaks being mistaken for genuine structural shifts.
The Market Structure Navigator addresses this by modeling every significant swing high and swing low as an ATR-based zone with measurable thickness. It tracks two layers of structure simultaneously — external (major) pivots that define the larger-degree trend, and internal (minor) pivots that provide context within that trend. Each zone passes through a three-state lifecycle, and structural breaks are automatically classified as either Break of Structure (BOS) or Change of Character (CHoCH), giving you an immediate read on whether a break confirms the existing trend or signals a potential reversal.
This is an overlay indicator — all elements are drawn directly on the price chart.
---
Core Concepts
Dual-Layer Structure: External and Internal
The indicator identifies two categories of structural pivots using PulseWire's built-in pivot functions:
External structure (major): Pivots requiring a configurable number of bars on each side (default 20). These are the significant swing highs and lows that define the broader trend context. They update less frequently and represent the higher-degree market structure.
Internal structure (minor): Pivots requiring fewer bars on each side (default 7). These fire more frequently and capture the sub-swings that occur within the larger structural moves.
This dual-layer approach mirrors how institutional analysis treats structure: external levels define the direction of the larger trend; internal levels provide precision context for entries and exits within that trend.
Zone Geometry and ATR Thickness
Rather than marking a pivot as a single horizontal line, each pivot is rendered as a rectangular zone. The zone's top and bottom are calculated as:
zoneTop = pivotPrice + (ATR * zoneAtrMult)
zoneBottom = pivotPrice - (ATR * zoneAtrMult)
The default ATR multiplier is 0.5, meaning the zone extends half an ATR above and below the pivot price. This thickness is dynamic — it adjusts to the current volatility of the instrument rather than using a fixed pip or point value. Zones extend to the right as new bars form, keeping them visible as price approaches.
Three-State Zone Lifecycle
Every zone passes through three possible states:
Active (State 0): The zone has formed and not yet been tested. It extends to the right as bars pass, representing untested support or resistance. This is the most significant state — an active zone has not had its interest absorbed.
Swept (State 1): Price has reached the midpoint of the zone (configurable as either a wick touch or a close through the midpoint). A swept zone has been tested and shows that some activity occurred at that level. It may have weakened but is not yet confirmed as broken.
Broken (State 2): Price has closed decisively beyond the zone boundary (above the top for a resistance zone, below the bottom for a support zone). A broken zone stops extending. This state marks the structural failure of that level.
This lifecycle gives actionable information that a single horizontal line cannot. An active zone is very different from a swept zone even if they appear at the same price level.
BOS and CHoCH Classification
When price breaks through the last significant external high or low, the indicator determines whether the break is:
Break of Structure (BOS): The break occurs in the same direction as the current trend. A bullish BOS is a higher high that extends a confirmed uptrend; a bearish BOS is a lower low extending a downtrend. BOS signals trend continuation.
Change of Character (CHoCH): The break occurs against the current trend direction. A CHoCH in a downtrend means price has broken above the last significant swing high — a structural signal that the trend may be reversing. CHoCH signals a potential regime shift, not a confirmed reversal.
Both external and internal structural breaks are tracked separately. An internal CHoCH during an external downtrend, for example, may represent a short-term countertrend move within a larger bearish structure — context that a single-layer tool would miss.
Momentum Normalization
Momentum is calculated as the normalized price change:
momentum = priceChange / stdev(close, lookback)
This expresses the size of recent price movement in terms of its own standard deviation, making the momentum reading comparable across different instruments and volatility regimes.
Target Arrows
When an internal structural break occurs, the indicator draws a directional arrow label pointing toward the next significant external level. This provides a visual read on where price may be targeting within the larger structural context.
---
Features
Dual-layer structure detection: external major pivots and internal minor pivots tracked independently
ATR-dynamic zone thickness — zones adapt to current instrument volatility
Three-state zone lifecycle: Active, Swept, Broken — each visually distinct
Automatic BOS vs. CHoCH classification for both external and internal breaks
Configurable sweep mode: wick-based (high/low touches midpoint) or close-based (close through midpoint)
Equal high/low detection with configurable ATR tolerance to flag double tops/bottoms
Target arrows on internal breaks pointing toward the next external level
Dashboard table showing trend state, momentum, active zone counts, last known structural levels, and last break type
Full visual toggle controls for all overlay elements
Maximum zone count cap per type to maintain chart performance
---
Dashboard Table
A table displayed at the top-right of the chart provides a live summary of structural conditions:
Ext Trend: Current external trend direction (Bullish / Bearish)
Int Trend: Current internal trend direction
Momentum: Normalised momentum value
Ext Zones Active: Number of currently active external zones
Int Zones Active: Number of currently active internal zones
Last Ext High / Low: Price level of the most recent significant external pivot high and low
Last Break: The most recent break type (eBOS, eCHoCH, iBOS, iCHoCH)
---
Color System
External high zones: red
External low zones: white
Internal high zones: teal
Internal low zones: blue
BOS labels: green
CHoCH labels: red
This color separation allows you to immediately distinguish between the two structural layers without reading labels.
---
Input Parameters
External Pivot Length (default 20) — bars required on each side for a major pivot to confirm
Internal Pivot Length (default 7) — bars required on each side for a minor pivot to confirm
ATR Length (default 14) — ATR period used for zone thickness calculation
Zone ATR Multiplier (default 0.5) — controls how wide each zone is relative to ATR
Equal H/L Tolerance (default 0.3 ATR) — how close two pivots must be to be considered equal highs or lows
Sweep Mode (Wick / Close) — whether zone sweeps are triggered by wick touch or candle close through the midpoint
Max Zones Per Type (default 40) — caps the number of active zones drawn per category to preserve chart performance
BOS Lookback (default 30) — bars looked back when checking for structural breaks
Visual Toggles — individual controls for zones, BOS/CHoCH labels, target arrows, and the dashboard table
---
How to Use
Apply to any chart. The indicator will begin plotting zones as enough bars form to confirm pivots at the chosen lengths.
Allow sufficient historical bars to load so that the external pivots have time to confirm — with extLen set to 20, a pivot requires 20 bars after the swing point before it is officially plotted.
Read the external layer first. The external trend (eBOS/eCHoCH sequence) tells you the larger-degree direction. Trade in alignment with this unless you have strong reason to fade it.
Use the internal layer for timing. Internal CHoCH events within an external uptrend can signal pullback entries; internal BOS events in the direction of the external trend can confirm continuation.
Active zones are the most significant. A first-touch of an active zone is generally more meaningful than a return to a swept or broken zone.
When price approaches a zone, check the sweep mode setting and monitor whether price is reaching the midpoint (sweep) or closing through the boundary (break).
The target arrow on an internal break shows the next external level — this is a reference, not a guaranteed target.
---
Limitations
Pivot detection is inherently lagging. A pivot at bar N is only confirmed after N + extLen (or intLen) additional bars have formed. This means zones appear after the fact — the exact pivot price was in the past by the time the zone is drawn.
With longer pivot lengths, the indicator requires more historical bars to display meaningful structure. On short lookback windows or when first applied to a chart, the initial display may show few or no zones until sufficient pivot confirmation has accumulated.
ATR-based zone thickness means zone width changes with volatility. During high-volatility periods, zones become wider and may overlap. During compressed volatility, zones are narrower. Adjust the ATR multiplier if zones are too wide or too narrow for your preferred trading style.
The BOS/CHoCH classification is based on the direction of the previous break relative to the current one. In choppy, range-bound markets, rapid BOS/CHoCH alternation is possible and does not necessarily indicate a trend — it may simply reflect noise.
Zone lifecycle states reflect price behavior relative to the zone midpoint and boundary. They do not predict whether a swept zone will hold or whether a broken zone will become a new support/resistance level.
Maximum zone count limits (default 40 per type) are necessary to maintain chart performance. On instruments or timeframes with many pivot formations, older zones will be removed as new ones are added.
No indicator can classify market structure with certainty in real time. CHoCH signals a potential reversal; it does not confirm one. Always apply additional judgment.
---
Originality Statement
The distinguishing design decisions in this indicator are: zone-based pivot modeling, the three-state lifecycle, and the integrated dual-layer structure system.
Most structure tools mark a swing high or low as a horizontal line at a single price. This indicator models each pivot as a zone with ATR-derived thickness, acknowledging that price reactions do not occur at a tick but within a range that varies with the instrument's current volatility. A 0.5 ATR zone around a pivot is a more honest representation of where liquidity and interest are likely to cluster.
The three-state lifecycle (Active → Swept → Broken) adds information that static horizontal lines cannot convey. An active zone that has never been tested is categorically different from one that has seen a wick test — and both are different from a zone that has been fully broken. Treating these three states identically discards relevant context.
The dual-layer architecture (external major + internal minor) is not simply running the same algorithm twice at different sensitivities. The external layer provides the trend framework; the internal layer provides the tactical sub-structure within it. The BOS/CHoCH classification connects these two layers — an internal CHoCH is interpreted in the context of the external trend direction, not in isolation.
---
Disclaimer
This indicator is provided for educational and informational purposes only. It does not constitute financial advice, investment advice, or a recommendation to buy or sell any security. All trading involves risk, including the possible loss of principal. Past indicator performance does not guarantee future results. Always conduct your own research and consult a qualified financial professional before making any trading decisions.
-Made with passion by officialjackofalltrades
Indicator
Indicator
AG Pro Position Planner [AGPro Series]AG Pro Position Planner
OVERVIEW
AG Pro Position Planner is a structured trade-planning and risk-organization tool designed for traders who want to map a position before execution. It focuses on four core elements of trade preparation: entry location, stop placement, target mapping, and position sizing. Instead of trying to predict direction or generate automated entries, the script helps organize a plan around levels that the user defines manually.
The purpose of this tool is not to tell the user what to buy or sell. Its purpose is to turn a discretionary plan into a visible, measurable framework on the chart. By combining entry, stop, risk budget, capital usage, and target structure in one view, the script helps reduce planning ambiguity and makes the trade idea easier to review before any order is placed.
The script supports both long and short planning. It can also operate in two different target modes. In R-Based mode, targets are derived from the distance between entry and stop. In Manual mode, the user can input exact target prices directly and the script will convert those targets into their implied R-multiples. This allows the same tool to support both systematic planning and discretionary scenario mapping without changing the underlying workflow.
The visual design is intentionally restrained. The chart shows entry, stop, and target levels, along with optional reward and risk zones. A compact panel summarizes the key planning information, including direction, mode, risk per unit, risk budget, sizing, exposure, and target statistics. The result is a planning layout that remains readable on both light and dark themes while keeping the focus on structure rather than decoration.
WHAT THIS SCRIPT DOES
This script helps the user:
• define a planned entry price
• define a planned stop price
• convert account risk into a position size estimate
• map one to three targets on the chart
• compare manual targets to the initial risk distance
• review exposure before execution
• validate whether a manual target structure is logically ordered
• visualize the reward zone above entry and the risk zone below entry for long scenarios, or the inverse logic for short scenarios
The script is designed as a planning layer. It does not attempt to replace the user’s analysis process. It assumes the user already has a trade idea and needs a cleaner way to structure and review that idea.
UNIQUE EDGE
The distinguishing feature of this script is not signal generation. Its edge is organizational clarity.
Many tools focus on entries, signals, or directional interpretation. This one focuses on plan construction. The user chooses the key prices, and the script translates them into a coherent risk model. That distinction matters. The script does not present itself as a forecasting engine, a market-timing system, or an automated decision model. It is a position-planning framework.
A second differentiator is the dual target workflow. Some users think in fixed R-multiples. Others think in exact price objectives. AG Pro Position Planner supports both approaches in the same interface. In Manual mode, the script still reports the effective R-value of each target, which helps the user compare discretionary targets against the initial stop distance without losing consistency.
A third differentiator is the built-in validation behavior. The script checks whether the trade structure is logically valid for the chosen direction. In Manual mode, it also checks whether the targets are placed in the correct direction and in the correct order. This helps the user detect plan errors before execution rather than after the fact.
METHODOLOGY
The planning model is straightforward by design.
1) Entry and stop define the base risk distance.
The script measures the absolute distance between entry and stop. That distance becomes the reference risk per unit.
2) Account risk defines the risk budget.
The user enters an account size and a percentage risk per trade. The script converts this into a monetary risk budget.
3) Position size is estimated from the risk budget.
The script divides the risk budget by effective risk per unit and rounds the resulting quantity down to the selected quantity step.
4) Optional fee adjustment can be included.
An estimated fee percentage can be added to the per-unit risk as a conservative sizing buffer.
5) Targets are then mapped in one of two ways.
In R-Based mode, each target is calculated from the entry-to-stop distance using the selected R-multipliers.
In Manual mode, the user provides exact target prices and the script calculates the implied R-value of each target relative to the original stop distance.
6) Exposure statistics are summarized in the panel.
The panel shows stop distance, capital usage, risk budget, and sizing information so the trade can be evaluated as a complete plan rather than as isolated levels.
This methodology is intentionally transparent. The script is not using hidden directional filters, prediction logic, or undisclosed entry models. The calculations are derived from the user’s own inputs.
TARGET MODES
R-Based Mode
R-Based mode is intended for users who want a consistent structure around initial risk. The user defines entry and stop, then sets target multipliers such as 1R, 2R, or 3R. The script projects those levels automatically from the base risk distance. This is useful when the user wants standardized scenario planning and fast comparison between multiple setups.
Manual Mode
Manual mode is intended for users who work with exact price objectives. In this mode, the user enters target prices directly. The script then converts those levels into implied R-values. This allows discretionary targets to be measured against the same initial risk model.
To reduce planning mistakes, the script validates whether manual targets are placed in the correct direction and in the correct order for the chosen trade direction. Invalid target structures are flagged in the panel instead of being silently accepted.
PANEL AND VISUAL STRUCTURE
The chart can display:
• entry line
• stop line
• target lines
• reward zone
• risk zone
• right-side labels for entry, stop, and targets
• a compact summary panel
The panel is designed to keep the most useful information visible without taking over the chart. Its goal is to support review, not to dominate the screen.
The compact panel includes:
• plan summary
• validation badge
• entry and stop
• risk per unit
• risk budget
• sizing
• exposure
• target statistics
This structure is meant to help the user answer practical questions quickly:
How much is being risked?
How large is the position?
How much capital is being used?
How far is the stop?
What does each target represent in both price and R terms?
KEY INPUTS
Trade Setup
• Trade Direction
• Target Mode
• Entry Price
• Stop Price
• R-based targets
• Manual targets
Risk Model
• Account Size
• Risk Per Trade (%)
• Estimated Fees (%)
• Quantity Step
Visual Settings
• Panel visibility
• Panel position
• Panel theme
• Panel text size
• Level label size
• Label offset
• Risk/reward zone visibility
• Zone transparency
• Individual target visibility
These inputs are separated by function so the planning workflow stays readable and predictable.
VALIDATION AND SAFETY LOGIC
The script validates several conditions before presenting a plan as valid.
For direction:
• Long plans require stop below entry
• Short plans require stop above entry
For base structure:
• Entry must be positive
• Stop must be positive
• Account size must be positive
• Risk percentage must be positive
• Quantity step must be positive
• Entry and stop must not be identical
For manual targets:
• Targets must be in the correct direction relative to entry
• Targets must be logically ordered for the selected direction
If the structure is invalid, the panel reflects that status instead of presenting the setup as a clean plan. This behavior is intentional. The script is designed to help organize decisions, but also to prevent simple construction errors from being overlooked.
WHO THIS SCRIPT IS FOR
This script is intended for users who already make their own directional decisions and want a cleaner way to structure position plans on the chart.
It may be useful for:
• discretionary traders
• swing traders
• intraday traders
• users who plan entries and stops manually
• users who prefer fixed-R target mapping
• users who want manual targets translated into risk terms
• users who want better visual discipline before execution
It is less relevant for users who are looking for:
• automated entries
• hidden directional logic
• predictive signals
• scanner behavior
• portfolio automation
• strategy backtests
SIGNALS AND ALERTS
This script does not generate buy signals or sell signals.
This script does not publish automated trade calls.
This script does not attempt to identify market direction.
This script does not include alert logic for execution decisions.
Its purpose is planning, visualization, and risk organization.
LIMITATIONS AND TRANSPARENCY
This script is a planning tool, not an execution engine.
It does not know whether the selected entry will be filled.
It does not know whether slippage will occur.
It does not know whether the market will reach the defined targets.
It does not account for instrument-specific margin rules, liquidation mechanics, funding costs, or exchange-specific order behavior unless the user adjusts inputs manually.
The sizing output is an estimate based on the values entered into the script. Real-world execution may differ due to slippage, fees, order type, spread, partial fills, and instrument-specific trading conditions.
In Manual mode, the script evaluates the price structure entered by the user, but it does not claim that those targets are likely to be reached. It only expresses them relative to the initial risk distance.
The chart zones are visual planning aids. They are not probability forecasts and should not be interpreted as predictive boundaries.
WHAT THIS SCRIPT IS NOT
This script is not:
• a strategy tester
• a signal service
• an automated trade system
• a forecasting model
• a promise of profitability
• a replacement for independent analysis
• a substitute for execution judgment
• a guarantee of risk control in live market conditions
It is a structured chart tool for planning and reviewing position scenarios.
RISK DISCLOSURE
Trading and investing involve risk. Any planned setup can fail, and losses can exceed expectations due to slippage, volatility, or execution conditions. This script is provided as an organizational and visualization tool only. Users remain fully responsible for their own analysis, trade selection, order placement, and risk management decisions.
No indicator can remove market risk. A visually clean plan is still only a plan. Position sizing, stop placement, and target mapping should always be reviewed in the context of the instrument, timeframe, liquidity conditions, and the user’s own trading process.
FINAL NOTE
AG Pro Position Planner is built around a simple idea: a trade plan should be measurable before it is actionable. By turning entry, stop, risk budget, sizing, and targets into a single visible structure, the script aims to make discretionary planning more disciplined, more transparent, and easier to review.
The script does not attempt to decide for the user. It helps the user define the plan clearly enough to evaluate it. Indicator
Adaptive Ichimoku Nexus [WillyAlgoTrader]☁️ Adaptive Ichimoku Nexus — a modern approach to the legendary all-time indicator Ichimoku Kinko Hyo. This overlay indicator replaces the fixed periods of the classic Ichimoku system with a volatility-adaptive engine that dynamically scales Tenkan-Sen, Kijun-Sen, and Senkou Span B lookback periods based on current market conditions. Every TK cross signal is scored by an 8-factor confluence engine (0–100) that combines all five Ichimoku dimensions with volume, momentum pulse, and momentum acceleration. The indicator also includes a dedicated Kumo breakout engine with retest detection, three Ichimoku-anchored SL modes with R:R-based TP levels, and a multi-timeframe Ichimoku alignment panel — creating a complete trading system built entirely on Ichimoku principles enhanced with adaptive intelligence.
Ichimoku Kinko Hyo was designed in the 1930s with fixed periods (9/26/52) calibrated for the Japanese trading week. These periods remain the default worldwide, but modern markets are faster, more volatile, and trade 24/7. A fixed 26-period Kijun-Sen responds identically whether the market is in a tight range or a momentum breakout — producing late signals in trends and whipsaws in consolidation.
This indicator preserves the complete Ichimoku structure — all five lines, the cloud, and the displacement — while making the periods responsive to current volatility. In high-volatility environments, all three Donchian-based periods shorten → the Tenkan reacts faster, the Kijun adapts sooner, the cloud thins and pivots quicker. In low-volatility consolidation, the periods lengthen → noise is filtered, fewer false TK crosses, thicker cloud provides stronger S/R. The entire Ichimoku system breathes with the market.
🧩 WHY THESE COMPONENTS WORK TOGETHER
Classic Ichimoku already integrates five components into one system: Tenkan-Sen (momentum), Kijun-Sen (trend), Senkou Span A/B (future S/R), and Chikou Span (lagging confirmation). The genius of Ichimoku is that these five dimensions are designed to confirm each other — a "5/5 alignment" is one of the strongest signals in technical analysis.
This indicator enhances the system at three levels:
Level 1 — Adaptive periods: The volatility engine scales all three Donchian-based components (Tenkan, Kijun, Span B) proportionally, preserving the Ichimoku ratios while adapting the speed. This means the relationship between Tenkan and Kijun (the core signal mechanism) stays consistent — they just both become faster or slower together.
Level 2 — Confluence scoring: Instead of manually checking "Is Tenkan above Kijun? Is price above cloud? Is Chikou confirming?" — the 8-factor engine quantifies every Ichimoku dimension plus volume and momentum into a single 0–100 score. A score of 85 means virtually every Ichimoku component plus momentum and volume agrees. A score of 35 means the signal is conflicted — skip it.
Level 3 — Structural TP/SL: The Kumo edge and Kijun-Sen are natural Ichimoku support/resistance levels. Using them as stop-loss anchors (instead of arbitrary ATR multiples) produces structurally meaningful stops that respect the same framework generating the signals.
Level 4 — Momentum Pulse: Classic Ichimoku has no built-in momentum acceleration measure. The Momentum Pulse engine quantifies how fast the TK spread is changing and which direction the future cloud is rotating — capturing the urgency behind each signal.
Without adaptive periods, the system is rigid. Without scoring, you must manually assess 5+ factors. Without structural SL, your risk management ignores Ichimoku's own S/R levels. Without the Momentum Pulse, you can't distinguish between a strong and a fading TK cross. Each layer adds a dimension that classic Ichimoku lacks.
🔍 WHAT MAKES IT ORIGINAL
1️⃣ Volatility-adaptive Ichimoku periods.
When Adaptive mode is on, each Donchian midline (Tenkan, Kijun, Span B) uses a volatility-scaled period:
adaptedPeriod = basePeriod × (1 + strength × (1 − 2 × volRatio))
Where volRatio = (currentATR − lowestATR) / (highestATR − lowestATR) over the volatility lookback (default 50 bars), normalized to 0–1.
When volRatio → 1 (high volatility): adaptedPeriod = basePeriod × (1 − strength) — periods shorten
When volRatio → 0 (low volatility): adaptedPeriod = basePeriod × (1 + strength) — periods lengthen
The Adapt Strength parameter (default 0.4 = ±40%) controls the range of scaling. With basePeriod=26 and strength=0.4: periods range from 16 (high vol) to 36 (low vol). Each adapted period is clamped to a valid range and fed into the standard Donchian midline formula: (highest(high, period) + lowest(low, period)) / 2.
This means all five Ichimoku lines (Tenkan, Kijun, Senkou A, Senkou B, Chikou) adapt proportionally — the system remains internally consistent. In Classic mode, the standard fixed periods are used unchanged.
2️⃣ 8-factor confluence scoring engine (0–100).
Every bar computes both a bullish and bearish score from 8 factors:
— 📐 Price vs Cloud (20 pts) : above cloud = 20, inside = 8, below = 0 (bull). Symmetric for bear. The cloud is the strongest S/R in Ichimoku.
— ⚡ TK alignment (15 pts) : Tenkan > Kijun = 15 (bull). The core Ichimoku momentum signal.
— 👁️ Chikou confirmation (15 pts) : Chikou Span above price at displaced position = 15 (bull). The lagging confirmation.
— ☁️ Cloud direction (10 pts) : Span A slope > Span B slope = 10 (bull). Future cloud turning bullish indicates trend momentum.
— 📏 Kumo thickness (8 pts) : thick cloud = 8, thin cloud = 2. Thick cloud provides stronger S/R backing.
— 📈 Volume (10 pts) : volume > SMA(20) × 1.2 = 10. Confirms institutional participation.
— 💪 Momentum alignment (12 pts) : Momentum Pulse > 20 = 12, > 0 = 6. Strong momentum behind the signal.
— 🚀 Momentum acceleration (10 pts) : Momentum Pulse rising = 10. Trend is accelerating, not fading.
Max score = 100. Signals require score ≥ Min Confluence Score (default 50). Grades: Strong (≥ 80), Standard (≥ 50), Weak (< 50).
3️⃣ Momentum Pulse engine (−100 to +100).
A composite momentum measure built from three Ichimoku-derived components:
— TK spread normalized by ATR (weight 40): tkSpreadNorm = (Tenkan − Kijun) / ATR. Measures how far apart the momentum and trend lines are relative to volatility.
— TK spread acceleration (weight 100): tkSpreadNorm − tkSpreadNorm . Measures how fast the spread is changing — captures momentum buildup.
— Cloud slope differential (weight 30): (ΔSpanA − ΔSpanB) / ATR over 5 bars. Measures whether the future cloud is rotating bullish or bearish.
Combined: momentumPulse = tkSpread×40 + tkAcceleration×100 + cloudSlope×30, clamped to , smoothed with EMA(5). States: Accelerating (rising + positive), Bull Fading (falling + positive), Bear Accelerating (falling + negative), Bear Fading (rising + negative).
4️⃣ Three Ichimoku-anchored SL modes.
Stop-loss placement uses Ichimoku structure:
— Kumo Edge (default): SL at the nearest cloud boundary (kumoBot for longs, kumoTop for shorts) + ATR buffer. The cloud is Ichimoku's primary S/R — placing the stop here means your stop is at the strongest structural level in the framework.
— Kijun : SL at the Kijun-Sen ± ATR buffer. The Kijun is Ichimoku's equilibrium line — price tends to return to it.
— ATR : SL at entry ± 2× ATR. Pure volatility-based fallback.
TP1/TP2/TP3 are R:R multiples of the risk distance (default 1.5/2.5/4.0). A minimum risk distance of 0.5× ATR is enforced.
5️⃣ Kumo breakout engine with retest detection.
Detects when price closes above the cloud (was below or inside on the previous bar) with volume confirmation:
— kumoBreakUp: close > kumoTop AND previous close ≤ kumoTop AND volume > SMA(20) × breakoutMultiplier
— kumoBreakDown: close < kumoBot AND previous close ≥ kumoBot AND same volume condition
After a breakout, a retest signal fires if within 10 bars, price touches the cloud edge and closes back on the breakout side — confirming the cloud has flipped from resistance to support (or vice versa). Retest signals appear as small circles distinct from the larger diamond breakout markers.
6️⃣ Kijun-Sen S/R zone detection.
When the Kijun-Sen has been flat for 4+ consecutive bars and then starts moving, the flat level is marked as a support/resistance zone (shaded box ± 0.15× ATR). Flat Kijun is a well-known Ichimoku S/R concept — price tends to be attracted to flat Kijun levels. The indicator automates this detection and visualization.
7️⃣ Multi-timeframe Ichimoku alignment panel.
Three configurable timeframes (default 15M/1H/4H) each compute a full Ichimoku state using the classic periods:
— Bull ● : close > cloud AND Tenkan > Kijun
— Bear ● : close < cloud AND Tenkan < Kijun
— Neutral ○ : anything else
The panel shows per-TF alignment plus a summary: ALL BULL ✓ (all 3 TFs bullish), ALL BEAR ✓ (all 3 bearish), or Mixed. All MTF data uses + lookahead_on for non-repainting.
⚙️ HOW IT WORKS — CALCULATION FLOW
Step 1 — Volatility measurement: ATR(14) is normalized to 0–1 by its position within the recent high-low range over the volatility lookback.
Step 2 — Period adaptation: Each base period (9/26/52) is scaled by the adapt strength and vol ratio. High vol → shorter periods, low vol → longer. Classic mode bypasses this.
Step 3 — Ichimoku calculation: Tenkan = Donchian midline (adapted period). Kijun = Donchian midline (adapted period). Senkou A = avg(Tenkan, Kijun). Senkou B = Donchian midline (adapted period). Chikou = source price. Cloud displaced forward by displacement bars.
Step 4 — Kumo at current bar: Span A and Span B are read at displacement offset to get the current cloud boundaries. Thickness, price position (above/below/inside), and thin-cloud status are computed.
Step 5 — Momentum Pulse: TK spread, spread acceleration (vs 3 bars ago), and cloud slope differential — combined and EMA-smoothed.
Step 6 — Confluence scoring: 8 factors evaluated. Bull and bear scores computed independently.
Step 7 — Signals: TK cross + score threshold + enabled filters (Kumo thickness, volume, Chikou) → confirmed buy/sell. Kumo breakout: cloud boundary cross + volume surge → breakout signal. Retest: cloud edge touch within 10 bars of breakout.
Step 8 — TP/SL: SL from Kumo edge / Kijun / ATR mode. TPs as R:R multiples. TP/SL hits tracked per trade.
📖 HOW TO USE
🎯 Quick start:
1. Add the indicator — the Ichimoku cloud and lines appear (adaptive by default)
2. "Long 78%" / "Short 65%" labels = TK cross signals with confluence score
3. ☁▲ / ☁▼ diamonds = Kumo breakout signals
4. Entry, SL, TP1–TP3 lines appear on each signal
5. Check the MTF panel for multi-timeframe alignment
👁️ Reading the chart:
— 🔵 Blue line = Tenkan-Sen (conversion, fast)
— 🔴 Pink line = Kijun-Sen (base, slow)
— 🟠 Orange line (displaced back) = Chikou Span
— 🟩🟥 Cloud fill = Kumo (green bullish, red bearish)
— 🟢 "Long XX%" label = confirmed bullish TK cross with score
— 🔴 "Short XX%" label = confirmed bearish TK cross with score
— 💎 Cyan diamond = Kumo breakout (☁▲ up / ☁▼ down)
— ⚫ Small circle = Kumo edge retest
— 🟪 Shaded zone = flat Kijun S/R area
— 🔵 Blue line = entry, 🔴 red = SL, 🟢 green = TP1/TP2/TP3
📊 Dashboard fields:
— Mode: Adaptive / Classic
— Trend: Bullish / Bearish / Neutral (price vs cloud + TK alignment)
— Signal: last signal with bars elapsed
— Score: confluence percentage with color grade
— Momentum: Pulse state + value (Accelerating / Bull Fading / Bear Accel / etc.)
— Cloud: price position (Above / Below / Inside / Thin)
— Trade: TP/SL progress (→ TP1, TP1 ✓ → TP2, TP3 ✓ Closed, SL ✗ Closed)
— MTF: 3-timeframe Ichimoku alignment + summary (ALL BULL / ALL BEAR / Mixed)
— Version
🔧 Tuning guide:
— Too many weak signals: increase Min Score (60–80), enable all filters
— Missing signals: decrease Min Score (30–40), disable Chikou filter
— Adaptive too aggressive: decrease Adapt Strength (0.2–0.3) or increase Volatility Lookback (100+)
— Want classic Ichimoku: switch to Classic mode — pure 9/26/52 with scoring and TP/SL
— Stops too tight: increase SL ATR Buffer (0.7–1.0) or switch to ATR SL mode
— Scalping: Conversion 5, Base 13, Span B 26, Displacement 13, Min Score 40
— Swing: Conversion 12, Base 34, Span B 68, Displacement 34, Min Score 65
⚙️ KEY SETTINGS REFERENCE
⚙️ Main:
— Calculation Mode (default Adaptive): Adaptive / Classic
— Conversion/Base/Span B/Displacement (default 9/26/52/26)
🔄 Adaptive Engine:
— Volatility Lookback (default 50): ATR normalization window
— Adapt Strength (default 0.4): period scaling range (±40%)
🔍 Filters:
— Min Confluence Score (default 50): 0–100 threshold
— Kumo Thickness Filter (default On): suppress in thin cloud
— Volume Filter (default On): auto-disabled on forex
— Chikou Confirmation (default On): require lagging span alignment
🎯 Smart TP/SL:
— SL Mode (default Kumo Edge): Kumo Edge / Kijun / ATR
— SL ATR Buffer (default 0.5): padding beyond SL level
— TP1/TP2/TP3 R:R (default 1.5/2.5/4.0)
💥 Kumo Breakout:
— Breakout Vol Mult (default 1.3): volume surge requirement
— Show Retest Signals (default On): cloud edge retest detection
🔄 Multi-Timeframe:
— TF 1/2/3 (default 15/60/240): configurable timeframes
🔔 Alerts
— 🟢 BUY / 🔴 SELL — TK cross with score, SL, TP1–TP3
— ☁️▲ KUMO BREAK UP / ☁️▼ KUMO BREAK DOWN
— 🎯 TP1 HIT / 🛑 SL HIT
All support plain text and JSON webhook format. Bar-close confirmed.
⚠️ IMPORTANT NOTES
— 🚫 No repainting. All TK cross signals and Kumo breakouts require barstate.isconfirmed. MTF data uses + lookahead_on. A warmup period (Span B + displacement, minimum 80 bars) prevents signals during insufficient data.
— ☁️ This preserves the complete Ichimoku structure. All five lines, the cloud, displacement, and Chikou are computed exactly as Ichimoku specifies — the only change is that in Adaptive mode, the three Donchian periods scale with volatility. Switching to Classic mode produces a standard Ichimoku with no modifications.
— 📐 The adaptive engine scales all three periods proportionally using the same vol ratio and strength. The relationship between Tenkan (fast) and Kijun (slow) is preserved — they don't drift independently.
— ⚖️ The confluence score is Ichimoku-native . Six of eight factors (price vs cloud, TK alignment, Chikou, cloud direction, Kumo thickness, momentum) are derived directly from Ichimoku components. Only volume and momentum acceleration are external additions.
— 📊 The Momentum Pulse is not a standalone oscillator — it's derived from TK spread dynamics and cloud rotation, both Ichimoku-native measurements. It quantifies what experienced Ichimoku traders assess visually: "Is this TK cross strong and accelerating, or weak and fading?"
— 🔄 Kumo breakout retest detection uses a 10-bar window after the initial breakout. Retests beyond 10 bars are not tracked.
— 🛠️ This is a signal and analysis tool , not an automated trading bot. It enhances Ichimoku with adaptive periods, scoring, and risk management — trade decisions remain yours.
— 🌐 Works on all markets and timeframes. Volume filter auto-disables on instruments without volume data. Indicator
