OPEN-SOURCE SCRIPT
업데이트됨 False Break Trap Planner [AGPro Series]
False Break Trap Planner [AGPro Series]
🧠 Core Idea
Is a breakout still holding, or is it turning into a false-break trap that deserves caution?
📌 Overview / What it does
False Break Trap Planner is a chart-first breakout failure planner built to evaluate range-edge break attempts after price moves beyond a recent high or low boundary.
Instead of only marking that a breakout happened, the script studies whether the move is holding beyond the edge, being reclaimed back into the range, or becoming a confirmed trap-risk context. It produces a 0-100 Trap Risk score, a reclaim state, a break-quality reading, a failure-room estimate, false-break zones, reclaim rails, and target-back guides.
This script does not predict price direction, automate execution, or claim that a failed break must reverse. It organizes the anatomy of a potential false break so traders can review the setup with cleaner context.
🎯 Purpose & Design Philosophy
This script was built for traders who need a practical decision layer around breakout failure, not another generic signal marker.
The gap it fills is the space between a clean breakout tool and a liquidity sweep tool. Many chart tools mark a level break, a wick, or a reclaim. This planner asks what the trader should review next: is the break holding, is reclaim pressure developing, is the failure fast enough to matter, and is there room back inside the range?
The design mindset is structured caution. The script helps users slow down around breakout traps, separate active risk from confirmed failure, and keep risk / target / invalidation context visible.
⚡ Why This Script Is Different
Most tools focus on breakout confirmation, sweep labels, or generic failed-break signals.
This script does NOT try to become a stop-hunt map, liquidity sweep engine, support/resistance zone scanner, or broad breakout system.
Instead, it focuses on one specific workflow: a prior range edge is broken, the break either holds or gets reclaimed, and the planner scores whether that behavior deserves trap-risk review.
⚙️ Methodology
1. Context Detection
The script maps a recent range high and range low from previous bars, then watches for an ATR-normalized break beyond either edge.
2. Reference Mapping
When a break attempt appears, the planner freezes the range edge, opposite edge, midpoint, and false-break extreme so the event can be evaluated consistently.
3. Reaction Evaluation
The model scores breakout failure speed, reclaim strength, wick size, volume spike, and whether price closes back inside the range.
4. Visual Output
The script displays a false-break box, reclaim or fail rail, target-back line, trap confirmation labels, reclaim-watch labels, and a premium AG Pro panel.
🗺️ How to Read the Chart
Zones = the active false-break box between the broken range edge and the failed extension.
Labels = compact state markers such as Upper Break Watch, Lower Break Watch, Reclaim Watch, Upper Trap, Lower Trap, or Break Accepted.
Colors = teal for lower-break trap recovery context, pink for upper-break trap risk, yellow for watch states, indigo for accepted/holding context, and red for confirmed trap-risk pressure.
Panel = a compact decision panel showing Trap Risk, Reclaim State, Break Quality, Failure Room, and Action.
🚦 Signals & States
• Upper Break Watch → price has moved beyond the upper range edge and the break is under review.
• Lower Break Watch → price has moved beyond the lower range edge and the break is under review.
• Reclaim Watch → price is testing back toward or inside the broken edge, but confirmation is not complete.
• Trap Confirmed → the break has closed back inside the range with enough trap-risk score.
• Break Holding → the break is still outside the range and has not reclaimed.
• Break Accepted → the break has held beyond the acceptance window and should not be treated as an active trap by default.
🔔 Alerts Logic
Alerts trigger when the planner detects confirmed upper or lower trap context, upper or lower reclaim-watch context, or break acceptance.
Each alert is an attention marker. It highlights a state transition that may deserve review. It is not a trade instruction and should not be treated as an automated entry or exit signal.
🧩 Confluence Logic
The strongest trap-risk context appears when several factors align:
• Fast failure after the break
• Close back inside the prior range
• Strong wick rejection
• Volume spike during the failed extension
• Clean room back toward the range midpoint
When these align, the panel score rises and the state becomes easier to interpret.
📊 When to Use
• Breakout and breakdown attempts around a recent range
• Markets where false breaks and failed continuations are common
• Intraday or swing charts where range edges are visually relevant
• Review workflows that need caution before chasing a break
• Breakout traders who want a structured invalidation and failure-room layer
⚠️ When NOT to Use
• Extremely low-liquidity instruments
• Very noisy micro timeframes with unreliable candles
• Markets with poor or synthetic volume data
• News-driven volatility where single-bar extremes distort ATR and volume
• Charts where the selected lookback does not represent a meaningful range
🎛️ Key Inputs
• Range Edge Lookback → controls the prior range used for break attempts.
• Minimum Break ATR → defines how far price must move beyond the edge before the planner starts tracking.
• Fast Reclaim Window → controls how many bars can pass before a reclaim becomes less meaningful.
• Trap Confirmed Score → minimum 0-100 score required for a confirmed trap label.
• Break Acceptance Bars → defines when a break should be treated as holding rather than still failing.
• Visual settings → control boxes, rails, target-back lines, label density, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The panel is designed as a clean AG Pro planning cockpit. The first row uses the standard merged blue AGPro header row, followed by five decision rows.
The chart visuals are intentionally focused: one active false-break box, a reclaim rail, a soft fail rail, a target-back line, and controlled labels. The goal is premium readability without turning the chart into a generic level map.
🧪 Practical Usage Workflow
1. Read the panel and check the current Reclaim State.
2. Review the false-break box and identify which edge was broken.
3. Check whether price is holding beyond the edge or closing back inside.
4. Compare Trap Risk with Break Quality.
5. Use the target-back line and failure-room reading as context, not as a forecast.
🔍 Interpretation Guidelines
Think in states, not predictions.
A high Trap Risk score means the attempted break has characteristics often associated with failed continuation. It does not mean the next move is guaranteed.
A strong Break Quality score means the break is still showing participation and close-through behavior. In that context, early fading can be premature.
The cleanest reading appears when Trap Risk is high, Break Quality is weak, and price has closed back inside the range.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a stop-hunt map
• Not a liquidity sweep scanner
• Not a support/resistance zone system
• Not a replacement for risk planning
⚠️ Limitations & Transparency
The active range depends on the selected lookback. A different lookback can produce different edges.
ATR and volume conditions can change quickly during high-volatility periods, which may affect scoring.
Breakout behavior differs across symbols, sessions, and timeframes. A trap-like structure on one market may not behave the same way on another.
The script is rule-based and does not know external news, order flow, or hidden liquidity.
🧠 Market Context Notes
False breaks often become more relevant near visible range edges, crowded breakout levels, and late-stage expansion attempts.
The planner is most useful when combined with broader market context, liquidity conditions, volatility regime, and the trader's own risk rules.
🧾 Use Case Examples
When price breaks above a recent range but closes back inside with a long upper wick and strong volume, the planner may mark Upper Trap context.
When price breaks below a range but quickly reclaims the lower edge, the planner may shift into Lower Trap context.
When price breaks and keeps closing beyond the edge after the acceptance window, the planner may mark Break Accepted instead of forcing a trap interpretation.
🧱 System Philosophy
False Break Trap Planner follows the AGPro Series decision-engine direction: score the setup, identify the state, show the risk reference, show the target-back context, and make the next review step clear.
The script is built to help traders make a structured chart-reading decision, not to add another isolated signal.
🔐 Non-Promise Statement
No script can confirm certainty.
No trap score guarantees reversal, continuation, or profitability.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk controls, and market interpretation.
This script is for educational and analytical use only and does not provide financial advice or guaranteed trading outcomes.
📚 Educational Note
Use the planner as a structured review layer around breakout failure behavior. The best value comes from comparing state, score, failure room, and broader market context together.
🧠 Core Idea
Is a breakout still holding, or is it turning into a false-break trap that deserves caution?
📌 Overview / What it does
False Break Trap Planner is a chart-first breakout failure planner built to evaluate range-edge break attempts after price moves beyond a recent high or low boundary.
Instead of only marking that a breakout happened, the script studies whether the move is holding beyond the edge, being reclaimed back into the range, or becoming a confirmed trap-risk context. It produces a 0-100 Trap Risk score, a reclaim state, a break-quality reading, a failure-room estimate, false-break zones, reclaim rails, and target-back guides.
This script does not predict price direction, automate execution, or claim that a failed break must reverse. It organizes the anatomy of a potential false break so traders can review the setup with cleaner context.
🎯 Purpose & Design Philosophy
This script was built for traders who need a practical decision layer around breakout failure, not another generic signal marker.
The gap it fills is the space between a clean breakout tool and a liquidity sweep tool. Many chart tools mark a level break, a wick, or a reclaim. This planner asks what the trader should review next: is the break holding, is reclaim pressure developing, is the failure fast enough to matter, and is there room back inside the range?
The design mindset is structured caution. The script helps users slow down around breakout traps, separate active risk from confirmed failure, and keep risk / target / invalidation context visible.
⚡ Why This Script Is Different
Most tools focus on breakout confirmation, sweep labels, or generic failed-break signals.
This script does NOT try to become a stop-hunt map, liquidity sweep engine, support/resistance zone scanner, or broad breakout system.
Instead, it focuses on one specific workflow: a prior range edge is broken, the break either holds or gets reclaimed, and the planner scores whether that behavior deserves trap-risk review.
⚙️ Methodology
1. Context Detection
The script maps a recent range high and range low from previous bars, then watches for an ATR-normalized break beyond either edge.
2. Reference Mapping
When a break attempt appears, the planner freezes the range edge, opposite edge, midpoint, and false-break extreme so the event can be evaluated consistently.
3. Reaction Evaluation
The model scores breakout failure speed, reclaim strength, wick size, volume spike, and whether price closes back inside the range.
4. Visual Output
The script displays a false-break box, reclaim or fail rail, target-back line, trap confirmation labels, reclaim-watch labels, and a premium AG Pro panel.
🗺️ How to Read the Chart
Zones = the active false-break box between the broken range edge and the failed extension.
Labels = compact state markers such as Upper Break Watch, Lower Break Watch, Reclaim Watch, Upper Trap, Lower Trap, or Break Accepted.
Colors = teal for lower-break trap recovery context, pink for upper-break trap risk, yellow for watch states, indigo for accepted/holding context, and red for confirmed trap-risk pressure.
Panel = a compact decision panel showing Trap Risk, Reclaim State, Break Quality, Failure Room, and Action.
🚦 Signals & States
• Upper Break Watch → price has moved beyond the upper range edge and the break is under review.
• Lower Break Watch → price has moved beyond the lower range edge and the break is under review.
• Reclaim Watch → price is testing back toward or inside the broken edge, but confirmation is not complete.
• Trap Confirmed → the break has closed back inside the range with enough trap-risk score.
• Break Holding → the break is still outside the range and has not reclaimed.
• Break Accepted → the break has held beyond the acceptance window and should not be treated as an active trap by default.
🔔 Alerts Logic
Alerts trigger when the planner detects confirmed upper or lower trap context, upper or lower reclaim-watch context, or break acceptance.
Each alert is an attention marker. It highlights a state transition that may deserve review. It is not a trade instruction and should not be treated as an automated entry or exit signal.
🧩 Confluence Logic
The strongest trap-risk context appears when several factors align:
• Fast failure after the break
• Close back inside the prior range
• Strong wick rejection
• Volume spike during the failed extension
• Clean room back toward the range midpoint
When these align, the panel score rises and the state becomes easier to interpret.
📊 When to Use
• Breakout and breakdown attempts around a recent range
• Markets where false breaks and failed continuations are common
• Intraday or swing charts where range edges are visually relevant
• Review workflows that need caution before chasing a break
• Breakout traders who want a structured invalidation and failure-room layer
⚠️ When NOT to Use
• Extremely low-liquidity instruments
• Very noisy micro timeframes with unreliable candles
• Markets with poor or synthetic volume data
• News-driven volatility where single-bar extremes distort ATR and volume
• Charts where the selected lookback does not represent a meaningful range
🎛️ Key Inputs
• Range Edge Lookback → controls the prior range used for break attempts.
• Minimum Break ATR → defines how far price must move beyond the edge before the planner starts tracking.
• Fast Reclaim Window → controls how many bars can pass before a reclaim becomes less meaningful.
• Trap Confirmed Score → minimum 0-100 score required for a confirmed trap label.
• Break Acceptance Bars → defines when a break should be treated as holding rather than still failing.
• Visual settings → control boxes, rails, target-back lines, label density, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The panel is designed as a clean AG Pro planning cockpit. The first row uses the standard merged blue AGPro header row, followed by five decision rows.
The chart visuals are intentionally focused: one active false-break box, a reclaim rail, a soft fail rail, a target-back line, and controlled labels. The goal is premium readability without turning the chart into a generic level map.
🧪 Practical Usage Workflow
1. Read the panel and check the current Reclaim State.
2. Review the false-break box and identify which edge was broken.
3. Check whether price is holding beyond the edge or closing back inside.
4. Compare Trap Risk with Break Quality.
5. Use the target-back line and failure-room reading as context, not as a forecast.
🔍 Interpretation Guidelines
Think in states, not predictions.
A high Trap Risk score means the attempted break has characteristics often associated with failed continuation. It does not mean the next move is guaranteed.
A strong Break Quality score means the break is still showing participation and close-through behavior. In that context, early fading can be premature.
The cleanest reading appears when Trap Risk is high, Break Quality is weak, and price has closed back inside the range.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a stop-hunt map
• Not a liquidity sweep scanner
• Not a support/resistance zone system
• Not a replacement for risk planning
⚠️ Limitations & Transparency
The active range depends on the selected lookback. A different lookback can produce different edges.
ATR and volume conditions can change quickly during high-volatility periods, which may affect scoring.
Breakout behavior differs across symbols, sessions, and timeframes. A trap-like structure on one market may not behave the same way on another.
The script is rule-based and does not know external news, order flow, or hidden liquidity.
🧠 Market Context Notes
False breaks often become more relevant near visible range edges, crowded breakout levels, and late-stage expansion attempts.
The planner is most useful when combined with broader market context, liquidity conditions, volatility regime, and the trader's own risk rules.
🧾 Use Case Examples
When price breaks above a recent range but closes back inside with a long upper wick and strong volume, the planner may mark Upper Trap context.
When price breaks below a range but quickly reclaims the lower edge, the planner may shift into Lower Trap context.
When price breaks and keeps closing beyond the edge after the acceptance window, the planner may mark Break Accepted instead of forcing a trap interpretation.
🧱 System Philosophy
False Break Trap Planner follows the AGPro Series decision-engine direction: score the setup, identify the state, show the risk reference, show the target-back context, and make the next review step clear.
The script is built to help traders make a structured chart-reading decision, not to add another isolated signal.
🔐 Non-Promise Statement
No script can confirm certainty.
No trap score guarantees reversal, continuation, or profitability.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk controls, and market interpretation.
This script is for educational and analytical use only and does not provide financial advice or guaranteed trading outcomes.
📚 Educational Note
Use the planner as a structured review layer around breakout failure behavior. The best value comes from comparing state, score, failure room, and broader market context together.
릴리즈 노트
🔧 UPDATE NOTES - V1.1This update focuses on premium chart readability, clearer trap-zone presentation, and cleaner panel interpretation.
The core purpose of the script remains unchanged.
This release improves how the existing false-break trap logic is presented, organized, and reviewed 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 false-break zone presentation
The active false-break box now uses a separate centered badge with filled background and contrast-safe text.
• Improved label readability
Break Watch, Reclaim Watch, Trap Confirmed, and Break Accepted labels now use cleaner premium casing and stronger contrast logic.
• Rebalanced default visual density
Label cooldown, context spacing, and retained label count were adjusted to keep the chart informative without becoming crowded.
• Upgraded panel structure
The AG Pro panel now shows Workflow, State, Trap Risk, Break Quality, Failure Room, and Review for faster interpretation.
• Cleaned publication naming
The indicator short title was simplified while preserving the full [AGPro Series] title format.
------------------------
Visual Improvements
------------------------
• Kept the false-break zone labeled at the center of the visual area
• Removed reliance on low-contrast or unboxed zone text
• Improved chart readability by separating the zone surface from the status badge
• Reduced repeated context labels while preserving enough chart story for screenshots
• Refined panel emphasis so the active workflow and trap-risk state stand out more clearly
------------------------
Interface & Usability
------------------------
• Panel header remains a single merged blue AG Pro title row
• Panel visibility, location, theme, and font size remain user-controlled
• Chart label font size remains adjustable from settings
• Trap Risk and Break Quality are presented as direct score-and-grade values
• Review text is action-oriented but remains analytical and non-prescriptive
------------------------
Behavior Notes
------------------------
This update does not change the core analytical purpose of the script.
The script still evaluates false-break context using range-edge breaks, penetration depth, reclaim behavior, wick response, relative volume, and acceptance timing.
The goal is to improve clarity and usability, not to introduce predictive behavior.
Users should interpret outputs the same way as before, but with improved visual structure.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may affect how false-break events appear.
Trap zones, reclaim rails, and labels 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 adds a reversion-rate proof layer to the False Break Trap Planner. The
core trap-risk engine, scoring and rails remain unchanged. This script continues
to function as an analytical visualization tool. It does not predict price
direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
- Reversion-Rate Proof Layer
The panel now tracks how often a Trap Confirmed context reverted back toward the
range midpoint before extending beyond the false-break extreme, with sample size
shown.
- Range-Scaled, Representative Target
The proof measures a balanced reversion from the broken edge toward the range
midpoint - scaled to the range - rather than a fixed distance, so the rate reflects
realistic post-trap behavior across markets.
- Honest, Non-Repaint Statistics
Each trap is counted once. Samples are confirmed-bar gated, resolve as a non-win on
continuation or timeout, resolve same-bar ambiguity conservatively, and use a fixed
window to avoid inflation.
- New Proof Inputs
A dedicated proof group adds Proof Window Bars and Proof Reversion To Mid % so the
reversion test can be tuned per market and timeframe.
------------------------
Visual Improvements
------------------------
- Kept the premium false-break box, centered badge and rails intact
- Preserved the target-back guide and contrast-safe label text
- Maintained moderate, non-overlapping label density
- No added chart clutter from the proof layer
------------------------
Interface & Usability
------------------------
- Added a Reversion Rate proof row to the planner panel
- Improved first-glance trust with a visible track-record context
- Kept all existing settings and defaults backward compatible
- Enhanced overall experience without changing the core engine
------------------------
Behavior Notes
------------------------
This update does not change how break attempts, trap risk, break quality, failure
room or rails are computed. The goal is added proof context. Outputs should be
interpreted the same way as before.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool. Volatility, liquidity and
timeframe differences can affect how breaks, traps and statistics appear. Always
interpret outputs 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
면책사항
해당 정보와 게시물은 금융, 투자, 트레이딩 또는 기타 유형의 조언이나 권장 사항으로 간주되지 않으며, 트레이딩뷰에서 제공하거나 보증하는 것이 아닙니다. 자세한 내용은 이용 약관을 참조하세요.