Candle Expansion Readiness [AGPro Series]Candle Expansion Readiness
🧠 Core Idea
Is the current candle expansion meaningful enough to monitor, or is it only a noisy wide candle?
📌 Overview / What it does
Candle Expansion Readiness is a chart-first candle quality planner built to evaluate whether an active expansion candle has enough structure to deserve attention.
Instead of treating every wide candle as important, the script studies body efficiency, wick control, relative volume, ATR-normalized expansion, recent range behavior, and close location. These components are converted into a 0-100 Expansion Readiness Score with a clear state: READY, WATCH, FADE RISK, or WAIT.
The script produces expansion candle labels, a forward follow-through box, risk edge, target guide, failure/fade states, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that an expansion candle will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want a cleaner way to judge expansion candles before reacting to them.
The gap it fills is practical: many candle tools mark a candle after it appears, but they do not explain whether that candle is efficient, supported, close-positioned, and monitorable. Candle Expansion Readiness turns that moment into a structured planning question.
The design supports a decision-first workflow: read the candle quality, check whether follow-through is developing, identify the risk edge, and decide whether the context deserves more attention.
⚡ Why This Script Is Different
Most tools focus on large candles, volume spikes, engulfing patterns, institutional candle labels, or general breakout signals.
This script does NOT clone Institutional Candle Detector, does not classify candles into institutional taxonomies, does not build an absorption system, and does not act as a generic breakout-volume tool.
Instead, it evaluates the current expansion candle as a readiness event. The output is not a trade command. It is a planning state that helps users separate monitorable expansion from weak, noisy, or fading candle behavior.
⚙️ Methodology
1. Context Detection
The script reads the active candle side from candle direction and close behavior, or lets the user force bullish or bearish readiness mode.
2. Reference Mapping
It maps the expansion candle, risk edge, follow-through window, and target guide.
3. Reaction Evaluation
The model scores body efficiency, wick control, relative volume, ATR expansion, recent range expansion, and directional close location.
4. Visual Output
The result appears through compact labels, candle glow, a forward follow-through box, risk edge, target guide, deterministic alerts, and the AGPro planning panel.
🗺️ How to Read the Chart
Zones = the follow-through box shows the monitored area from the expansion risk edge toward the target guide. Its label is centered inside the box.
Labels = compact markers show READY, WATCH, DOWNGRADE, CONFIRMED, INVALID, or FADED context.
Colors = green highlights stronger bullish readiness or confirmation, pink highlights bearish or invalidated context, amber highlights caution, and indigo highlights watch behavior.
Panel = the panel summarizes Candle Efficiency, Volume Support, Expansion Score, Follow-Through, and Action.
🚦 Signals & States
• READY → candle expansion quality is strong enough to monitor.
• WATCH → candle quality is improving but confirmation is incomplete.
• FADE RISK → the candle expanded, but wick or close behavior is weak.
• CONFIRMED → follow-through reached the active target guide.
• INVALIDATED → price crossed the active risk edge.
• FADED → the follow-through window expired without confirmation.
• WAIT → no strong enough expansion context is active.
🔔 Alerts Logic
Alerts trigger when the planner enters READY state, downgrades from READY or WATCH, crosses the active risk edge, confirms at the target guide, or fades after the follow-through window.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The readiness state becomes stronger when body efficiency, close location, relative volume, ATR expansion, and wick control align on the same candle.
When those elements align and the follow-through box remains active without risk-edge violation, the candle context becomes cleaner. When the score is high but follow-through fails, the planner intentionally downgrades the context instead of ignoring the failure.
📊 When to Use
• Active intraday or swing charts where candle expansion matters.
• Breakout attempts where candle quality needs review.
• Continuation moves that require follow-through monitoring.
• Reversal attempts where the trader wants to know whether the impulse candle is efficient or noisy.
• Liquid symbols with reliable OHLC and volume data.
⚠️ When NOT to Use
• Very low-liquidity markets with unreliable candles.
• Extremely noisy sessions where wide candles fail repeatedly.
• Symbols with poor or missing volume data if volume support is central to your workflow.
• News-driven spikes where normal candle-quality rules may lose relevance.
• As a standalone entry system without broader market context.
🎛️ Key Inputs
• Sensitivity → controls how strict the readiness model is.
• Expansion Lookback → compares the current candle to recent range behavior.
• READY Threshold → minimum 0-100 score required for READY state.
• Confirmation Mode → controls whether close quality alone is enough or whether volume/edge confirmation is required.
• Follow-Through Bars → defines how long the script monitors the active expansion.
• Risk Edge Buffer ATR → moves the invalidation reference slightly beyond the candle edge.
• Visual settings → control boxes, risk edge, target guide, candle glow, labels, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The panel gives the current decision state without becoming a crowded dashboard. The follow-through box creates a clean visual planning area, while compact labels keep the chart active without burying price candles.
The first panel row follows the AGPro merged blue header standard and shows only the script name.
🧪 Practical Usage Workflow
1. Read the Expansion Score and Action row.
2. Check whether the candle is READY, WATCH, or FADE RISK.
3. If READY appears, inspect the follow-through box and risk edge.
4. Watch whether price confirms, fades, or invalidates.
5. Interpret the result within your broader structure, liquidity, and risk plan.
🔍 Interpretation Guidelines
Think of the script as a candle expansion planner, not a signal caller.
A READY candle deserves attention because its structure is cleaner than average. A WATCH candle needs more evidence. A FADE RISK candle warns that expansion exists, but the candle quality is not clean. INVALIDATED and FADED states are part of the workflow because failed expansion is useful information.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not an institutional candle detector.
• Not an order block, fair value gap, or support/resistance map.
⚠️ Limitations & Transparency
• Timeframe differences can change how expansion candles appear.
• Volatility spikes can temporarily distort candle-quality readings.
• Volume data may differ by exchange, broker, symbol, and feed.
• Follow-through is evaluated through a fixed monitoring window.
• Market conditions can shift after a READY candle appears.
🧠 Market Context Notes
Candle expansion is most useful when interpreted with liquidity, structure, volatility, and location.
The script focuses on the candle itself and the immediate follow-through plan. Traders should still consider broader trend context, nearby levels, session behavior, and event risk.
🧾 Use Case Examples
When a bullish candle closes near its high with strong body efficiency and relative volume, the script may mark READY and project a follow-through box above the risk edge.
When a wide candle has heavy wick behavior and poor close location, the script may flag FADE RISK instead of treating the candle as clean expansion.
When a READY candle fails back through its risk edge, the active plan becomes INVALIDATED.
🧱 System Philosophy
AGPro tools are designed to support structured chart reading. The goal is to convert market behavior into clean, rule-based context that helps traders think more clearly.
Candle Expansion Readiness follows that philosophy by turning a single expansion candle into a monitored planning state.
🔐 Non-Promise Statement
No script can provide certainty.
This tool organizes candle expansion context, but it does not guarantee continuation, reversal, profit, or any specific market outcome.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution, position sizing, and risk management.
Nothing in this script or description is financial advice.
📚 Educational Note
Use the script to study how clean expansion candles behave across different symbols and timeframes. The value is in comparing candle quality, follow-through, and failure behavior over time.
Indicator
