OPEN-SOURCE SCRIPT
업데이트됨 Candle Expansion Readiness [AGPro Series]
Candle Expansion Readiness [AGPro Series]
🧠 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 [AGPro Series] 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.
🧠 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 [AGPro Series] 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.
릴리즈 노트
🔧 UPDATE NOTES - V1.1This update focuses on readability, visual structure, panel clarity, and chart interpretation.
The core purpose of the script remains unchanged.
This release improves how the existing candle expansion 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
------------------------
• Refined the expansion map presentation
The active follow-through zone now uses a separate centered status badge instead of relying on low-contrast zone text.
• Improved label hierarchy
Event labels now use clearer premium wording, stronger contrast, and safer candle offsets for better public chart readability.
• Optimized panel flow
The panel now includes a cleaner workflow row, merged blue header, score context, follow-through status, and next-action review language.
• Reduced visual clutter
Default object retention and label spacing were tuned to keep the chart informative without becoming crowded.
• Improved theme compatibility
Panel colors, labels, and centered badges were adjusted for better readability on both dark and light chart layouts.
------------------------
Visual Improvements
------------------------
• Improved chart readability by separating the follow-through zone from its centered status badge
• Reduced overlap risk between labels, candles, and active expansion guides
• Refined visual hierarchy so the active expansion map, risk edge, labels, and panel are easier to scan
• Adjusted label language and casing for a more polished publication-style appearance
------------------------
Interface & Usability
------------------------
• Added a clearer workflow row to the panel
• Preserved panel show/hide, location, theme, and font-size controls
• Preserved chart label font-size control for event labels and centered expansion badges
• Kept the panel header as a single merged blue row for AGPro Series consistency
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The goal is to improve clarity and usability, not to introduce new predictive behavior.
Users should interpret outputs the same way as before, but with improved visual structure and cleaner chart context.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may affect how readiness 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.
릴리즈 노트
UPDATE NOTES - 1.2This update focuses on chart readability, label consistency, active-plan clarity, and panel usability.
The core purpose of the script remains unchanged.
This release improves how the existing candle expansion readiness 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
------------------------
- Rebuilt the active expansion map presentation.
The follow-through box now uses a cleaner centered badge with shorter text, reducing cramped label behavior around the active candle map.
- Added optional Risk / Target right-side tags.
The active risk edge and target guide are easier to read without forcing users to inspect only the panel.
- Refined label density defaults.
The default visible event-label memory was increased while sparse context labels are now enabled in a controlled way, helping charts avoid a nearly empty appearance without turning into label spam.
- Improved label consistency.
All chart labels, centered badges, and right-side tags now use the same selected chart label font size.
- Expanded the panel from a crowded compact layout into a cleaner 8-row workflow panel.
Body, wick, volume, follow-through, risk edge, target guide, and review context are easier to scan.
------------------------
Visual Improvements
------------------------
- Improved chart readability by shortening active map badge text.
- Reduced overlap risk between event labels and active follow-through map labels.
- Added clearer visual hierarchy for risk edge, target guide, and expansion state.
- Kept zone text out of box text and preserved the separate centered badge approach.
- Adjusted default label offset to keep labels close enough to candles while remaining readable.
------------------------
Interface & Usability
------------------------
- Panel show/hide, location, theme, and font-size controls remain available.
- Label font-size control remains available and now applies consistently across all chart labels.
- Target guide is enabled by default for a more complete planning footprint.
- Risk and target tags can be toggled from Chart Visuals.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical identity of the script.
The readiness score still evaluates body efficiency, wick control, relative volume, ATR expansion, close-location quality, and range context.
Users should interpret outputs the same way as before, but with improved visual structure and clearer active-plan context.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may affect how readiness 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.
릴리즈 노트
UPDATE NOTES - Version 1.3This update focuses on adding a confirmation-anchored proof layer to the readiness model.
The core purpose of the script remains unchanged.
This release adds a proof layer that measures how often Ready expansion candles followed through
toward the target guide before the risk edge was lost, and it tidies the panel so the readiness
read stays compact.
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 a Proof Layer (Follow / Hold / React / Flip)
The panel now reports how reliably Ready expansion candles followed through on the current symbol
and timeframe. Each time the readiness model enters the Ready state, that candle is tracked
forward over a configurable horizon, with the Ready close as the entry, the candle risk edge as
the risk reference, and a one risk unit (1R) target capped at the target guide:
- Follow Rate : share of Ready candles that continued one risk unit toward the target guide
before the risk edge was lost
- Hold Rate : share whose risk edge was not lost through resolution
- React Rate : share that produced an early favorable follow-through reaction
- Flip Rate : share whose risk edge was lost within the horizon (the follow-through failed)
A sample size (n) is shown so the rates are read in context, and they display as "building" only
until the first Ready candle resolves.
* Streamlined the panel
The previous standalone Review row duplicated the Workflow next-step and the side already shown
in the State row, so it was removed. The freed space now carries the proof layer, keeping the
panel focused on readiness, risk, follow-through, and proof.
* Added hidden proof outputs
Follow, Hold, React, and Flip rates are exported as hidden plots so they can be used in alerts
and screeners without adding chart clutter.
------------------------
Visual Improvements
------------------------
* Reduced panel redundancy by removing the duplicate next-action row.
* Preserved the readiness candle glow, follow-through box, centered expansion badge, risk edge,
target guide, and right-side Risk and Target tags.
* Kept label density controlled with the existing cooldown, sparse context, and retained-label
limits.
------------------------
Behavior Notes
------------------------
This update does not change the core readiness logic of the script.
The proof rates are descriptive statistics of Ready expansion candles on the current symbol and
timeframe. They measure how often a Ready candle followed through one risk unit toward the target
guide before its risk edge, not trade performance, and they do not change how the readiness
score, states, risk edge, target guide, or follow-through outcomes are produced.
Users should interpret outputs the same way as before, now with added reliability context.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Proof rates depend on the available history and on how many Ready candles occurred on the current
symbol and timeframe; a small sample (low n) should be treated with caution. Each Ready candle is
counted once, with the close entry, candle risk edge, and 1R target frozen at the Ready bar.
Market conditions such as volatility, liquidity, and timeframe differences may affect how Ready
candles and rates 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.
오픈 소스 스크립트
트레이딩뷰의 진정한 정신에 따라, 이 스크립트의 작성자는 이를 오픈소스로 공개하여 트레이더들이 기능을 검토하고 검증할 수 있도록 했습니다. 작성자에게 찬사를 보냅니다! 이 코드는 무료로 사용할 수 있지만, 코드를 재게시하는 경우 하우스 룰이 적용된다는 점을 기억하세요.
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
면책사항
해당 정보와 게시물은 금융, 투자, 트레이딩 또는 기타 유형의 조언이나 권장 사항으로 간주되지 않으며, 트레이딩뷰에서 제공하거나 보증하는 것이 아닙니다. 자세한 내용은 이용 약관을 참조하세요.
오픈 소스 스크립트
트레이딩뷰의 진정한 정신에 따라, 이 스크립트의 작성자는 이를 오픈소스로 공개하여 트레이더들이 기능을 검토하고 검증할 수 있도록 했습니다. 작성자에게 찬사를 보냅니다! 이 코드는 무료로 사용할 수 있지만, 코드를 재게시하는 경우 하우스 룰이 적용된다는 점을 기억하세요.
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
면책사항
해당 정보와 게시물은 금융, 투자, 트레이딩 또는 기타 유형의 조언이나 권장 사항으로 간주되지 않으며, 트레이딩뷰에서 제공하거나 보증하는 것이 아닙니다. 자세한 내용은 이용 약관을 참조하세요.