Volume Follow-Through Planner [AGPro Series]Volume Follow-Through Planner
🧠 Core Idea
Did high volume create real continuation, or was it only a one-bar event?
📌 Overview / What it does
Volume Follow-Through Planner is a decision-oriented volume analytics overlay built to evaluate what happens after a qualified high-volume candle appears.
Instead of only marking volume spikes, the script opens a follow-through review window, measures next-bar progress, spread quality, close location, trend-side alignment, risk-rail defense, target-room progress, and converts the result into a 0-100 follow-through score.
It produces volume event labels, a forward follow-through box, a centered box label, a risk rail, a target-room guide, continuation/failure state labels, optional target-review labels, alert conditions, and a compact AGPro planning panel. It does not predict future price, automate execution, or claim that a high-volume event must continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want volume to answer a practical planning question: did the event actually create usable continuation context?
Many volume tools stop at detection. They show that volume was high, but they do not explain whether later candles accepted, extended, failed, or faded after the event.
Volume Follow-Through Planner fills that gap by treating volume as the start of a review process, not the final answer. The goal is a cleaner decision layer: event quality, follow-through quality, risk edge, bias context, and next action.
⚡ Why This Script Is Different
Most volume tools focus on identifying spikes, climaxes, absorption, or simple participation changes.
This script does NOT try to clone Volume Climax Detector, Volume Absorption Zones, Breakout Volume Quality, or a generic breakout scanner.
Instead, it focuses on post-event behavior. The volume event must be strong enough to matter, but the main question is what happens next: continuation, weak follow-through, risk building, target review, or failure.
⚙️ Methodology
1. Context Detection
The script measures local relative volume against a rolling volume baseline, normalizes candle spread by ATR, checks body quality, close location, and trend-side alignment.
2. Reference Mapping
When a qualified event appears, the script anchors a follow-through box from the event close toward a target-room guide and places a risk rail beyond the event candle.
3. Reaction Evaluation
During the review window, the planner measures next-bar progress, favorable movement, adverse movement, follow-through closes, rail defense, and time efficiency.
4. Visual Output
The result is converted into a 0-100 follow-through score, chart labels, centered box text, guide lines, panel rows, and alert conditions.
🗺️ How to Read the Chart
Zones = the follow-through box projected from the event close toward the target-room guide.
Labels = volume event, follow-through ready, one-bar event, target review, or failed event states.
Colors = teal for constructive bullish context, pink for constructive bearish context, yellow for caution, and indigo for target/strong review states.
Panel = compact decision summary showing Volume Event, Follow-Through, Spread Quality, Bias, and Action.
Risk rail = the invalidation reference behind the event candle. A confirmed close beyond it marks the active event as failed.
🚦 Signals & States
• Volume Event → a qualified high-volume candle opened a follow-through review.
• FT WATCH → the event is active but still needs more progress.
• FT READY → follow-through quality reached the planner threshold.
• RISK BUILDING → adverse movement is rising while the event is still active.
• ONE-BAR EVENT → volume appeared, but follow-through did not develop enough inside the review window.
• FAILED → price closed beyond the risk rail.
• TARGET REVIEW → the event reached the target-room guide and should be reviewed in context.
🔔 Alerts Logic
Alerts trigger when a qualified volume event appears, when follow-through reaches the ready threshold, when the risk rail is broken, when the target-room guide is reached, and when an event becomes a one-bar event.
Alerts are attention markers. They are not trade instructions, entry rules, or automated execution logic.
🧩 Confluence Logic
The strongest context appears when relative volume, spread quality, close location, next-bar progress, follow-through closes, and trend-side bias align.
When the event has strong participation but weak progress, the planner reduces the follow-through score instead of treating volume alone as enough.
📊 When to Use
• After noticeable participation expansion
• During directional continuation attempts
• Around strong candle events that need confirmation from later bars
• On liquid instruments with reliable volume data
• When the main question is whether volume created continuation or only temporary attention
⚠️ When NOT to Use
• Very low-liquidity symbols
• Charts with unreliable or missing volume data
• Extremely noisy micro timeframes
• Markets where one candle can distort volume baselines
• Conditions where the user needs a full volume profile, absorption zone, or climax detector instead
🎛️ Key Inputs
• Sensitivity → controls how demanding the volume event gate is.
• Volume Lookback → defines the baseline used for relative volume.
• Minimum Planner Score → sets the FT READY threshold.
• Follow-Through Window → controls how many bars are used for early review.
• Risk Rail Buffer → adjusts the invalidation reference behind the event candle.
• Target Guide ATR → controls the projected target-room guide.
• Cooldown Bars → limits repeated events around the same move.
• Visual settings → control labels, optional target-review labels, boxes, guide lines, panel location, panel theme, and font sizes.
🖥️ Interface & Visual Design
The panel is designed as a compact planning cockpit rather than a data dump.
The first row uses the AGPro blue merged header style, while the rows below focus only on the decision fields needed for fast interpretation.
The chart visuals are intentionally moderate: enough labels to make the chart feel active, but controlled by cooldown, maximum visible objects, and spacing settings.
🧪 Practical Usage Workflow
1. Read the panel and check whether a volume event is active.
2. Inspect the follow-through box and risk rail.
3. Watch whether price progresses beyond the event close or fades back toward the rail.
4. Use the Follow-Through score and Action row as context for further review.
5. Confirm the broader market structure, volatility, and liquidity environment separately.
🔍 Interpretation Guidelines
Think of the first volume event as a question, not an answer.
Strong follow-through means the event received continuation support. Weak follow-through means volume did not yet translate into useful directional progress. A failed event means the risk rail was broken and the original event context should be rejected.
The score is a planning aid. It should be interpreted with market structure, higher-timeframe context, and risk controls.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a volume climax detector
• Not an absorption zone map
• Not a generic support/resistance tool
⚠️ Limitations & Transparency
Volume quality depends on the chart symbol and exchange feed.
Timeframe changes can materially alter event frequency, volume baselines, and follow-through behavior.
Extreme volatility can make the risk rail or target-room guide less stable.
The script is rule-based and cannot understand news, liquidation cascades, macro events, or hidden order flow.
🧠 Market Context Notes
High volume is most useful when later candles confirm that participation had directional effect.
If price cannot progress after the event, the volume may represent temporary effort, late participation, absorption-like behavior, or simple noise.
This script focuses on that after-event evaluation.
🧾 Use Case Examples
When a strong bullish volume event appears and later candles close above the event close, the follow-through score can improve toward FT READY.
When a bearish volume event appears but price immediately reclaims the event area and breaks the rail, the state can shift to FAILED.
When volume expands but price stays trapped near the event close, the state can become ONE-BAR EVENT.
🧱 System Philosophy
The AGPro planner style is built around decision quality.
A chart tool should not only show what happened. It should help the user evaluate validity, strength, risk, target room, and the next state to monitor.
🔐 Non-Promise Statement
No script can provide certainty.
No signal, state, score, label, or alert guarantees a future outcome.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution, risk management, and decisions.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the planner to study how volume events behave after they appear. The most important information is often not the event itself, but whether later candles confirm, weaken, or invalidate it.
Indicador Pine Script®



