Breakout Follow-Through Planner [AGPro Series]Breakout Follow-Through Planner
🧠 Core Idea
Did the breakout receive enough follow-through to stay valid?
📌 Overview / What it does
Breakout Follow-Through Planner is a chart-first breakout planning tool designed to evaluate what happens after price clears a recent structure edge.
Instead of treating the breakout candle as the full story, the script maps the broken level, creates a follow-through corridor, tracks post-break travel, measures close progress, monitors retest-depth risk, and converts the full sequence into a 0-100 Follow-Through Score.
The script produces a breakout line, follow-through corridor, weak-continuation labels, failure rail, target-room guide, alerts, and a clean AGPro decision panel. It does not predict price, automate trades, or issue entry/exit commands.
🎯 Purpose & Design Philosophy
This script was built for traders who already understand that a breakout is only the first event.
The practical question comes after the break: does price travel away from the level, hold enough distance, and preserve clean room, or does it stall and begin to retest too deeply? This planner turns that post-break phase into a readable decision process.
The design supports a planning mindset: identify the breakout, review follow-through quality, respect the failure rail, measure target room, and decide whether the active context still deserves attention.
⚡ Why This Script Is Different
Most breakout tools focus on the moment price crosses a level.
This script does NOT clone Breakout Volume Quality, Breakout Retest Readiness, Acceptance Breakout Planner, Volume Expansion Breakout Planner, or a generic support/resistance breakout scanner.
Instead, it focuses on post-break travel quality. The key question is not simply "did price break?" or "was volume high?" or "did the retest hold?" The key question is whether the breakout received enough follow-through after the break to remain structurally valid.
⚙️ Methodology
1. Context Detection
The script builds recent upper and lower breakout references from a configurable prior structure window.
2. Reference Mapping
When price closes beyond a reference edge by an ATR-normalized buffer, the planner starts an active breakout follow-through plan.
3. Reaction Evaluation
The model evaluates break candle quality, volume support, follow-through travel, number of closes beyond the breakout close, retest-depth risk, target room, and failure rail behavior.
4. Visual Output
The chart shows the breakout line, active follow-through corridor, failure rail, target-room guide, compact labels, and an AGPro panel summarizing the current decision state.
🗺️ How to Read the Chart
Follow-Through Corridor = the active path from the breakout close toward the target-room guide. Its text is centered inside the corridor.
Breakout Line = the structure edge that was cleared and now anchors the active plan.
Failure Rail = the invalidation reference behind the breakout line. It is an analytical guide, not a stop order.
Target Room = the projected planning guide based on the prior structure height.
Labels = compact markers such as BFT UP, BFT DN, FT READY, WEAK FT, RETEST RISK, FAIL RAIL, ROOM HIT, and TRACK.
Colors = teal supports constructive bullish follow-through, pink supports bearish follow-through, amber marks caution, indigo marks target-room review, and red marks failure rail pressure.
Panel = the main decision interface showing Breakout Side, Follow-Through, Retest Risk, Target Room, and Action.
🚦 Signals & States
• BFT UP → a bullish breakout started a follow-through review.
• BFT DN → a bearish breakout started a follow-through review.
• FT WATCH → follow-through evidence is developing but not complete.
• FT READY → travel, closes, score quality, and retest-depth conditions are constructive.
• WEAK FT → the follow-through window aged without enough progress.
• RETEST RISK → price moved too deeply back toward or through the breakout line.
• FAIL RAIL → price closed through the failure rail after the breakout plan.
• ROOM HIT → price reached the target-room guide and context should be reviewed.
🔔 Alerts Logic
Alerts can trigger when a bullish or bearish breakout plan starts, follow-through reaches the ready state, weak follow-through or retest risk appears, the failure rail is hit, or target-room review is reached.
These alerts are attention markers for chart review. They are not trade instructions, automated strategy rules, or guaranteed outcomes.
🧩 Confluence Logic
The strongest follow-through context usually appears when the breakout candle is clean, price travels away from the breakout close, multiple closes hold beyond the breakout close, retest depth remains controlled, volume support is present, and target room is still readable.
When these conditions weaken, the planner can shift toward FT WATCH, WEAK FT, RETEST RISK, FAILED, or TARGET REVIEW.
📊 When to Use
• Breakout continuation review
• Range exits where post-break travel matters
• Trend continuation attempts after structure breaks
• Breakouts that need a clear failure rail and target-room reference
• Chart review workflows where the trader wants a decision state instead of another raw breakout marker
⚠️ When NOT to Use
• Low-liquidity markets with unreliable candles or volume
• Extremely noisy ranges where every breakout immediately snaps back inside
• Abnormal news spikes where ATR and structure references may distort quickly
• Situations where the user needs full trade management, position sizing, or automation
🎛️ Key Inputs
• Structure Lookback → controls the recent high/low reference used for breakout detection.
• Break Buffer ATR → defines how far price must close beyond the reference edge.
• Minimum Break Quality → filters weaker breakout candles before the planner starts.
• Follow-Through Window → controls the early review period after the breakout.
• Required Travel ATR → defines the preferred post-break travel distance.
• Maximum Clean Retest Depth ATR → controls when retest depth becomes risk.
• Failure Rail ATR → sets the analytical invalidation rail behind the breakout line.
• Target Room Range Multiple → projects the target-room guide from prior structure height.
• Visual and Panel Settings → control corridor visibility, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The follow-through corridor carries the main story, while the breakout line, failure rail, and target guide create a clean level-risk-room hierarchy. Labels are compact and controlled by cooldown and maximum-visible settings so the chart remains active without becoming crowded.
The AGPro panel uses a merged blue title row and a compact decision layout for fast review.
🧪 Practical Usage Workflow
1. Read the panel to identify the current breakout side and follow-through state.
2. Check the breakout line and follow-through corridor.
3. Review whether price is traveling away, stalling, retesting too deeply, or reaching target room.
4. Use the failure rail as a structural review reference.
5. Treat the Action row as a planning prompt, not as an instruction.
🔍 Interpretation Guidelines
The Follow-Through Score should be read as context quality, not certainty.
A higher score means the breakout has cleaner post-break travel under the script's rules. A lower score means the breakout may be stalling, losing distance, retesting too deeply, or lacking enough supporting evidence.
The target-room guide does not forecast price. It gives a structured reference for whether the current path still has room to review.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an auto-trading system.
This script does not provide guaranteed signals.
This script is not a generic support/resistance map.
This script is not a Breakout Volume Quality clone.
This script is not a Breakout Retest Readiness clone.
⚠️ Limitations & Transparency
The script is rule-based and depends on the selected lookback, ATR length, timeframe, and symbol behavior.
Different markets can produce different breakout behavior. Lower timeframes may show more noise. Higher timeframes may produce fewer but cleaner events.
Volatility changes can affect corridor size, failure rail distance, target-room projection, and event frequency. Outputs should be interpreted within broader market context.
🧠 Market Context Notes
Breakout follow-through is usually most useful when structure is readable, liquidity is sufficient, and the market has enough room to travel after the break.
Volume can support the score, but the script is not built around volume alone. The central decision layer is post-break price travel and structural validity.
🧾 Use Case Examples
When price breaks above recent structure and immediately travels away with multiple closes beyond the breakout close, the planner can move from FT WATCH toward FT READY.
When price breaks but returns deeply through the breakout line before enough travel appears, the planner can mark RETEST RISK or FAIL RAIL.
When price reaches the projected target-room guide, the planner shifts to ROOM HIT so the context can be reviewed instead of blindly extended.
🧱 System Philosophy
The script is built around the AGPro decision-engine approach: structure first, quality score second, risk and target context always visible, and no promise-based signals.
🔐 Non-Promise Statement
No script can provide certainty.
No output should be treated as a guarantee.
The tool organizes breakout follow-through context so users can review price action with more structure.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions.
This script does not provide financial advice.
📚 Educational Note
Use the planner to study how breakouts behave after the first break. The value is in comparing clean follow-through, weak continuation, deep retests, and failure-rail behavior across many examples.
Indicator
CPR Expansion Planner [AGPro Series]CPR Expansion Planner
🧠 Core Idea
Is CPR width and price acceptance setting up a structured expansion day, or is price still inside a weak pivot context?
📌 Overview / What it does
CPR Expansion Planner is a chart-first Central Pivot Range planning tool built to evaluate whether the current session is developing enough structure for an expansion-day read.
The script studies CPR width, the current anchor open, accepted closes beyond CPR, developing range expansion, target room, and the active invalidation shelf. These components are converted into a 0-100 Expansion Score and a clear next-action state.
It produces a CPR band, projected expansion room, target rail, invalidation shelf, state labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate trades, or guarantee continuation.
🎯 Purpose & Design Philosophy
This script was built for traders who already watch CPR but want a more practical planning layer than a static pivot display.
Many CPR tools show the Central Pivot Range and leave the user to decide whether the day is balanced, expanding, failing, or already extended. This script fills that gap by translating CPR context into readiness, room, invalidation, and action language.
The design supports a planning mindset: identify the CPR base, check whether price is accepting beyond it, measure whether expansion has room, and keep the invalidation shelf visible.
⚡ Why This Script Is Different
Most tools focus on plotting CPR lines, daily pivots, or support/resistance reactions.
This script does NOT clone a Pivot Points Reaction Map, does not plot a full pivot ladder, and does not treat every pivot touch as a reaction signal.
Instead, it focuses on one question: is the CPR context preparing an expansion day with enough acceptance, range development, and target room to deserve attention?
⚙️ Methodology
1. Context Detection
The script builds CPR from the selected anchor and reads whether price is working above, below, or inside the CPR structure.
2. Reference Mapping
It maps the CPR band, accepted expansion side, invalidation shelf, projected target rail, and active expansion room.
3. Reaction Evaluation
The model scores CPR width, open location, accepted closes beyond CPR, current range expansion, and target room.
4. Visual Output
The result is shown through CPR zones, state labels, planner rails, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the CPR band shows the active expansion base. The expansion room box shows the distance between the accepted CPR edge and the target rail.
Labels = READY, WATCH, ROOM, SHIFT, FOLLOW, and INVALID labels describe the current planning state.
Colors = green highlights bullish expansion context, pink highlights bearish expansion context, amber highlights room or follow-through review, indigo highlights watch states, and red highlights invalidation risk.
Panel = the panel summarizes CPR Width, Accepted Side, Expansion Score, Invalidation, and Action.
🚦 Signals & States
• READY → CPR acceptance, score, room, and confirmation are aligned.
• WATCH → price is beyond CPR but still needs cleaner confirmation or score improvement.
• ROOM BLOCKED → CPR acceptance exists, but the target rail is too close or already reached.
• EXTENDED → price has moved beyond the planned target room and late-chase risk is elevated.
• INVALID RISK → price has reached the active invalidation shelf.
• SHIFT → the accepted expansion side changed after a previous READY state.
🔔 Alerts Logic
Alerts trigger when the script detects a READY CPR expansion state, accepted side shift, invalidation risk, major follow-through, or blocked target room.
Alerts are attention markers. They are not trade instructions, automated entries, or exit commands.
🧩 Confluence Logic
The strongest context appears when narrow CPR width, a balanced anchor open, accepted closes beyond CPR, range expansion, and clean target room align.
When only one or two components are present, the script usually stays in WATCH, ROOM BLOCKED, or WAIT rather than forcing a strong state.
📊 When to Use
• Intraday markets where Daily CPR is a visible reference.
• Swing contexts where Weekly CPR is more relevant.
• Potential expansion days after narrow CPR conditions.
• Sessions where price begins accepting clearly beyond the CPR band.
• Traders who want risk and target context around CPR instead of only static lines.
⚠️ When NOT to Use
• Very low-liquidity symbols with unreliable volume and wide spreads.
• Extremely noisy sessions where price repeatedly crosses CPR without acceptance.
• News-driven volatility where normal CPR structure can be overwhelmed.
• Markets where the selected CPR anchor is not meaningful for the user's timeframe.
🎛️ Key Inputs
• CPR Anchor → switches between Daily and Weekly CPR.
• Sensitivity → adjusts how quickly the planner recognizes CPR expansion conditions.
• Confirmation Mode → controls whether acceptance requires close confirmation, volume support, or stricter alignment.
• READY Threshold → sets the minimum Expansion Score for READY states.
• Clean Target Room ATR → defines how much space is needed before the target rail is considered clean.
• Event Label Cooldown → controls label density and keeps the chart readable.
• Panel and Label Font Size → controls visual readability.
🖥️ Interface & Visual Design
The interface is chart-first.
The CPR band anchors the setup, the expansion room gives directional context, and the invalidation shelf keeps risk visible. The panel is intentionally compact, with one merged blue AGPro title row and five decision rows.
The goal is a premium PulseWire visual: informative enough to avoid an empty chart, but restrained enough to stay clean.
🧪 Practical Usage Workflow
1. Read the panel and check the Expansion Score.
2. Identify whether price is accepting above or below CPR.
3. Review the expansion room and target rail.
4. Check the invalidation shelf.
5. Interpret READY, WATCH, ROOM, FOLLOW, or INVALID as planning context.
🔍 Interpretation Guidelines
Think in terms of structure, not prediction.
A narrow CPR can create expansion potential, but it still needs acceptance. Acceptance can be useful only if there is enough target room. A strong score with limited room may be less attractive than a moderate score with cleaner structure.
The script helps organize the CPR read; it does not replace broader market context.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not an auto trading system.
• Not a guaranteed signal generator.
• Not a full pivot ladder or generic support/resistance reaction map.
⚠️ Limitations & Transparency
• CPR behavior can vary across assets and sessions.
• Timeframe selection changes how the CPR anchor should be interpreted.
• High-impact news can distort normal expansion behavior.
• Thin liquidity can create false acceptance beyond CPR.
• The score is rule-based and should be interpreted within broader market context.
🧠 Market Context Notes
CPR can help frame session balance and directional acceptance. A narrow CPR often attracts expansion-day attention, but the useful question is not only whether CPR is narrow. The useful question is whether price accepts away from it with room, structure, and a clear invalidation reference.
🧾 Use Case Examples
When price opens near CPR, accepts above the top of the range, and develops range expansion with clean target room, the script may shift toward READY.
When price moves beyond CPR but immediately reaches the target rail, the script can mark ROOM BLOCKED or EXTENDED.
When price fails back through the opposite CPR edge, the planner can show INVALID RISK.
🧱 System Philosophy
AGPro Series tools are designed to turn visible market structure into practical decision context.
This script follows that philosophy by converting CPR from a passive reference into a structured expansion planner with score, state, risk, and target logic.
🔐 Non-Promise Statement
No guarantees.
No certainty.
No script can remove market risk or replace user responsibility.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and interpretation of market conditions.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the script to study how CPR width, acceptance, range expansion, and target room interact over time. The best value comes from reviewing repeated examples across different symbols, sessions, and timeframes.
Indicator
Stop Run Reversal Planner [AGPro Series]Stop Run Reversal Planner
🧠 Core Idea
Did a stop run create a confirmed reversal context with clear risk, target room, and next-action guidance?
📌 Overview / What it does
Stop Run Reversal Planner is a chart-first stop-run reversal planning tool built to evaluate wick sweeps around recent range extremes.
The script detects when price runs beyond a prior high or low, checks whether price closes back through the swept reference, evaluates confirmation candle quality, scores volume response, measures target room, and converts the context into a 0-100 reversal readiness score.
It produces stop-run wick zones, confirmation labels, reclaim rails, invalidation guides, reversal target bands, alerts, and a clean AGPro planning panel. It does not predict price direction, automate execution, or claim that every stop run must reverse.
🎯 Purpose & Design Philosophy
This script was built for traders who want structure after a fast liquidity run instead of another simple sweep marker.
Stop-run candles can look dramatic, but not every sweep deserves the same attention. Some sweeps reclaim cleanly, confirm with stronger candle behavior, and leave usable target room. Others are only noise, continuation, or incomplete rejection.
The design supports a planning workflow: identify the stop run, wait for confirmation, read the readiness score, check invalidation, review target room, and decide whether the context deserves attention.
⚡ Why This Script Is Different
Most stop-hunt tools focus on mapping sweep zones or marking that liquidity was taken.
This script does NOT try to clone a stop-hunt map, liquidity grab detector, liquidity sweep engine, order block map, or broad SMC dashboard.
Instead, it focuses on the post-stop-run reversal decision. The key question is not only "was a stop run printed?" The key question is "did that stop run turn into a confirmed reversal plan with acceptable reclaim quality, invalidation logic, and target room?"
⚙️ Methodology
1. Context Detection
The script tracks recent range highs and lows, then checks whether price runs beyond one side with a meaningful wick sweep.
2. Reference Mapping
The swept reference becomes the reclaim rail. The sweep extreme becomes the invalidation guide. The opposite side of the reference range, or an ATR fallback, becomes the target-room guide.
3. Reaction Evaluation
The scoring model evaluates wick sweep quality, close-back-inside behavior, confirmation candle quality, relative volume response, trend-turn context, and available target room.
4. Visual Output
Qualified contexts are displayed through stop-run wick zones, confirmation labels, reclaim rails, invalidation lines, target bands, alerts, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = the stop-run wick zone between the swept reference and the sweep extreme.
Labels = stop-run watch, confirmed reversal, invalidation, and target-band review markers.
Colors = teal highlights bullish reversal contexts, pink highlights bearish reversal contexts, amber marks watch states, and indigo marks target-room areas.
Panel = the panel summarizes Stop Run, Confirmation, Reclaim Quality, Invalidation, and Action.
🚦 Signals & States
• Bull Stop Run Watch → price swept below the recent low and may need confirmation.
• Bear Stop Run Watch → price swept above the recent high and may need confirmation.
• Bull Reversal Confirmed → downside stop run reclaimed with enough confirmation quality and target room.
• Bear Reversal Confirmed → upside stop run rejected with enough confirmation quality and target room.
• Reversal Invalidated → price crossed the active invalidation guide.
• Target Band Review → price reached the active reversal target band.
🔔 Alerts Logic
Alerts trigger when a bull or bear stop-run watch appears, when a bull or bear reversal confirmation becomes active, when invalidation is crossed, or when the target band is reached.
Alerts are attention markers. They are not trade instructions, entry signals, exit signals, or automation commands.
🧩 Confluence Logic
The reversal context becomes stronger when multiple factors align:
Stop-run wick + close back inside + strong confirmation candle + supportive volume response + usable target room + cleaner trend-turn behavior.
When only one or two factors appear, the script keeps the context in watch mode or ignores it completely.
📊 When to Use
• After fast wick sweeps beyond recent highs or lows
• Around failed breakout or failed breakdown attempts
• In range-edge reversal review workflows
• When price reclaims a swept level and needs structured confirmation
• When a trader wants risk, target, and action context instead of only a sweep marker
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy micro-timeframes
• News candles with abnormal gaps
• Strong one-way trend conditions where stop runs may continue rather than reverse
• Situations where the user wants an automatic buy or sell signal
🎛️ Key Inputs
• Stop-Run Reference Lookback → controls the recent high / low range used for sweep detection.
• Sensitivity → changes how selective wick-sweep detection should be.
• Confirmation Mode → controls how strict the post-sweep confirmation candle must be.
• Minimum Reversal Score → sets the 0-100 score required before a confirmed plan is drawn.
• Confirmation Window Bars → defines how long a stop run can wait for confirmation.
• Target Room ATR Fallback → creates a practical target guide when the opposite range side is not useful.
• Invalidation Buffer ATR → places the invalidation guide beyond the sweep extreme.
• Visual settings → control zones, rails, target bands, labels, panel location, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built to stay chart-first.
The panel gives the decision summary. The stop-run zone shows where the sweep happened. The reclaim rail shows the level price had to recover. The invalidation line marks the level that would weaken the reversal context. The target band gives a structured review area without making a promise.
The layout is intentionally compact, readable, and publication-friendly.
🧪 Practical Usage Workflow
1. Read the panel to identify the current Stop Run and Confirmation state.
2. Check whether the chart shows a stop-run wick zone and reclaim rail.
3. Review the Reclaim Quality score and confirmation label.
4. Compare the current price with invalidation and target-band guides.
5. Interpret the context with broader market structure, liquidity, and volatility conditions.
🔍 Interpretation Guidelines
A stop-run watch means price has swept a recent edge, but the reversal plan is not yet confirmed.
A confirmed reversal state means the script found stronger reclaim, candle, volume, and target-room conditions.
An invalidation marker means the active context weakened according to the script rules.
A target-band review marker means price reached a planned review area, not that the move must stop there.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto trading system
• Not a guaranteed signal tool
• Not a stop-hunt zone map
• Not a liquidity grab detector
• Not an order block or FVG map
• Not a generic SMC dashboard
⚠️ Limitations & Transparency
Stop-run behavior changes across symbols, sessions, and timeframes.
Some stop runs continue instead of reversing. Some reclaim attempts fail after confirmation. Some symbols have weak or unreliable volume data, which can affect the score model.
The script provides structured context, not certainty.
🧠 Market Context Notes
Stop-run reversal behavior often appears near visible range edges, prior swing highs, prior swing lows, and failed breakout areas.
The strongest contexts usually combine a meaningful sweep, clean reclaim, strong confirmation candle, usable room, and a clear invalidation guide.
🧾 Use Case Examples
When price runs below a recent low, leaves a strong lower wick, closes back above the swept reference, and confirms with stronger follow-through, the script may classify the context as a bullish stop-run reversal plan.
When price runs above a recent high, rejects the move, closes back below the swept reference, and confirms with stronger downside behavior, the script may classify the context as a bearish stop-run reversal plan.
🧱 System Philosophy
Stop Run Reversal Planner follows the AGPro decision-engine approach: the goal is not to add another signal to the chart, but to organize the decision around validity, score, risk, target room, and next action.
🔐 Non-Promise Statement
No script can guarantee a reversal, outcome, or market reaction.
This script provides rule-based analytical context only.
📉 Risk Disclosure
Trading involves risk.
Users remain responsible for their own decisions, execution, risk management, and interpretation.
This script does not provide financial advice.
📚 Educational Note
Use the output as a structured review layer. The best readings usually come from combining the planner state with broader market structure, timeframe context, liquidity conditions, and personal risk rules.
Indicator
3AK On Balance Turnover [OBT]📊 3AK On Balance Turnover (OBT)
3AK OBT (On Balance Turnover) is a price-action + participation indicator designed to help swing traders understand the strength behind a move , not just the move itself.
While traditional indicators like On Balance Volume focus on volume, this indicator goes one step further by tracking turnover (Volume × Price) — giving a clearer picture of money flow into and out of a stock.
🔍 What does this indicator show?
The indicator plots a cumulative turnover line (OBT) that rises or falls based on price movement:
When price moves up → turnover is added
When price moves down → turnover is subtracted
This creates a running total of buying vs selling pressure — helping you see whether real money is supporting the trend .
💡 How to interpret OBT (Key Insights)
1. Strength during pullbacks
One of the most powerful uses of OBT is during pullbacks.
If price pulls back but OBT stays near highs, it suggests:
The selling pressure is weak
The overall trend is still strong
The pullback may be temporary (market-driven, not stock weakness)
👉 This helps traders avoid exiting strong stocks too early due to minor corrections.
2. Breakout readiness using Smoothening Curve
You can optionally enable a smoothening curve (Moving Average of OBT).
When OBT is far above the curve → it may be extended
When OBT and curve are close together → compression phase
👉 Breakouts tend to have a higher probability when OBT and its curve are close, as it indicates buildup before expansion.
3. Early breakout signals (OBT leads Price)
Markers help identify important signals:
🟪 New OBT High before Price High
OBT makes a new high, but price hasn’t yet
Indicates accumulation happening quietly
👉 Often signals that a price breakout may be near
🟨 New OBT High + Price High
Both OBT and price make new highs together
👉 Confirms strong momentum and participation
(Both markers can be turned ON/OFF from settings based on your preference.)
🎯 Why use On Balance Turnover instead of Volume?
Volume alone doesn’t always reflect true participation.
OBT improves this by incorporating price:
High volume at low price ≠ High volume at high price
OBT captures actual traded value, making it more meaningful
⚙️ Customization
Choose different smoothening types: SMA, EMA, WMA, VWMA
Adjust smoothening length
Control visibility of breakout markers
Configure lookback period for “new high” detection (default: 65 bars ~ 3 months)
⚠️ Disclaimer
This indicator is designed for educational and swing trading purposes only.
It does not guarantee profits or successful trades.
Market conditions, news, and broader sentiment can impact price behavior. Always use this indicator alongside your own analysis and risk management. Indicator
Expansion Failure Planner [AGPro Series]Expansion Failure Planner
🧠 Core Idea
Did volatility expansion create real travel, or did it fail back inside the prior structure?
📌 Overview / What it does
Expansion Failure Planner is a public-free PulseWire indicator built to evaluate failed volatility expansion attempts. It detects when price expands beyond a recent range edge, then tracks whether the move produces meaningful travel or quickly loses the edge.
The script produces a failed expansion corridor, expansion-edge guide, risk shelf, return-to-range target guide, compact state labels, alerts, and a clean AG Pro planning panel. It does not predict future price direction or automate trade decisions.
🎯 Purpose & Design Philosophy
This script was built for traders who do not only want to see that volatility expanded. They want to know whether the expansion still has quality, whether failure risk is rising, and what context should be reviewed next.
The design supports a decision-first workflow: identify the expansion attempt, measure failure risk, review target room, and decide whether the context deserves attention.
⚡ Why This Script Is Different
Most volatility tools focus on expansion, squeeze release, or breakout continuation.
This script does NOT act as a generic breakout signal, generic S/R zone, or continuation-only volatility map.
Instead, it focuses on one narrow question: did the expansion fail before producing real travel?
⚙️ Methodology
1. Context Detection
The script defines a prior range and watches for a volatility expansion attempt beyond that range edge.
2. Reference Mapping
It stores the expansion edge, expansion extreme, prior range midpoint, and return-to-range target area.
3. Reaction Evaluation
The planner scores failed travel using ATR expansion, close-back-inside behavior, missing follow-through, volume response, and range re-entry quality.
4. Visual Output
It draws the failed expansion corridor, expansion edge, risk shelf, return target, compact labels, and a premium AG Pro panel.
🗺️ How to Read the Chart
Zones = the failed expansion corridor between the original edge and the expansion extreme.
Labels = expansion attempts, failure-ready states, watch states, hold states, and reset context.
Colors = teal for upside expansion attempts, pink for downside expansion attempts, yellow for watch context, and indigo for edge/hold review.
Panel = the preferred viewing timeframe, current expansion state, 0-100 failure risk, reclaim status, target room, and next action.
🚦 Signals & States
• UP EXP / DN EXP → a volatility expansion attempt has been detected.
• UP FAIL / DN FAIL → the expansion failed back inside the prior structure with enough score.
• WATCH → failure risk is developing but confirmation is incomplete.
• HOLD → expansion is still holding beyond the edge.
• RESET / NO FAIL → the active failure window expired or real travel invalidated the failure context.
🔔 Alerts Logic
Alerts trigger when expansion failure reaches ready status, when watch context develops, when expansion holds beyond the edge, or when the failure window resets.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The strongest context appears when ATR expansion, edge loss, missing follow-through, range re-entry, and participation align. When these components agree, the failure risk score increases.
📊 When to Use
• After volatility expansion attempts
• Around range-edge probes
• During breakout failure review
• When a move expands but does not travel
• When price quickly returns inside prior structure
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro ranges
• News-driven candles with abnormal gaps
• Markets where volume data is unreliable
• Charts where the prior range is not structurally meaningful
🎛️ Key Inputs
• Sensitivity → changes how strict the failure model is.
• Prior Range Lookback → defines the structure used for expansion reference.
• Expansion Bar ATR → controls how large a candle must be to qualify.
• Required Real Travel ATR → defines how much progress the expansion should produce.
• Confirmation Mode → controls close/volume/strict confirmation.
• Visual Settings → control corridor, guides, labels, projection, and label size.
• Panel Settings → control panel visibility, location, theme, font size, and best-viewed timeframe guidance.
🖥️ Interface & Visual Design
The panel is designed as a compact planning cockpit. The first row uses the AGPro merged blue header standard, while the remaining rows show best-viewed timeframe guidance, state, score, reclaim status, target room, and action.
The visual hierarchy keeps the chart readable: one active corridor, clear guide lines, and controlled labels.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check whether price is above or below the expansion edge.
3. Review the failed expansion corridor.
4. Compare failure risk with target room.
5. Use alerts as attention markers, not decisions.
🔍 Interpretation Guidelines
Think in terms of failed travel, not prediction. A high score means the script detected stronger failure characteristics. A low score means expansion may still be holding, or failure evidence is not strong enough.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a generic breakout indicator
• Not a generic support/resistance zone map
⚠️ Limitations & Transparency
• Timeframe differences can change expansion and failure structure.
• Volatility spikes can distort ATR-based scoring.
• Volume quality varies by market.
• Fast markets can move beyond the corridor before confirmation.
• Outputs should be interpreted within broader market context.
🧠 Market Context Notes
Expansion failure often matters when volatility appears strong but cannot create distance. This script focuses on that transition point between momentum attempt and failed travel.
🧾 Use Case Examples
When price expands above a range, stalls quickly, closes back inside the edge, and fails to build distance, the planner can mark an upside expansion failure.
When price expands below a range, loses downside follow-through, and re-enters the structure, the planner can mark a downside expansion failure.
🧱 System Philosophy
AGPro tools are built to reduce chart ambiguity by turning raw market events into structured decision context.
🔐 Non-Promise Statement
No indicator can provide certainty. This script provides rule-based context only.
📉 Risk Disclosure
Trading involves risk. Users are responsible for their own decisions. This script does not provide financial advice or guaranteed trading outcomes.
📚 Educational Note
Use the script as a structured learning and review tool for expansion failure behavior, failed travel, and volatility response.
Indicator
Channel Breakout [EXCAVO]Automatic Convergent Channel Detection with Multi-Filter Breakout Confirmation
The Channel Breakout automatically detects convergent channel patterns — wedges, flags, and triangles — by fitting trendlines through confirmed swing pivots on both boundaries simultaneously. When price breaks out with volume and momentum confirmation, the indicator signals the direction with colored channel lines and an entry label on the breakout candle.
This is not a basic highest/lowest channel. The boundaries are built from verified pivot points, and a convergence filter ensures only genuinely contracting channels qualify — expanding ranges and sideways boxes are excluded.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ HOW TO USE
Step 1 → Add the indicator. It begins scanning for convergent channel
patterns using swing pivots on the current timeframe.
Step 2 → Wait for a channel to form. The indicator draws the upper and
lower boundary lines in blue while price remains inside.
Step 3 → Watch for the breakout signal. When price closes beyond either
boundary with confirmation, channel lines turn blue (bull) or
red (bear), and an arrow label appears on the breakout candle.
Step 4 → Check the dashboard. It shows the current pattern state,
breakout strength (Strong / Medium / Weak), and the directional
bias score that built up while price was inside the channel.
Step 5 → Read the strength rating. Strong breakouts combine high volume,
deep body penetration, and RSI alignment. Weak breakouts show
fewer confirming factors and may warrant additional analysis.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ HOW IT CALCULATES
◆ Pivot Detection
Swing highs and lows are identified with ta.pivothigh / ta.pivotlow using a
configurable lookback (Pivot Detection Length, default 5 bars each side). Only
confirmed, closed pivots are used — no repainting. All recent pivots within the
Max Channel Width lookback are stored and passed to the trendline fitting engine.
◆ Best-Fit Trendline Algorithm
For the upper boundary, the engine tests every pair of stored pivot highs (a, b).
For each candidate line through (a, b), it counts how many other pivot highs lie
within ATR × Touch Tolerance of the line while no pivot exceeds it by more than
ATR × Max Deviation. The line with the most qualifying touches becomes the upper
boundary. The same process runs independently for pivot lows to find the lower
boundary. Both boundaries must exist with at least Min Touches (default 2) to
form a valid channel.
◆ Convergence Filter
Once both boundaries are found, the engine measures channel width at the earliest
shared bar (widthStart) and at the current bar (widthNow):
convRate = 1 − (widthNow / widthStart)
A channel is only accepted when convRate >= Min Convergence Rate (default 0.02).
This rejects expanding wedges and flat ranges, keeping only contracting patterns.
◆ Breakout Detection and Strength Score
On each confirmed bar close, the engine projects both boundary lines to the current
bar. A bull breakout fires when close > upper boundary; a bear breakout when
close < lower boundary. The breakout strength score blends five components:
penetration depth relative to ATR (25%), candle body ratio (15%), body commitment
relative to the broken boundary (15%), volume vs SMA-20 spike (25%), and RSI
alignment above/below 50 (20%). Score >= 65 = Strong, >= 35 = Medium, < 35 = Weak.
◆ Confirmation Filters
Three optional filters gate the breakout signal. Volume Spike Multiplier requires
the breakout bar's volume to exceed 20-bar SMA by a configurable factor. Volume
Contraction Filter requires that average volume inside the channel was lower than
before the channel formed — confirming energy compression. Momentum Confirmation
requires RSI > 50 for bull breakouts and RSI < 50 for bear breakouts. Any filter
can be disabled for forex or low-volume instruments.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ WHAT MAKES IT DIFFERENT
◆ Pivot-Confirmed Boundaries
Most auto-channel scripts use ta.highest / ta.lowest, which anchors lines to the
highest wick in a window regardless of pattern shape. This indicator builds
boundaries only through confirmed swing pivot points, the same anchor logic a
trader would use when drawing manually.
◆ Convergence-Only Filter
The convRate filter rejects any channel that is not actively narrowing. Sideways
ranges, expanding wedges, and parallel channels are all excluded. Only patterns
where price is compressing toward a decision point qualify.
◆ Best-Fit Touch Counting
The engine evaluates every pair of pivots and selects the line with the highest
touch count, not just the first two pivots it finds. A channel supported by four
touches is stronger than one supported by two, and the algorithm reflects that
by preferring denser confirmation.
◆ Multi-Component Strength Score
The breakout strength is not a simple volume check. It combines five independent
signals — penetration depth, body ratio, body commitment relative to the broken
level, volume spike, and momentum direction — into a single 0-100 score that
classifies the breakout as Strong, Medium, or Weak.
◆ Directional Bias Score
While price is inside the channel, the dashboard tracks a real-time directional
bias built from channel slope (35%), RSI deviation from 50 (35%), and price
position within the channel range (30%). This gives a probabilistic lean on
which side of the channel is more likely to break before the signal fires.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ DASHBOARD
Real-time panel (top right) with key state metrics:
Status - Active (channel forming) / Bull Breakout / Bear Breakout / Scanning
Direction - directional bias with arrow and % while channel is active (e.g. ▲ 64%); BULLISH or BEARISH after breakout
Strength - Strong / Medium / Weak (breakout strength score); — while channel is forming
Convergence - narrowing rate of the active channel in %; — when no channel
Legend table (bottom left) explains every visual element. Toggle in Dashboard settings.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ SETTINGS
Main Settings
Pivot Detection Length - 5 (bars left/right for swing pivot confirmation; lower = more sensitive)
Min Touches per Boundary - 2 (minimum pivot touches required per trendline)
Max Channel Width (bars) - 120 (maximum lookback for channel search)
Min Convergence Rate - 0.02 (minimum narrowing ratio; higher = stricter contraction)
Filters
Volume Spike Mult - 1.2 (breakout bar volume vs SMA-20; set 0.5 to disable on forex)
Volume Contraction Filter - ON (require declining volume inside the channel)
Momentum Confirmation - ON (RSI > 50 for bull, < 50 for bear)
Visual
Show Channel Patterns - ON (draw boundary lines)
Show Pattern Background - OFF (subtle bgcolor while inside active channel)
Channel Lines
Line Width - 2 (boundary line thickness; 1-4)
Risk Management
Show Entry Labels - ON (arrow label on the breakout candle)
Dashboard
Show Dashboard - ON
Position - Top Right (Top Left / Top Right / Bottom Left / Bottom Right)
Font Size - Small (Small / Normal)
Advanced
Touch Tolerance (ATR) - 0.15 (pivot distance to count as a touch; 0.10-0.25)
Max Deviation (ATR) - 0.30 (maximum pivot overshoot from the line)
Min Channel Width (ATR) - 0.5 (minimum channel width filter)
Alerts
JSON Alerts - OFF (structured JSON payload for 3Commas, Wunderbit, and similar bots)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
▸ ALERTS
Bull Breakout - price closes above the upper channel boundary with confirmation
Bear Breakout - price closes below the lower channel boundary with confirmation
Any Breakout - either direction; use for a single alert covering both signals
New Pattern - a new convergent channel has been detected and is now active
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Best regards,
EXCAVO
Disclaimer
Trading involves significant risk. This indicator is a technical analysis tool
and does not constitute financial advice, investment recommendations, or a
guarantee of future results. Past indicator behavior does not guarantee future
performance. Always use proper risk management and your own judgment.
Indicator
AI UltraTrend X Pro V1The AI UltraTrend X Pro V1 is a high-performance, signal-based indicator engineered to identify explosive trend reversals while aggressively filtering out sideways market noise. Built specifically to handle high-volatility environments like BankNifty, this tool excels at capturing large point moves by combining institutional flow tracking with advanced price-action breakouts.
Key Features
Multi-Segment Mastery: While optimized for the fast-paced nature of BankNifty, the logic is universally applicable across Equity, Forex, Commodities, and Crypto.
Optimized for 3m+ Timeframes: Designed for the 3-minute duration and above, providing a perfect balance between early entries and noise reduction.
Hybrid Execution Logic: Unlike standard indicators that rely solely on crossovers, this script uses a dual-trigger system—line crosses and volatility-backed breakouts—ensuring you never miss a gap-up or a sudden trend explosion.
Intraday & Swing Flexibility: Seamlessly transitions between aggressive Intraday scalping and Positional trend following. The indicator maintains its state, allowing users to carry trades or square off at the end of the session based on their own risk profile.
Advanced Anti-Chop Shield: Features a built-in Volume & Volatility filter that identifies "dead zones" (gray signal areas) to prevent the "multiple entries/exits" common in flat markets.
Dynamic Trailing Stop-Loss: Plots a real-time, ATR-based trailing exit (Yellow Line) that locks in profits while giving the trend enough "breathing room" to survive minor pullbacks.
How to Use
Enter CE: Triggered when the signal turns Green and price breaks recent resistance.
Enter PE: Triggered when the signal turns Red and price breaks recent support.
Stay with the Trend: The background remains color-coded (Green/Red) as long as the trend is healthy.
Exit: Close your position when the signal label flips.
Best Settings
Timeframe: 3m, 5m, or 15m.
Chart: Works best on standard Candlesticks or Heikin Ashi for smoother trend following. Indicator
Acceptance Breakout Planner [AGPro Series]Acceptance Breakout Planner
🧠 Core Idea
Did price truly accept beyond the breakout level, or did it only tag the level and fail to hold?
📌 Overview / What it does
Acceptance Breakout Planner is a chart-first breakout decision tool designed to evaluate what happens after price moves beyond a key rolling reference edge.
Instead of treating every breakout as meaningful, the script measures close persistence, time beyond the level, retest-hold behavior, range distance, candle quality, volume support, and failure shelf risk. It converts that evidence into a 0-100 Acceptance Score and a clear next-action state.
The script produces an acceptance band, a failure shelf, a target-room guide, controlled chart labels, alerts, and a clean AGPro planning panel. It does not predict price movement, automate execution, or claim that acceptance will continue.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between a simple breakout marker and a full trade-management system.
Many traders can see when price crosses a level. The harder question is whether price is spending enough time beyond that level to deserve attention, or whether the break is only a low-commitment tag.
The design supports a planner mindset: observe the break, measure acceptance, watch the failure shelf, and review the next state with structure instead of reacting to a single candle.
⚡ Why This Script Is Different
Most breakout tools focus on the moment price crosses a level.
This script does NOT function as a generic breakout signal, volume-spike detector, consolidation breakout box, Donchian channel tool, or broad break-retest scanner.
Instead, it focuses on post-break acceptance quality. The key question is not simply "did price break?" The key question is "did price remain accepted beyond the broken reference long enough to reduce tag-only risk?"
This keeps the script separate from Breakout Volume Quality, Consolidation Breakout Quality, Break-Retest Quality, Price Acceptance Profile, and reference-specific breakout tools in the AGPro catalog.
⚙️ Methodology
1. Context Detection
The script maps rolling upper and lower reference edges from prior bars. These references are used only as breakout acceptance anchors.
2. Reference Mapping
When price closes beyond a reference edge by an ATR-adjusted buffer, the planner starts an active acceptance sequence.
3. Reaction Evaluation
The active sequence is scored through close persistence, time beyond the level, acceptance-band retests, candle quality, relative volume support, and distance from the failure shelf.
4. Visual Output
The chart shows an acceptance band, a failure shelf, a target-room guide, compact state labels, and a panel that summarizes acceptance score, time beyond, break side, failure risk, and action.
🗺️ How to Read the Chart
Acceptance Band = the zone around the broken level where price should hold if acceptance is developing.
Failure Shelf = the invalidation context behind the broken level. A close through this shelf means the breakout acceptance sequence needs review.
Target Room = a projected planning guide based on the prior reference range. It is not a forecast or promised target.
Labels = compact event markers such as BULL BRK, BEAR BRK, WATCH, HOLD, ACCEPT, TAG, RISK, and REJECT.
Colors = teal supports constructive acceptance, pink marks rejection or failure pressure, yellow marks caution, and indigo marks active watch states.
Panel = a compact decision view showing Acceptance Score, Time Beyond, Break Side, Failure Risk, and Action.
🚦 Signals & States
• BULL BRK → price closed beyond the upper reference and started an acceptance review.
• BEAR BRK → price closed beyond the lower reference and started an acceptance review.
• WATCH → acceptance evidence is improving but is not mature yet.
• HOLD → price revisited the acceptance band and held beyond the broken reference.
• ACCEPT → close persistence, score quality, and time beyond the level reached the accepted state.
• TAG → the sequence is active, but close persistence is still weak after the review window.
• RISK → acceptance is not mature and the failure shelf is becoming more relevant.
• REJECT → price closed through the failure shelf after the breakout sequence.
🔔 Alerts Logic
Alerts trigger when a new acceptance break starts, when accepted state appears, when a retest hold is detected, when failure risk rises, or when price rejects through the failure shelf.
Alerts are attention markers. They are not trade instructions, automation commands, or certainty statements.
🧩 Confluence Logic
The strongest acceptance context appears when several conditions align:
• price closes beyond the broken reference more than once
• the acceptance band holds during a retest
• candle structure remains directional
• failure shelf distance remains healthy
• volume support is present without being the only reason for the score
When these elements align, the Acceptance Score rises and the state becomes easier to interpret.
📊 When to Use
• Breakout review after price crosses a visible range edge
• Markets where one-bar breakout tags are common
• Trend continuation attempts that need acceptance confirmation
• Range expansion moves where the trader wants to separate holding behavior from weak level pokes
• Chart review workflows that need a clear post-break next-action state
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable candles
• Very noisy symbols where reference edges are constantly pierced
• News-driven volatility where ATR buffers may become unstable
• Situations where the user expects automatic trade entries
• Markets where volume data is missing and volume support is treated as less useful
🎛️ Key Inputs
• Break Side → controls whether the planner evaluates bullish breaks, bearish breaks, or both.
• Reference Lookback → defines the prior-bar range used to map breakout reference edges.
• Close Beyond Level ATR → controls how far beyond the level price must close before a sequence starts.
• Acceptance Band ATR → controls the retest-hold zone around the broken level.
• Failure Shelf ATR → controls the invalidation context behind the broken level.
• Minimum Beyond Closes → controls how much close persistence is required before acceptance can mature.
• ACCEPTED Threshold → sets the minimum 0-100 score for accepted state.
• Label / Panel Controls → adjust visual density, placement, theme, and font size.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first. The acceptance band and failure shelf show the current structure, while labels mark only meaningful state changes.
The panel uses the AGPro standard: a single blue merged header row, compact rows, clear state colors, adjustable location, adjustable theme, and normal font size by default.
The visual hierarchy is intentionally restrained so the chart looks active without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel to see the current Acceptance Score and action state.
2. Check whether price is holding beyond the broken reference or drifting back into the band.
3. Watch the failure shelf to understand whether the breakout is losing acceptance.
4. Review labels only as context markers, not as standalone decisions.
5. Confirm the broader market context before acting on any chart interpretation.
🔍 Interpretation Guidelines
Think of the script as a post-break acceptance reviewer.
A higher Acceptance Score means the breakout has stronger evidence of persistence according to the script model. A lower score means the move may still be early, weak, or vulnerable to failure.
The most useful reading is the relationship between time beyond the level, retest behavior, and failure shelf distance.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not guaranteed signals
• Not a generic support/resistance map
• Not a consolidation breakout box tool
• Not a pure volume breakout detector
• Not a full break-retest scanner
⚠️ Limitations & Transparency
Breakout acceptance is sensitive to timeframe, volatility, liquidity, and symbol behavior.
The reference edges are rolling and can change as older bars leave the lookback window.
ATR-based buffers can expand or contract during volatile market conditions.
Relative volume may be less useful on symbols with limited or inconsistent volume data.
🧠 Market Context Notes
Acceptance after a breakout is often more useful than the initial break itself.
A level tag shows that price reached a reference. Acceptance shows whether price can keep spending time beyond that reference.
This distinction is the core purpose of the planner.
🧾 Use Case Examples
When price closes above a reference edge and then holds the acceptance band on a later retest, the script may shift from watch context toward stronger acceptance.
When price breaks a reference but quickly returns through the failure shelf, the script marks rejection context instead of treating the break as mature.
When price remains beyond the level but does not build enough persistence, the script can show TAG ONLY or FAILURE RISK.
🧱 System Philosophy
Acceptance Breakout Planner follows the AGPro decision-engine approach:
It does not ask users to react to a raw signal.
It organizes the chart into quality, state, risk, target-room context, and next-action review.
🔐 Non-Promise Statement
No script can remove uncertainty from markets.
No state, score, label, band, shelf, or alert guarantees future price behavior.
📉 Risk Disclosure
Trading involves risk.
This script is for educational and analytical use only.
It does not provide financial advice, investment advice, trade instructions, or guaranteed outcomes.
Users remain responsible for their own decisions, risk management, and market evaluation.
📚 Educational Note
Use the script to study the difference between a breakout tag and breakout acceptance.
The strongest value comes from comparing the planner state with broader structure, volatility, liquidity, and personal execution rules.
Indicator
Reclaim Breakout Planner [AGPro Series]Reclaim Breakout Planner
🧠 Core Idea
Is a recently broken structural level being lost and reclaimed in a way that creates a valid breakout planning area?
📌 Overview / What it does
Reclaim Breakout Planner is a chart-first breakout planning tool built around structural pivot reclaim behavior. It detects when price breaks beyond a confirmed pivot level, temporarily moves back through that broken level, and then closes back on the breakout side with measurable acceptance quality.
The script produces a 0-100 Acceptance Score, an active Reclaim State, an Acceptance Pocket, a Risk Edge, a Target Corridor, controlled chart labels, and a compact AG Pro panel. The goal is to help traders organize reclaim context after a structural breakout attempt.
This script does not predict price direction, automate trades, or mark every pivot as important. It filters for a specific sequence: structural level break -> temporary level loss -> reclaim close -> planning state.
🎯 Purpose & Design Philosophy
Many breakout tools stop after price crosses a level. Many retest tools treat any return to the level as meaningful. This script was built for the narrower question that often matters after a breakout: did price briefly lose the broken level and then reclaim it with enough quality to deserve attention?
It is designed for traders who want a cleaner decision-support layer around breakout acceptance, not another crowded support/resistance map. The mindset is planning first: evaluate validity, score quality, locate risk, estimate target room, and decide whether the context deserves monitoring.
⚡ Why This Script Is Different
Most tools focus on the breakout candle or the retest touch.
This script does NOT clone VWAP Reclaim Quality, Previous Day Sweep & Reclaim, EMA reclaim maps, session VWAP reaction tools, or a simple breakout retest readiness model.
Instead, it focuses on structural pivot reclaim after a level is briefly lost. The reclaim must come from a confirmed pivot break, a temporary move back through the broken level, and a close back on the breakout side. That creates a distinct reclaim-planning workflow rather than a generic level scanner.
⚙️ Methodology
1. Context Detection
The script identifies confirmed pivot highs and pivot lows as structural levels. These levels are not VWAP, previous-day highs/lows, session anchors, order blocks, or fixed support/resistance zones.
2. Breakout Arming
When price closes beyond a pivot level by an ATR-normalized amount, the planner arms a reclaim watch. A bullish watch begins after a close above resistance. A bearish watch begins after a close below support.
3. Reclaim Evaluation
The script waits for price to temporarily lose the broken level and then close back through it. It scores the event using reclaim close distance, retest depth, volume support, trend alignment, and wick rejection.
4. Visual Output
Accepted reclaims create an Acceptance Pocket, Risk Edge, Target Corridor, event labels, sparse context labels, and panel state. The visuals are designed to stay readable without leaving the chart empty.
🗺️ How to Read the Chart
Acceptance Pocket = the reclaimed structural level area where the breakout side is being tested.
Risk Edge = the failed-side reference beyond the pocket. It is a planning boundary, not a trading instruction.
Target Corridor = a projected review area based on the reclaim risk distance and the selected R multiple.
Labels = compact event and context markers such as Bull Reclaim, Bear Reclaim, Retest Watch, and Failed Reclaim. Target Review labels are optional because the target corridor already marks the review area.
Colors = bullish reclaim context uses teal, bearish reclaim context uses pink, caution/watch states use gold or indigo, and risk/failure context uses red.
Panel = shows Reclaim State, Acceptance Score, Risk Edge, Target Room, and Action.
🚦 Signals & States
• Scan Structure → no active reclaim plan exists yet.
• Bull Retest Watch → price broke above a structural pivot and is waiting for a valid reclaim sequence.
• Bear Retest Watch → price broke below a structural pivot and is waiting for a valid reclaim sequence.
• Acceptance Watch → reclaim exists, but the score is not strong enough for the highest planning state.
• Plan Review → reclaim quality is strong enough to monitor as structured planning context.
• Risk Edge Test → price is testing the failed-side boundary.
• Failed Reclaim → the active reclaim plan closed beyond the risk edge.
• Target Review → price reached the projected target corridor area.
🔔 Alerts Logic
Bullish Reclaim Breakout Plan triggers when a bullish structural reclaim is accepted and the score is above the alert threshold.
Bearish Reclaim Breakout Plan triggers when a bearish structural reclaim is accepted and the score is above the alert threshold.
Reclaim Risk Edge Failed triggers when an active reclaim plan closes beyond the risk edge.
Reclaim Target Corridor Reached triggers when price reaches the projected target corridor.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when a confirmed pivot breakout, temporary level loss, reclaim close, supportive volume, trend alignment, and wick rejection appear together. The score compresses those components into one readable 0-100 Acceptance Score.
📊 When to Use
• After structural breakouts where price returns to the broken level
• During trending or transitioning markets where reclaim behavior matters
• When evaluating whether a breakout level is being accepted after a brief failure
• When a trader needs risk edge and target-room context around a reclaim sequence
⚠️ When NOT to Use
• Very low-liquidity symbols with unreliable volume and erratic candles
• Extremely noisy ranges where pivots form too frequently
• News-driven candles where ATR-normalized structure can be distorted
• Markets where price is far from any meaningful structural pivot
🎛️ Key Inputs
• Reclaim Side → selects Auto, Bullish Only, or Bearish Only.
• Pivot Strength → controls how selective structural levels are.
• Minimum Break Close ATR → defines how far beyond the pivot price must close before a reclaim watch is armed.
• Minimum Level Loss ATR → requires price to temporarily move back through the broken level before reclaim evaluation.
• Acceptance Pocket ATR → controls the visual and logical reclaim pocket size.
• Retest Window Bars → controls how long the reclaim watch remains valid.
• Risk Edge Buffer ATR → adjusts the failed-side planning boundary.
• Target Corridor R Multiple → controls the projected target review area.
• Label and Panel Settings → control chart label density, optional target review labels, font size, panel location, and panel theme.
🖥️ Interface & Visual Design
The interface is intentionally compact. The chart carries the main decision layer through acceptance pockets, risk edges, target corridors, and event labels. The panel acts as a quick readout for state, score, risk, target room, and next action.
The first panel row follows the AGPro style with a merged blue title row. Label density is controlled by cooldown and maximum visible label settings so the chart remains premium and readable.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check whether the planner is scanning, watching a retest, or showing an accepted reclaim.
3. Inspect the Acceptance Pocket and Risk Edge.
4. Compare the Acceptance Score with the active state.
5. Use the Target Corridor as a review area, not as a guaranteed objective.
🔍 Interpretation Guidelines
A high score means the reclaim sequence is cleaner under the script's rules. It does not mean the market must continue.
A weak score means the reclaim lacks enough acceptance quality, volume support, trend alignment, or wick rejection.
A failed reclaim means the planning structure has weakened and should be re-evaluated in broader market context.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a VWAP reclaim tool
• Not a previous-day sweep reclaim script
• Not a generic support/resistance map
• Not an order block or FVG scanner
⚠️ Limitations & Transparency
Timeframe selection affects pivot behavior. Lower timeframes may create more reclaim sequences, while higher timeframes may produce fewer but more important structural levels.
Volatility can widen pockets and risk edges. During extreme volatility, reclaim signals can appear later or fail faster.
Volume quality may be less reliable on markets where reported volume is synthetic, incomplete, or inconsistent.
🧠 Market Context Notes
Reclaim behavior often matters when a market tests whether a broken level is becoming accepted. A clean reclaim can show that a breakout area is still being defended. A failed reclaim can show that the attempted breakout lost structure.
The script treats that behavior as planning context, not certainty.
🧾 Use Case Examples
When price closes above a pivot high, dips back below the broken level, then closes back above it with rejection wick and supportive volume, the planner may create a bullish reclaim plan.
When price closes below a pivot low, trades back above the broken level, then closes back below it with rejection behavior, the planner may create a bearish reclaim plan.
🧱 System Philosophy
AGPro tools are designed to help traders organize context, not chase isolated signals. This script follows that principle by turning reclaim behavior into a structured planning workflow with score, state, risk edge, target room, and action text.
🔐 Non-Promise Statement
No script can guarantee continuation, reversal, or future price behavior. Reclaim structure can fail, especially in fast, illiquid, or news-driven markets.
📉 Risk Disclosure
Trading involves risk. This script is for educational and analytical use only. It does not provide financial advice, investment advice, or guaranteed trading outcomes. Users remain responsible for their own decisions.
📚 Educational Note
Use the script to study how reclaimed structural levels behave across symbols, timeframes, and volatility environments. The best use is disciplined observation, comparison, and context building.
Indicator
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
Session Range Expansion Planner [AGPro Series]Session Range Expansion Planner
🧠 Core Idea
Is the session expanding from balance into a valid range extension, or is the break still too weak to trust as context?
📌 Overview / What it does
Session Range Expansion Planner is a 1H-focused intraday execution-readiness tool built around one clear workflow: define the early-session balance, track expansion beyond that range, and score whether the move has enough acceptance, volume support, volatility fit, and target room to deserve attention.
The script produces a session range box, accepted target-room bands, acceptance/rejection context, alerts, and a premium AGPro panel with a 0-100 planner score. The default visual preset is optimized for 1H and lower charts. Higher intraday charts such as 4H are intentionally kept clean by default.
It does not predict the next candle, automate entries, or issue buy/sell commands. It organizes session behavior into a structured decision layer so the user can evaluate the setup within their own plan.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between simple session boxes and generic breakout indicators.
Most tools show where the session range is. Fewer tools explain whether the break from that range is actually being accepted, whether participation supports it, and whether there is usable room beyond the range.
Session Range Expansion Planner supports a planning mindset: define balance first, wait for expansion, check acceptance, evaluate room, then decide whether the context is worth further review.
⚡ Why This Script Is Different
Most session tools focus on marking opens, coloring sessions, or printing a breakout label as soon as price crosses a high or low.
This script does NOT act as a generic session high/low map, generic support/resistance tool, or broad session reaction scanner.
Instead, it treats the first part of the session as a balance structure and asks whether the later expansion has enough quality to become actionable context. The decision layer is built around acceptance bars, volume support, ATR regime, obstacle distance, and target-room quality.
⚙️ Methodology
1. Context Detection
The script reads the selected intraday session and builds an initial balance range from the first user-defined number of bars.
2. Reference Mapping
The session balance high and low become the only active expansion boundaries. The tool does not use PDH, PDL, weekly open, order blocks, FVGs, or generic swing zones.
3. Reaction Evaluation
When price breaks beyond the balance range, the engine measures acceptance closes, volume support, ATR regime quality, break distance, and nearby obstacle room.
4. Visual Output
The script displays a centered session range label, directional expansion labels, target-room band, acceptance/rejection labels, alerts, and a premium panel with score and next-action state.
🗺️ How to Read the Chart
Session Range Box = the early-session balance area.
Expansion Labels = the side where price first expands beyond the balance high or low.
Target-Room Band = the projected room beyond the broken boundary after expansion has been accepted, scaled by session range or ATR.
Acceptance Labels = confirmation that price has sustained closes beyond the range for the configured number of bars.
Rejection Labels = warning that price has failed back through the broken boundary.
Colors:
• Teal = upside expansion context
• Pink = downside expansion context
• Amber = neutral, warning, or rejection context
• Indigo = AGPro visual accent and target-room support
Panel = the decision cockpit showing planner score, session range, expansion side, acceptance, room score, and next action.
🚦 Signals & States
• Range Set → the initial balance window has completed.
• Expansion Up → price expanded above the session balance high.
• Expansion Down → price expanded below the session balance low.
• Accepted → the expansion held beyond the range for the required acceptance bars.
• Rejection Risk → price failed back through the broken boundary.
• Room Check Reached → price reached the projected target-room area.
🔔 Alerts Logic
Alerts trigger when:
• Upside range expansion is detected
• Downside range expansion is detected
• Expansion becomes accepted
• Rejection risk appears after expansion
Alerts are attention markers. They are not trade instructions and should be interpreted together with broader market context.
🧩 Confluence Logic
The strongest context appears when expansion direction, sustained acceptance, volume support, balanced ATR regime, and clean target room align at the same time.
When those conditions stack together, the planner score rises and the panel moves toward a review-ready state.
📊 When to Use
• 1H intraday charts with clear session behavior
• Opening balance or early-session range workflows
• Breakout quality review
• Volatility expansion planning
• Session continuation evaluation
The script is most useful when a trader wants to know whether a session range break is actually being accepted, not just whether a line was crossed.
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy micro timeframes
• Markets with unreliable volume
• Sessions with irregular trading hours
• News-driven candles where range expansion is disorderly
In weak conditions, reduce sensitivity or require stricter acceptance.
🎛️ Key Inputs
• Session Timezone → defines how the selected session is interpreted.
• Expansion Session → sets the active intraday window. The default full-day session is designed to work cleanly on crypto and other 24-hour symbols.
• Visual Timeframe Preset → controls which intraday timeframes show chart objects. The default is 1H and lower because 4H session expansion charts can become too compressed.
• Balance Window Bars → controls how many early-session bars define the range.
• Acceptance Bars → defines how much sustained closing behavior is required.
• Sensitivity → adjusts how fast the script recognizes expansion.
• Confirmation Mode → controls wick, close, or strict acceptance confirmation.
• Minimum Planner Score → sets the score threshold for review-ready context.
• ATR Length → controls volatility normalization and label spacing.
• Obstacle Lookback → estimates nearby structure that may reduce room quality.
• Target Room Multiplier → controls the projected target-room distance.
• Visual Settings → control range boxes, centered range label limit, rails, accepted target-room band, minimum visual score, optional expansion labels, optional room-check labels, optional range-set labels, label size, and object limits.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is chart-first. The range box and target-room band carry the main visual story, while labels explain state transitions only when meaningful events occur.
The panel is intentionally compact. It gives a fast read of expansion quality without forcing the user to decode many separate plots.
The first panel row follows the AGPro standard: a single merged blue header row with only the script name.
🧪 Practical Usage Workflow
1. Apply the script to an intraday chart.
2. Confirm the correct session and timezone.
3. Let the initial balance window complete.
4. Watch for expansion beyond the balance high or low.
5. Check whether acceptance bars confirm sustained behavior.
6. Read the planner score and room score.
7. Use the next-action state as context for your own execution plan.
🔍 Interpretation Guidelines
A clean expansion is not just a break beyond the range. It should show acceptance, participation, reasonable volatility, and enough room before nearby obstruction.
Low scores usually mean the break is early, unsupported, too noisy, too extended, or too close to an obstacle.
The best use is comparative: review which sessions and symbols repeatedly produce clean accepted expansions versus weak false breaks.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a buy/sell command system
• Not a generic support/resistance map
• Not an order block, FVG, or liquidity sweep scanner
⚠️ Limitations & Transparency
Session behavior can vary across assets, timeframes, exchanges, and trading hours.
ATR regime and volume support are rule-based approximations, not certainty models.
On very low timeframes, labels may appear more frequently. On higher intraday timeframes, fewer but more meaningful events are expected.
Markets can expand cleanly and still reverse later. The tool measures context quality, not future certainty.
🧠 Market Context Notes
Session range expansion often becomes more meaningful when it is read together with broader trend, liquidity, volatility, and higher-timeframe structure.
The script deliberately stays focused on session balance and expansion quality. Users can combine it with their own broader framework without duplicating other AGPro tools.
🧾 Use Case Examples
When price breaks above the session range, holds above the balance high for the required acceptance bars, and room score remains strong, the panel may shift into review-ready continuation context.
When price breaks the range but quickly closes back inside the balance, the script marks rejection risk and the panel moves away from continuation review.
🧱 System Philosophy
AGPro tools are built to help traders organize context into clear decision layers.
Session Range Expansion Planner follows that philosophy by turning a common intraday event into a structured planning process: balance, expansion, acceptance, room, action.
🔐 Non-Promise Statement
No script can guarantee future price movement.
The score is a structured context model, not a certainty model.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and historical session behavior does not guarantee future outcomes.
Users are responsible for their own decisions, risk management, and position sizing.
This script is provided for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the script to study how different markets expand from early-session balance. The most valuable insight is not a single label, but the repeated relationship between range quality, acceptance, room, and market context.
Indicator
Volatility Stop Run Planner [AGPro Series]Volatility Stop Run Planner
🧠 Core Idea
Is the current volatility spike a stop-run review context, or is it behaving more like real expansion?
📌 Overview / What it does
Volatility Stop Run Planner is a chart-first volatility risk and execution-readiness tool designed to evaluate sharp ATR expansion around recent range edges.
The script studies wick expansion, ATR load, close recovery, range-edge penetration, reclaim quality, and early follow-through. It then converts qualified events into a 0-100 planner score, a clear next-action state, reclaim guides, invalidation guides, target-room references, stop-run review zones, expansion review zones, and a clean AGPro planning panel.
It does not predict where price must go next. It does not automate entries or exits. It is built to organize volatile stop-run and expansion contexts so traders can evaluate the event with more structure.
🎯 Purpose & Design Philosophy
This script was built for traders who need a practical decision framework during fast volatility spikes.
Many charts look most confusing exactly when volatility expands: wicks stretch, stops may be triggered, range edges are breached, and the candle can either reclaim or continue. This planner fills that gap by asking whether the spike is showing stop-run characteristics, real expansion behavior, or a cooldown state that still needs confirmation.
The design supports a planning mindset: identify the event, evaluate quality, locate the reclaim level, define invalidation context, estimate target room, and decide what deserves attention next.
⚡ Why This Script Is Different
Most stop-run tools focus on liquidity sweeps, stop-hunt zones, or level raids.
This script does NOT try to become another liquidity grab detector, stop-hunt map, order block map, or generic sweep marker.
Instead, it focuses on the volatility event itself. It evaluates whether a spike around a recent range edge is recovering, rejecting, expanding, or entering a cooldown window. The core output is not a buy or sell signal. It is a planner state that helps the user decide whether the current volatility context deserves review, patience, or no action.
⚙️ Methodology
1. Context Detection
The script measures ATR load, candle range relative to ATR, wick dominance, body efficiency, and recent range-edge interaction.
2. Reference Mapping
It maps the recent high / low reference range, the reclaim level, the spike extreme, the invalidation guide, and the target-room reference.
3. Reaction Evaluation
The model scores stop-run risk, reclaim quality, volatility load, range-edge penetration, and expansion quality. These components are blended into a 0-100 planner score.
4. Visual Output
Qualified events are displayed through stop-run review zones, expansion review zones, reclaim lines, active risk / target guides, optional volatility cooldown boxes, premium labels, alerts, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = stop-run or expansion review areas created around qualified volatility spike events.
Labels = compact event markers showing the detected context, planner score, score tier, and next-action state.
Colors = bullish reclaim contexts use AGPro teal, bearish reclaim contexts use AGPro pink, and expansion / neutral review contexts use controlled accent tones.
Panel = the panel summarizes Spike State, Planner Score, Stop-Run Risk, Reclaim Quality, Risk / Target, Volatility Load, and Action.
🚦 Signals & States
• Bull Stop-Run → downside spike below the recent range edge followed by reclaim-quality behavior.
• Bear Stop-Run → upside spike above the recent range edge followed by rejection-quality behavior.
• Expansion Up → volatility spike closes cleanly above the recent range edge with stronger body efficiency.
• Expansion Down → volatility spike closes cleanly below the recent range edge with stronger body efficiency.
• Spike Watch → volatility is elevated, but the candle has not yet produced enough reclaim or expansion evidence.
• Normal Load → no qualified volatility event is currently detected.
🔔 Alerts Logic
Alerts trigger when the planner detects a qualified Bull Stop-Run Review, Bear Stop-Run Review, Expansion Up Review, Expansion Down Review, or Spike Watch context.
These alerts are attention markers. They are not trade instructions, entry signals, exit signals, or automated strategy commands.
🧩 Confluence Logic
The strongest planner states appear when multiple conditions align:
ATR spike + wick expansion + range-edge penetration + reclaim quality + clean risk / target context.
When the spike reclaims the reference level with strong wick rejection, the stop-run review context becomes stronger. When the candle closes beyond the range edge with strong body efficiency, the expansion review context becomes stronger.
📊 When to Use
• Around sudden volatility spikes
• Near recent range highs or lows
• During breakout or breakdown attempts
• After large wick candles that need structured interpretation
• When deciding whether a fast move deserves review, patience, or no action
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes
• News-driven candles with abnormal gaps
• Markets where ATR is distorted by isolated historical spikes
• Situations where the user expects a simple signal-only entry tool
🎛️ Key Inputs
• Sensitivity → controls how selective the spike and stop-run planner should be.
• Reference Lookback → defines the recent range edge used for spike evaluation.
• ATR Length → normalizes volatility, invalidation, target room, and label spacing.
• Minimum Planner Score → sets the score required before events are drawn.
• Confirmation Mode → controls how strict reclaim or expansion confirmation should be.
• Cooldown Bars → defines the post-spike visual review window.
• Visual settings → control zones, labels, guides, panel theme, panel location, and font sizes.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The panel provides the decision summary. The chart zones show where the volatility event happened. The reclaim line identifies the reference level. The risk / target guides frame the active review context without turning the script into a trade command system.
The visual hierarchy is intentionally compact, premium, and readable.
🧪 Practical Usage Workflow
1. Read the panel to identify the current Spike State and Planner Score.
2. Check whether the chart is showing a stop-run review, expansion review, or spike watch context.
3. Compare the reclaim line with the candle close and wick behavior.
4. Review the invalidation and target-room guides.
5. Interpret the event within broader market structure and volatility conditions.
🔍 Interpretation Guidelines
A high stop-run risk score means the spike has stronger rejection and reclaim characteristics.
A high expansion score means the spike is behaving more like continuation through the range edge.
A cooldown window means the event needs follow-through review rather than immediate interpretation.
No single score should be read in isolation. The strongest use case is to combine the planner state with structure, liquidity, trend, and timeframe context.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto trading system
• Not a guaranteed signal tool
• Not a liquidity grab detector
• Not a stop-hunt zone map
• Not an order block or FVG map
⚠️ Limitations & Transparency
Volatility behavior changes across symbols, sessions, and timeframes.
ATR can expand sharply during news, low-liquidity gaps, or abnormal market conditions.
Some stop-run-looking candles can still continue in the same direction. Some expansion-looking candles can fail quickly. The script provides structured context, not certainty.
🧠 Market Context Notes
Stop-run behavior often appears when price briefly trades through visible reference areas and then reclaims them.
Expansion behavior often appears when price accepts beyond the reference with stronger body efficiency and less rejection.
The planner is designed to help users separate these contexts with a consistent rule-based framework.
🧾 Use Case Examples
When price spikes below a recent low, leaves a large lower wick, and closes back above the reference, the script may classify the event as a Bull Stop-Run Review.
When price expands above a recent high with a strong body close and limited upper rejection, the script may classify the event as Expansion Up.
When volatility spikes but reclaim or expansion evidence is incomplete, the script may show Spike Watch or keep the event in cooldown.
🧱 System Philosophy
Volatility Stop Run Planner follows the AGPro Series decision-engine approach:
Context first.
Risk before reaction.
Reclaim before assumption.
Expansion quality before excitement.
Attention markers instead of promises.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No state, score, label, alert, line, or zone should be interpreted as guaranteed market direction.
📉 Risk Disclosure
Trading involves risk.
Users remain responsible for their own analysis, risk management, and decisions.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The script is designed to make volatile candles easier to review by separating stop-run behavior, expansion behavior, and cooldown context into a clean visual planning workflow.
Indicator
Volume Expansion Breakout Planner [AGPro Series]Volume Expansion Breakout Planner
🧠 Core Idea
After a breakout, is volume expanding in a constructive path, or is the move losing participation and acceptance?
📌 Overview / What it does
Volume Expansion Breakout Planner is a chart-first breakout planning tool built around post-breakout participation quality.
Instead of judging only the breakout candle, the script maps the broken reference level, draws an acceptance band, monitors relative volume after the break, tracks whether price holds the path, and converts the full sequence into a 0-100 quality score.
The output includes compact breakout path labels, volume expansion labels, hold labels, failed-volume labels, an invalidation rail, a room or review guide, and a clean AGPro decision panel. It does not predict price, automate entries, or issue trade commands.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between simple breakout markers and full trade-management tools.
Many breakouts look strong on the first candle but quickly lose participation. Others start quietly and become stronger as post-break volume expands. This tool is designed for traders who want to evaluate that path with structure, not emotion.
The mindset is planning-first: identify the breakout reference, evaluate volume expansion, check acceptance, respect invalidation, and decide whether the path deserves continued attention.
⚡ Why This Script Is Different
Most breakout tools focus on the first break beyond a level.
This script does NOT try to clone a standard breakout volume confirmation tool, a Darvas breakout system, a triangle breakout scanner, or a generic support/resistance map.
Instead, it focuses on the post-break volume expansion path: what happens after the level breaks, whether volume remains constructive, whether price accepts the broken area, and whether the path becomes suspicious or failed.
⚙️ Methodology
1. Context Detection
The script builds a prior price structure from a configurable lookback and identifies the upper and lower breakout references.
2. Reference Mapping
When price closes beyond the reference by an ATR-normalized buffer, the script starts a breakout path and draws the broken level, acceptance band, invalidation rail, and a room or review guide.
3. Reaction Evaluation
The model evaluates relative volume, candle efficiency, close location, breakout distance, trend alignment, range quality, post-break participation, progress, acceptance, and failure behavior.
4. Visual Output
The chart displays compact path labels, volume expansion labels, accepted-path labels, failed-volume labels, and a premium AGPro panel summarizing the current decision state.
🗺️ How to Read the Chart
Zones = the acceptance band around the broken level. Its text changes by state, such as BULL PATH REVIEW, ACCEPTED BULL PATH, or FAILED BEAR PATH.
Labels = compact path state markers such as UP, DN, VOL+, HOLD, FAIL, WATCH UP, and WATCH DN. Label scores can be enabled from settings if the user wants more detail.
Colors = teal for constructive bullish paths, pink for constructive bearish paths, yellow for watch or caution states, indigo for room or review guide emphasis, and muted gray for expired paths.
Panel = the current breakout side, volume expansion state, acceptance state, quality score, and next action.
🚦 Signals & States
• UP → a bullish breakout path has started.
• DN → a bearish breakout path has started.
• VOL+ → post-break volume is expanding with directional follow-through.
• HOLD → the path held beyond the acceptance band with constructive volume.
• FAIL → the path returned into weak-volume or invalidation conditions.
• WATCH UP / WATCH DN → optional approach labels when price is near a breakout reference while relative volume is building.
🔔 Alerts Logic
Alerts trigger when a high-quality bullish or bearish volume expansion path starts, when post-break volume expands, when the path becomes accepted, or when failed-volume conditions appear.
These alerts are attention markers for chart review. They are not trade instructions.
🧩 Confluence Logic
The strongest readings usually occur when the breakout closes cleanly beyond the reference, relative volume expands above baseline, candle structure is efficient, trend alignment supports the side, and price later accepts the broken area.
When these conditions align, the quality score improves and the next-action state becomes more constructive.
📊 When to Use
• Breakout continuation review
• Range exits where volume quality matters
• Post-break acceptance monitoring
• Breakouts that need a clear invalidation reference
• Multi-symbol review where traders need fast path-quality comparison
⚠️ When NOT to Use
• Low-liquidity symbols with unreliable volume
• Markets with irregular session volume or distorted feeds
• Extremely choppy periods where every break returns inside the prior structure
• Events driven by abnormal news volatility where technical volume baselines become less stable
🎛️ Key Inputs
• Breakout Lookback → controls the prior structure used for breakout references.
• Break Buffer ATR → defines how far price must close beyond the level.
• Volume Baseline Length → controls the relative volume baseline.
• Expansion RVOL Threshold → defines the required volume expansion for strong pulses.
• Minimum Planner Score → controls how selective the main path states are.
• Acceptance Band ATR → controls the decision zone around the broken level.
• Invalidation Rail ATR → controls the structural failure reference.
• Panel / Label Settings → control location, theme, font size, label scores, optional watch labels, and label density.
🖥️ Interface & Visual Design
The interface is built for fast chart reading.
The acceptance band is the main visual anchor. The breakout line, invalidation rail, and room or review guide create a compact planning map without filling the chart with generic zones. Labels are short, shifted slightly away from the candle, and capped by user settings.
The AGPro panel follows the publication standard with a single merged blue header row containing only the script name.
🧪 Practical Usage Workflow
1. Read the panel to see whether a breakout path is active.
2. Check the acceptance band and broken level.
3. Evaluate whether volume is expanding or fading.
4. Watch for ACCEPTED or FAILED VOL states.
5. Use the invalidation rail and room or review guide as planning references within broader market context.
🔍 Interpretation Guidelines
Read the score as a structured quality model, not as certainty.
A higher score means the path has cleaner participation, stronger candle structure, better close quality, better trend alignment, and stronger acceptance behavior according to the script's rules.
A lower score means the path is weaker, less accepted, or more vulnerable to failed-volume behavior.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a complete trading system
• Not a generic buy/sell indicator
⚠️ Limitations & Transparency
Volume quality depends on the reliability of the PulseWire volume feed for the selected symbol.
Different timeframes can produce different breakout references and acceptance behavior.
High-volatility news periods, low-liquidity markets, and irregular session activity can reduce the usefulness of relative volume baselines.
The script is rule-based and should be interpreted alongside broader context.
🧠 Market Context Notes
Volume expansion is most useful when it is connected to structure.
The broken level matters because it gives the move a reference. The acceptance band matters because it shows whether the market is holding that reference. The invalidation rail matters because it defines when the path has lost structural quality.
🧾 Use Case Examples
When price breaks above a prior range with strong RVOL and later holds the acceptance band, the path may remain constructive.
When price breaks below a range but volume fades and price returns above the broken reference, the path may become suspicious or failed.
When price approaches a reference with building volume but no confirmed break, VOL WATCH keeps the trader aware without turning the tool into a signal board.
🧱 System Philosophy
The script is part of the AGPro planner-style workflow: show the reference, score the context, define invalidation, monitor acceptance, and guide the next review step.
🔐 Non-Promise Statement
No script can guarantee continuation, reversal, or outcome certainty.
This tool organizes breakout-volume context so users can evaluate the chart more clearly.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and market interpretation.
This script is provided for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the script to study how post-breakout volume behaves after price leaves a prior structure. The most useful insights often come from comparing accepted paths against failed-volume paths over many examples.
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
Breakout Failure Recovery [AGPro Series]Breakout Failure Recovery
🧠 Core Idea
After a failed breakout, is price recovering through the reclaim level or confirming the failure?
📌 Overview / What it does
Breakout Failure Recovery is a chart-first failed-breakout lifecycle planner built to evaluate what happens after price probes outside a recent range and closes back inside.
The script maps a failure box, reclaim trigger, risk shelf, recovery/rejection labels, and a compact AGPro panel. It converts close-back-inside behavior, reclaim speed, retest response, volume behavior, and time decay into a 0-100 Recovery Score with a clear next-action state.
It does not predict the next move, automate execution, or act as a generic failed-break signal. Its purpose is to organize the post-failure decision context.
🎯 Purpose & Design Philosophy
This script was built for traders who do not want to treat every failed breakout the same way.
Some failed breaks recover quickly through the original breakout level. Others reject the boundary, lose time, and confirm that the attempt has failed. This tool focuses on that decision window.
The design supports a planner mindset: identify the failure, measure the reclaim attempt, locate the risk shelf, and decide whether the context deserves review or should be downgraded.
⚡ Why This Script Is Different
Most tools mark a failed break as a single event.
This script does NOT stop at the failed-break label, does not clone a Swing Failure Pattern engine, and does not become a generic breakout-failure signal board.
Instead, it evaluates the recovery path after the failure. The main output is a recovery state: Recovery Active, Recovery Watch, Failure Confirmed, Reclaim Pending, Window Decaying, or No Active Failure.
⚙️ Methodology
1. Context Detection
The script builds a recent range from prior bars and checks whether price probes beyond the upper or lower boundary before closing back inside.
2. Reference Mapping
When a failed break appears, it maps the failure box, reclaim trigger, and risk shelf around the failed boundary.
3. Reaction Evaluation
The model scores close-back-inside quality, reclaim speed, retest response, volume behavior, and time decay.
4. Visual Output
The result is shown through centered failure-box text, a centered risk-shelf label, reclaim/reject labels, alert conditions, and a clean AGPro planning panel.
🗺️ How to Read the Chart
Failure Box = the failed-break excursion outside the recent range.
Reclaim Trigger = the level that shows the original breakout attempt is trying to recover.
Risk Shelf = the boundary zone where retest response should be reviewed.
Labels = compact markers for failed break, reclaim, reject, decay, and watch context.
Colors = teal highlights constructive recovery context, pink highlights failure or rejection pressure, amber highlights shelf review, and indigo highlights watch states.
Panel = summarizes Failure State, Recovery Score, Reclaim Level, Risk Zone, and Action.
🚦 Signals & States
• Failed Breakout Detected → price probed outside the recent range and closed back inside.
• Recovery Watch → recovery conditions are developing, but reclaim confirmation is incomplete.
• Recovery Active → reclaim behavior and the Recovery Score have reached stronger review context.
• Failure Confirmed → price rejects the failed boundary or moves deeper back into the range.
• Reclaim Pending → an active failure exists, but recovery conditions are not strong enough yet.
• Window Decaying → the failed-break context is getting old and should carry less weight.
🔔 Alerts Logic
Alerts trigger when a failed breakout is detected, when Recovery Watch appears, when Recovery Active appears, or when Failure Confirmed appears.
Alerts are attention markers only. They are not trade instructions, entry commands, exit commands, or automated strategy rules.
🧩 Confluence Logic
The strongest recovery context appears when price closes back inside the range, reclaims the failed boundary quickly, shows a constructive retest response, receives supportive volume, and does not lose too much time after the failed break.
When these components weaken, the script can shift toward Reclaim Pending, Window Decaying, or Failure Confirmed.
📊 When to Use
• After a breakout attempt closes back inside a recent range
• During range-bound markets with frequent boundary tests
• Around failed expansion attempts where reclaim quality matters
• When deciding whether a failed breakout deserves continued monitoring
• On liquid symbols where range, volume, and candle behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles
• Extremely noisy micro-timeframes
• News-driven spikes where levels lose structure quickly
• Markets with unreliable volume data
• Situations where the user expects a direct signal-only tool
🎛️ Key Inputs
• Failure Range Lookback → controls the recent range used to detect failed breaks.
• Failure Probe ATR → defines how far price must probe beyond the range boundary.
• Recovery Window Bars → controls how long the failed-break recovery window stays relevant.
• Retest / Shelf ATR → controls risk shelf thickness and boundary response tolerance.
• Recovery Active Threshold → sets the minimum score for the strongest recovery state.
• Label and Panel Font Size → controls chart labels, centered zone text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The failure box gives the visual story. The reclaim trigger and risk shelf define the practical review frame. Labels remain compact and controlled so the chart stays active without becoming crowded.
The AGPro panel uses a merged blue title row and a compact decision layout for fast reading.
🧪 Practical Usage Workflow
1. Read the panel state and Recovery Score.
2. Check the failure box and failed boundary.
3. Compare price behavior against the reclaim trigger.
4. Review the risk shelf and rejection response.
5. Treat alerts as attention markers, then evaluate broader market context.
🔍 Interpretation Guidelines
Think in terms of failed-break lifecycle, not prediction.
A stronger Recovery Score means the failed breakout is attempting to reclaim quickly with better response and participation. A weaker score means the failure may be aging, rejecting, or losing structural quality.
Failure Confirmed does not mean the market must continue in one direction. It means the failed-break attempt is not recovering cleanly within the current rule set.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a generic failed-break signal
• Not a Swing Failure Pattern clone
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, range, volume, and candle behavior.
Different timeframes can change how failure and recovery appear. Volatility spikes can temporarily distort boundary behavior. Symbols with unreliable volume may produce weaker participation readings.
Outputs should always be interpreted with broader market structure, liquidity, and risk context.
🧠 Market Context Notes
Failed breakouts are most useful when the boundary is readable and the follow-up reaction is clear.
A quick reclaim can show that the failed attempt is recovering. A weak retest, slow response, or deep move back into the range can show that the failed break is confirming instead.
🧾 Use Case Examples
When price probes above a range, closes back inside, then quickly reclaims the upper boundary with supportive volume, the planner may classify the context as Recovery Active.
When price probes above a range, closes back inside, retests the boundary from below, and rejects again, the planner may classify the context as Failure Confirmed.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning failed breakouts into a structured decision question: is the attempt recovering, aging, or confirming failure?
🔐 Non-Promise Statement
No indicator can provide certainty.
This tool provides structured visual context and rule-based attention markers. It does not guarantee continuation, reversal, recovery, or rejection.
📉 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 failed breakouts behave after the first rejection, how reclaim speed affects context, and how risk shelves help organize post-failure review.
Indicator
Regression Deviation Channel [JOAT]Regression Deviation Channel
Introduction
The Regression Deviation Channel is an institutional-style statistical trend and execution framework built around segmented regression, deviation envelopes, premium/discount zoning, breakout qualification, and risk mapping. Instead of acting like a plain moving-average channel, it models price through a best-fit regression path, measures dispersion with RMSE, then classifies where price is trading inside that structure: discount, equilibrium, or premium.
This version is designed to feel more like a desk-grade directional map than a simple overlay. It combines a frozen regression segment, internal band hierarchy, confidence scoring, Supertrend stack alignment, breakout detection, and ATR-based trade mapping into one visual structure. The goal is not just to show where price is, but whether the current move is balanced, compressed, expanding, or resolving.
Why This Indicator Exists
Most channels are too simple. They show boundaries but do not explain what price is doing inside those boundaries. This indicator was built to solve that by combining:
Segmented Regression: Tracks the current directional price path with a proper best-fit slope
Deviation Architecture: Uses RMSE to define statistically meaningful channel width
Premium / Discount Zoning: Splits the channel into expensive, fair value, and cheap territory
Breakout Qualification: Scores breakout quality using slope, participation, structure, and location
Trend Stack Context: Adds Supertrend alignment to distinguish strong directional pressure from noise
Trade Mapping: Builds clean ATR-based stop and multi-target projections after confirmed breaks
The result is a regression channel that does more than draw lines. It gives context, bias, execution framing, and visual hierarchy.
Core Components Explained
1. Segmented Regression Engine
= f_ols(winLen)
basisVal = intercept + slope * float(barsInSeg - 1)
upperVal = basisVal + rmse * multiplier
lowerVal = basisVal - rmse * multiplier
The core engine uses manual ordinary least squares regression to calculate the channel basis. Once the segment matures, the regression values are frozen and projected forward until price resolves beyond the envelope.
This “freeze and resolve” behavior keeps the channel visually stable instead of constantly shifting every bar.
2. RMSE Deviation Structure
Root mean squared error defines channel width, making the envelope responsive to how tightly price is hugging the trend.
Tight RMSE = cleaner trend structure
Wide RMSE = unstable or volatile structure
Internal bands split the envelope into inner, quarter, and outer zones
These nested bands create a true structure ladder instead of a single upper/lower shell.
3. Premium / Discount Channel Arrays
The channel is separated into three value areas:
Premium: Upper edge territory where price is extended and expensive relative to the current regression path
Equilibrium: The center band around fair value and neutral orderflow balance
Discount: Lower edge territory where price is cheap relative to the active path
This makes the indicator more useful for directional context:
Bull channels pressing premium signal strong continuation pressure
Bear channels pressing discount signal strong downside control
Repeated failure to hold premium/discount can signal exhaustion or rebalancing
4. Breakout Confidence Model
Breakouts are not treated equally. The indicator scores breakout quality using four ingredients:
Participation: Distance from the regression basis normalized by ATR
Slope Force: Strength of the normalized regression slope
Location: Whether price is already pressing the outer structure
Alignment: Whether price direction and Supertrend stack agree with the channel
breakoutConfidence = participation + slopeForce + location + alignment
This helps separate lazy drifts from high-quality channel resolution.
5. Supertrend Ribbon Stack
The Supertrend layer is not there as a generic add-on. It acts as a second-order directional filter.
Bull channel + bull Supertrend = higher-quality directional stack
Bear channel + bear Supertrend = stronger downside stack
When regression and Supertrend disagree, price is more likely in transition
The fill between regression basis and Supertrend visually shows whether pressure is aligned or conflicted.
6. ATR Risk Map
After a confirmed breakout, the indicator projects:
1 ATR-based stop level
3 reward targets using configurable risk-reward multiples
Auto-expiring lines so stale trade maps are removed
This gives the channel direct execution value instead of leaving the user to manually measure every move.
Visual Elements
Metallic Basis Line: Gold-toned centerline for the active regression basis
Outer Deviation Shell: Main channel boundaries with glow
Inner Structure Bands: Internal ladder for pressure staging
Premium / Discount Fills: Separate upper and lower value zones inside the channel
Equilibrium Fill: Neutral fair-value region
Supertrend Ribbon: Context layer showing secondary directional alignment
Iridescent Candles: Candle coloring that intensifies as control and confidence improve
Breakout Markers: Compact signals for confirmed resolves
Readiness Diamonds: Pre-break alignment markers when channel conditions are strong
The visual hierarchy is designed so you can read the channel at a glance without relying on heavy objects or clutter.
Dashboard
The dashboard is intentionally compact and fixed to the right side. It shows only the highest-signal metrics:
Bias
Regime
Flow
Channel Position
Confidence
Compression
Trend Stack
Trade Map
How to Use This Indicator
Step 1: Identify Channel Bias
Check whether the regression slope is bullish or bearish. That defines the primary directional path.
Step 2: Read Value Location
See whether price is trading in premium, equilibrium, or discount. This tells you whether price is extended or balanced inside the channel.
Step 3: Watch Trend Stack Alignment
When Supertrend and regression agree, directional pressure is cleaner. When they disagree, reduce conviction.
Step 4: Monitor Confidence
Use the breakout confidence score to judge whether price is merely drifting or building a meaningful resolution.
Step 5: Trade the Resolve, Not the Noise
Use breakout markers and ATR map levels when price exits the frozen envelope with qualified pressure.
Best Practices
Use higher timeframes for cleaner channel geometry
Treat equilibrium as fair value, not a signal by itself
Bull channels work best when premium holds and pullbacks respect the inner bands
Bear channels work best when discount holds and rallies fail at internal structure
High compression followed by rising confidence often precedes expansion
Use the risk map for framing, not blind automation
Indicator Limitations
Regression is still a model of recent price, not a guarantee of future direction
Sudden event-driven moves can invalidate the frozen segment quickly
Premium and discount are relative to the current channel, not absolute market value
High breakout confidence can still fail in thin or news-driven markets
Short segments increase responsiveness but also increase noise
Technical Implementation
Built in Pine Script v6 using:
Manual OLS regression
RMSE deviation envelopes
Segment freeze-and-resolve logic
Internal quarter and inner bands
Premium/discount channel zoning
Supertrend stack integration
Breakout confidence scoring
ATR-based stop and target map
Compact institutional dashboard
Originality Statement
This indicator is original in how it treats a regression channel as a full market-state framework instead of a static overlay. The value is not just in plotting upper and lower lines, but in combining:
Segment freezing
Internal value zoning
Directional stack confirmation
Breakout qualification
Execution mapping
Each layer contributes different information: regression defines path, RMSE defines structure, premium/discount defines value, Supertrend defines stack, and confidence defines quality.
Disclaimer
This indicator is provided for educational and informational purposes only. It is not financial advice. Regression channels, premium/discount zones, and breakout scores are analytical tools, not guarantees of market outcome. All trading decisions remain the responsibility of the user.
-Made with passion by officialjackofalltrades
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
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
Breakout Retest Readiness [AGPro Series]Breakout Retest Readiness
🧠 Core Idea
Is the post-breakout retest being accepted with structure, or is the breakout losing quality at the risk edge?
📌 Overview / What it does
Breakout Retest Readiness is a chart-first planning tool built to evaluate what happens after a confirmed breakout and after price starts interacting with the retest pocket.
The script maps the broken structure level, builds a retest pocket around it, places a risk-edge shelf beyond the pocket, and projects a target-room guide for context. It then scores the active retest environment with a 0-100 Acceptance Score and displays a clear next-action state in the AG Pro panel.
This script does not predict continuation. It does not automate entries. It is designed to organize post-breakout retest context so traders can review acceptance, rejection, risk edge, and plan quality in a cleaner way.
🎯 Purpose & Design Philosophy
Most breakout tools focus on the moment price crosses a level. In practice, many useful decisions happen after the break, when price returns toward the broken level and either accepts it or fails around it.
This script was built for traders who want a structured retest planning layer rather than another basic breakout marker. It supports a patient workflow: wait for structure, observe the pocket, evaluate acceptance, and review risk before reacting.
The design philosophy is simple: the chart should answer what state the retest is in, how strong the acceptance context is, where risk is being tested, and what the next review step should be.
⚡ Why This Script Is Different
Most tools focus on detecting a breakout or grading the first retest as a standalone signal.
This script does NOT try to clone a classic break-retest quality grader, and it does not print simple buy or sell commands.
Instead, it works as a post-breakout readiness planner. It arms a retest pocket after a confirmed breakout, waits for price to interact with that pocket, evaluates acceptance versus rejection, tracks the risk edge, and keeps the next-action state visible in the panel.
The difference is the decision layer. The script is less about saying "a retest happened" and more about answering whether the active retest environment is constructive enough to keep reviewing.
⚙️ Methodology
1. Context Detection
The script identifies a confirmed break beyond recent structure using a prior high or prior low reference. The breakout must clear the structure by an ATR-normalized buffer so minor pokes are filtered.
2. Reference Mapping
After a valid break, the script stores the breakout line, builds a retest pocket around it, places an invalidation shelf beyond the broken level, and projects a target-room guide from the prior structure range.
3. Reaction Evaluation
When price interacts with the retest pocket, the script evaluates breakout quality, retest depth, wick rejection, volume change, and trend agreement. These components combine into a 0-100 Acceptance Score.
4. Visual Output
The chart shows the active retest pocket, breakout line, risk edge, target guide, compact event labels, and the AG Pro panel. The panel summarizes retest state, acceptance score, breakout quality, risk edge, and action.
🗺️ How to Read the Chart
Retest Pocket = the zone around the broken structure level where price is being evaluated after the breakout.
Breakout Line = the structure level that was crossed and now anchors the retest plan.
Risk Edge = the invalidation shelf beyond the retest pocket. It is a planning reference, not a stop recommendation.
Target Guide = a target-room marker projected from the prior range. It is context only, not a forecast.
Labels = compact state markers such as ARMED, TEST, ACCEPT, REJECT, RISK EDGE, or EXPIRE.
Colors = bullish retest plans use the AGPro teal tone, bearish plans use the AGPro pink tone, watch states use indigo or amber, and risk conditions use red.
Panel = the main decision interface showing retest state, acceptance score, breakout quality, risk edge, and next action.
🚦 Signals & States
• Breakout Armed → a breakout retest plan has been created after price cleared structure.
• Testing Pocket → price is interacting with the active retest pocket and acceptance is being evaluated.
• Accepted Retest → the retest has held the pocket with enough acceptance quality to deserve review.
• Rejected Retest → the retest has failed around the pocket and quality has weakened.
• Risk Edge Hit → price has moved beyond the mapped risk shelf.
• Expired → the retest window aged out before a constructive interaction.
🔔 Alerts Logic
Alerts are available for breakout plan arming, retest pocket interaction, accepted retest readiness, rejected retest or risk-edge pressure, and expired retest plans.
Each alert is an attention marker. Alerts do not represent trade instructions, guaranteed outcomes, or automated strategy decisions.
🧩 Confluence Logic
The strongest acceptance context appears when the breakout quality, retest depth, wick rejection, volume behavior, and trend agreement support the same side.
When these components align, the retest score improves. When the pocket is too deep, volume behavior is poor, trend context disagrees, or the risk edge is pressured, the readiness state weakens.
📊 When to Use
• After clean breakouts from recent structure
• During trend continuation review
• When price returns toward a broken level
• When the trader wants to separate constructive retests from weak post-break reactions
• On liquid symbols where structure, volume, and candle behavior are readable
⚠️ When NOT to Use
• Extremely low-liquidity instruments
• Highly noisy lower timeframes
• News-driven volatility spikes
• Markets with no clear structure reference
• Situations where the breakout level is too close to major external obstruction
🎛️ Key Inputs
• Breakout Structure Lookback → controls the prior structure reference used for breakout detection.
• Maximum Bars To Retest → controls how long the script waits for the retest pocket to matter.
• Sensitivity → adjusts how strict the breakout and acceptance model should be.
• Minimum Acceptance Score → defines the score needed before accepted readiness can appear.
• Retest Pocket Width ATR → controls the width of the post-breakout pocket.
• Invalidation Shelf ATR → controls the mapped risk-edge distance beyond the broken level.
• Target Guide Range Multiple → controls the forward target-room guide.
• Visual Settings → control pockets, lines, labels, label density, label size, and forward rendering.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is built around a clean AG Pro panel and one main chart object family: the retest pocket.
The pocket label is centered inside the zone so the active state is visible without needing extra clutter. The breakout line, invalidation shelf, and target guide create a simple visual hierarchy: level, risk, and room.
Labels are intentionally compact and controlled by cooldown and maximum-visible settings so the chart remains active without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Locate the active retest pocket.
3. Check whether price is testing, accepting, rejecting, or pressing the risk edge.
4. Compare the Acceptance Score with the breakout quality.
5. Use the action row as a review prompt, not as an instruction.
🔍 Interpretation Guidelines
The Acceptance Score should be read as context quality, not certainty.
A higher score means the current retest has cleaner structural behavior under the script's rules. A lower score means the retest is less constructive, too deep, poorly supported, or not aligned with trend context.
The Risk Edge matters because a retest can look acceptable for a few bars and still lose structure if price pushes beyond the invalidation shelf. The panel keeps that condition visible.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an auto-trading system.
This script does not provide guaranteed signals.
This script is not a generic support and resistance map.
This script is not a clone of a first-retest grading tool.
⚠️ Limitations & Transparency
The script is rule-based and depends on the selected lookback, timeframe, and market structure.
Different symbols can produce different retest behavior. Lower timeframes may show more noise. Higher timeframes may produce fewer but stronger events.
Volatility changes can affect pocket size, risk-edge distance, and event frequency. Users should interpret every output within broader market context.
🧠 Market Context Notes
Breakout retests are most useful when structure is clear, liquidity is sufficient, and price has enough room to continue without immediate obstruction.
Volume behavior can add context, but volume data quality varies across markets. When volume is unreliable, the script treats that component more neutrally.
The retest pocket is not a guaranteed support or resistance zone. It is a structured review area around the broken level.
🧾 Use Case Examples
When price breaks above recent structure and later returns to the pocket with a controlled pullback, the script can mark the retest as Testing Pocket or Accepted Retest depending on score quality.
When price breaks below structure but quickly pushes back above the pocket and pressures the mapped risk edge, the script can mark rejection or risk-edge pressure.
When a breakout never returns to the pocket within the selected time window, the script can expire the plan instead of keeping old context alive.
🧱 System Philosophy
AGPro tools are designed to support structured chart reading. The goal is not to add more random signals, but to turn market behavior into clearer states, cleaner context, and better review discipline.
Breakout Retest Readiness follows that philosophy by turning a common post-breakout question into a visible planning workflow.
🔐 Non-Promise Statement
No script can confirm future price direction with certainty.
This tool organizes retest context. It does not promise continuation, reversal, profit, or accuracy.
📉 Risk Disclosure
Trading involves risk.
All outputs from this script are educational and analytical in nature.
Users are responsible for their own decisions, risk management, position sizing, and market interpretation.
This script does not provide financial advice.
📚 Educational Note
Use the script to study how breakouts behave after price returns to the broken level. The most useful insight is often not the breakout itself, but how the market reacts when the level is tested again.
Indicator
False Break Trap Planner [AGPro Series]False Break Trap Planner
🧠 Core Idea
Is a breakout still holding, or is it turning into a false-break trap that deserves caution?
📌 Overview / What it does
False Break Trap Planner is a chart-first breakout failure planner built to evaluate range-edge break attempts after price moves beyond a recent high or low boundary.
Instead of only marking that a breakout happened, the script studies whether the move is holding beyond the edge, being reclaimed back into the range, or becoming a confirmed trap-risk context. It produces a 0-100 Trap Risk score, a reclaim state, a break-quality reading, a failure-room estimate, false-break zones, reclaim rails, and target-back guides.
This script does not predict price direction, automate execution, or claim that a failed break must reverse. It organizes the anatomy of a potential false break so traders can review the setup with cleaner context.
🎯 Purpose & Design Philosophy
This script was built for traders who need a practical decision layer around breakout failure, not another generic signal marker.
The gap it fills is the space between a clean breakout tool and a liquidity sweep tool. Many chart tools mark a level break, a wick, or a reclaim. This planner asks what the trader should review next: is the break holding, is reclaim pressure developing, is the failure fast enough to matter, and is there room back inside the range?
The design mindset is structured caution. The script helps users slow down around breakout traps, separate active risk from confirmed failure, and keep risk / target / invalidation context visible.
⚡ Why This Script Is Different
Most tools focus on breakout confirmation, sweep labels, or generic failed-break signals.
This script does NOT try to become a stop-hunt map, liquidity sweep engine, support/resistance zone scanner, or broad breakout system.
Instead, it focuses on one specific workflow: a prior range edge is broken, the break either holds or gets reclaimed, and the planner scores whether that behavior deserves trap-risk review.
⚙️ Methodology
1. Context Detection
The script maps a recent range high and range low from previous bars, then watches for an ATR-normalized break beyond either edge.
2. Reference Mapping
When a break attempt appears, the planner freezes the range edge, opposite edge, midpoint, and false-break extreme so the event can be evaluated consistently.
3. Reaction Evaluation
The model scores breakout failure speed, reclaim strength, wick size, volume spike, and whether price closes back inside the range.
4. Visual Output
The script displays a false-break box, reclaim or fail rail, target-back line, trap confirmation labels, reclaim-watch labels, and a premium AG Pro panel.
🗺️ How to Read the Chart
Zones = the active false-break box between the broken range edge and the failed extension.
Labels = compact state markers such as Upper Break Watch, Lower Break Watch, Reclaim Watch, Upper Trap, Lower Trap, or Break Accepted.
Colors = teal for lower-break trap recovery context, pink for upper-break trap risk, yellow for watch states, indigo for accepted/holding context, and red for confirmed trap-risk pressure.
Panel = a compact decision panel showing Trap Risk, Reclaim State, Break Quality, Failure Room, and Action.
🚦 Signals & States
• Upper Break Watch → price has moved beyond the upper range edge and the break is under review.
• Lower Break Watch → price has moved beyond the lower range edge and the break is under review.
• Reclaim Watch → price is testing back toward or inside the broken edge, but confirmation is not complete.
• Trap Confirmed → the break has closed back inside the range with enough trap-risk score.
• Break Holding → the break is still outside the range and has not reclaimed.
• Break Accepted → the break has held beyond the acceptance window and should not be treated as an active trap by default.
🔔 Alerts Logic
Alerts trigger when the planner detects confirmed upper or lower trap context, upper or lower reclaim-watch context, or break acceptance.
Each alert is an attention marker. It highlights a state transition that may deserve review. It is not a trade instruction and should not be treated as an automated entry or exit signal.
🧩 Confluence Logic
The strongest trap-risk context appears when several factors align:
• Fast failure after the break
• Close back inside the prior range
• Strong wick rejection
• Volume spike during the failed extension
• Clean room back toward the range midpoint
When these align, the panel score rises and the state becomes easier to interpret.
📊 When to Use
• Breakout and breakdown attempts around a recent range
• Markets where false breaks and failed continuations are common
• Intraday or swing charts where range edges are visually relevant
• Review workflows that need caution before chasing a break
• Breakout traders who want a structured invalidation and failure-room layer
⚠️ When NOT to Use
• Extremely low-liquidity instruments
• Very noisy micro timeframes with unreliable candles
• Markets with poor or synthetic volume data
• News-driven volatility where single-bar extremes distort ATR and volume
• Charts where the selected lookback does not represent a meaningful range
🎛️ Key Inputs
• Range Edge Lookback → controls the prior range used for break attempts.
• Minimum Break ATR → defines how far price must move beyond the edge before the planner starts tracking.
• Fast Reclaim Window → controls how many bars can pass before a reclaim becomes less meaningful.
• Trap Confirmed Score → minimum 0-100 score required for a confirmed trap label.
• Break Acceptance Bars → defines when a break should be treated as holding rather than still failing.
• Visual settings → control boxes, rails, target-back lines, label density, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The panel is designed as a clean AG Pro planning cockpit. The first row uses the standard merged blue AGPro header row, followed by five decision rows.
The chart visuals are intentionally focused: one active false-break box, a reclaim rail, a soft fail rail, a target-back line, and controlled labels. The goal is premium readability without turning the chart into a generic level map.
🧪 Practical Usage Workflow
1. Read the panel and check the current Reclaim State.
2. Review the false-break box and identify which edge was broken.
3. Check whether price is holding beyond the edge or closing back inside.
4. Compare Trap Risk with Break Quality.
5. Use the target-back line and failure-room reading as context, not as a forecast.
🔍 Interpretation Guidelines
Think in states, not predictions.
A high Trap Risk score means the attempted break has characteristics often associated with failed continuation. It does not mean the next move is guaranteed.
A strong Break Quality score means the break is still showing participation and close-through behavior. In that context, early fading can be premature.
The cleanest reading appears when Trap Risk is high, Break Quality is weak, and price has closed back inside the range.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a stop-hunt map
• Not a liquidity sweep scanner
• Not a support/resistance zone system
• Not a replacement for risk planning
⚠️ Limitations & Transparency
The active range depends on the selected lookback. A different lookback can produce different edges.
ATR and volume conditions can change quickly during high-volatility periods, which may affect scoring.
Breakout behavior differs across symbols, sessions, and timeframes. A trap-like structure on one market may not behave the same way on another.
The script is rule-based and does not know external news, order flow, or hidden liquidity.
🧠 Market Context Notes
False breaks often become more relevant near visible range edges, crowded breakout levels, and late-stage expansion attempts.
The planner is most useful when combined with broader market context, liquidity conditions, volatility regime, and the trader's own risk rules.
🧾 Use Case Examples
When price breaks above a recent range but closes back inside with a long upper wick and strong volume, the planner may mark Upper Trap context.
When price breaks below a range but quickly reclaims the lower edge, the planner may shift into Lower Trap context.
When price breaks and keeps closing beyond the edge after the acceptance window, the planner may mark Break Accepted instead of forcing a trap interpretation.
🧱 System Philosophy
False Break Trap Planner follows the AGPro Series decision-engine direction: score the setup, identify the state, show the risk reference, show the target-back context, and make the next review step clear.
The script is built to help traders make a structured chart-reading decision, not to add another isolated signal.
🔐 Non-Promise Statement
No script can confirm certainty.
No trap score guarantees reversal, continuation, or profitability.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk controls, and market interpretation.
This script is for educational and analytical use only and does not provide financial advice or guaranteed trading outcomes.
📚 Educational Note
Use the planner as a structured review layer around breakout failure behavior. The best value comes from comparing state, score, failure room, and broader market context together.
Indicator
Compression Breakout Readiness [AGPro Series]Compression Breakout Readiness
🧠 Core Idea
Is compression mature enough for a breakout watch state, or is the range still early, noisy, or structurally weak?
📌 Overview / What it does
Compression Breakout Readiness is a chart-first breakout planning tool designed to evaluate whether a compressed range has developed enough maturity to deserve active attention.
Instead of printing a generic breakout signal, the script studies range contraction, ATR compression, pivot tightening, volume dry-up, directional side bias, invalidation-edge distance, and projected breakout room. These components are converted into a 0-100 Readiness Score and a clear next-action state.
The script produces an active compression box, breakout watch corridor, invalidation edge, target guide, compact state labels, alerts, and a clean AGPro planning panel. It does not predict direction, automate execution, or guarantee that a breakout will follow through.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate the quality of compression before reacting to a breakout attempt.
Many breakout tools only mark the moment price crosses a level. The more useful planning question often comes earlier: is the range actually tight, mature, quiet, and biased enough to watch, or is the structure still too loose?
The design supports a decision-first workflow: identify compression, measure readiness, check risk edge, review the watch side, then decide whether the chart deserves attention.
⚡ Why This Script Is Different
Most tools focus on squeeze dots, breakout arrows, generic consolidation boxes, or simple high/low range breaks.
This script does NOT act as a generic squeeze indicator, a choppiness filter, a support/resistance mapper, or a direct buy/sell signal generator.
Instead, it evaluates compression maturity before and around the breakout edge. The main output is not a trade command. It is a readiness state that helps the user separate READY WATCH conditions from early, neutral, overheated, or invalidated compression contexts.
⚙️ Methodology
1. Context Detection
The script maps the active compression range and evaluates whether current volatility and range width are contracting relative to their baselines.
2. Reference Mapping
It builds the compression box, active breakout watch corridor, invalidation edge, and target guide from the current structure.
3. Reaction Evaluation
The model scores range contraction, ATR compression, pivot tightening, volume dry-up, side bias, and compression age. It also checks whether the invalidation edge is too tight, too wide, or balanced.
4. Visual Output
The result is shown through centered zone text, compact chart labels, clean edge lines, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Compression Box = the active range being evaluated for breakout readiness.
Breakout Watch Corridor = the planning area beyond the active compression edge.
Invalidation Edge = the opposite-side reference used to judge risk context.
Labels = compact state markers such as READY WATCH, WATCH, EDGE REVIEW, PREMATURE, HOT RISK, and INVALID EDGE.
Colors = teal for bullish watch context, pink for bearish or invalid context, amber for caution, and indigo for watch/neutral emphasis.
Panel = the panel summarizes Compression Age, Readiness Score, Expansion Side, Risk Edge, and Action.
🚦 Signals & States
• READY WATCH → compression is mature, biased, and risk edge distance is balanced enough for active review.
• WATCH → compression is developing, but at least one readiness component remains incomplete.
• EDGE REVIEW → price has moved beyond the compression edge and the user should verify the close and broader context.
• PREMATURE → compression has not lasted long enough to build strong maturity.
• HOT RISK → volatility has expanded too aggressively for clean readiness interpretation.
• NO BIAS → compression exists, but the directional side is not clear enough in Auto mode.
• INVALID EDGE → price crossed the active invalidation edge and the prior context may need reset.
🔔 Alerts Logic
Alerts trigger when the planner enters READY WATCH, WATCH, EDGE REVIEW, HOT RISK, or INVALID EDGE state.
These alerts are attention markers. They are not trade instructions, entry signals, broker actions, or automated strategy commands.
🧩 Confluence Logic
The strongest readiness state appears when multiple components align:
Range contraction + ATR compression + pivot tightening + volume dry-up + directional side bias + balanced risk edge.
When those components improve together, the score can rise toward READY WATCH. If volatility becomes too hot, risk becomes distorted, or the active edge fails, the state downgrades.
📊 When to Use
• Before evaluating a possible breakout setup
• During narrow ranges where volatility is compressing
• Around coiling structures that need maturity review
• When comparing whether one compression range is cleaner than another
• On liquid symbols where range, ATR, and volume behavior are meaningful
⚠️ When NOT to Use
• Extremely low-liquidity markets
• Highly noisy micro-timeframes
• News-driven volatility spikes
• Symbols with unreliable or missing volume data
• Situations where the user wants a simple breakout arrow or automated trade signal
🎛️ Key Inputs
• Breakout Watch Side → selects Auto, Bullish Watch, or Bearish Watch evaluation.
• Compression Lookback → defines the active range used for readiness scoring.
• ATR Baseline → controls volatility compression comparison.
• Volume Dry-Up Length → evaluates whether participation is contracting inside compression.
• Minimum Compression Age → controls how mature a range must be before stronger readiness states appear.
• READY / WATCH Thresholds → adjust how selective the planner is.
• Visual settings → control compression box, breakout corridor, range edges, invalidation edge, projection length, labels, and candle tint.
• Panel settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The compression box uses centered text so the user can read score and age directly inside the structure. The breakout corridor provides a clean forward planning reference without filling the chart with many competing levels.
The AGPro panel uses a single merged blue header row and a compact five-row decision layout. Label and panel font sizes are adjustable, with Normal as the default.
🧪 Practical Usage Workflow
1. Read the panel Readiness Score and Action.
2. Check whether the compression box is mature or premature.
3. Review the Expansion Side and breakout watch corridor.
4. Compare the Risk Edge with the visible structure.
5. Treat labels and alerts as review prompts, not trade commands.
🔍 Interpretation Guidelines
A higher score means the script sees stronger compression maturity according to its rule set.
READY WATCH does not mean price must break out. It means the compression context is organized enough to deserve attention.
WATCH means the structure may be developing but is not fully mature.
HOT RISK and INVALID EDGE are caution states. They warn that the range may no longer be clean enough for the same readiness read.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed signals.
It is not a generic squeeze indicator.
It is not a choppiness dashboard.
It is not a support/resistance scanner.
It is not a direct breakout entry tool.
⚠️ Limitations & Transparency
Compression quality depends on the selected lookback, timeframe, volatility baseline, and market condition.
Volume dry-up may be less reliable on symbols with inconsistent exchange volume.
Fast volatility expansion can quickly change the readiness state.
Different timeframes can show different compression ranges and side-bias context.
The script is rule-based and should be interpreted as an analytical planning layer, not as certainty.
🧠 Market Context Notes
Compression by itself is not enough.
A useful breakout watch context also needs maturity, reduced noise, a readable side, and a practical invalidation edge.
This script keeps those elements visible so users can review breakout readiness before reacting emotionally to a candle crossing a range edge.
🧾 Use Case Examples
When a range contracts, ATR falls below baseline, volume dries up, and side bias becomes clear, the planner may move toward WATCH or READY WATCH.
When price pushes beyond the edge while readiness is acceptable, the script can mark EDGE REVIEW so the user can verify the close and broader context.
When ATR expands too aggressively before structure is mature, the planner can show HOT RISK instead of treating every move as a clean breakout context.
🧱 System Philosophy
Compression Breakout Readiness follows the AGPro Series decision-engine approach:
Context first.
Readiness before reaction.
Risk edge before target guide.
Attention markers instead of promises.
🔐 Non-Promise Statement
No script can remove uncertainty.
No state, score, label, alert, box, corridor, or line should be interpreted as guaranteed market direction.
📉 Risk Disclosure
Trading involves risk.
All decisions remain the responsibility of the user.
This script is for educational and analytical chart review only and does not provide financial advice.
📚 Educational Note
Use the script to study how compression matures, weakens, breaks, or invalidates around range edges. The strongest reading comes from combining the panel state with the visible chart structure and broader market context.
Indicator
Volatility Expansion Planner [AGPro Series]Volatility Expansion Planner
🧠 Core Idea
Is volatility expanding with structure, or is the chart only producing random noise?
📌 Overview / What it does
Volatility Expansion Planner is a chart-first volatility expansion and breakout quality tool built to evaluate whether a release from compression has enough structure to deserve active attention.
Instead of showing another generic expansion signal, the script studies ATR expansion, prior range release, close efficiency, volume support, trend alignment, compression age, and the active risk shelf behind the move. These components are converted into a 0-100 Expansion Score and a clear next-action state.
The script produces an expansion corridor, ATR expansion band, prior range edge, risk shelf, compact quality labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that an expansion will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to separate structured volatility expansion from unstable noise.
Many volatility tools identify compression, release, or regime changes, but they often stop before answering the practical planning question: is the expansion clean enough to evaluate, and where is the risk reference if the release fails?
The design philosophy is simple: volatility expansion is only useful when it has structure, confirmation, and a readable risk shelf.
⚡ Why This Script Is Different
Most tools focus on squeeze dots, volatility regime labels, ATR readings, or basic breakout markers.
This script does NOT clone a Squeeze Momentum Indicator, does not rebuild an ATR Compression Map, and does not act as a generic breakout signal.
Instead, it evaluates whether expansion is structurally supported. The main output is not a trade command. It is a planning state that helps users distinguish STRUCTURED expansion from WATCH, RISK REVIEW, NOISE, or WAIT conditions.
⚙️ Methodology
1. Context Detection
The script reads the active expansion side using prior range release and trend context, or lets the user force long-side or short-side expansion planning.
2. Reference Mapping
It maps the prior range edge, current ATR expansion, compression age, risk shelf, and projected expansion corridor.
3. Reaction Evaluation
The model scores ATR expansion, range breakout, close efficiency, volume support, trend alignment, compression maturity, and risk shelf quality.
4. Visual Output
The result is displayed through an expansion corridor, ATR band, range edge, risk shelf, compact labels, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the expansion corridor shows the projected release path from the prior range edge toward a measured target guide. Its label is centered inside the corridor.
Labels = compact state markers show STRUCTURED, WATCH, RISK REVIEW, NOISE, or SHELF CHECK context.
Colors = green highlights cleaner structured expansion, pink highlights unstable expansion risk, amber highlights review conditions, and indigo highlights watch conditions.
Panel = the panel summarizes Expansion Score, Squeeze Age, Confirmation, Risk Shelf, and Action.
🚦 Signals & States
• STRUCTURED → volatility is expanding with range release, confirmation, and a usable risk shelf.
• WATCH → expansion context is improving but confirmation is incomplete.
• RISK REVIEW → expansion is active but the risk shelf is too tight or too wide for clean planning.
• NOISE → volatility is hot or inefficient and may represent unstable movement.
• WAIT → the script does not detect a strong enough expansion context yet.
• SHELF CHECK → price crossed the prior risk shelf and the expansion context should be reviewed.
🔔 Alerts Logic
Alerts trigger when the planner enters STRUCTURED expansion, WATCH state, NOISE state, RISK REVIEW state, or when price crosses the prior risk shelf.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The strongest context appears when ATR expands from a prior compressed structure, price closes beyond the prior range edge, candle efficiency is strong, volume support improves, trend alignment agrees with the expansion side, and the risk shelf remains readable.
When these components align, the Expansion Score improves and the state can move from WATCH to STRUCTURED.
📊 When to Use
• Before evaluating volatility expansion after a quiet range
• During breakout or continuation attempts where expansion quality matters
• When price releases from a prior structure but confirmation is uncertain
• When comparing whether an expansion has clean risk context or only noisy movement
• On liquid symbols where range, volume, and ATR behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles
• Extremely noisy micro-timeframes
• News-driven spikes where ATR expands abruptly without structure
• Markets where volume is unreliable and price gaps distort the risk shelf
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Expansion Side → controls Auto, Long Expansion, or Short Expansion mode.
• Prior Range Lookback → controls how the script maps the range edge before release.
• ATR Baseline → controls how current volatility is compared with normal volatility.
• Minimum Squeeze Age → defines how mature compression should be before stronger expansion scoring.
• Risk Shelf Lookback → controls the shelf used behind the expansion for planning context.
• STRUCTURED Threshold → sets the minimum score required for the strongest state.
• Label and Panel Font Size → controls chart labels, corridor text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The expansion corridor gives the main visual story. The range edge and risk shelf define the practical planning frame. The ATR band adds volatility context without turning the script into a lower-pane oscillator.
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 Expansion Score.
2. Check whether price is releasing from the prior range edge.
3. Review the risk shelf distance and confirmation state.
4. Compare the expansion corridor with broader structure.
5. Treat alerts as attention markers, then evaluate the broader market context.
🔍 Interpretation Guidelines
Think in terms of expansion quality, not prediction.
A stronger score means multiple structural conditions are aligned. A weaker score means expansion may be premature, poorly confirmed, too hot, or difficult to plan around.
RISK REVIEW is especially important because volatility can expand while the practical risk reference remains too tight, too wide, or unclear.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a Squeeze Momentum clone
• Not an ATR Compression Map clone
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, range, and volume behavior.
Timeframe differences can change how compression and expansion appear. 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 and liquidity context.
🧠 Market Context Notes
Volatility expansion is most useful when it appears after a readable compression phase and respects a clear structural shelf.
Expansion without shelf clarity can still move, but it is harder to plan around. Expansion with poor close efficiency or excessive ATR heat can be noisy even when price breaks a range edge.
🧾 Use Case Examples
When price closes beyond a prior range edge with rising ATR, improved volume support, efficient candle structure, and a defined risk shelf, the planner may classify the move as STRUCTURED.
When ATR expands sharply but candles close poorly and the shelf is too far away, the planner may classify the context as NOISE or RISK REVIEW.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning volatility expansion into a structured planning question: Is the release clean, confirmed, and readable enough to deserve attention?
🔐 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 volatility behaves after compression, how expansion quality changes across timeframes, and how risk shelf clarity affects the readability of a move.
Indicator
Pre-Breakout Pressure Planner [AGPro Series]Pre-Breakout Pressure Planner
🧠 Core Idea
Is pressure building before a breakout, or is the setup still premature?
📌 Overview / What it does
Pre-Breakout Pressure Planner is a chart-first breakout readiness tool designed to evaluate pressure before price leaves a range.
The script maps an active pressure box, upper and lower trigger corridors, directional buildup side, volume support, fakeout-risk context, invalidation reference, and target-room projection. These factors are converted into a 0-100 Pressure Score with a clear next-action state such as Bull Pressure, Bear Pressure, Coil Watch, Premature, Fakeout Risk, or Trigger Review.
It does not predict breakouts, automate entries, or confirm post-breakout acceptance. It is built to help traders organize the pre-breakout decision process before reacting to price movement.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate whether a breakout setup is becoming valid before the breakout actually happens.
Many traders notice a range only after price has already moved. This tool focuses on the earlier planning phase: Is the range compressed? Is one side applying pressure? Is volume supportive? Is the candle behavior constructive? Is there fakeout risk near the boundary?
The design supports a planning mindset. It helps the user read pressure quality, risk location, target room, and next-action context without turning the chart into a generic signal board.
⚡ Why This Script Is Different
Most breakout tools focus on the moment price breaks a level.
This script does NOT focus on post-breakout confirmation, measured move corridors, generic support/resistance boxes, or simple buy/sell labels.
Instead, it evaluates the setup before the break. The core question is whether pressure is building in a structured way or whether the range is still too early, too wide, too weak, or vulnerable to a fakeout.
This keeps the concept separate from consolidation breakout tools. The purpose is not to grade a completed breakout. The purpose is to organize the pre-breakout readiness window.
⚙️ Methodology
1. Context Detection
The script builds a live pressure range from prior bars and evaluates whether price remains inside the active box, probes a boundary, or enters a trigger corridor.
2. Reference Mapping
It maps the pressure box, upper trigger corridor, lower trigger corridor, active-side invalidation reference, and projected target-room reference.
3. Reaction Evaluation
The model scores range compression, higher-lows or lower-highs buildup, relative volume behavior, candle pressure, and close location inside the box.
4. Visual Output
The script displays the active pressure box, centered status label, trigger corridors, optional risk/target guides, compact event labels, alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Pressure Box = the active range where pre-breakout pressure is being evaluated.
Trigger Corridors = narrow upper and lower zones where breakout review becomes relevant.
Risk / Target Guides = active-side invalidation and target-room references used for planning context.
Labels = compact state markers showing pressure, watch, fakeout risk, or trigger-review context.
Colors = teal supports bullish buildup, pink supports bearish buildup, amber marks neutral or developing pressure, and red marks elevated fakeout risk.
Panel = summarizes Pressure Score, Buildup Side, Volume Support, Fakeout Risk, Risk / Target, and Action.
🚦 Signals & States
• Bull Pressure → bullish buildup is forming inside the pressure box near the upper trigger context.
• Bear Pressure → bearish buildup is forming inside the pressure box near the lower trigger context.
• Coil Watch → compression or pressure exists, but the directional side is not clear enough yet.
• Premature → the setup does not yet meet the pressure score or structural requirements.
• Fakeout Risk → a boundary probe appears with weak support, poor candle pressure, or elevated rejection risk.
• Trigger Review → price has entered or crossed a trigger corridor and deserves context review.
🔔 Alerts Logic
Alerts can trigger when bullish pressure appears, bearish pressure appears, fakeout risk appears, or price enters trigger-review context.
Each alert is an attention marker. Alerts are not trade instructions, entry commands, exit commands, or automated strategy rules.
🧩 Confluence Logic
The strongest pressure read appears when multiple conditions align:
Range compression + directional buildup + supportive relative volume + constructive candle pressure + close location near the active trigger side.
When these conditions weaken, the planner can shift toward Coil Watch, Premature, or Fakeout Risk.
📊 When to Use
• Before evaluating a potential range breakout.
• During tight ranges where pressure may be building on one side.
• Around breakout watchlists where fakeout risk needs context.
• During volatility compression before expansion attempts.
• On liquid symbols where ATR, range boundaries, and relative volume are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity symbols with unreliable candles or volume.
• Very noisy micro-timeframes where range boundaries change too often.
• News-driven volatility spikes where pre-breakout pressure can distort quickly.
• Markets where the recent range is too wide to represent meaningful compression.
• As a standalone reason to enter or exit a trade.
🎛️ Key Inputs
• Pressure Range Lookback → controls the prior range used to build the active pressure box.
• Buildup Slope Lookback → controls how the script measures rising lows or falling highs.
• Sensitivity → changes how strict the compression model is.
• Minimum Pressure Score → sets the score needed for Bull Pressure or Bear Pressure states.
• Volume Support Level → defines constructive relative volume before breakout.
• Trigger Corridor ATR Width → controls the size of the upper and lower trigger corridors.
• Invalidation Buffer ATR → controls the active-side invalidation reference.
• Target Room Multiple → projects target-room context from the pressure range height.
• Visual settings → control boxes, guides, labels, panel visibility, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is designed to be chart-first.
The main visual object is the active pressure box with a centered status label. Trigger corridors are narrow and controlled so the chart does not become a generic zone map. Event labels are compact, offset away from candles, and limited by cooldown and maximum-visible settings.
The AGPro panel follows the standard publication layout with a single merged blue title row, adjustable panel location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Read the panel Pressure Score and Action.
2. Check whether the pressure box is tight or still too wide.
3. Review the Buildup Side and Volume Support rows.
4. Check whether Fakeout Risk is Low, Moderate, or Elevated.
5. Compare the active trigger corridor with invalidation and target-room context.
6. Treat labels and alerts as attention markers inside broader analysis.
🔍 Interpretation Guidelines
A high Pressure Score means the pre-breakout setup is more organized according to the script's rule set. It does not mean price must break out.
Bull Pressure and Bear Pressure describe directional buildup, not guaranteed direction.
Fakeout Risk means the boundary behavior deserves caution and context review. It does not mean a breakout cannot continue later.
Trigger Review means price is interacting with a corridor. It is a review state, not a command.
🚫 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 post-breakout confirmation engine.
• Not a generic support/resistance zone map.
• Not an order-block, FVG, or supply/demand scanner.
⚠️ Limitations & Transparency
The script depends on selected lookback values, ATR normalization, relative volume behavior, and current timeframe.
Different symbols may compress differently. Some markets can show pressure for a long time before expansion. Others may probe a boundary and return inside the range several times.
The model is rule-based. Outputs should always be interpreted with broader structure, volatility, liquidity, and trader-defined risk controls.
🧠 Market Context Notes
Pre-breakout pressure is useful because the quality of a range can change before the breakout candle appears.
Rising lows can show pressure toward the upper boundary. Falling highs can show pressure toward the lower boundary. Volume support and candle pressure help judge whether that buildup is constructive or weak.
The script organizes these factors into a clean planner view so the user can decide whether the setup deserves attention, patience, or caution.
🧾 Use Case Examples
When price remains inside a tight range and the panel shifts to Bull Pressure with supported volume, the upper trigger corridor becomes the main review area.
When price presses into a boundary but the panel shows Elevated Fakeout Risk, the user can recognize that the probe may be weak or vulnerable to rejection.
When the score stays low and the state remains Premature, the range may need more time before it deserves attention.
🧱 System Philosophy
Pre-Breakout Pressure Planner follows the AGPro decision-engine approach: a script should help traders evaluate setup quality, risk, target 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 before the chart forces a decision.
🔐 Non-Promise Statement
No script can guarantee direction, continuation, breakout success, or outcome.
This tool provides structured pre-breakout 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 pressure builds inside ranges before breakout attempts.
The strongest learning value comes from comparing the panel state, pressure box, trigger corridors, and fakeout-risk labels with the broader chart context.
Indicator
