Body Close Break Planner [AGPro Series]TITLE
Body Close Break Planner
🧠 Core Idea
Did price break structure with real body-close acceptance, or was the move only a wick event with weak commitment?
📌 Overview / What it does
Body Close Break Planner is built to evaluate whether a structure break is being accepted with real candle-body commitment. Instead of reacting to every wick beyond a prior high or low, the script focuses on closes that actually establish acceptance beyond the rail.
The script maps the body break rail, an acceptance pocket, a retest shelf, a failure rail, and a first target-room reference. It also adds event labels, right-side tags, and a compact AG Pro panel that summarizes the quality of the active break with a 0-100 Body Break Score.
This script does not predict trend continuation, automate entries, or treat every breakout as valid. It is a rule-based analytical and visualization tool that helps users separate real body-close structure acceptance from weaker noise-driven break attempts.
🎯 Purpose & Design Philosophy
This script was built to solve a very common structural problem: many breakout candles look convincing in the moment, but the move fails because the market never achieved real closing acceptance beyond the level.
The tool was designed for traders who want to evaluate whether a break has genuine body-based commitment, whether the first retest is constructive, and where the structure fails if acceptance is lost.
The mindset behind the script is selective, disciplined, and evidence-based. It supports traders who want to read acceptance quality rather than react to every temporary excursion beyond a level.
⚡ Why This Script Is Different
Most breakout tools focus on level crossing, wick penetration, or generic break-and-retest behavior.
This script does NOT treat every breach of structure as a meaningful breakout.
Instead, it asks whether the move closed through structure with enough body commitment, whether price is still being accepted beyond the rail, whether the retest shelf improves the setup, and whether the move still has room before it becomes extended or fails.
⚙️ Methodology
1. Context Detection
The script maps recent structure highs and lows, then checks whether price closes beyond them with enough candle-body commitment and range expansion.
2. Reference Mapping
Once a valid body-close break is confirmed, the script locks the broken rail, builds an acceptance pocket, marks a retest shelf, and defines a failure line plus a first target-room reference.
3. Reaction Evaluation
Price is then reviewed against the body-break rail and the retest shelf. The script checks whether the move is still accepted, whether the retest improves the structure, or whether the breakout falls back through the failure boundary.
4. Visual Output
The final output includes the acceptance pocket, body-break rail, retest shelf, failure rail, room line, event labels, right-side tags, and dashboard panel.
🗺️ How to Read the Chart
Zones:
The acceptance pocket represents the active post-break area where structure acceptance is being judged.
Labels:
Labels identify new bullish or bearish body-close breaks, accepted structure, retest-ready behavior, target review, and failed breaks.
Colors:
Teal represents stronger constructive break behavior.
Pink represents bearish or failed context.
Gold represents review areas such as target-room interaction.
Indigo represents the main body-break rail.
Panel:
The panel summarizes the active break type, the Body Break Score, current acceptance quality, available room, and the current action state.
🚦 Signals & States
• Bull Break → A bullish body-close structure break has been detected.
• Bear Break → A bearish body-close structure break has been detected.
• Body Accepted → Price is still being accepted beyond the broken structure rail.
• Retest Ready → Price interacted with the retest shelf constructively and the setup quality improved.
• Target Review → The first projected room reference has been reached and context should be reassessed.
• Failed → Price moved back through the failure boundary and the break is no longer structurally clean.
• Wait Break → No valid active body-close break exists.
• Expired → The break is too old to remain active within the current framework.
🔔 Alerts Logic
Alerts can trigger when a new bullish or bearish body-close break is detected, when structure remains accepted, when a retest shelf strengthens the setup, when target room is reached, or when the break fails.
Alerts are attention markers only. They highlight structural events inside the script logic. They are not trade instructions, automated entries, or guarantees of follow-through.
🧩 Confluence Logic
The context becomes stronger when multiple conditions align together.
For example, a structure break with a strong body ratio, clean range expansion, stable hold beyond the break rail, and a constructive retest shelf interaction is much stronger than a shallow close that immediately falls back into the old range.
When body commitment, breakout range, retest quality, and available room align together, the context becomes structurally more reliable.
📊 When to Use
• Breakout or breakdown environments where close quality matters
• Markets with clean price structure and readable swing levels
• Crypto, forex, indices, and liquid stocks
• 1H, 4H, and 1D chart review
• Situations where wick-only breaks create repeated false positives
⚠️ When NOT to Use
• Illiquid markets with distorted price prints
• Extremely noisy sessions with poor candle quality
• Very low-range environments where closes carry little structural information
• Symbols dominated by gaps or erratic price jumps
• Conditions where the market repeatedly overshoots levels without clean follow-through
🎛️ Key Inputs
• Structure Lookback → Controls how recent highs and lows are mapped
• Minimum Range Ratio → Controls how much expansion is required before a break qualifies
• Minimum Body / Range → Filters out weak closes and wick-dominant candles
• Close Buffer ATR → Controls how far beyond structure the close must finish
• Acceptance Pocket ATR → Controls the depth of the post-break pocket
• Retest Shelf Buffer → Controls how shelf interactions are interpreted
• Failure Buffer ATR → Controls where the active break becomes invalid
• Visual Settings → Control labels, panel location, theme, font size, and optional chart styling
🖥️ Interface & Visual Design
The interface is designed to answer one question quickly: is this break actually being accepted?
The panel creates a clean information hierarchy so the user can understand break state, score, room, and current action without reading every chart element manually. The chart layer keeps the acceptance pocket, body-break rail, failure line, and room reference readable without overwhelming candles.
The visual intent is professional, premium, and publication-friendly rather than decorative.
🧪 Practical Usage Workflow
1. Read the panel to confirm whether a valid body-close break is active
2. Check the body-break rail and acceptance pocket
3. Evaluate whether price is simply holding or whether the retest shelf improved the structure
4. Review room to the target reference and distance to failure
5. Use labels and tags as context markers, not as direct commands
🔍 Interpretation Guidelines
A stronger score suggests better body commitment, healthier range expansion, and more reliable post-break structure.
A Body Accepted state means price is still holding beyond the broken rail, but it does not automatically mean the move is early or low-risk.
A Retest Ready state suggests the market pulled back in a controlled way and defended the structure more convincingly.
A Target Review state suggests that the first projected room objective has already been reached and the context should be reassessed rather than assumed to continue indefinitely.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an automated trading system.
This script does not place orders.
This script does not guarantee continuation, retest success, target reach, or profitability.
⚠️ Limitations & Transparency
This script is rule-based and depends on the quality of the underlying market structure.
Different timeframes can produce very different break quality profiles. In high-volatility or low-liquidity conditions, candle closes may appear meaningful while still failing quickly. In some markets, wick behavior may remain important even when the body-close break model is intentionally strict.
Outputs should always be interpreted within broader market context rather than in isolation.
🧠 Market Context Notes
Body-close acceptance often matters most around obvious swing highs, swing lows, range edges, and post-compression expansion points.
A wick beyond structure can attract attention, but a true close beyond structure often tells a more reliable story about commitment. Even so, not every accepted break becomes a trend. Some become retest traps, and some run directly into higher-timeframe resistance or support.
🧾 Use Case Examples
Example 1:
Price closes above a well-defined swing high with a strong body and good expansion. The script marks a bull break, builds the acceptance pocket, and later upgrades the context when the retest shelf holds.
Example 2:
Price breaks below a swing low with body commitment, but then quickly closes back through the failure boundary. The script marks the break as failed, signaling that the downside acceptance did not hold.
Example 3:
A strong body-close break remains accepted and quickly reaches the first target-room line. The script marks target review, reminding the user to reassess efficiency and extension.
🧱 System Philosophy
AGPro Series tools are built as decision-support frameworks, not generic signal generators.
The philosophy here is to reward quality over noise: stronger closes, cleaner acceptance, clearer structure, and more readable post-break behavior.
🔐 Non-Promise Statement
This script does not promise certainty.
It does not promise that a body-close break will continue, hold, retest cleanly, or reach its projected room. It only organizes the structure so the user can evaluate the break with more discipline and clarity.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly, and any analytical tool can become less reliable under shifting volatility, liquidity, or structural conditions. Users remain fully responsible for their own decisions, execution, and risk management.
This script is for educational and analytical purposes only. It does not provide financial advice.
📚 Educational Note
This tool is most effective when combined with broader market structure, liquidity awareness, and disciplined trade management.
It is designed to improve interpretation quality, not to replace critical thinking.
Indicador Pine Script®






















