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.
Pine Script® indicator






















