OPEN-SOURCE SCRIPT
Aktualisiert

Volume Follow-Through Planner [AGPro Series]

551
Volume Follow-Through Planner [AGPro Series]

🧠 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.
Versionshinweise
🔧 UPDATE NOTES - V1.2

This update focuses on presentation flexibility, readability, and publication polish.

The core purpose of the script remains unchanged.
This release improves how the existing volume follow-through logic is presented, organized, and interpreted on the chart.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

• Added Box Badge Anchor control
The centered follow-through box badge can now be positioned more precisely inside the projected follow-through lane.

• Added Adaptive HTF Projection
Daily, weekly, and monthly charts now use shorter box and guide projections by default so higher-timeframe screenshots remain balanced.

• Added Slate panel theme
Users can now choose between Elite Dark, Slate, and Clean Light panel themes.

• Expanded panel placement controls
The panel now supports Middle Center in addition to the existing top, middle, and bottom placement options.

• Added Huge font-size support
Chart labels, centered box labels, and panel text now include a Huge option for presentation screenshots.

• Preserved the follow-through engine
Volume event detection, follow-through scoring, risk rail behavior, target review, one-bar event logic, and alerts remain unchanged.


------------------------
Visual Improvements
------------------------

• Improved follow-through box badge placement control

• Reduced oversized projected boxes on higher-timeframe screenshots

• Refined panel theme flexibility for dark, slate, and light chart layouts

• Preserved the original event labels, boxes, guide rails, and EMA context

• Maintained the existing premium chart density without adding unnecessary clutter


------------------------
Interface & Usability
------------------------

• Optimized panel location flexibility for more chart compositions

• Improved label and panel readability for larger presentation views

• Added more font-size control for labels, box badges, and panel text

• Enhanced overall user experience without changing the core analytical model


------------------------
Behavior Notes
------------------------

This update does not change the core analytical logic of the script.

The volume event, follow-through, one-bar, failed-event, target-review, and alert behavior should be interpreted the same way as before.

The goal is to improve clarity and usability, not to introduce new predictive behavior.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, timeframe differences, and volume quality may affect how labels and states appear.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.

Haftungsausschluss

Die Informationen und Veröffentlichungen sind nicht als Finanz-, Anlage-, Handels- oder andere Arten von Ratschlägen oder Empfehlungen gedacht, die von TradingView bereitgestellt oder gebilligt werden, und stellen diese nicht dar. Lesen Sie mehr in den Nutzungsbedingungen.