Começar

BREAKOUT-QUALITY

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®
por AGProLabs
Breakout Follow-Through Planner [AGPro Series]Breakout Follow-Through Planner 🧠 Core Idea Did the breakout receive enough follow-through to stay valid? 📌 Overview / What it does Breakout Follow-Through Planner is a chart-first breakout planning tool designed to evaluate what happens after price clears a recent structure edge. Instead of treating the breakout candle as the full story, the script maps the broken level, creates a follow-through corridor, tracks post-break travel, measures close progress, monitors retest-depth risk, and converts the full sequence into a 0-100 Follow-Through Score. The script produces a breakout line, follow-through corridor, weak-continuation labels, failure rail, target-room guide, alerts, and a clean AGPro decision panel. It does not predict price, automate trades, or issue entry/exit commands. 🎯 Purpose & Design Philosophy This script was built for traders who already understand that a breakout is only the first event. The practical question comes after the break: does price travel away from the level, hold enough distance, and preserve clean room, or does it stall and begin to retest too deeply? This planner turns that post-break phase into a readable decision process. The design supports a planning mindset: identify the breakout, review follow-through quality, respect the failure rail, measure target room, and decide whether the active context still deserves attention. ⚡ Why This Script Is Different Most breakout tools focus on the moment price crosses a level. This script does NOT clone Breakout Volume Quality, Breakout Retest Readiness, Acceptance Breakout Planner, Volume Expansion Breakout Planner, or a generic support/resistance breakout scanner. Instead, it focuses on post-break travel quality. The key question is not simply "did price break?" or "was volume high?" or "did the retest hold?" The key question is whether the breakout received enough follow-through after the break to remain structurally valid. ⚙️ Methodology 1. Context Detection The script builds recent upper and lower breakout references from a configurable prior structure window. 2. Reference Mapping When price closes beyond a reference edge by an ATR-normalized buffer, the planner starts an active breakout follow-through plan. 3. Reaction Evaluation The model evaluates break candle quality, volume support, follow-through travel, number of closes beyond the breakout close, retest-depth risk, target room, and failure rail behavior. 4. Visual Output The chart shows the breakout line, active follow-through corridor, failure rail, target-room guide, compact labels, and an AGPro panel summarizing the current decision state. 🗺️ How to Read the Chart Follow-Through Corridor = the active path from the breakout close toward the target-room guide. Its text is centered inside the corridor. Breakout Line = the structure edge that was cleared and now anchors the active plan. Failure Rail = the invalidation reference behind the breakout line. It is an analytical guide, not a stop order. Target Room = the projected planning guide based on the prior structure height. Labels = compact markers such as BFT UP, BFT DN, FT READY, WEAK FT, RETEST RISK, FAIL RAIL, ROOM HIT, and TRACK. Colors = teal supports constructive bullish follow-through, pink supports bearish follow-through, amber marks caution, indigo marks target-room review, and red marks failure rail pressure. Panel = the main decision interface showing Breakout Side, Follow-Through, Retest Risk, Target Room, and Action. 🚦 Signals & States • BFT UP → a bullish breakout started a follow-through review. • BFT DN → a bearish breakout started a follow-through review. • FT WATCH → follow-through evidence is developing but not complete. • FT READY → travel, closes, score quality, and retest-depth conditions are constructive. • WEAK FT → the follow-through window aged without enough progress. • RETEST RISK → price moved too deeply back toward or through the breakout line. • FAIL RAIL → price closed through the failure rail after the breakout plan. • ROOM HIT → price reached the target-room guide and context should be reviewed. 🔔 Alerts Logic Alerts can trigger when a bullish or bearish breakout plan starts, follow-through reaches the ready state, weak follow-through or retest risk appears, the failure rail is hit, or target-room review is reached. These alerts are attention markers for chart review. They are not trade instructions, automated strategy rules, or guaranteed outcomes. 🧩 Confluence Logic The strongest follow-through context usually appears when the breakout candle is clean, price travels away from the breakout close, multiple closes hold beyond the breakout close, retest depth remains controlled, volume support is present, and target room is still readable. When these conditions weaken, the planner can shift toward FT WATCH, WEAK FT, RETEST RISK, FAILED, or TARGET REVIEW. 📊 When to Use • Breakout continuation review • Range exits where post-break travel matters • Trend continuation attempts after structure breaks • Breakouts that need a clear failure rail and target-room reference • Chart review workflows where the trader wants a decision state instead of another raw breakout marker ⚠️ When NOT to Use • Low-liquidity markets with unreliable candles or volume • Extremely noisy ranges where every breakout immediately snaps back inside • Abnormal news spikes where ATR and structure references may distort quickly • Situations where the user needs full trade management, position sizing, or automation 🎛️ Key Inputs • Structure Lookback → controls the recent high/low reference used for breakout detection. • Break Buffer ATR → defines how far price must close beyond the reference edge. • Minimum Break Quality → filters weaker breakout candles before the planner starts. • Follow-Through Window → controls the early review period after the breakout. • Required Travel ATR → defines the preferred post-break travel distance. • Maximum Clean Retest Depth ATR → controls when retest depth becomes risk. • Failure Rail ATR → sets the analytical invalidation rail behind the breakout line. • Target Room Range Multiple → projects the target-room guide from prior structure height. • Visual and Panel Settings → control corridor visibility, labels, panel location, theme, and font sizes. 🖥️ Interface & Visual Design The interface is intentionally chart-first. The follow-through corridor carries the main story, while the breakout line, failure rail, and target guide create a clean level-risk-room hierarchy. Labels are compact and controlled by cooldown and maximum-visible settings so the chart remains active without becoming crowded. The AGPro panel uses a merged blue title row and a compact decision layout for fast review. 🧪 Practical Usage Workflow 1. Read the panel to identify the current breakout side and follow-through state. 2. Check the breakout line and follow-through corridor. 3. Review whether price is traveling away, stalling, retesting too deeply, or reaching target room. 4. Use the failure rail as a structural review reference. 5. Treat the Action row as a planning prompt, not as an instruction. 🔍 Interpretation Guidelines The Follow-Through Score should be read as context quality, not certainty. A higher score means the breakout has cleaner post-break travel under the script's rules. A lower score means the breakout may be stalling, losing distance, retesting too deeply, or lacking enough supporting evidence. The target-room guide does not forecast price. It gives a structured reference for whether the current path still has room to review. 🚫 What This Script Is NOT This script is not a prediction engine. This script is not financial advice. This script is not an auto-trading system. This script does not provide guaranteed signals. This script is not a generic support/resistance map. This script is not a Breakout Volume Quality clone. This script is not a Breakout Retest Readiness clone. ⚠️ Limitations & Transparency The script is rule-based and depends on the selected lookback, ATR length, timeframe, and symbol behavior. Different markets can produce different breakout behavior. Lower timeframes may show more noise. Higher timeframes may produce fewer but cleaner events. Volatility changes can affect corridor size, failure rail distance, target-room projection, and event frequency. Outputs should be interpreted within broader market context. 🧠 Market Context Notes Breakout follow-through is usually most useful when structure is readable, liquidity is sufficient, and the market has enough room to travel after the break. Volume can support the score, but the script is not built around volume alone. The central decision layer is post-break price travel and structural validity. 🧾 Use Case Examples When price breaks above recent structure and immediately travels away with multiple closes beyond the breakout close, the planner can move from FT WATCH toward FT READY. When price breaks but returns deeply through the breakout line before enough travel appears, the planner can mark RETEST RISK or FAIL RAIL. When price reaches the projected target-room guide, the planner shifts to ROOM HIT so the context can be reviewed instead of blindly extended. 🧱 System Philosophy The script is built around the AGPro decision-engine approach: structure first, quality score second, risk and target context always visible, and no promise-based signals. 🔐 Non-Promise Statement No script can provide certainty. No output should be treated as a guarantee. The tool organizes breakout follow-through context so users can review price action with more structure. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions. This script does not provide financial advice. 📚 Educational Note Use the planner to study how breakouts behave after the first break. The value is in comparing clean follow-through, weak continuation, deep retests, and failure-rail behavior across many examples.
Indicador Pine Script®
por AGProLabs
CPR Expansion Planner [AGPro Series]CPR Expansion Planner 🧠 Core Idea Is CPR width and price acceptance setting up a structured expansion day, or is price still inside a weak pivot context? 📌 Overview / What it does CPR Expansion Planner is a chart-first Central Pivot Range planning tool built to evaluate whether the current session is developing enough structure for an expansion-day read. The script studies CPR width, the current anchor open, accepted closes beyond CPR, developing range expansion, target room, and the active invalidation shelf. These components are converted into a 0-100 Expansion Score and a clear next-action state. It produces a CPR band, projected expansion room, target rail, invalidation shelf, state labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate trades, or guarantee continuation. 🎯 Purpose & Design Philosophy This script was built for traders who already watch CPR but want a more practical planning layer than a static pivot display. Many CPR tools show the Central Pivot Range and leave the user to decide whether the day is balanced, expanding, failing, or already extended. This script fills that gap by translating CPR context into readiness, room, invalidation, and action language. The design supports a planning mindset: identify the CPR base, check whether price is accepting beyond it, measure whether expansion has room, and keep the invalidation shelf visible. ⚡ Why This Script Is Different Most tools focus on plotting CPR lines, daily pivots, or support/resistance reactions. This script does NOT clone a Pivot Points Reaction Map, does not plot a full pivot ladder, and does not treat every pivot touch as a reaction signal. Instead, it focuses on one question: is the CPR context preparing an expansion day with enough acceptance, range development, and target room to deserve attention? ⚙️ Methodology 1. Context Detection The script builds CPR from the selected anchor and reads whether price is working above, below, or inside the CPR structure. 2. Reference Mapping It maps the CPR band, accepted expansion side, invalidation shelf, projected target rail, and active expansion room. 3. Reaction Evaluation The model scores CPR width, open location, accepted closes beyond CPR, current range expansion, and target room. 4. Visual Output The result is shown through CPR zones, state labels, planner rails, deterministic alerts, and a premium AGPro panel. 🗺️ How to Read the Chart Zones = the CPR band shows the active expansion base. The expansion room box shows the distance between the accepted CPR edge and the target rail. Labels = READY, WATCH, ROOM, SHIFT, FOLLOW, and INVALID labels describe the current planning state. Colors = green highlights bullish expansion context, pink highlights bearish expansion context, amber highlights room or follow-through review, indigo highlights watch states, and red highlights invalidation risk. Panel = the panel summarizes CPR Width, Accepted Side, Expansion Score, Invalidation, and Action. 🚦 Signals & States • READY → CPR acceptance, score, room, and confirmation are aligned. • WATCH → price is beyond CPR but still needs cleaner confirmation or score improvement. • ROOM BLOCKED → CPR acceptance exists, but the target rail is too close or already reached. • EXTENDED → price has moved beyond the planned target room and late-chase risk is elevated. • INVALID RISK → price has reached the active invalidation shelf. • SHIFT → the accepted expansion side changed after a previous READY state. 🔔 Alerts Logic Alerts trigger when the script detects a READY CPR expansion state, accepted side shift, invalidation risk, major follow-through, or blocked target room. Alerts are attention markers. They are not trade instructions, automated entries, or exit commands. 🧩 Confluence Logic The strongest context appears when narrow CPR width, a balanced anchor open, accepted closes beyond CPR, range expansion, and clean target room align. When only one or two components are present, the script usually stays in WATCH, ROOM BLOCKED, or WAIT rather than forcing a strong state. 📊 When to Use • Intraday markets where Daily CPR is a visible reference. • Swing contexts where Weekly CPR is more relevant. • Potential expansion days after narrow CPR conditions. • Sessions where price begins accepting clearly beyond the CPR band. • Traders who want risk and target context around CPR instead of only static lines. ⚠️ When NOT to Use • Very low-liquidity symbols with unreliable volume and wide spreads. • Extremely noisy sessions where price repeatedly crosses CPR without acceptance. • News-driven volatility where normal CPR structure can be overwhelmed. • Markets where the selected CPR anchor is not meaningful for the user's timeframe. 🎛️ Key Inputs • CPR Anchor → switches between Daily and Weekly CPR. • Sensitivity → adjusts how quickly the planner recognizes CPR expansion conditions. • Confirmation Mode → controls whether acceptance requires close confirmation, volume support, or stricter alignment. • READY Threshold → sets the minimum Expansion Score for READY states. • Clean Target Room ATR → defines how much space is needed before the target rail is considered clean. • Event Label Cooldown → controls label density and keeps the chart readable. • Panel and Label Font Size → controls visual readability. 🖥️ Interface & Visual Design The interface is chart-first. The CPR band anchors the setup, the expansion room gives directional context, and the invalidation shelf keeps risk visible. The panel is intentionally compact, with one merged blue AGPro title row and five decision rows. The goal is a premium TradingView visual: informative enough to avoid an empty chart, but restrained enough to stay clean. 🧪 Practical Usage Workflow 1. Read the panel and check the Expansion Score. 2. Identify whether price is accepting above or below CPR. 3. Review the expansion room and target rail. 4. Check the invalidation shelf. 5. Interpret READY, WATCH, ROOM, FOLLOW, or INVALID as planning context. 🔍 Interpretation Guidelines Think in terms of structure, not prediction. A narrow CPR can create expansion potential, but it still needs acceptance. Acceptance can be useful only if there is enough target room. A strong score with limited room may be less attractive than a moderate score with cleaner structure. The script helps organize the CPR read; it does not replace broader market context. 🚫 What This Script Is NOT • Not a prediction engine. • Not financial advice. • Not an auto trading system. • Not a guaranteed signal generator. • Not a full pivot ladder or generic support/resistance reaction map. ⚠️ Limitations & Transparency • CPR behavior can vary across assets and sessions. • Timeframe selection changes how the CPR anchor should be interpreted. • High-impact news can distort normal expansion behavior. • Thin liquidity can create false acceptance beyond CPR. • The score is rule-based and should be interpreted within broader market context. 🧠 Market Context Notes CPR can help frame session balance and directional acceptance. A narrow CPR often attracts expansion-day attention, but the useful question is not only whether CPR is narrow. The useful question is whether price accepts away from it with room, structure, and a clear invalidation reference. 🧾 Use Case Examples When price opens near CPR, accepts above the top of the range, and develops range expansion with clean target room, the script may shift toward READY. When price moves beyond CPR but immediately reaches the target rail, the script can mark ROOM BLOCKED or EXTENDED. When price fails back through the opposite CPR edge, the planner can show INVALID RISK. 🧱 System Philosophy AGPro Series tools are designed to turn visible market structure into practical decision context. This script follows that philosophy by converting CPR from a passive reference into a structured expansion planner with score, state, risk, and target logic. 🔐 Non-Promise Statement No guarantees. No certainty. No script can remove market risk or replace user responsibility. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions, risk management, and interpretation of market conditions. This script is for educational and analytical purposes only and does not provide financial advice. 📚 Educational Note Use the script to study how CPR width, acceptance, range expansion, and target room interact over time. The best value comes from reviewing repeated examples across different symbols, sessions, and timeframes.
Indicador Pine Script®
por AGProLabs
Acceptance Breakout Planner [AGPro Series]Acceptance Breakout Planner 🧠 Core Idea Did price truly accept beyond the breakout level, or did it only tag the level and fail to hold? 📌 Overview / What it does Acceptance Breakout Planner is a chart-first breakout decision tool designed to evaluate what happens after price moves beyond a key rolling reference edge. Instead of treating every breakout as meaningful, the script measures close persistence, time beyond the level, retest-hold behavior, range distance, candle quality, volume support, and failure shelf risk. It converts that evidence into a 0-100 Acceptance Score and a clear next-action state. The script produces an acceptance band, a failure shelf, a target-room guide, controlled chart labels, alerts, and a clean AGPro planning panel. It does not predict price movement, automate execution, or claim that acceptance will continue. 🎯 Purpose & Design Philosophy This script was built to fill the gap between a simple breakout marker and a full trade-management system. Many traders can see when price crosses a level. The harder question is whether price is spending enough time beyond that level to deserve attention, or whether the break is only a low-commitment tag. The design supports a planner mindset: observe the break, measure acceptance, watch the failure shelf, and review the next state with structure instead of reacting to a single candle. ⚡ Why This Script Is Different Most breakout tools focus on the moment price crosses a level. This script does NOT function as a generic breakout signal, volume-spike detector, consolidation breakout box, Donchian channel tool, or broad break-retest scanner. Instead, it focuses on post-break acceptance quality. The key question is not simply "did price break?" The key question is "did price remain accepted beyond the broken reference long enough to reduce tag-only risk?" This keeps the script separate from Breakout Volume Quality, Consolidation Breakout Quality, Break-Retest Quality, Price Acceptance Profile, and reference-specific breakout tools in the AGPro catalog. ⚙️ Methodology 1. Context Detection The script maps rolling upper and lower reference edges from prior bars. These references are used only as breakout acceptance anchors. 2. Reference Mapping When price closes beyond a reference edge by an ATR-adjusted buffer, the planner starts an active acceptance sequence. 3. Reaction Evaluation The active sequence is scored through close persistence, time beyond the level, acceptance-band retests, candle quality, relative volume support, and distance from the failure shelf. 4. Visual Output The chart shows an acceptance band, a failure shelf, a target-room guide, compact state labels, and a panel that summarizes acceptance score, time beyond, break side, failure risk, and action. 🗺️ How to Read the Chart Acceptance Band = the zone around the broken level where price should hold if acceptance is developing. Failure Shelf = the invalidation context behind the broken level. A close through this shelf means the breakout acceptance sequence needs review. Target Room = a projected planning guide based on the prior reference range. It is not a forecast or promised target. Labels = compact event markers such as BULL BRK, BEAR BRK, WATCH, HOLD, ACCEPT, TAG, RISK, and REJECT. Colors = teal supports constructive acceptance, pink marks rejection or failure pressure, yellow marks caution, and indigo marks active watch states. Panel = a compact decision view showing Acceptance Score, Time Beyond, Break Side, Failure Risk, and Action. 🚦 Signals & States • BULL BRK → price closed beyond the upper reference and started an acceptance review. • BEAR BRK → price closed beyond the lower reference and started an acceptance review. • WATCH → acceptance evidence is improving but is not mature yet. • HOLD → price revisited the acceptance band and held beyond the broken reference. • ACCEPT → close persistence, score quality, and time beyond the level reached the accepted state. • TAG → the sequence is active, but close persistence is still weak after the review window. • RISK → acceptance is not mature and the failure shelf is becoming more relevant. • REJECT → price closed through the failure shelf after the breakout sequence. 🔔 Alerts Logic Alerts trigger when a new acceptance break starts, when accepted state appears, when a retest hold is detected, when failure risk rises, or when price rejects through the failure shelf. Alerts are attention markers. They are not trade instructions, automation commands, or certainty statements. 🧩 Confluence Logic The strongest acceptance context appears when several conditions align: • price closes beyond the broken reference more than once • the acceptance band holds during a retest • candle structure remains directional • failure shelf distance remains healthy • volume support is present without being the only reason for the score When these elements align, the Acceptance Score rises and the state becomes easier to interpret. 📊 When to Use • Breakout review after price crosses a visible range edge • Markets where one-bar breakout tags are common • Trend continuation attempts that need acceptance confirmation • Range expansion moves where the trader wants to separate holding behavior from weak level pokes • Chart review workflows that need a clear post-break next-action state ⚠️ When NOT to Use • Extremely low-liquidity markets with unreliable candles • Very noisy symbols where reference edges are constantly pierced • News-driven volatility where ATR buffers may become unstable • Situations where the user expects automatic trade entries • Markets where volume data is missing and volume support is treated as less useful 🎛️ Key Inputs • Break Side → controls whether the planner evaluates bullish breaks, bearish breaks, or both. • Reference Lookback → defines the prior-bar range used to map breakout reference edges. • Close Beyond Level ATR → controls how far beyond the level price must close before a sequence starts. • Acceptance Band ATR → controls the retest-hold zone around the broken level. • Failure Shelf ATR → controls the invalidation context behind the broken level. • Minimum Beyond Closes → controls how much close persistence is required before acceptance can mature. • ACCEPTED Threshold → sets the minimum 0-100 score for accepted state. • Label / Panel Controls → adjust visual density, placement, theme, and font size. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The acceptance band and failure shelf show the current structure, while labels mark only meaningful state changes. The panel uses the AGPro standard: a single blue merged header row, compact rows, clear state colors, adjustable location, adjustable theme, and normal font size by default. The visual hierarchy is intentionally restrained so the chart looks active without becoming crowded. 🧪 Practical Usage Workflow 1. Read the panel to see the current Acceptance Score and action state. 2. Check whether price is holding beyond the broken reference or drifting back into the band. 3. Watch the failure shelf to understand whether the breakout is losing acceptance. 4. Review labels only as context markers, not as standalone decisions. 5. Confirm the broader market context before acting on any chart interpretation. 🔍 Interpretation Guidelines Think of the script as a post-break acceptance reviewer. A higher Acceptance Score means the breakout has stronger evidence of persistence according to the script model. A lower score means the move may still be early, weak, or vulnerable to failure. The most useful reading is the relationship between time beyond the level, retest behavior, and failure shelf distance. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not an auto-trading system • Not guaranteed signals • Not a generic support/resistance map • Not a consolidation breakout box tool • Not a pure volume breakout detector • Not a full break-retest scanner ⚠️ Limitations & Transparency Breakout acceptance is sensitive to timeframe, volatility, liquidity, and symbol behavior. The reference edges are rolling and can change as older bars leave the lookback window. ATR-based buffers can expand or contract during volatile market conditions. Relative volume may be less useful on symbols with limited or inconsistent volume data. 🧠 Market Context Notes Acceptance after a breakout is often more useful than the initial break itself. A level tag shows that price reached a reference. Acceptance shows whether price can keep spending time beyond that reference. This distinction is the core purpose of the planner. 🧾 Use Case Examples When price closes above a reference edge and then holds the acceptance band on a later retest, the script may shift from watch context toward stronger acceptance. When price breaks a reference but quickly returns through the failure shelf, the script marks rejection context instead of treating the break as mature. When price remains beyond the level but does not build enough persistence, the script can show TAG ONLY or FAILURE RISK. 🧱 System Philosophy Acceptance Breakout Planner follows the AGPro decision-engine approach: It does not ask users to react to a raw signal. It organizes the chart into quality, state, risk, target-room context, and next-action review. 🔐 Non-Promise Statement No script can remove uncertainty from markets. No state, score, label, band, shelf, or alert guarantees future price behavior. 📉 Risk Disclosure Trading involves risk. This script is for educational and analytical use only. It does not provide financial advice, investment advice, trade instructions, or guaranteed outcomes. Users remain responsible for their own decisions, risk management, and market evaluation. 📚 Educational Note Use the script to study the difference between a breakout tag and breakout acceptance. The strongest value comes from comparing the planner state with broader structure, volatility, liquidity, and personal execution rules.
Indicador Pine Script®
por AGProLabs
Reclaim Breakout Planner [AGPro Series]Reclaim Breakout Planner 🧠 Core Idea Is a recently broken structural level being lost and reclaimed in a way that creates a valid breakout planning area? 📌 Overview / What it does Reclaim Breakout Planner is a chart-first breakout planning tool built around structural pivot reclaim behavior. It detects when price breaks beyond a confirmed pivot level, temporarily moves back through that broken level, and then closes back on the breakout side with measurable acceptance quality. The script produces a 0-100 Acceptance Score, an active Reclaim State, an Acceptance Pocket, a Risk Edge, a Target Corridor, controlled chart labels, and a compact AG Pro panel. The goal is to help traders organize reclaim context after a structural breakout attempt. This script does not predict price direction, automate trades, or mark every pivot as important. It filters for a specific sequence: structural level break -> temporary level loss -> reclaim close -> planning state. 🎯 Purpose & Design Philosophy Many breakout tools stop after price crosses a level. Many retest tools treat any return to the level as meaningful. This script was built for the narrower question that often matters after a breakout: did price briefly lose the broken level and then reclaim it with enough quality to deserve attention? It is designed for traders who want a cleaner decision-support layer around breakout acceptance, not another crowded support/resistance map. The mindset is planning first: evaluate validity, score quality, locate risk, estimate target room, and decide whether the context deserves monitoring. ⚡ Why This Script Is Different Most tools focus on the breakout candle or the retest touch. This script does NOT clone VWAP Reclaim Quality, Previous Day Sweep & Reclaim, EMA reclaim maps, session VWAP reaction tools, or a simple breakout retest readiness model. Instead, it focuses on structural pivot reclaim after a level is briefly lost. The reclaim must come from a confirmed pivot break, a temporary move back through the broken level, and a close back on the breakout side. That creates a distinct reclaim-planning workflow rather than a generic level scanner. ⚙️ Methodology 1. Context Detection The script identifies confirmed pivot highs and pivot lows as structural levels. These levels are not VWAP, previous-day highs/lows, session anchors, order blocks, or fixed support/resistance zones. 2. Breakout Arming When price closes beyond a pivot level by an ATR-normalized amount, the planner arms a reclaim watch. A bullish watch begins after a close above resistance. A bearish watch begins after a close below support. 3. Reclaim Evaluation The script waits for price to temporarily lose the broken level and then close back through it. It scores the event using reclaim close distance, retest depth, volume support, trend alignment, and wick rejection. 4. Visual Output Accepted reclaims create an Acceptance Pocket, Risk Edge, Target Corridor, event labels, sparse context labels, and panel state. The visuals are designed to stay readable without leaving the chart empty. 🗺️ How to Read the Chart Acceptance Pocket = the reclaimed structural level area where the breakout side is being tested. Risk Edge = the failed-side reference beyond the pocket. It is a planning boundary, not a trading instruction. Target Corridor = a projected review area based on the reclaim risk distance and the selected R multiple. Labels = compact event and context markers such as Bull Reclaim, Bear Reclaim, Retest Watch, and Failed Reclaim. Target Review labels are optional because the target corridor already marks the review area. Colors = bullish reclaim context uses teal, bearish reclaim context uses pink, caution/watch states use gold or indigo, and risk/failure context uses red. Panel = shows Reclaim State, Acceptance Score, Risk Edge, Target Room, and Action. 🚦 Signals & States • Scan Structure → no active reclaim plan exists yet. • Bull Retest Watch → price broke above a structural pivot and is waiting for a valid reclaim sequence. • Bear Retest Watch → price broke below a structural pivot and is waiting for a valid reclaim sequence. • Acceptance Watch → reclaim exists, but the score is not strong enough for the highest planning state. • Plan Review → reclaim quality is strong enough to monitor as structured planning context. • Risk Edge Test → price is testing the failed-side boundary. • Failed Reclaim → the active reclaim plan closed beyond the risk edge. • Target Review → price reached the projected target corridor area. 🔔 Alerts Logic Bullish Reclaim Breakout Plan triggers when a bullish structural reclaim is accepted and the score is above the alert threshold. Bearish Reclaim Breakout Plan triggers when a bearish structural reclaim is accepted and the score is above the alert threshold. Reclaim Risk Edge Failed triggers when an active reclaim plan closes beyond the risk edge. Reclaim Target Corridor Reached triggers when price reaches the projected target corridor. Alerts are attention markers. They are not trade instructions. 🧩 Confluence Logic The context becomes stronger when a confirmed pivot breakout, temporary level loss, reclaim close, supportive volume, trend alignment, and wick rejection appear together. The score compresses those components into one readable 0-100 Acceptance Score. 📊 When to Use • After structural breakouts where price returns to the broken level • During trending or transitioning markets where reclaim behavior matters • When evaluating whether a breakout level is being accepted after a brief failure • When a trader needs risk edge and target-room context around a reclaim sequence ⚠️ When NOT to Use • Very low-liquidity symbols with unreliable volume and erratic candles • Extremely noisy ranges where pivots form too frequently • News-driven candles where ATR-normalized structure can be distorted • Markets where price is far from any meaningful structural pivot 🎛️ Key Inputs • Reclaim Side → selects Auto, Bullish Only, or Bearish Only. • Pivot Strength → controls how selective structural levels are. • Minimum Break Close ATR → defines how far beyond the pivot price must close before a reclaim watch is armed. • Minimum Level Loss ATR → requires price to temporarily move back through the broken level before reclaim evaluation. • Acceptance Pocket ATR → controls the visual and logical reclaim pocket size. • Retest Window Bars → controls how long the reclaim watch remains valid. • Risk Edge Buffer ATR → adjusts the failed-side planning boundary. • Target Corridor R Multiple → controls the projected target review area. • Label and Panel Settings → control chart label density, optional target review labels, font size, panel location, and panel theme. 🖥️ Interface & Visual Design The interface is intentionally compact. The chart carries the main decision layer through acceptance pockets, risk edges, target corridors, and event labels. The panel acts as a quick readout for state, score, risk, target room, and next action. The first panel row follows the AGPro style with a merged blue title row. Label density is controlled by cooldown and maximum visible label settings so the chart remains premium and readable. 🧪 Practical Usage Workflow 1. Read the panel state. 2. Check whether the planner is scanning, watching a retest, or showing an accepted reclaim. 3. Inspect the Acceptance Pocket and Risk Edge. 4. Compare the Acceptance Score with the active state. 5. Use the Target Corridor as a review area, not as a guaranteed objective. 🔍 Interpretation Guidelines A high score means the reclaim sequence is cleaner under the script's rules. It does not mean the market must continue. A weak score means the reclaim lacks enough acceptance quality, volume support, trend alignment, or wick rejection. A failed reclaim means the planning structure has weakened and should be re-evaluated in broader market context. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a VWAP reclaim tool • Not a previous-day sweep reclaim script • Not a generic support/resistance map • Not an order block or FVG scanner ⚠️ Limitations & Transparency Timeframe selection affects pivot behavior. Lower timeframes may create more reclaim sequences, while higher timeframes may produce fewer but more important structural levels. Volatility can widen pockets and risk edges. During extreme volatility, reclaim signals can appear later or fail faster. Volume quality may be less reliable on markets where reported volume is synthetic, incomplete, or inconsistent. 🧠 Market Context Notes Reclaim behavior often matters when a market tests whether a broken level is becoming accepted. A clean reclaim can show that a breakout area is still being defended. A failed reclaim can show that the attempted breakout lost structure. The script treats that behavior as planning context, not certainty. 🧾 Use Case Examples When price closes above a pivot high, dips back below the broken level, then closes back above it with rejection wick and supportive volume, the planner may create a bullish reclaim plan. When price closes below a pivot low, trades back above the broken level, then closes back below it with rejection behavior, the planner may create a bearish reclaim plan. 🧱 System Philosophy AGPro tools are designed to help traders organize context, not chase isolated signals. This script follows that principle by turning reclaim behavior into a structured planning workflow with score, state, risk edge, target room, and action text. 🔐 Non-Promise Statement No script can guarantee continuation, reversal, or future price behavior. Reclaim structure can fail, especially in fast, illiquid, or news-driven markets. 📉 Risk Disclosure Trading involves risk. This script is for educational and analytical use only. It does not provide financial advice, investment advice, or guaranteed trading outcomes. Users remain responsible for their own decisions. 📚 Educational Note Use the script to study how reclaimed structural levels behave across symbols, timeframes, and volatility environments. The best use is disciplined observation, comparison, and context building.
Indicador Pine Script®
por AGProLabs
Session Range Expansion Planner [AGPro Series]Session Range Expansion Planner 🧠 Core Idea Is the session expanding from balance into a valid range extension, or is the break still too weak to trust as context? 📌 Overview / What it does Session Range Expansion Planner is a 1H-focused intraday execution-readiness tool built around one clear workflow: define the early-session balance, track expansion beyond that range, and score whether the move has enough acceptance, volume support, volatility fit, and target room to deserve attention. The script produces a session range box, accepted target-room bands, acceptance/rejection context, alerts, and a premium AGPro panel with a 0-100 planner score. The default visual preset is optimized for 1H and lower charts. Higher intraday charts such as 4H are intentionally kept clean by default. It does not predict the next candle, automate entries, or issue buy/sell commands. It organizes session behavior into a structured decision layer so the user can evaluate the setup within their own plan. 🎯 Purpose & Design Philosophy This script was built to fill the gap between simple session boxes and generic breakout indicators. Most tools show where the session range is. Fewer tools explain whether the break from that range is actually being accepted, whether participation supports it, and whether there is usable room beyond the range. Session Range Expansion Planner supports a planning mindset: define balance first, wait for expansion, check acceptance, evaluate room, then decide whether the context is worth further review. ⚡ Why This Script Is Different Most session tools focus on marking opens, coloring sessions, or printing a breakout label as soon as price crosses a high or low. This script does NOT act as a generic session high/low map, generic support/resistance tool, or broad session reaction scanner. Instead, it treats the first part of the session as a balance structure and asks whether the later expansion has enough quality to become actionable context. The decision layer is built around acceptance bars, volume support, ATR regime, obstacle distance, and target-room quality. ⚙️ Methodology 1. Context Detection The script reads the selected intraday session and builds an initial balance range from the first user-defined number of bars. 2. Reference Mapping The session balance high and low become the only active expansion boundaries. The tool does not use PDH, PDL, weekly open, order blocks, FVGs, or generic swing zones. 3. Reaction Evaluation When price breaks beyond the balance range, the engine measures acceptance closes, volume support, ATR regime quality, break distance, and nearby obstacle room. 4. Visual Output The script displays a centered session range label, directional expansion labels, target-room band, acceptance/rejection labels, alerts, and a premium panel with score and next-action state. 🗺️ How to Read the Chart Session Range Box = the early-session balance area. Expansion Labels = the side where price first expands beyond the balance high or low. Target-Room Band = the projected room beyond the broken boundary after expansion has been accepted, scaled by session range or ATR. Acceptance Labels = confirmation that price has sustained closes beyond the range for the configured number of bars. Rejection Labels = warning that price has failed back through the broken boundary. Colors: • Teal = upside expansion context • Pink = downside expansion context • Amber = neutral, warning, or rejection context • Indigo = AGPro visual accent and target-room support Panel = the decision cockpit showing planner score, session range, expansion side, acceptance, room score, and next action. 🚦 Signals & States • Range Set → the initial balance window has completed. • Expansion Up → price expanded above the session balance high. • Expansion Down → price expanded below the session balance low. • Accepted → the expansion held beyond the range for the required acceptance bars. • Rejection Risk → price failed back through the broken boundary. • Room Check Reached → price reached the projected target-room area. 🔔 Alerts Logic Alerts trigger when: • Upside range expansion is detected • Downside range expansion is detected • Expansion becomes accepted • Rejection risk appears after expansion Alerts are attention markers. They are not trade instructions and should be interpreted together with broader market context. 🧩 Confluence Logic The strongest context appears when expansion direction, sustained acceptance, volume support, balanced ATR regime, and clean target room align at the same time. When those conditions stack together, the planner score rises and the panel moves toward a review-ready state. 📊 When to Use • 1H intraday charts with clear session behavior • Opening balance or early-session range workflows • Breakout quality review • Volatility expansion planning • Session continuation evaluation The script is most useful when a trader wants to know whether a session range break is actually being accepted, not just whether a line was crossed. ⚠️ When NOT to Use • Very low-liquidity symbols • Extremely noisy micro timeframes • Markets with unreliable volume • Sessions with irregular trading hours • News-driven candles where range expansion is disorderly In weak conditions, reduce sensitivity or require stricter acceptance. 🎛️ Key Inputs • Session Timezone → defines how the selected session is interpreted. • Expansion Session → sets the active intraday window. The default full-day session is designed to work cleanly on crypto and other 24-hour symbols. • Visual Timeframe Preset → controls which intraday timeframes show chart objects. The default is 1H and lower because 4H session expansion charts can become too compressed. • Balance Window Bars → controls how many early-session bars define the range. • Acceptance Bars → defines how much sustained closing behavior is required. • Sensitivity → adjusts how fast the script recognizes expansion. • Confirmation Mode → controls wick, close, or strict acceptance confirmation. • Minimum Planner Score → sets the score threshold for review-ready context. • ATR Length → controls volatility normalization and label spacing. • Obstacle Lookback → estimates nearby structure that may reduce room quality. • Target Room Multiplier → controls the projected target-room distance. • Visual Settings → control range boxes, centered range label limit, rails, accepted target-room band, minimum visual score, optional expansion labels, optional room-check labels, optional range-set labels, label size, and object limits. • Panel Settings → control panel visibility, location, theme, and font size. 🖥️ Interface & Visual Design The interface is chart-first. The range box and target-room band carry the main visual story, while labels explain state transitions only when meaningful events occur. The panel is intentionally compact. It gives a fast read of expansion quality without forcing the user to decode many separate plots. The first panel row follows the AGPro standard: a single merged blue header row with only the script name. 🧪 Practical Usage Workflow 1. Apply the script to an intraday chart. 2. Confirm the correct session and timezone. 3. Let the initial balance window complete. 4. Watch for expansion beyond the balance high or low. 5. Check whether acceptance bars confirm sustained behavior. 6. Read the planner score and room score. 7. Use the next-action state as context for your own execution plan. 🔍 Interpretation Guidelines A clean expansion is not just a break beyond the range. It should show acceptance, participation, reasonable volatility, and enough room before nearby obstruction. Low scores usually mean the break is early, unsupported, too noisy, too extended, or too close to an obstacle. The best use is comparative: review which sessions and symbols repeatedly produce clean accepted expansions versus weak false breaks. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a buy/sell command system • Not a generic support/resistance map • Not an order block, FVG, or liquidity sweep scanner ⚠️ Limitations & Transparency Session behavior can vary across assets, timeframes, exchanges, and trading hours. ATR regime and volume support are rule-based approximations, not certainty models. On very low timeframes, labels may appear more frequently. On higher intraday timeframes, fewer but more meaningful events are expected. Markets can expand cleanly and still reverse later. The tool measures context quality, not future certainty. 🧠 Market Context Notes Session range expansion often becomes more meaningful when it is read together with broader trend, liquidity, volatility, and higher-timeframe structure. The script deliberately stays focused on session balance and expansion quality. Users can combine it with their own broader framework without duplicating other AGPro tools. 🧾 Use Case Examples When price breaks above the session range, holds above the balance high for the required acceptance bars, and room score remains strong, the panel may shift into review-ready continuation context. When price breaks the range but quickly closes back inside the balance, the script marks rejection risk and the panel moves away from continuation review. 🧱 System Philosophy AGPro tools are built to help traders organize context into clear decision layers. Session Range Expansion Planner follows that philosophy by turning a common intraday event into a structured planning process: balance, expansion, acceptance, room, action. 🔐 Non-Promise Statement No script can guarantee future price movement. The score is a structured context model, not a certainty model. 📉 Risk Disclosure Trading involves risk. Market conditions can change quickly, and historical session behavior does not guarantee future outcomes. Users are responsible for their own decisions, risk management, and position sizing. This script is provided for educational and analytical use only and does not provide financial advice. 📚 Educational Note Use the script to study how different markets expand from early-session balance. The most valuable insight is not a single label, but the repeated relationship between range quality, acceptance, room, and market context.
Indicador Pine Script®
por AGProLabs
Volume Expansion Breakout Planner [AGPro Series]Volume Expansion Breakout Planner 🧠 Core Idea After a breakout, is volume expanding in a constructive path, or is the move losing participation and acceptance? 📌 Overview / What it does Volume Expansion Breakout Planner is a chart-first breakout planning tool built around post-breakout participation quality. Instead of judging only the breakout candle, the script maps the broken reference level, draws an acceptance band, monitors relative volume after the break, tracks whether price holds the path, and converts the full sequence into a 0-100 quality score. The output includes compact breakout path labels, volume expansion labels, hold labels, failed-volume labels, an invalidation rail, a room or review guide, and a clean AGPro decision panel. It does not predict price, automate entries, or issue trade commands. 🎯 Purpose & Design Philosophy This script was built to fill the gap between simple breakout markers and full trade-management tools. Many breakouts look strong on the first candle but quickly lose participation. Others start quietly and become stronger as post-break volume expands. This tool is designed for traders who want to evaluate that path with structure, not emotion. The mindset is planning-first: identify the breakout reference, evaluate volume expansion, check acceptance, respect invalidation, and decide whether the path deserves continued attention. ⚡ Why This Script Is Different Most breakout tools focus on the first break beyond a level. This script does NOT try to clone a standard breakout volume confirmation tool, a Darvas breakout system, a triangle breakout scanner, or a generic support/resistance map. Instead, it focuses on the post-break volume expansion path: what happens after the level breaks, whether volume remains constructive, whether price accepts the broken area, and whether the path becomes suspicious or failed. ⚙️ Methodology 1. Context Detection The script builds a prior price structure from a configurable lookback and identifies the upper and lower breakout references. 2. Reference Mapping When price closes beyond the reference by an ATR-normalized buffer, the script starts a breakout path and draws the broken level, acceptance band, invalidation rail, and a room or review guide. 3. Reaction Evaluation The model evaluates relative volume, candle efficiency, close location, breakout distance, trend alignment, range quality, post-break participation, progress, acceptance, and failure behavior. 4. Visual Output The chart displays compact path labels, volume expansion labels, accepted-path labels, failed-volume labels, and a premium AGPro panel summarizing the current decision state. 🗺️ How to Read the Chart Zones = the acceptance band around the broken level. Its text changes by state, such as BULL PATH REVIEW, ACCEPTED BULL PATH, or FAILED BEAR PATH. Labels = compact path state markers such as UP, DN, VOL+, HOLD, FAIL, WATCH UP, and WATCH DN. Label scores can be enabled from settings if the user wants more detail. Colors = teal for constructive bullish paths, pink for constructive bearish paths, yellow for watch or caution states, indigo for room or review guide emphasis, and muted gray for expired paths. Panel = the current breakout side, volume expansion state, acceptance state, quality score, and next action. 🚦 Signals & States • UP → a bullish breakout path has started. • DN → a bearish breakout path has started. • VOL+ → post-break volume is expanding with directional follow-through. • HOLD → the path held beyond the acceptance band with constructive volume. • FAIL → the path returned into weak-volume or invalidation conditions. • WATCH UP / WATCH DN → optional approach labels when price is near a breakout reference while relative volume is building. 🔔 Alerts Logic Alerts trigger when a high-quality bullish or bearish volume expansion path starts, when post-break volume expands, when the path becomes accepted, or when failed-volume conditions appear. These alerts are attention markers for chart review. They are not trade instructions. 🧩 Confluence Logic The strongest readings usually occur when the breakout closes cleanly beyond the reference, relative volume expands above baseline, candle structure is efficient, trend alignment supports the side, and price later accepts the broken area. When these conditions align, the quality score improves and the next-action state becomes more constructive. 📊 When to Use • Breakout continuation review • Range exits where volume quality matters • Post-break acceptance monitoring • Breakouts that need a clear invalidation reference • Multi-symbol review where traders need fast path-quality comparison ⚠️ When NOT to Use • Low-liquidity symbols with unreliable volume • Markets with irregular session volume or distorted feeds • Extremely choppy periods where every break returns inside the prior structure • Events driven by abnormal news volatility where technical volume baselines become less stable 🎛️ Key Inputs • Breakout Lookback → controls the prior structure used for breakout references. • Break Buffer ATR → defines how far price must close beyond the level. • Volume Baseline Length → controls the relative volume baseline. • Expansion RVOL Threshold → defines the required volume expansion for strong pulses. • Minimum Planner Score → controls how selective the main path states are. • Acceptance Band ATR → controls the decision zone around the broken level. • Invalidation Rail ATR → controls the structural failure reference. • Panel / Label Settings → control location, theme, font size, label scores, optional watch labels, and label density. 🖥️ Interface & Visual Design The interface is built for fast chart reading. The acceptance band is the main visual anchor. The breakout line, invalidation rail, and room or review guide create a compact planning map without filling the chart with generic zones. Labels are short, shifted slightly away from the candle, and capped by user settings. The AGPro panel follows the publication standard with a single merged blue header row containing only the script name. 🧪 Practical Usage Workflow 1. Read the panel to see whether a breakout path is active. 2. Check the acceptance band and broken level. 3. Evaluate whether volume is expanding or fading. 4. Watch for ACCEPTED or FAILED VOL states. 5. Use the invalidation rail and room or review guide as planning references within broader market context. 🔍 Interpretation Guidelines Read the score as a structured quality model, not as certainty. A higher score means the path has cleaner participation, stronger candle structure, better close quality, better trend alignment, and stronger acceptance behavior according to the script's rules. A lower score means the path is weaker, less accepted, or more vulnerable to failed-volume behavior. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a complete trading system • Not a generic buy/sell indicator ⚠️ Limitations & Transparency Volume quality depends on the reliability of the TradingView volume feed for the selected symbol. Different timeframes can produce different breakout references and acceptance behavior. High-volatility news periods, low-liquidity markets, and irregular session activity can reduce the usefulness of relative volume baselines. The script is rule-based and should be interpreted alongside broader context. 🧠 Market Context Notes Volume expansion is most useful when it is connected to structure. The broken level matters because it gives the move a reference. The acceptance band matters because it shows whether the market is holding that reference. The invalidation rail matters because it defines when the path has lost structural quality. 🧾 Use Case Examples When price breaks above a prior range with strong RVOL and later holds the acceptance band, the path may remain constructive. When price breaks below a range but volume fades and price returns above the broken reference, the path may become suspicious or failed. When price approaches a reference with building volume but no confirmed break, VOL WATCH keeps the trader aware without turning the tool into a signal board. 🧱 System Philosophy The script is part of the AGPro planner-style workflow: show the reference, score the context, define invalidation, monitor acceptance, and guide the next review step. 🔐 Non-Promise Statement No script can guarantee continuation, reversal, or outcome certainty. This tool organizes breakout-volume context so users can evaluate the chart more clearly. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions, risk management, and market interpretation. This script is provided for educational and analytical use only and does not provide financial advice. 📚 Educational Note Use the script to study how post-breakout volume behaves after price leaves a prior structure. The most useful insights often come from comparing accepted paths against failed-volume paths over many examples.
Indicador Pine Script®
por AGProLabs
Range Escape Planner [AGPro Series]Range Escape Planner 🧠 Core Idea Is price escaping a mature range with enough quality to monitor, or is the move still vulnerable to failure? 📌 Overview / What it does Range Escape Planner is a chart-first breakout quality and trade planning tool built around mature range escape behavior. Instead of printing a generic breakout signal, the script maps the active range boundary, projected escape corridor, invalidation edge, target guide, obstruction room, follow-through quality, and retest behavior. These components are converted into a 0-100 Escape Score and a clear next-action state. The script produces a range boundary box, escape corridor, risk/target guide lines, compact labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that a range escape will continue. 🎯 Purpose & Design Philosophy This script was built for traders who want to evaluate breakout quality after price leaves a mature range. Many breakout tools identify the break itself but stop before answering the practical planning questions: is the range mature, is the close beyond the boundary strong enough, is volatility expanding constructively, is there clean room, and where is the failure reference? The design philosophy is simple: a range escape is only useful when it has maturity, confirmation, room, and a readable invalidation edge. ⚡ Why This Script Is Different Most tools focus on basic range breaks, box breakouts, session opening ranges, or simple breakout markers. This script does NOT clone Darvas Box Breakout Quality, does NOT rebuild an ORB model, and does NOT act as a generic consolidation breakout signal. Instead, it treats the move as a planning problem. The main output is not a buy or sell command. It is a structured state that helps users separate VALID ESCAPE, ESCAPE WATCH, RANGE READY, OBSTRUCTION, FAILED, and WAIT RANGE conditions. ⚙️ Methodology 1. Context Detection The script maps the prior range from previous bars and checks whether price is still inside, near an edge, or closing beyond the boundary. 2. Reference Mapping It draws the mature range, escape edge, invalidation edge, projected target guide, and older swing obstruction room. 3. Reaction Evaluation The model scores range maturity, close beyond range, volatility expansion, follow-through, retest quality, and obstruction room. 4. Visual Output The result is displayed through centered zone labels, compact event labels, guide lines, deterministic alerts, and a premium AGPro panel. 🗺️ How to Read the Chart Zones = the range box shows the active mature range. The escape corridor shows the projected planning path from the broken boundary toward a target guide. Zone text is centered inside the boxes. Labels = compact markers identify RANGE READY, ESCAPE WATCH, VALID ESCAPE, RETEST HOLD, OBSTRUCTION, and FAILED context. Colors = green highlights cleaner long-side escape quality, pink highlights short-side or failure risk, amber highlights review conditions, and indigo highlights watch or mature-range context. Panel = the panel summarizes Escape Score, Range Age, Confirmation, Obstruction, and Action. 🚦 Signals & States • RANGE READY → the range is mature and price is near an escape edge. • ESCAPE WATCH → price has escaped the range, but follow-through or retest confirmation is still incomplete. • VALID ESCAPE → the escape has stronger score alignment, follow-through or retest support, and acceptable obstruction context. • RETEST HOLD → price retested the escape edge and held outside the prior range. • OBSTRUCTION → the escape is active, but older structure may limit clean room. • FAILED → price returned through the escape edge and the escape context is no longer clean. • WAIT RANGE → no mature range escape context is active. 🔔 Alerts Logic Alerts trigger when the planner detects RANGE READY, New Range Escape, ESCAPE WATCH, VALID ESCAPE, RETEST HOLD, OBSTRUCTION REVIEW, or FAILED ESCAPE conditions. These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands. 🧩 Confluence Logic The strongest context appears when a range is mature, price closes beyond the range boundary, volatility expands constructively, candle follow-through improves, the broken edge holds on retest, and obstruction room remains acceptable. When these components align, the Escape Score improves and the state can progress from RANGE READY to ESCAPE WATCH or VALID ESCAPE. 📊 When to Use • During range breakout and range expansion review • 4H and multi-hour swing charts where the range structure has enough space to breathe • After price has spent time inside a defined range • When evaluating whether a breakout has clean follow-through • When a trader needs a visible invalidation edge and target-room reference • On liquid markets where ATR, range, and swing structure are readable ⚠️ When NOT to Use • Very low-liquidity symbols with unstable candles • Extremely noisy micro-timeframes • Very compressed intraday charts where labels and range boxes can crowd the price action • News-driven spikes where price gaps far beyond the range • Markets where older swing structure is too messy to define clean obstruction room • Situations where the user expects a signal-only entry tool 🎛️ Key Inputs • Planning Side → controls Auto, Long Escape, or Short Escape mode. • Range Lookback → controls how the prior range boundary is mapped. • Minimum Range Age → defines how mature the range should be before stronger scoring. • Minimum Close Beyond Edge ATR → controls how far price must close beyond the boundary before an escape registers. • Follow-Through ATR → defines stronger post-escape movement beyond the edge. • Retest Tolerance ATR → controls how close price can revisit the broken boundary and still count as a hold. • Obstruction Lookback → controls how older swing structure is checked for clean room. • Label and Panel Font Size → controls chart labels, centered box text, and panel readability. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The range box defines the active decision area. The escape corridor shows the forward planning path. The invalidation, target, and obstruction lines add context without turning the chart into a crowded signal board. The AGPro panel provides a compact decision summary with a merged blue title row and clear state hierarchy. 🧪 Practical Usage Workflow 1. Read the panel state and Escape Score. 2. Check whether the range is mature enough. 3. Review the escape corridor and edge line. 4. Check confirmation, retest behavior, and obstruction room. 5. Treat alerts as attention markers, then evaluate broader market context. 🔍 Interpretation Guidelines Think in terms of escape quality, not prediction. A stronger score means multiple structural conditions are aligned. A weaker score means the escape may be premature, poorly confirmed, obstructed, too noisy, or already failed. OBSTRUCTION is especially important because a range can break cleanly while nearby older structure still limits practical room. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not an auto-trading system • Not a guaranteed signal tool • Not a Darvas Box clone • Not an ORB model • Not a generic support/resistance zone map ⚠️ Limitations & Transparency The script is rule-based and depends on recent price, volatility, range, and older swing structure. Timeframe differences can change how range maturity and escape quality appear. Volatility spikes can distort the score. Thin markets can create false escape or failure behavior. Outputs should always be interpreted with broader market structure, liquidity, and risk context. 🧠 Market Context Notes Range escape behavior is most useful when a readable balance area exists before expansion. An escape with no follow-through may still be early. An escape with immediate obstruction may require extra caution. An escape that returns through the broken edge is treated as failed context, not as a new opposite prediction. 🧾 Use Case Examples When price closes beyond a mature range, volatility expands from normal conditions, the candle holds beyond the edge, and older obstruction room is clean, the planner may classify the move as VALID ESCAPE. When price breaks the boundary but quickly returns through the edge, the planner may classify the context as FAILED. When price escapes but older swing structure is immediately ahead, the planner may show OBSTRUCTION even if the score is otherwise improving. 🧱 System Philosophy AGPro planning tools are designed to help traders evaluate context before reacting. This script follows that philosophy by turning a range breakout into a structured planning question: is the escape mature, confirmed, readable, and supported by clean room? 🔐 Non-Promise Statement No indicator can guarantee continuation, reversal, or follow-through. This tool provides structured visual context and rule-based attention markers. It does not provide certainty. 📉 Risk Disclosure Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty. Users are responsible for their own analysis, risk management, and decisions. This script is for educational and analytical use only and does not provide financial advice. 📚 Educational Note Use the planner to study how mature ranges resolve, how escape quality changes after the first break, and how obstruction room affects the readability of breakout continuation.
Indicador Pine Script®
por AGProLabs
Breakout Failure Recovery [AGPro Series]Breakout Failure Recovery 🧠 Core Idea After a failed breakout, is price recovering through the reclaim level or confirming the failure? 📌 Overview / What it does Breakout Failure Recovery is a chart-first failed-breakout lifecycle planner built to evaluate what happens after price probes outside a recent range and closes back inside. The script maps a failure box, reclaim trigger, risk shelf, recovery/rejection labels, and a compact AGPro panel. It converts close-back-inside behavior, reclaim speed, retest response, volume behavior, and time decay into a 0-100 Recovery Score with a clear next-action state. It does not predict the next move, automate execution, or act as a generic failed-break signal. Its purpose is to organize the post-failure decision context. 🎯 Purpose & Design Philosophy This script was built for traders who do not want to treat every failed breakout the same way. Some failed breaks recover quickly through the original breakout level. Others reject the boundary, lose time, and confirm that the attempt has failed. This tool focuses on that decision window. The design supports a planner mindset: identify the failure, measure the reclaim attempt, locate the risk shelf, and decide whether the context deserves review or should be downgraded. ⚡ Why This Script Is Different Most tools mark a failed break as a single event. This script does NOT stop at the failed-break label, does not clone a Swing Failure Pattern engine, and does not become a generic breakout-failure signal board. Instead, it evaluates the recovery path after the failure. The main output is a recovery state: Recovery Active, Recovery Watch, Failure Confirmed, Reclaim Pending, Window Decaying, or No Active Failure. ⚙️ Methodology 1. Context Detection The script builds a recent range from prior bars and checks whether price probes beyond the upper or lower boundary before closing back inside. 2. Reference Mapping When a failed break appears, it maps the failure box, reclaim trigger, and risk shelf around the failed boundary. 3. Reaction Evaluation The model scores close-back-inside quality, reclaim speed, retest response, volume behavior, and time decay. 4. Visual Output The result is shown through centered failure-box text, a centered risk-shelf label, reclaim/reject labels, alert conditions, and a clean AGPro planning panel. 🗺️ How to Read the Chart Failure Box = the failed-break excursion outside the recent range. Reclaim Trigger = the level that shows the original breakout attempt is trying to recover. Risk Shelf = the boundary zone where retest response should be reviewed. Labels = compact markers for failed break, reclaim, reject, decay, and watch context. Colors = teal highlights constructive recovery context, pink highlights failure or rejection pressure, amber highlights shelf review, and indigo highlights watch states. Panel = summarizes Failure State, Recovery Score, Reclaim Level, Risk Zone, and Action. 🚦 Signals & States • Failed Breakout Detected → price probed outside the recent range and closed back inside. • Recovery Watch → recovery conditions are developing, but reclaim confirmation is incomplete. • Recovery Active → reclaim behavior and the Recovery Score have reached stronger review context. • Failure Confirmed → price rejects the failed boundary or moves deeper back into the range. • Reclaim Pending → an active failure exists, but recovery conditions are not strong enough yet. • Window Decaying → the failed-break context is getting old and should carry less weight. 🔔 Alerts Logic Alerts trigger when a failed breakout is detected, when Recovery Watch appears, when Recovery Active appears, or when Failure Confirmed appears. Alerts are attention markers only. They are not trade instructions, entry commands, exit commands, or automated strategy rules. 🧩 Confluence Logic The strongest recovery context appears when price closes back inside the range, reclaims the failed boundary quickly, shows a constructive retest response, receives supportive volume, and does not lose too much time after the failed break. When these components weaken, the script can shift toward Reclaim Pending, Window Decaying, or Failure Confirmed. 📊 When to Use • After a breakout attempt closes back inside a recent range • During range-bound markets with frequent boundary tests • Around failed expansion attempts where reclaim quality matters • When deciding whether a failed breakout deserves continued monitoring • On liquid symbols where range, volume, and candle behavior are readable ⚠️ When NOT to Use • Very low-liquidity symbols with unstable candles • Extremely noisy micro-timeframes • News-driven spikes where levels lose structure quickly • Markets with unreliable volume data • Situations where the user expects a direct signal-only tool 🎛️ Key Inputs • Failure Range Lookback → controls the recent range used to detect failed breaks. • Failure Probe ATR → defines how far price must probe beyond the range boundary. • Recovery Window Bars → controls how long the failed-break recovery window stays relevant. • Retest / Shelf ATR → controls risk shelf thickness and boundary response tolerance. • Recovery Active Threshold → sets the minimum score for the strongest recovery state. • Label and Panel Font Size → controls chart labels, centered zone text, and panel readability. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The failure box gives the visual story. The reclaim trigger and risk shelf define the practical review frame. Labels remain compact and controlled so the chart stays active without becoming crowded. The AGPro panel uses a merged blue title row and a compact decision layout for fast reading. 🧪 Practical Usage Workflow 1. Read the panel state and Recovery Score. 2. Check the failure box and failed boundary. 3. Compare price behavior against the reclaim trigger. 4. Review the risk shelf and rejection response. 5. Treat alerts as attention markers, then evaluate broader market context. 🔍 Interpretation Guidelines Think in terms of failed-break lifecycle, not prediction. A stronger Recovery Score means the failed breakout is attempting to reclaim quickly with better response and participation. A weaker score means the failure may be aging, rejecting, or losing structural quality. Failure Confirmed does not mean the market must continue in one direction. It means the failed-break attempt is not recovering cleanly within the current rule set. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not auto trading • Not guaranteed signals • Not a generic failed-break signal • Not a Swing Failure Pattern clone ⚠️ Limitations & Transparency The script is rule-based and depends on recent price, volatility, range, volume, and candle behavior. Different timeframes can change how failure and recovery appear. Volatility spikes can temporarily distort boundary behavior. Symbols with unreliable volume may produce weaker participation readings. Outputs should always be interpreted with broader market structure, liquidity, and risk context. 🧠 Market Context Notes Failed breakouts are most useful when the boundary is readable and the follow-up reaction is clear. A quick reclaim can show that the failed attempt is recovering. A weak retest, slow response, or deep move back into the range can show that the failed break is confirming instead. 🧾 Use Case Examples When price probes above a range, closes back inside, then quickly reclaims the upper boundary with supportive volume, the planner may classify the context as Recovery Active. When price probes above a range, closes back inside, retests the boundary from below, and rejects again, the planner may classify the context as Failure Confirmed. 🧱 System Philosophy AGPro planning tools are designed to help traders evaluate context before reacting. This script follows that philosophy by turning failed breakouts into a structured decision question: is the attempt recovering, aging, or confirming failure? 🔐 Non-Promise Statement No indicator can provide certainty. This tool provides structured visual context and rule-based attention markers. It does not guarantee continuation, reversal, recovery, or rejection. 📉 Risk Disclosure Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty. Users are responsible for their own analysis, risk management, and decisions. This script is for educational and analytical use only and does not provide financial advice. 📚 Educational Note Use the planner to study how failed breakouts behave after the first rejection, how reclaim speed affects context, and how risk shelves help organize post-failure review.
Indicador Pine Script®
por AGProLabs
Range Expansion Risk Planner [AGPro Series]Range Expansion Risk Planner 🧠 Core Idea Does a range expansion offer clean room, or is price moving into immediate failure risk? 📌 Overview / What it does Range Expansion Risk Planner is a chart-first breakout quality and risk-planning tool built for one specific moment: price has left a defined range, and the trader needs to understand whether the expansion has enough structure to deserve attention. Instead of printing generic breakout signals, the script maps the source range, freezes the broken edge, builds an expansion runway, tracks a failure rail, estimates target room, evaluates retest behavior, and converts those conditions into a 0-100 planner score. The script produces a source range box, expansion runway, failed-expansion review band, risk/target rails, full-state labels, deterministic alerts, and a clean AGPro panel. It does not predict future price movement, automate execution, or guarantee that a breakout will continue. 🎯 Purpose & Design Philosophy This script was built for traders who want to evaluate range expansion quality after price leaves a structure, not simply react to the first candle outside the range. Many tools mark breakouts, draw range boxes, or highlight volatility expansion. The gap is the planning layer after the break: Is the source range mature? Was the expansion candle strong enough? Did price close clearly beyond the edge? Is the retest accepted or weak? Is there enough room before the next target-side reference? The design supports a decision-first workflow. It helps users separate a clean range expansion from a weak release, blocked room, failed expansion, or early unconfirmed movement. ⚡ Why This Script Is Different Most tools focus on breakout arrows, range highs/lows, volatility spikes, or support/resistance zones. This script does NOT become a generic range breakout signal, a generic S/R zone map, a squeeze indicator, or a target predictor. Instead, it evaluates the quality of the expansion plan after the range edge is broken. The main output is not a trade command. It is a planning state that helps the user decide whether the current expansion is CLEAN, on REVIEW, waiting for retest, blocked by room risk, or failing back into the source range. ⚙️ Methodology 1. Context Detection The script maps the active source range using a user-defined lookback and detects whether price has closed beyond the upper or lower edge with enough ATR-normalized distance. 2. Reference Mapping When a qualified expansion appears, the script freezes the source range, the broken edge, the failure rail, and the target-room marker so the plan can be reviewed consistently. 3. Reaction Evaluation The model scores range maturity, expansion candle quality, close beyond edge, retest quality, target-room distance, and failure-rail distance. 4. Visual Output The result is displayed through a source range box, expansion runway, failed-expansion band, risk/target rails, full-state event labels, alerts, and a premium AGPro panel. 🗺️ How to Read the Chart Zones = the source range shows where the expansion came from. The expansion runway shows the path between the broken edge and the target-room marker. The failed-expansion band shows the area where the release may be losing structure. Labels = full-state markers show Range Expansion, Clean Expansion, Expansion Review, Retest Accepted, Failed Expansion, Target Room Reached, Failure Risk, or Range Watch context. Colors = teal highlights cleaner bullish expansion, pink highlights bearish or failed contexts, amber highlights review/risk states, and indigo highlights watch or target-edge states. Panel = the panel summarizes Range Maturity, Expansion Risk, Room Risk, Confirmation, and Action. 🚦 Signals & States • CLEAN EXPANSION → range expansion quality is strong enough to deserve active review. • REVIEW → expansion context is developing, but confirmation or target room is incomplete. • WAIT RETEST → price has expanded, but the broken edge has not yet been accepted clearly. • ROOM BLOCKED → target-side room is limited relative to the current risk structure. • FAILURE RISK → price is back inside the range or close to the failed-expansion area. • FAILED → price crossed the failure rail and the prior expansion plan should be reviewed. • TARGET EDGE → price reached the active target-room marker. • RANGE WATCH → the range is mature enough to monitor, but no qualified expansion is active yet. 🔔 Alerts Logic Alerts trigger when the planner enters clean expansion, review state, retest accepted state, failed-expansion warning, or target-room reached state. These alerts are attention markers only. They are not trade instructions, entry signals, automated strategy commands, or guaranteed outcomes. 🧩 Confluence Logic The strongest context appears when a mature source range releases with a strong expansion candle, price closes clearly beyond the edge, target-side room remains open, the failure rail is not too far away, and the broken edge receives constructive retest behavior. When those components align, the planner score improves and the action state becomes cleaner. 📊 When to Use • After price leaves a clear range • During breakout-review workflows • When comparing whether a release has enough room to justify attention • When price retests the broken range edge • On liquid symbols where ATR, range, and volume behavior are readable • Especially on 4H swing charts, where range release, retest behavior, failure risk, and target-room context remain visually readable ⚠️ When NOT to Use • Extremely low-liquidity symbols • Very noisy micro-timeframes • News-driven candles that distort the range edge • Markets with frequent gaps or unreliable volume • Situations where the user expects a simple buy/sell signal 🎛️ Key Inputs • Expansion Side → controls Auto, Long Expansion, or Short Expansion planning. • Sensitivity → changes how selective the range maturity and edge-close requirements are. • Source Range Lookback → defines the range used before expansion. • ATR Length → normalizes failure rail, label spacing, expansion distance, and room risk. • Retest Review Bars → controls how long an edge retest can improve confirmation quality. • Target-Side Obstacle Lookback → searches for older target-side references before using the measured target. • CLEAN / REVIEW Scores → adjust how strict the state model is. • Visual settings → control boxes, runway, rails, labels, panel location, theme, and font sizes. 🖥️ Interface & Visual Design The interface is built around one primary decision path: source range → expansion runway → failure rail → target room. The panel uses the AGPro public-release standard with one merged blue header row containing only the script name. It keeps the decision fields readable without turning the chart into a crowded dashboard. Labels keep full professional state names, are offset away from candles, and are limited by cooldown and max-visible controls. 🧪 Practical Usage Workflow 1. Read the panel action state. 2. Check whether the source range was mature enough before expansion. 3. Review the expansion runway and target-room marker. 4. Check whether price accepted the broken edge or moved back into failure risk. 5. Use alerts as attention markers, then evaluate the broader market context. 🔍 Interpretation Guidelines A higher score means the model sees better alignment between source range quality, expansion candle quality, edge close, retest behavior, and target room. CLEAN EXPANSION does not mean a trade must be taken. It means the expansion structure is clean enough to deserve active review. REVIEW means the release may be developing, but the user should check confirmation and room quality before treating it as clean. FAILED and FAILURE RISK are caution states. They help identify when an expansion is losing structure after leaving the range. 🚫 What This Script Is NOT This script is not a prediction engine. It is not financial advice. It is not an auto-trading system. It does not provide guaranteed signals. It does not replace user judgment, risk management, or broader market analysis. ⚠️ Limitations & Transparency Timeframe differences can change how range maturity, retests, and target-room references appear. Volatility changes can widen failure rails or reduce clean target room. Fast market conditions can move from CLEAN to FAILED quickly if price returns into the source range. The script is rule-based and should be interpreted as an analytical planning layer, not as certainty. 🧠 Market Context Notes Range expansion quality is not only about breaking the edge. A cleaner expansion usually needs a readable source range, a decisive close beyond the edge, enough room before obstruction, and a failure reference that is not too wide. The planner is most useful when it prevents users from treating every breakout as equal. 🧾 Use Case Examples When price closes beyond a mature range and the target-room marker remains far enough away, the planner may move into REVIEW or CLEAN EXPANSION. When price retests the broken edge and holds outside the range, confirmation can improve. When price closes back through the failure rail, the planner marks FAILED so the old expansion idea is not treated as clean anymore. 🧱 System Philosophy Range Expansion Risk Planner follows the AGPro Series decision-engine approach: Context first. Risk before reaction. Structure before signal. Attention markers instead of promises. 🔐 Non-Promise Statement No indicator can remove uncertainty. No score, state, label, alert, range box, runway, or rail should be interpreted as guaranteed market direction. 📉 Risk Disclosure Trading involves risk. All decisions remain the responsibility of the user. This script is for educational and analytical chart review only and does not provide financial advice. 📚 Educational Note Use this script to study how range expansions develop, how broken edges behave after release, and how failure risk can be organized visually before making discretionary decisions.
Indicador Pine Script®
por AGProLabs
Volatility Expansion Planner [AGPro Series]Volatility Expansion Planner 🧠 Core Idea Is volatility expanding with structure, or is the chart only producing random noise? 📌 Overview / What it does Volatility Expansion Planner is a chart-first volatility expansion and breakout quality tool built to evaluate whether a release from compression has enough structure to deserve active attention. Instead of showing another generic expansion signal, the script studies ATR expansion, prior range release, close efficiency, volume support, trend alignment, compression age, and the active risk shelf behind the move. These components are converted into a 0-100 Expansion Score and a clear next-action state. The script produces an expansion corridor, ATR expansion band, prior range edge, risk shelf, compact quality labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that an expansion will continue. 🎯 Purpose & Design Philosophy This script was built for traders who want to separate structured volatility expansion from unstable noise. Many volatility tools identify compression, release, or regime changes, but they often stop before answering the practical planning question: is the expansion clean enough to evaluate, and where is the risk reference if the release fails? The design philosophy is simple: volatility expansion is only useful when it has structure, confirmation, and a readable risk shelf. ⚡ Why This Script Is Different Most tools focus on squeeze dots, volatility regime labels, ATR readings, or basic breakout markers. This script does NOT clone a Squeeze Momentum Indicator, does not rebuild an ATR Compression Map, and does not act as a generic breakout signal. Instead, it evaluates whether expansion is structurally supported. The main output is not a trade command. It is a planning state that helps users distinguish STRUCTURED expansion from WATCH, RISK REVIEW, NOISE, or WAIT conditions. ⚙️ Methodology 1. Context Detection The script reads the active expansion side using prior range release and trend context, or lets the user force long-side or short-side expansion planning. 2. Reference Mapping It maps the prior range edge, current ATR expansion, compression age, risk shelf, and projected expansion corridor. 3. Reaction Evaluation The model scores ATR expansion, range breakout, close efficiency, volume support, trend alignment, compression maturity, and risk shelf quality. 4. Visual Output The result is displayed through an expansion corridor, ATR band, range edge, risk shelf, compact labels, deterministic alerts, and a premium AGPro panel. 🗺️ How to Read the Chart Zones = the expansion corridor shows the projected release path from the prior range edge toward a measured target guide. Its label is centered inside the corridor. Labels = compact state markers show STRUCTURED, WATCH, RISK REVIEW, NOISE, or SHELF CHECK context. Colors = green highlights cleaner structured expansion, pink highlights unstable expansion risk, amber highlights review conditions, and indigo highlights watch conditions. Panel = the panel summarizes Expansion Score, Squeeze Age, Confirmation, Risk Shelf, and Action. 🚦 Signals & States • STRUCTURED → volatility is expanding with range release, confirmation, and a usable risk shelf. • WATCH → expansion context is improving but confirmation is incomplete. • RISK REVIEW → expansion is active but the risk shelf is too tight or too wide for clean planning. • NOISE → volatility is hot or inefficient and may represent unstable movement. • WAIT → the script does not detect a strong enough expansion context yet. • SHELF CHECK → price crossed the prior risk shelf and the expansion context should be reviewed. 🔔 Alerts Logic Alerts trigger when the planner enters STRUCTURED expansion, WATCH state, NOISE state, RISK REVIEW state, or when price crosses the prior risk shelf. These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands. 🧩 Confluence Logic The strongest context appears when ATR expands from a prior compressed structure, price closes beyond the prior range edge, candle efficiency is strong, volume support improves, trend alignment agrees with the expansion side, and the risk shelf remains readable. When these components align, the Expansion Score improves and the state can move from WATCH to STRUCTURED. 📊 When to Use • Before evaluating volatility expansion after a quiet range • During breakout or continuation attempts where expansion quality matters • When price releases from a prior structure but confirmation is uncertain • When comparing whether an expansion has clean risk context or only noisy movement • On liquid symbols where range, volume, and ATR behavior are readable ⚠️ When NOT to Use • Very low-liquidity symbols with unstable candles • Extremely noisy micro-timeframes • News-driven spikes where ATR expands abruptly without structure • Markets where volume is unreliable and price gaps distort the risk shelf • Situations where the user expects a signal-only entry tool 🎛️ Key Inputs • Expansion Side → controls Auto, Long Expansion, or Short Expansion mode. • Prior Range Lookback → controls how the script maps the range edge before release. • ATR Baseline → controls how current volatility is compared with normal volatility. • Minimum Squeeze Age → defines how mature compression should be before stronger expansion scoring. • Risk Shelf Lookback → controls the shelf used behind the expansion for planning context. • STRUCTURED Threshold → sets the minimum score required for the strongest state. • Label and Panel Font Size → controls chart labels, corridor text, and panel readability. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The expansion corridor gives the main visual story. The range edge and risk shelf define the practical planning frame. The ATR band adds volatility context without turning the script into a lower-pane oscillator. The AGPro panel provides a compact decision summary with a merged blue title row and clear state hierarchy. 🧪 Practical Usage Workflow 1. Read the panel state and Expansion Score. 2. Check whether price is releasing from the prior range edge. 3. Review the risk shelf distance and confirmation state. 4. Compare the expansion corridor with broader structure. 5. Treat alerts as attention markers, then evaluate the broader market context. 🔍 Interpretation Guidelines Think in terms of expansion quality, not prediction. A stronger score means multiple structural conditions are aligned. A weaker score means expansion may be premature, poorly confirmed, too hot, or difficult to plan around. RISK REVIEW is especially important because volatility can expand while the practical risk reference remains too tight, too wide, or unclear. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not an auto-trading system • Not a guaranteed signal tool • Not a Squeeze Momentum clone • Not an ATR Compression Map clone ⚠️ Limitations & Transparency The script is rule-based and depends on recent price, volatility, range, and volume behavior. Timeframe differences can change how compression and expansion appear. Volatility spikes can temporarily distort the score. Symbols with unreliable volume may produce weaker participation readings. Outputs should always be interpreted with broader market structure and liquidity context. 🧠 Market Context Notes Volatility expansion is most useful when it appears after a readable compression phase and respects a clear structural shelf. Expansion without shelf clarity can still move, but it is harder to plan around. Expansion with poor close efficiency or excessive ATR heat can be noisy even when price breaks a range edge. 🧾 Use Case Examples When price closes beyond a prior range edge with rising ATR, improved volume support, efficient candle structure, and a defined risk shelf, the planner may classify the move as STRUCTURED. When ATR expands sharply but candles close poorly and the shelf is too far away, the planner may classify the context as NOISE or RISK REVIEW. 🧱 System Philosophy AGPro planning tools are designed to help traders evaluate context before reacting. This script follows that philosophy by turning volatility expansion into a structured planning question: Is the release clean, confirmed, and readable enough to deserve attention? 🔐 Non-Promise Statement No indicator can guarantee continuation, reversal, or follow-through. This tool provides structured visual context and rule-based attention markers. It does not provide certainty. 📉 Risk Disclosure Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty. Users are responsible for their own analysis, risk management, and decisions. This script is for educational and analytical use only and does not provide financial advice. 📚 Educational Note Use the planner to study how volatility behaves after compression, how expansion quality changes across timeframes, and how risk shelf clarity affects the readability of a move.
Indicador Pine Script®
por AGProLabs
No-Progress Failure Map [AGPro Series]No-Progress Failure Map 🧠 Core Idea Did price trigger a setup but fail to travel far enough afterward? 📌 Overview / What it does No-Progress Failure Map is a post-trigger execution failure planner designed to evaluate whether an active setup is actually moving after it triggers, or simply stalling around the trigger area. The script builds a progress window, maps a risk shelf, projects a minimum progress rail, tracks elapsed bars, measures distance travelled in ATR, evaluates candle efficiency, reads volume participation, and converts the result into a 0-100 Progress Score with a clear action state. It does not predict price direction, automate trading, or print guaranteed entry or exit commands. Its purpose is to organize the question of progress versus failure after a trigger appears. 🎯 Purpose & Design Philosophy This script was built for traders who do not want to judge a setup only at the moment it triggers. Many setups look valid at first, but the real weakness appears later: price does not travel far enough, time passes, participation fades, or the trigger side is lost. This tool turns that hidden execution problem into a visible decision layer. It supports a planning mindset: trigger, observe progress, evaluate time cost, check failure risk, and decide what deserves attention next. ⚡ Why This Script Is Different Most tools focus on finding the trigger itself. This script does NOT behave like a generic signal indicator, opening range failure tool, RSI failure swing detector, order-block map, support/resistance scanner, or broad regime dashboard. Instead, it asks a narrower execution question: after a setup starts, is price travelling enough to keep the idea alive, or is the setup becoming a no-progress failure? ⚙️ Methodology 1. Context Detection The script selects the evaluation side using Auto, Long Context, or Short Context. Auto mode follows trend and slope context. 2. Trigger Mapping The planner starts a tracking window from a selected trigger model: Range Break, Impulse Close, or Trend Reclaim. 3. Progress Evaluation It measures favorable travel, elapsed bars, close efficiency, relative volume, time decay, reclaim behavior, and risk shelf pressure. 4. Visual Output It displays a stalled-move box, minimum progress rail, risk shelf, trigger line, event labels, alerts, and a compact AGPro panel. 🗺️ How to Read the Chart Zones = the stalled-move box between the risk shelf and the minimum progress rail. Labels = compact event markers for Trigger, No Progress, Reclaim, Travel OK, and Failed states. Colors = teal marks accepted progress, pink/red marks failure or invalidation, amber marks stalled progress, and indigo marks active watch or recovery context. Panel = summarizes Progress Score, Elapsed Bars, Distance Travelled, Failure Risk, and Action. 🚦 Signals & States • Trigger → a new post-trigger progress window is active. • Watch Progress → the setup is active but has not yet proven enough travel. • Stalled → price has lost the trigger side or is not progressing cleanly. • No Progress → the evaluation window matured without enough favorable travel. • Reclaim → price recovered the trigger side after temporary loss. • Travel OK → the setup reached the accepted progress threshold. • Failed → the tracked setup crossed its risk shelf. 🔔 Alerts Logic Alerts trigger when a new progress window starts, when no-progress failure risk appears, when travel is accepted, when a reclaim appears, or when the risk shelf is crossed. Alerts are attention markers. They are not trade instructions, automated strategy commands, or certainty signals. 🧩 Confluence Logic The strongest progress context appears when favorable travel, close efficiency, volume participation, time efficiency, and trigger-side control align. When travel is weak and elapsed bars increase, the failure-risk reading rises. When the trigger side is lost and reclaimed, the script marks recovery context but does not treat it as certainty. 📊 When to Use • After a breakout-style trigger appears. • During continuation attempts that should show progress quickly. • Around trend reclaim setups where follow-through matters. • When a setup looks active but price remains trapped near the trigger. • On liquid markets where ATR and relative volume are meaningful. ⚠️ When NOT to Use • Extremely low-liquidity markets with unreliable candles or volume. • Very noisy micro-timeframes where trigger-side loss is frequent. • News-driven volatility spikes where ATR expands suddenly. • Symbols where volume data is missing or not useful. • As a standalone reason to enter, exit, or size a trade. 🎛️ Key Inputs • Evaluation Side → controls Auto, Long Context, or Short Context. • Trigger Model → selects Range Break, Impulse Close, or Trend Reclaim activation. • Evaluation Window Bars → defines how long the setup has to show minimum progress. • Minimum Progress ATR → defines the expected favorable travel threshold. • Progress Accepted ATR → defines stronger follow-through. • Risk Shelf Buffer ATR → controls invalidation distance around the initial shelf. • Visual Settings → control boxes, rails, prior boxes, labels, panel location, theme, and font sizes. 🖥️ Interface & Visual Design The interface is chart-first. The stalled-move box is the primary visual object and contains a centered progress meter. Rails show trigger, risk, and progress references without turning the chart into a crowded level map. The panel follows the AGPro publication layout with a single merged blue title row, adjustable location, adjustable theme, and adjustable font size. 🧪 Practical Usage Workflow 1. Read the panel state and Progress Score. 2. Check whether price is travelling beyond the minimum progress rail. 3. Review elapsed bars versus the evaluation window. 4. Watch for No Progress, Reclaim, Travel OK, or Failed labels. 5. Interpret the output inside broader market structure and risk context. 🔍 Interpretation Guidelines A high Progress Score means the setup is moving efficiently relative to this rule set. It does not mean price must continue. A No Progress label means the setup has not travelled enough after the selected trigger. It does not guarantee failure, but it highlights weakening execution quality. A Failed state means the mapped risk shelf was crossed. It should be read as rule-based invalidation context, not as financial advice. 🚫 What This Script Is NOT • Not a prediction engine. • Not financial advice. • Not auto trading. • Not guaranteed signals. • Not a buy/sell signal service. • Not an opening range failure tool. • Not an RSI failure swing detector. • Not a generic support/resistance or order-block map. ⚠️ Limitations & Transparency Progress quality depends on the selected trigger model, lookback, ATR length, timeframe, and market conditions. Different symbols may produce different volume behavior. High volatility can expand the tracking box quickly, while low volatility can make progress thresholds harder to interpret. The script is rule-based and should be used as an analytical planning layer, not as a complete trading system. 🧠 Market Context Notes No-progress behavior is often a time and efficiency problem, not just a price-level problem. A setup can trigger, remain technically alive, and still become unattractive if it fails to move far enough while time passes. This script makes that condition visible. 🧾 Use Case Examples When price breaks a recent range but remains near the trigger after the evaluation window, the map can mark No Progress and increase failure risk. When price loses the trigger side and then reclaims it, the script can mark Reclaim so the user can review whether recovery is meaningful. When price travels beyond the accepted progress threshold with efficient closes, the panel can move toward Travel OK context. 🧱 System Philosophy No-Progress Failure Map follows the AGPro decision-engine approach: the script should help users evaluate context, quality, risk, progress, and next action without promising an outcome. The goal is not to add another signal. The goal is to make post-trigger progress easier to judge. 🔐 Non-Promise Statement No script can guarantee direction, continuation, reversal, or outcome. This tool provides structured chart context only. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own analysis, risk controls, position sizing, and trading decisions. This script does not provide financial advice, investment advice, or guaranteed trading outcomes. 📚 Educational Note Use the script to study how triggered setups behave after activation. The most useful reading comes from comparing progress, elapsed bars, risk shelf behavior, and broader market context.
Indicador Pine Script®
por AGProLabs
Cup and Handle Quality [AGPro Series]Cup and Handle Quality 🧩 OVERVIEW Cup and Handle Quality is a visual pattern-quality overlay for one of the most recognized continuation structures in technical analysis: the cup and handle. The script is designed to map the full pattern lifecycle instead of only marking a breakout candle. It studies the left cup rim, the cup base, the right rim recovery, the controlled handle pullback, the breakout behavior, and the measured projection context. The goal is to make cup and handle structures easier to recognize, compare, and explain directly on the chart. The final visual output is intentionally clear. The detected cup and handle candle ranges are framed with subtle boxes, while thick curved outlines make the formation readable at a glance. The rim line, target line, DEPTH arrow, and MOVE arrow help users understand how the structure is measured, not just where the label appears. ✅ WHAT MAKES IT DIFFERENT Most public cup and handle tools focus on one of two things: either they draw a simple breakout marker, or they scan aggressively and leave the chart crowded with low-context shapes. Cup and Handle Quality takes a narrower approach. It combines three layers: - Structure recognition: left rim, cup base, right rim, and handle low - Quality scoring: cup symmetry, handle depth, and breakout quality - Visual education: cup box, handle box, thick pattern outline, rim line, target line, and measurement arrows This makes the script more than a pattern detector. It is also a visual explanation tool. The chart shows where the cup was detected, where the handle formed, how deep the cup is, and where the measured projection line comes from. 🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS This script has its own lane inside the AGPro Series. It is not a flag scanner, wedge detector, triangle breakout module, inside-bar breakout tool, Donchian breakout validator, double-top detector, head-and-shoulders detector, generic support-resistance map, or supply-demand zone script. Its lane is specifically: Cup rim recovery -> controlled handle depth -> breakout participation -> measured projection line. The script focuses on the complete cup and handle lifecycle. It does not try to replace broader breakout engines, market-structure tools, support-resistance tools, liquidity tools, or trend dashboards. The defining feature is the combination of a recognizable cup-and-handle drawing with a quality panel that grades the actual pattern components. ⚙️ METHODOLOGY The engine builds the pattern from pivot structure. A qualified setup begins with a left rim, moves into a cup low, recovers into a right rim, and then forms a handle pullback after the right rim. The quality model evaluates: 1. Cup Symmetry The script compares the two rim areas and measures how balanced the cup is over time. A cleaner return from the cup base into the right rim area produces a stronger symmetry reading. 2. Handle Depth The handle is measured as a percentage of cup depth. A useful handle should create structure without pulling so deeply that the cup profile loses strength. The input range allows the user to control how strict or flexible the handle requirement should be. 3. Breakout Quality Breakout quality is calculated from candle behavior and participation context. The script checks distance beyond the rim, candle body efficiency, close location, and relative volume against a configurable baseline. 4. Final Score The final score combines the structure score and breakout behavior into a compact quality reading. Developing setups can be shown before breakout confirmation, while confirmed breakouts require the breakout quality gate. 📊 PANEL The AGPro panel displays the main quality dimensions in a compact format: - Cup Symmetry - Handle Depth - Breakout Quality - Score The first row follows the AGPro standard with a merged blue title row. Panel location, panel theme, panel font size, and label font size are adjustable from settings. 🎛️ KEY INPUTS - Pivot Span controls structural sensitivity. - Minimum Cup Bars defines the shortest accepted cup duration. - Maximum Cup Bars defines the longest accepted cup duration. - Maximum Rim Variance % controls how closely the left and right rims must align. - Minimum Cup Depth ATR filters shallow structures. - Minimum Handle Depth % filters handles that are too shallow. - Maximum Handle Depth % filters handles that are too deep. - Breakout Volume Baseline controls the relative volume comparison. - Minimum Setup Score controls developing setup visibility. - Minimum Breakout Quality controls confirmed breakout strictness. - Minimum Pattern Score controls the final quality gate. - Show Developing Setup controls pre-breakout visualization. - Show Cup Path controls the curved cup drawing and cup candle box. - Show Handle Box controls the detected handle range. - Show Target Line controls the measured projection line. - Show Measurement Arrows controls the DEPTH and MOVE explanation arrows. - Pattern Stroke Width controls the thickness of the cup and handle outlines. - Target Projection Bars controls how far the measured target line extends. 🔍 HOW TO READ IT Start with the rim line. This is the reference level the structure must recover into and eventually move beyond. Then read the cup. The subtle cup box marks the detected candle range, while the thick curved outline helps the formation read visually as a cup instead of a simple V-shaped swing. Next read the handle. The handle box marks the controlled pullback area after the right rim. The curved handle outline makes the handle easier to recognize without turning it into a generic rectangle pattern. The DEPTH arrow shows the measured cup depth. The MOVE arrow transfers that depth upward from the rim area. The TARGET line shows the forward measured projection level. The panel summarizes the same structure numerically. Stronger Cup Symmetry, disciplined Handle Depth, and stronger Breakout Quality combine into the final Score. 🧩 BEST USE CASES Cup and Handle Quality is best used on liquid symbols and timeframes where swing structure has enough room to develop. It is especially useful for users who want a clean visual map of a classic continuation pattern without filling the chart with unrelated pattern families. The default settings are tuned for active discovery. Users who want fewer patterns can raise pivot sensitivity or score thresholds. Users who want a more reactive view can lower the score thresholds, while still using the chart visuals to review pattern quality. 🧠 VISUAL DESIGN PHILOSOPHY The design philosophy is simple: make the pattern understandable without making the chart noisy. The cup and handle are drawn with thick curved lines because this pattern is visual by nature. Newer users should be able to see the shape immediately. At the same time, the candle boxes keep the drawing grounded in the actual detected structure. The target is shown as a line rather than a large zone, keeping the projection clean. The DEPTH and MOVE arrows explain the measurement logic without turning the indicator into a crowded education panel. Labels are compact, and the panel is restrained so the chart remains the main focus. 🔔 ALERTS The script includes an alert condition for confirmed cup and handle breakouts. Alert name: Cup and Handle Quality Breakout Alert message: Cup and Handle Quality : high-quality cup and handle breakout confirmed on {{ticker}} at {{close}}. Alerts are tied to confirmed breakout logic, which means the structure, breakout quality, and pattern score must pass the configured gates. 🔹 LIMITATIONS AND TRANSPARENCY Cup and handle structures are pattern-based and depend on pivot interpretation. Different sensitivity settings can produce different structures on the same chart. Very noisy markets, illiquid symbols, extreme gaps, and unusually compressed price action can reduce pattern readability. Lower thresholds may produce more setups, but visual review remains important when using any chart-pattern tool. The thick cup and handle lines are designed as visual guides. The subtle candle boxes identify the detected structure ranges, while the curved outlines make the pattern easier to understand on the chart. ✅ IDEAL USER This script is built for traders and analysts who want a clean, visual, and structured way to study cup and handle formations. It is especially useful for: - Users who want classic chart patterns with a modern quality layer - Price-action traders who care about structure, handle depth, and breakout behavior - Chart reviewers who want a clear visual explanation of the setup - Newer users who benefit from seeing the cup, handle, depth, move, and target drawn directly on the chart - AGPro users who want a focused cup-and-handle tool that does not overlap with broader breakout or market-structure scripts
Indicador Pine Script®
por AGProLabs
Darvas Box Breakout Quality [AGPro Series]Darvas Box Breakout Quality 🔹 OVERVIEW Darvas Box Breakout Quality is built for one of the most recognizable and widely searched chart-pattern structures in technical analysis: the Darvas Box. The script focuses on the full Darvas lifecycle: Box formation → compression quality → breakout direction → volume support → failed-break behavior. Instead of treating every horizontal range as support and resistance, this script waits for a Darvas-style structure to form, validates the box by age and volatility-adjusted height, then evaluates how price resolves from that box. The result is a clean chart-pattern workflow designed for traders who want to study rectangular compression and breakout quality without turning the chart into a crowded zone map. The main visual element is the active Darvas box itself. By default, resolved boxes are removed after breakout so the chart stays focused on the current live structure instead of filling with old rectangles. 🔹 WHAT MAKES IT DIFFERENT Most box or breakout tools stop at drawing a rectangle or marking the first break beyond a level. Darvas Box Breakout Quality adds structure, scoring, and failure awareness. Core differentiators: • Darvas-first structure logic The rectangle is not a generic support/resistance zone. It comes from a Darvas box formation process built around a fresh seed high, containment, age, and volatility-adjusted box height. • Compression quality The script measures whether the box has enough maturity and controlled range behavior before treating it as a meaningful active structure. • Breakout quality score Every qualified breakout is evaluated with a 0-100 model that includes compression quality, relative volume, breakout distance, candle body participation, and directional close location. • Volume confirmation Breakout labels can require volume support, helping separate stronger participation events from weaker boundary pokes. • Failed-break tracking After breakout, the script watches whether price returns back inside the former box within the selected failure window. If it does, the event is marked as a failed break. • Premium visual restraint The default chart view uses one active box, compact labels, controlled label spacing, and a compact AGPro panel. The goal is to make the chart informative without making it noisy. 🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS This script is intentionally separated from the existing AGPro breakout and chart-pattern family. It is not Inside Bar Breakout Quality, because it does not require a mother bar or inside-bar compression sequence. It is not Donchian Breakout Quality, because it is not based on rolling channel highs and lows. It is not Opening Range Breakout logic, because it is not tied to a session-defined range. It is not Triangle Breakout Quality, because it does not use converging pivot boundaries, apex pressure, or diagonal structure. It is not Breakout Volume Quality, because volume is only one part of the confirmation model, not the entire concept. It is not a supply/demand, order-block, or generic support/resistance zone script. The rectangle exists only when the Darvas box formation process supports it. That distinction matters visually and analytically. On the chart, this script tells a Darvas story: rectangular compression, active box behavior, quality of release, and failed-break review. ⚙️ METHODOLOGY 1. Darvas seed detection The script looks for a fresh high over the selected lookback period. This high becomes the initial reference for a potential Darvas box. 2. Box formation After the seed appears, price must spend enough time contained beneath the upper boundary while the lower boundary develops. The box remains in formation until it meets the selected age and height requirements. 3. Volatility normalization The box height is measured relative to ATR. This helps filter boxes that are too flat to matter or too wide to represent clean compression. 4. Active box state When the box qualifies, the script displays the active Darvas box and optional midpoint. The box projects forward so the active breakout boundary remains visible while price approaches it. 5. Breakout confirmation A bullish breakout requires price to resolve above the Darvas top. A bearish breakout requires price to resolve below the Darvas bottom. Users can require close-based confirmation for stricter filtering. 6. Quality score The breakout score combines: • Compression quality • Relative volume support • ATR-normalized breakout distance • Candle body participation • Directional close location 7. Failed-break monitoring After breakout, the script watches a defined number of bars. If price returns back inside the former Darvas boundary, the failed-break marker is printed. 📊 PANEL The AGPro panel summarizes the current Darvas environment: • Box Age • Compression • Breakout Side • Volume Support • Latest Quality / State The first panel row follows the AGPro publication standard: one merged blue header row containing only the panel title. Panel location, panel theme, and panel font size are adjustable from settings. 🎛️ KEY INPUTS Darvas Box Detection • New High Lookback • Minimum Box Age • Maximum Box Age • ATR Length • Minimum Box Height ATR • Maximum Box Height ATR • Require Close Beyond Box Breakout Quality • Volume MA Length • Volume Support Threshold • Require Volume Support • Target Break Distance ATR • Minimum Breakout Score • Failed Break Window Visual Controls • Show Active Darvas Box • Show Box Midline • Show Breakout Labels • Show Failed Break Markers • Keep Resolved Box • Box Projection Bars • Label Cooldown Bars • Maximum Visible Labels • Label Offset ATR • Label Stack Offset ATR • Label Font Size Panel • Panel Location • Panel Theme • Panel Font Size 🔍 HOW TO READ IT When a Darvas box becomes active, the chart displays the live rectangular structure. The panel shows how old the box is, how compressed it is, and whether the latest environment has breakout direction or volume support. When price resolves outside the box with enough quality, the chart prints a compact breakout label such as UP 79 or DN 75. The number represents the breakout quality score. When price fails to hold outside the box and returns back inside during the selected failure window, the script prints a compact failed-break marker such as FAIL UP or FAIL DN. The best readings come when the box is visually clear, compression is meaningful, and the breakout candle has both directional close quality and volume support. 🧩 BEST USE CASES • Classic Darvas box formations • Rectangular range compression • Box breakout quality review • Volume-backed breakout confirmation • Failed-break review after a box release • Clean chart-pattern study • Multi-timeframe Darvas structure observation • Screenshot-friendly public chart analysis 🧠 VISUAL DESIGN PHILOSOPHY Darvas Box Breakout Quality is designed to look premium through restraint. The script avoids filling the chart with old boxes by default. It keeps the active Darvas box as the main visual layer, uses short event labels, adds cooldown and stack spacing to reduce overlap, and keeps the panel compact. This makes the indicator easier to publish, easier to read, and easier to use across different symbols and timeframes. 🔔 ALERTS The script includes alert conditions for: • High-quality bullish Darvas breakout • High-quality bearish Darvas breakout • Failed bullish Darvas breakout • Failed bearish Darvas breakout These alerts follow the same structure-aware logic used by the chart labels. 🔹 LIMITATIONS AND TRANSPARENCY Darvas box detection is structure-based and depends on the selected lookback, age, and ATR filters. Changing those settings can make the script more selective or more active. Volume support depends on the quality of the symbol's volume feed. On instruments where volume is less informative, users may prefer to adjust the volume threshold or disable the volume requirement. The score is a structured description of breakout quality according to the script's internal model. It is designed to help compare Darvas box releases by quality, not to replace the user's broader market context. ✅ IDEAL USER This script is designed for traders who want a focused Darvas box tool with cleaner structure detection, breakout quality scoring, volume confirmation, failed-break awareness, and a premium chart layout. It is best suited for users who want the Darvas box itself to remain the main story on the chart.
Indicador Pine Script®
por AGProLabs
Wedge Reversal Detector [AGPro Series]Wedge Reversal Detector 🔷 Overview Wedge Reversal Detector is a focused chart-pattern engine built for one specific structure: the rising wedge and falling wedge. Instead of scanning every possible reversal pattern, drawing broad support and resistance, or behaving like a generic breakout dashboard, this script studies the geometry of a wedge itself: confirmed pivot boundaries, slope convergence, pattern maturity, reversal break quality, projected reaction zone, and invalidation context. The goal is to make wedge analysis cleaner and more objective on a live chart. A valid wedge is not treated as just two random trendlines. The script requires a confirmed pivot structure, a meaningful initial width, a narrowing final width, and the correct slope relationship for either a rising wedge or a falling wedge. Once a qualified structure is active, it draws the converging boundaries directly on the chart and waits for a reversal-side break. The detector also includes two visual preparation layers. The developing-wedge preview layer can draw dashed boundaries before the structure is fully armed. The Wedge Radar layer keeps the latest compression window visible when no confirmed candidate is active. Radar projection is capped so higher-timeframe charts stay clean, and low-compression radar states can remain boundary-only until the structure becomes visually meaningful. Break labels, reaction zones, and invalidation guides remain reserved for stricter confirmed candidates. This keeps the chart visually informative without weakening the actual confirmation logic. The visual layer includes compact boundary tags that label the upper and lower rails directly on the right side of the structure. These tags are designed as chart annotations, not signal spam: they identify whether the rail is acting as a rejection rail, compression rail, reclaim rail, break rail, or invalidation rail. A single optional compression tag can also summarize the current radar or wedge state. 🔶 Why This Is Different Many wedge indicators stop at pattern drawing. Others become broad pattern scanners that mix wedges with channels, double tops, double bottoms, triangles, support and resistance zones, and unrelated reversal signals. Wedge Reversal Detector intentionally stays narrower. Its edge is the sequence: 1. Detect a qualified rising or falling wedge from confirmed pivots. 2. Measure whether the boundaries are genuinely converging. 3. Grade wedge maturity before any break occurs. 4. Confirm the reversal-side break with an optional close-based rule and ATR buffer. 5. Score break quality using maturity, boundary expansion, candle structure, close location, and volume participation. 6. Project a concept-native reaction zone from the wedge width. 7. Display a clean invalidation guide so the structure remains readable after the break. This makes the script a wedge lifecycle tool, not a general reversal scanner. 💎 Unique Edge The most important difference is that the script treats a wedge as a living geometric compression structure. It does not simply connect the latest two highs and lows and call the pattern complete. A candidate must pass span, width, convergence, and slope requirements before it becomes active. For rising wedges, the script looks for rising pivot highs and rising pivot lows where the lower boundary is climbing faster than the upper boundary. This creates upward compression, which is the core geometry behind a rising wedge. For falling wedges, it looks for falling pivot highs and falling pivot lows where the upper boundary is falling faster than the lower boundary. This creates downward compression, which is the core geometry behind a falling wedge. That difference matters because many weak wedge tools confuse ordinary channels with wedge compression. This script separates those structures by requiring the final width to be materially smaller than the starting width. 🔹 Methodology The engine begins with confirmed pivot highs and pivot lows. The user controls the pivot confirmation length, which allows the detector to be tuned for intraday, swing, or higher-timeframe charts. From the latest confirmed swing pair, the script builds two boundary lines: - Upper boundary from confirmed pivot highs - Lower boundary from confirmed pivot lows The detector then evaluates: - Pattern span in bars - Initial boundary width measured against ATR - Final boundary width relative to the starting width - Upper boundary slope - Lower boundary slope - Correct rising-wedge or falling-wedge geometry Only when those requirements align does the pattern become an active wedge. 🔸 Break Quality Model A wedge break is scored only after the reversal-side boundary is broken. The break quality score is built from multiple factors: - Wedge maturity - Distance beyond the broken boundary - Candle body participation - Close location inside the break candle - Volume ratio versus recent average volume The score is translated into a simple grade so the chart stays easy to read. This does not claim that a break must continue. It gives the user a structured read of how strong the confirmed break appears under the script's own rules. 🎯 Projected Reaction Zone After a confirmed wedge reversal break, the script projects a reaction zone using the initial wedge width. This zone is not a generic support/resistance box. It is tied directly to the wedge geometry and appears only after the structure confirms. The goal is to show the next area where price may naturally react after escaping the compression. The zone width and projection length are configurable, so users can keep the chart compact or allow more forward context depending on timeframe and style. 🧭 Invalidation Context The script also draws an invalidation guide after a confirmed break. For a bullish falling-wedge break, invalidation is tracked below the opposite wedge boundary with an ATR buffer. For a bearish rising-wedge break, invalidation is tracked above the opposite wedge boundary with an ATR buffer. This keeps the post-break structure organized without adding trade instructions or turning the script into a strategy. 📊 Panel The compact AGPro panel summarizes the current wedge lifecycle: - Wedge Type - Maturity - Break Quality - Target Zone Panel location, panel theme, and panel font size are adjustable from settings. The first panel row uses the AGPro standard: one merged blue header row containing only the panel title. ⚙️ Key Settings - Pivot Confirmation Length controls how strict the swing structure is. - Minimum Wedge Span filters out tiny patterns. - Maximum Final Width Ratio controls how much convergence is required. - Developing Wedge Preview Ratio controls how early dashed formation boundaries can appear. - Wedge Radar controls the latest-window visual radar that prevents panel-only charts while waiting for confirmed wedge geometry. - Radar Projection Bars limits how far radar boundaries extend into future bars. - Radar Fill Threshold keeps low-compression radar structures from creating oversized filled areas. - Boundary Tags add compact right-side rail annotations so the structure is easier to read without covering candles. - Compression Tag shows one status label for radar compression or armed-wedge maturity. - Boundary Break Buffer ATR adds confirmation distance beyond the wedge boundary. - Volume Confirmation Ratio contributes to break quality scoring. - Projection Length Bars controls how long the reaction zone extends forward. - Label Font Size and Label Offset ATR help maintain a clean chart presentation. 🧩 How It Differs From Other AGPro Tools This script is intentionally separate from AGPro channel, breakout, liquidity, and broad reversal tools. It is not a channel map. Channel tools organize parallel or multi-family structure. Wedge Reversal Detector only studies converging wedge geometry. It is not a double top or double bottom detector. Those patterns are based on repeated horizontal rejection and neckline behavior. This script is based on converging diagonal boundaries. It is not a broad reversal scanner. It does not combine every reversal pattern into one dashboard. It stays focused on wedge compression, wedge maturity, reversal break, projected reaction zone, and invalidation. It is not a generic breakout quality tool. Break quality is evaluated only after a valid rising or falling wedge exists. 🔔 Alerts The script includes alerts for: - Bullish falling wedge break - Bearish rising wedge break - High quality wedge break - Wedge invalidation These alerts are event notifications for the detected structure, not automated trading instructions. ✨ Best Use Case Wedge Reversal Detector is best suited for traders who already watch chart patterns, market structure, compression, and failed trend continuation. It helps reduce manual drawing by highlighting qualified wedge structures, then keeping the chart organized through the confirmation, projection, and invalidation phases. The result is a clean, premium, wedge-specific workflow designed for public chart reading: fewer random lines, fewer noisy labels, and a clearer view of whether the wedge structure is still forming, breaking, projecting, or invalidating.
Indicador Pine Script®
por AGProLabs
Triangle Breakout Quality [AGPro Series]Triangle Breakout Quality 🔺 OVERVIEW Triangle Breakout Quality is built for one of the most searched and visually recognizable chart structures in technical analysis: the triangle breakout. The script automatically detects triangle candidates from confirmed pivot highs and pivot lows, projects the upper and lower converging boundaries, measures how much the structure has compressed, locates the projected apex, and grades the quality of the eventual breakout. After the release, it monitors the first return toward the broken triangle boundary so the user can see whether price accepted the breakout or quickly lost structural quality. The goal is not to mark every small consolidation or every trendline touch. The goal is to isolate the full triangle sequence: Formation -> compression -> apex pressure -> boundary release -> first retest state. That full lifecycle is what gives the tool its own identity. A triangle is not just a range, not just a single diagonal line, and not just a breakout candle. It is a narrowing structure where both sides of price are being compressed into a decision point. This script is designed around that idea from the ground up. 🔹 WHAT MAKES IT DIFFERENT Most triangle tools stop at drawing two lines. Most breakout tools stop at the first candle outside a boundary. Triangle Breakout Quality does more by turning the structure into a scored, state-aware workflow. Core differentiators: • Dual-boundary validation The script requires both an upper pivot boundary and a lower pivot boundary. The two lines must converge. This prevents the logic from acting like a generic trendline-break detector. • Compression measurement The engine compares the opening width of the triangle with the current width. A pattern must show meaningful narrowing before it can qualify. • Apex pressure logic The script projects where the upper and lower boundaries intersect and evaluates whether the current structure is close enough to that decision zone to matter. • Breakout quality score Every displayed breakout receives a 0-100 score based on compression, apex pressure, breakout distance, candle body participation, close quality, and optional volume expansion. • Retest state After a breakout, the script watches the first return toward the broken triangle boundary. A held retest and a failed retest are visually different states, not the same event. • Premium visual restraint The chart shows active triangle lines, controlled breakout labels, optional retest labels, subtle candle tint, and a compact AGPro panel. Label density is capped so the layout stays clean for live use and publication screenshots. 🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS This script is intentionally separated from the existing AGPro breakout and structure family. It is not Break-Retest Quality, because it does not begin with a horizontal pivot break and then grade the first retest of that static level. Triangle Breakout Quality first requires a valid converging triangle structure. It is not Failed Break Quality, because it is not centered on false breaks and reclaim behavior. It tracks the primary breakout from a valid triangle and then monitors the first boundary retest. It is not Consolidation Breakout Quality, because the reference structure is not a horizontal range. A triangle must have two projected pivot boundaries that move toward each other. It is not Donchian Breakout Quality, because it is not based on period highs and lows or channel escape logic. It is not ATR Envelope Breakout Quality, because it does not use a volatility envelope as the breakout shell. It is not Auto Trendline Break Quality, because it does not score isolated trendline breaks. The event only matters when the upper and lower lines together form a valid triangle compression structure. That distinction matters visually and analytically. On the chart, this script tells a triangle story: converging boundaries, apex pressure, breakout quality, and retest state. It belongs in the chart-pattern lane, not the generic breakout lane. ⚙️ METHODOLOGY 1. Pivot anchors The script uses confirmed pivot highs and pivot lows to define the latest upper and lower triangle boundaries. This keeps the structure rules transparent and reproducible. 2. Convergence filter The upper boundary and lower boundary must move toward each other. The current width of the pattern must be smaller than the starting width, and the compression percentage must meet the selected threshold. 3. Width and maturity filters The pattern must be old enough to represent a real structure, but not so old that it becomes stale. The starting width and current width are also normalized by ATR so the same logic can adapt across symbols and timeframes. 4. Apex projection The script calculates where the two projected boundaries intersect. This creates the apex pressure layer, which helps separate mature triangle compression from loose diagonal movement. 5. Breakout confirmation A bullish breakout requires price to close beyond the projected upper boundary by an ATR-normalized buffer. A bearish breakout requires price to close beyond the projected lower boundary by the same type of buffer. 6. Quality score The breakout score combines: • Compression quality • Apex pressure • Breakout distance beyond the boundary • Candle body participation • Close position inside the breakout candle • Optional volume participation The result is displayed as a compact grade and score so the chart remains readable. 7. Retest state After a breakout, the script projects the broken triangle boundary forward internally and evaluates an ATR-scaled retest tolerance around it. If price revisits that boundary area and holds the correct side, the retest is marked as held. If price loses the boundary, the retest state is marked as failed. 📊 PANEL The AGPro panel summarizes the current structure and latest event: • Pattern Age • Compression • Apex Pressure • Breakout Side • Retest Quality • Current State Panel location, theme, and font size are adjustable. The first row follows the AGPro publication standard: one merged blue header row containing only the panel title. 🎛️ KEY INPUTS Triangle Structure • Pivot Length • Minimum Pattern Age • Maximum Pattern Age • Minimum Compression % • Minimum Starting Width ATR • Maximum Current Width ATR • Maximum Forward Apex Bars Breakout Quality • ATR Length • Volume Average Length • Use Volume Participation • Volume Full-Score Ratio • Minimum Break Distance ATR • High Quality Threshold • Minimum Label Score • Visual Cooldown Bars Retest State • Retest Minimum Bars • Retest Window Bars • Retest Tolerance ATR Visual Controls • Show Triangle Lines • Show Breakout Labels • Show Retest Labels • Tint Breakout Candles • Label Offset ATR • Label Font Size • Maximum Visible Events Panel • Show Panel • Panel Position • Panel Theme • Panel Font Size 🔍 HOW TO READ IT When a valid triangle is forming, the chart displays the converging upper and lower boundaries. The panel reports apex pressure and compression so the projected decision area is visible without adding extra rectangles to the chart. Compression shows how much the pattern has tightened relative to its opening width. When price closes beyond a valid boundary, the script prints a compact breakout label with a quality grade and score. A higher score means the breakout candle carried stronger structural qualities according to the script's rules. After the breakout, retest labels and the panel show whether the first return toward the broken triangle boundary held or failed. A held retest suggests cleaner acceptance of the breakout boundary. A failed retest suggests the release lost quality. Use the tool as a structured chart-reading layer. It is designed to help users compare triangle breakouts by quality, not to replace broader context such as trend, liquidity, session behavior, or personal execution rules. 🧩 BEST USE CASES • Symmetrical triangle compression • Ascending triangle pressure • Descending triangle pressure • Breakout candle quality review • First retest monitoring after triangle release • Screenshot-friendly pattern study • Multi-symbol scanning for cleaner chart-pattern candidates 🔹 LIMITATIONS AND TRANSPARENCY Triangle detection is based on confirmed pivots, so the final anchor points appear only after the selected pivot length has elapsed. This is standard pivot behavior and keeps the structure rules visible. The live triangle can change while new pivots form. Breakout and retest labels are event-based and are designed to remain stable after confirmation. Volume participation is optional because volume quality varies across markets and feeds. On instruments where volume is less informative, the volume component can be disabled. The score is a structured description of the triangle release according to the script's internal model. It should be read as context, not as an execution command.
Indicador Pine Script®
por AGProLabs
Trend Quality [AGPro Series]Trend Quality Trend Quality fuses three independent regime dimensions — ADX directional strength, Kaufman Efficiency Ratio, and ATR-normalized EMA slope — into a single 0–100 composite Trend Quality Score. A hysteresis + confirmation + cooldown gate turns that score into a stable TREND / CHOP regime, enhanced with HTF confirmation, lifecycle phases, score velocity, breakout grading, directional dominance, and a full adaptive on-chart quality window. The goal is simple: replace noisy "is this a trend?" guessing with a transparent, multi-dimensional, low-lag quality reading you can read in one glance. 🎯 OVERVIEW Most trend filters fail at the same thing — they tell you a trend exists, but not whether that trend is clean, accelerating, fading, or already exhausted. Trend Quality answers the harder question. Every bar is scored on three independent dimensions that each measure a different physical property of price movement: • ADX — directional strength (how strongly one side dominates) • Kaufman Efficiency Ratio (ER) — path efficiency (how little wasted motion) • ATR-normalized EMA slope — normalized trend velocity (how fast, relative to volatility) These three signals are combined into one 0–100 Trend Quality Score. A hysteresis band + confirmation bars + cooldown filter convert that score into a stable TREND / CHOP regime — no single-bar flipping, no false recovery wicks. On top of the core regime, the indicator layers Score Velocity, Lifecycle phases (Emerging → Confirmed → Exhausting), Breakout Quality grading (A / B / C), directional dominance, and a visual Quality Window that tracks the active trend zone and projects it forward. 💎 UNIQUE EDGE What separates Trend Quality from a standard ADX filter, an EMA slope indicator, or a generic regime meter: • Tri-factor fusion (not a single metric) — ADX alone misses path quality; ER alone misses direction; slope alone misses choppy-but-strong moves. Weighted fusion (45% ADX, 35% ER, 20% Slope) neutralizes each component's blind spot. • Stable regime, not a flickering line — the TREND / CHOP state passes through a 3-layer filter: hysteresis band around the threshold, N confirmation bars, and a cooldown window after every transition. The result is a regime reading that holds through pullbacks without flipping. • Score Velocity Engine — a second-derivative layer that watches how fast the score itself is changing. Surges flag momentum ignition; collapses flag quality breakdown before price confirms it. A bearish divergence detector fires when price makes new highs while quality is fading. • Lifecycle phases — inside every TREND regime, the script distinguishes Emerging (young, fresh, accelerating), Confirmed (mature, stable, above buffer), and Exhausting (score rolling over from a peak). This lets you see whether you are entering early, running mid-trend, or catching the end. • Breakout Quality Badge (A / B / C) — every CHOP → TREND transition receives a graded badge based on composite score plus velocity bonus. Grade A breakouts are rare and have an optional dedicated alert. • HTF confirmation with Auto-HTF mapping — the same engine runs on a higher timeframe. When LTF is trending but HTF is not, the regime is marked BLOCKED (not forced to CHOP) so you retain full transparency about why the regime is gated. • Adaptive Quality Window — a live rectangular zone that tracks the full trend's high/low from its start bar, projects forward, shows ceiling/floor projection labels, and preserves historical windows with directional color coding (green for up-trends, pink for down-trends, amber for HTF-blocked trends). 🧪 METHODOLOGY Core composite score (every bar, LTF): Score = 100 × (0.45 × ADX_norm + 0.35 × ER_norm + 0.20 × Slope_norm) • ADX_norm = min(ADX / 50, 1) • ER_norm = |close − close | / (SMA(|Δclose|, N) × N) • Slope_norm = min(|EMA − EMA | / ATR × 10, 1) Regime gating: • Hysteresis: +3 above threshold to enter TREND, −3 below to enter CHOP • Confirmation: N consecutive bars above/below the hysteresis band • Cooldown: N bars after every regime flip where no new flip is allowed MTF confirmation (optional, default ON): The same core function is called via request.security on the HTF (Auto: 30m→4H, 4H→Daily, Daily→Weekly, Weekly→Monthly in Strict mode). When LTF=TREND but HTF=CHOP, the regime is tagged BLOCKED — a transparent third state that is neither forced-CHOP nor accepted-TREND. Lifecycle logic: • Emerging: TREND is young (bars since start ≤ Emerging Bars) OR score slope ≥ 0 and score below buffer • Confirmed: score ≥ threshold + Confirmed Buffer AND HTF passes (optional) • Exhausting: score slope < 0 AND pullback from peak ≥ Exhaustion Pullback Score velocity: velocity = score − score (default 5-bar look-back) Breakout quality grading: bqScore = score + velocity_bonus (bonus: +15 if vel>15, +7 if vel>5, else 0) A ≥ 82, B ≥ 67, C < 67 🔔 SIGNALS & ALERTS The script exposes 12 alert conditions — all moderator-safe, educational, non-solicitating: • CHOP → TREND / TREND → CHOP regime flips with LTF+HTF context • Strong Trend composite conviction threshold • HTF Blocked / HTF Unblocked third-state transparency events • Emerging / Confirmed / Exhausting Trend lifecycle phase changes • Velocity Surge / Velocity Collapse second-derivative extremes • Grade-A Breakout rare high-conviction breakouts • Bearish Divergence price up, quality down warning On-chart visual events (also filterable via inputs): • Breakout Quality badge (A / B / C) at every CHOP → TREND • Bearish divergence ⚠ marker at trend peaks where quality fades • State tag near backbone: EMERGING / CONFIRMED / EXHAUSTING / HTF BLOCKED • Quality Window label: ACTIVE + phase • Projection labels on the right edge: QUALITY CEILING / TREND FLOOR All badge and warning labels are gated with an 8-bar cooldown so the chart stays clean even on repeated intra-swing triggers. ⚙️ KEY INPUTS Core engine: • ADX Length (14) — directional strength look-back • Efficiency Length (20) — ER path-efficiency window • Slope EMA Length (50) — trend backbone reference • ATR Length (14) — volatility normalization • TREND Threshold (55) — composite score level to enter TREND • Confirmation Bars (1) — bars of persistence before flipping • Strong Trend Offset (15) — extra score above threshold for STRONG tag MTF: • HTF Confirmation (ON) — enable/disable HTF gate • Auto HTF (ON, Strict) — smart HTF mapping per chart TF • Manual HTF (240) — override timeframe Stability: • Change Cooldown Bars (2) — lock-out window after any regime flip Lifecycle: • Emerging Phase Bars (4) — max trend age to stay Emerging • Confirmed Buffer (8.0) — score must clear threshold+buffer • Exhaustion Pullback (4.0) — peak-to-current drop to flag Exhausting Visual Overlay: • Backbone + Glow + Zone + State Candles + Quality Window + Historical Windows + Projection Box + Guides + Midline (all toggleable) Panel, Theme, Layout, Help rows, Alerts, Score Velocity Engine, Breakout Quality Badge, Divergence Detector — every layer has its own input group and can be shown/hidden independently. 📘 HOW TO USE Read-in-one-glance panel (standard AGPro format): • Blue header row: script title • Line 2: REGIME / LIFECYCLE · Score N/100 · Velocity state • Line 3: LTF regime · Direction · Directional Dominance • Line 4: HTF regime · MTF PASS/BLOCKED · Active Window state · Streak Quick playbook: 1. CHOP on LTF → wait. No setup, no commitment. 2. CHOP → TREND transition with Grade A badge + HTF PASS → highest-conviction regime start. 3. CONFIRMED phase with DOM HIGH and rising score → the middle of the trend, usually the cleanest section. 4. Velocity COLLAPSE or EXHAUSTING phase with bearish divergence ⚠ → quality is deteriorating; reduce exposure or tighten stops. 5. HTF BLOCKED amber window → LTF trend exists but higher timeframe disagrees; treat as lower-conviction and be aware of mean-reversion risk. The indicator does NOT issue buy/sell signals, does NOT define entry/exit prices, and is NOT a strategy. It is a regime-quality reading — a context layer you pair with your own trade management. ⚠️ LIMITATIONS & TRANSPARENCY • Trend-quality indicators are inherently trend-following. In low-volatility ranges the score can stay above threshold on minor moves; in very fast markets the score can lag by 1–3 bars while the filters stabilize. • HTF confirmation introduces a natural HTF delay. This is intentional (it removes noise) but means the HTF gate may lift several LTF bars after price has already moved. • All composite signals rely on look-backs (ADX 14, ER 20, Slope EMA 50, ATR 14). On very short intraday timeframes with low bar counts these need calibration. • Lifecycle phases are structural readings, not predictions. EXHAUSTING means the score is rolling over — not that price must reverse. • Past performance of any visual regime does not imply future performance. Charts showing clean historical windows are illustrative of the indicator's logic, not trading results. • No repainting on historical bars. The HTF call uses lookahead_off and barmerge.gaps_off. Score and regime values on closed bars are final. 🛡️ RISK DISCLOSURE This script is published as an educational and analytical tool. It does not provide financial advice, does not generate trade signals of any kind, and must not be used as a standalone decision system. Markets involve substantial risk of loss. Past behavior of any market regime, indicator output, or historical visual window is no guarantee of future results. Always combine any indicator with independent risk management, position sizing, a tested plan, and — where appropriate — the guidance of a licensed professional. You are solely responsible for any trading decisions you make.
Indicador Pine Script®
por AGProLabs
AG Pro ATR Envelope Breakout Quality [AGPro Series]AG Pro ATR Envelope Breakout Quality Overview / What it does AG Pro ATR Envelope Breakout Quality is a volatility-aware breakout framework built around a dynamic ATR envelope rather than a static horizontal level, fixed box, or session-defined range. The script tracks when price closes outside an ATR-based outer band, then evaluates whether that move shows enough quality to be treated as a meaningful breakout instead of a weak expansion, short-lived overshoot, or low-conviction push. The core logic is centered on three linked questions. First, did price achieve a valid close outside the active envelope? Second, was that move supported by enough momentum and relative participation to deserve attention? Third, what happened when price came back toward the broken area? This progression allows the script to move beyond a simple breakout marker and present a more structured breakout-quality workflow. Because the reference structure is dynamic, the script adapts to changing market conditions instead of forcing all setups into a fixed box logic. In periods of contraction, the envelope tightens and makes outside acceptance more meaningful. In periods of expansion, the envelope widens and helps separate true continuation pressure from ordinary volatility noise. This makes the tool especially useful for traders who want to judge whether an expansion is merely visible or genuinely tradable. The visual design is intentionally clean and overlay-first. The envelope defines the active volatility shell, breakout markers show where price escapes that shell, the throwback zone highlights the key acceptance pocket after the move, and the optional target line provides a simple expansion objective. A compact panel then summarizes the current state without taking over the chart. The result is a script that aims to look premium while still keeping the main story readable in a publish screenshot. Unique Edge The main distinction of this script is that it does not evaluate breakout quality from a static support/resistance line, a consolidation rectangle, a Donchian extreme, or an opening range boundary. It evaluates breakout quality from a moving ATR envelope. That difference is not cosmetic. It changes the entire logic of what counts as a breakout, how follow-through is judged, and how retests are interpreted. In several classic breakout tools, the market is asked to escape a fixed historical structure. Here, the market is asked to achieve acceptance outside a live volatility shell. This creates a different analytical lens. A move that looks impressive relative to a flat level may not be meaningful relative to a volatility-adjusted envelope. On the other hand, a clean close outside an adaptive outer band can reveal expansion quality that a simple line break would miss. This also separates the script from our other AG Pro tools. It is not a consolidation breakout evaluator, because its reference structure is not a box. It is not a Donchian breakout tool, because it is not based on period highs and lows. It is not an opening-range breakout model, because it is not session-box dependent. It is not a standard break-retest script, because the retest here happens around a dynamic envelope acceptance area rather than around a static horizontal level. That distinction matters both analytically and visually. Analytically, the script focuses on volatility-adjusted breakout acceptance. Visually, it produces a different type of chart story: an active envelope, a breakout event, a throwback pocket, and a projected path. This gives the script its own place inside the AG Pro catalog rather than making it feel like a variation of an existing breakout family member. Methodology The script begins with an ATR-based envelope built around a moving basis. This creates an adaptive upper and lower band that expand or contract with market volatility. A bullish breakout candidate appears when price closes outside the upper band. A bearish breakout candidate appears when price closes outside the lower band. Wick-only excursions are not enough. The script is designed to care about acceptance, not mere contact. Once an outside close is detected, the script evaluates breakout quality through a compact scoring framework. Momentum contribution helps measure whether the breakout candle shows real displacement or just a hesitant push. Volume contribution helps detect whether the breakout is supported by stronger-than-usual participation or whether it lacks confirmation. The combined result becomes the displayed breakout-quality score. After the initial breakout, the script monitors the first return toward the broken band area. This is where the throwback logic becomes important. Instead of treating every pullback the same way, the script classifies what happens around the envelope area and updates the state accordingly. A successful hold suggests that the market accepted the breakout. A failure suggests that the move lost structural quality after the initial expansion. An optional target line can be used to project a simple post-breakout objective. This is not presented as a promise of outcome. It is a visual planning reference intended to show a possible expansion path if the breakout continues to behave constructively. Together, the envelope, the breakout signal, the throwback state, and the target framework create a full breakout-quality sequence rather than a single event label. Signals & Alerts The script is designed to organize the breakout workflow into visible states rather than flooding the chart with constant commentary. The main states include bullish breakout, bearish breakout, throwback monitoring, throwback hold, breakout failure, and target hit. This makes the chart easier to read and helps the user understand where the setup currently stands. Bullish and bearish breakout markers appear when price achieves a confirmed outside close beyond the relevant envelope band. These are the initial expansion events. They are then followed by a monitoring phase in which the script watches how price behaves around the broken band area. If the return is constructive, the script can label that behavior as a successful hold. If the move loses quality and breaks down, the script can classify it as a failure. The target marker is optional and functions as a planning aid, not as a certainty engine. It simply shows that the projected expansion objective has been reached based on the chosen configuration. In practical use, this can help traders separate the breakout event itself from the later progression of the move. The alert set is intended to remain deterministic and chart-state aware. It focuses on confirmed breakout events, throwback behavior, breakout failure, and target completion. This keeps the script aligned with workflow clarity instead of turning it into a noisy alert generator. Key Inputs The envelope settings control the moving basis, ATR length, and multiplier that define the adaptive breakout shell. These settings determine how sensitive the script is to changing volatility and how demanding the outside-close condition becomes. The breakout filter settings allow the user to regulate confirmation quality. Depending on the selected configuration, the script can require stronger momentum, clearer outside distance, and optional volume confirmation. This helps users decide whether they want a more selective or more responsive model. The throwback analysis settings define how the script interprets the first return toward the broken envelope area. These settings influence how deeply price can revisit the area before the move is treated as weak, failed, or still acceptable. The target settings control whether the projected objective is shown and how far it is placed from the breakout area. The visual settings then manage panel visibility, panel placement, font sizing, historical object behavior, and label density so the script can remain clean in live use and in publish screenshots. Limitations & Transparency This script is a breakout-quality framework, not a prediction engine. It does not know in advance whether a breakout will continue. It evaluates the quality of a breakout after a valid outside-close event occurs and then tracks how price behaves afterward. That distinction is important. The ATR envelope is an adaptive reference, which means the same market move may be classified differently under different volatility regimes. That is intentional. The script is designed to respond to changing market structure, but any adaptive model will also reflect the sensitivity of its settings. Users should therefore expect the behavior of the tool to vary across symbols, timeframes, and volatility environments. Volume inputs may also behave differently across markets and data feeds. On some instruments, volume can add useful confirmation. On others, it may be less informative. For that reason, volume should be treated as a supporting factor rather than as an absolute truth layer. The target projection is a chart-planning feature, not a guaranteed outcome. Likewise, a breakout failure label does not mean the market cannot later recover, and a target hit does not mean the move was universally optimal. The script is meant to help structure chart reading, not replace trade management, context analysis, or personal decision-making. How this script differs from our other AG Pro tools Within the AG Pro lineup, this script is intentionally positioned as a volatility-envelope breakout tool. It does not compete with our box-based breakout logic, our period-high/low breakout logic, or our static break-retest logic. Its role is to answer a different question: did price achieve meaningful acceptance outside an adaptive ATR shell, and did that acceptance survive the first return test? That makes it especially useful when traders want a volatility-adjusted view of expansion quality. In markets where static levels are repeatedly pierced, an adaptive envelope framework can provide a cleaner read on whether the move is truly escaping current volatility conditions or simply stretching within ordinary noise. In that sense, the script is not a replacement for our other breakout-oriented tools. It is a separate layer with a different reference model, different retest logic, and a different chart story. That separation is deliberate and is one of the reasons the script belongs in its own category inside the broader AG Pro collection. Risk Disclosure This script is an analytical chart tool designed to visualize volatility-adjusted breakout conditions, breakout quality, and post-breakout behavior. It is not financial advice, not a signal service, and not a guarantee of future price direction. All breakout conditions can fail. Momentum can fade, volume can be inconsistent, and throwback behavior can change quickly. Markets remain uncertain, and no indicator can eliminate risk. Users should always apply their own market judgment, risk controls, and execution rules. Use the script as a structured decision-support layer, not as a stand-alone trading instruction. Confirmation from broader context, trend conditions, liquidity structure, and personal risk management remains essential.
Indicador Pine Script®
por AGProLabs
3
AG Pro Consolidation Breakout Quality [AGPro Series]AG Pro Consolidation Breakout Quality Overview / What it does AG Pro Consolidation Breakout Quality is an overlay tool designed to detect compression zones and evaluate the quality of the breakout that emerges from them. Instead of marking every simple range expansion, the script first looks for a valid consolidation structure, then measures how convincing the breakout is once price closes outside the box. The core idea is straightforward: not every breakout from a tight range carries the same informational value. Some breaks occur with weak commitment, low participation, and immediate failure. Others show stronger intent through better candle structure, stronger relative volume, longer pre-break compression, and cleaner continuation behavior. This script is built to separate those conditions visually and systematically. The indicator automatically identifies consolidation zones using a narrow-range logic relative to ATR. When a valid box forms, the structure is drawn on the chart. If price closes beyond the upper or lower edge of that box, the script registers a breakout or breakdown and assigns a quality score. A throwback event can also be tracked after the break, helping users distinguish cleaner expansions from breaks that immediately revisit the zone. This makes the script useful for traders who want to monitor compression-to-expansion behavior in a structured way. It can be used to review developing ranges, compare breakout quality across instruments, and filter visual attention toward stronger or weaker breakout events without turning the chart into a cluttered signal feed. Unique Edge The differentiating idea behind this tool is that it does not treat consolidation and breakout as two unrelated events. It treats them as one sequence: compression, release, validation, and possible throwback. That sequence is then scored. Many breakout tools only draw a box or mark the first candle that moves outside a recent range. This script adds a second layer by evaluating the break itself. Volume participation, the strength of the closing position, the duration of the consolidation, and the efficiency of the breakout candle all contribute to the final quality read. If price quickly throws back into the prior box, that weakness is also reflected. This makes the script a natural sibling to AG Pro Break-Retest Quality, but it is not a duplicate. Break-Retest Quality focuses on retest behavior after a level break. Consolidation Breakout Quality begins one step earlier by focusing on the compression box itself, the first breakout from that structure, and the immediate integrity of that release. The emphasis here is the quality of expansion from consolidation, not the later retest workflow. Methodology 1) Consolidation detection The script scans for a sequence of relatively narrow bars. Narrowness is measured against ATR, so the detection logic adapts to the volatility environment of the symbol rather than relying on a fixed tick or percentage threshold. Once the required number of bars is reached, a consolidation box is formed from the local high-low range of that sequence. 2) Breakout / breakdown detection A bullish breakout is registered when price closes above the upper boundary of the active consolidation box. A bearish breakdown is registered when price closes below the lower boundary. The breakout level is then projected forward visually so the user can continue tracking the structure after the event. 3) Quality scoring The script assigns a 1 to 5 quality score using a weighted ruleset built around the breakout event: - Base breakout occurrence - Relative volume expansion compared with a volume moving average - Strength of the close beyond the box boundary - Duration of the consolidation before release - Body efficiency of the breakout candle 4) Throwback context After the breakout, the script can monitor whether price returns back into the broken consolidation box within a user-defined lookback window. This is treated as a sign of weaker follow-through and can be displayed directly on the chart for fast context reading. 5) Visual workflow The chart uses a structured visual hierarchy: - Consolidation box - Breakout or breakdown label - Throwback warning label - Quality score card - Breakout level projection - Compact info panel The goal is to keep the workflow readable while preserving enough structure for live chart use. Signals & Alerts The script can generate alerts for: - Bullish breakout - Bearish breakdown - High-quality breakout conditions - Elite-quality breakout conditions - Throwback warning - Any breakout event This allows the tool to be used either as a visual chart companion or as part of a broader alert-driven workflow. Users who prefer stricter confirmation logic should configure alerts in a way that matches their execution style. Key Inputs Consolidation Settings - Consolidation Length: number of bars required to form a valid consolidation - ATR Multiplier: sensitivity threshold for narrow-range detection - ATR Length: volatility lookback - Max Zones to Display: keeps chart objects under control Quality Scoring - Volume Spike toggle - Volume MA Length - Volume Spike Multiplier - Close Position scoring toggle - Throwback monitoring toggle - Throwback lookback length Visual Settings - Box color - Bullish breakout color - Bearish breakdown color - Throwback color - Box, level, score, arrow, and panel visibility - Label size controls Alerts - Minimum score threshold for alert relevance Limitations & Transparency This script is a market-structure visualization and event-quality tool. It is not a prediction engine, and it does not claim that every high score will lead to continuation or that every low score will fail. The score is a structured summary of selected breakout characteristics, not a guarantee of outcome. Consolidation detection depends on the selected ATR settings and bar count. Different symbols, sessions, and timeframes may require different parameter values. Users should expect the frequency and strictness of the boxes to change when those settings are adjusted. Volume-based logic may be more informative on instruments and venues where reported volume is meaningful. On some markets, volume behavior can be less consistent, which may reduce the usefulness of the volume component. Throwback detection is intended as context, not as a complete post-break trade management model. A throwback can represent weakness, but in some workflows it may also represent a later confirmation opportunity. The script leaves that interpretation to the user. Risk Disclosure This indicator is for chart analysis, structure review, and breakout context evaluation only. It does not provide financial advice, investment recommendations, or guaranteed trade outcomes. All trading and investing involve risk, including the risk of loss. Users should evaluate the tool on their own symbols, timeframes, and execution rules before relying on it in live decision-making.
Indicador Pine Script®
por AGProLabs
2
AG Pro Inside Bar Breakout Quality [AGPro Series]AG Pro Inside Bar Breakout Quality Overview / What it does AG Pro Inside Bar Breakout Quality is an overlay tool built to study one of the market’s most familiar compression structures: the inside bar. Instead of stopping at simple detection, the script evaluates what happens after the pattern forms and grades the breakout attempt with a structured quality model. The result is a workflow-oriented view of inside bar compression, breakout strength, and failed continuation behavior. The script first identifies a strict inside bar condition, where the current bar remains fully contained within the previous bar’s range. That parent range becomes the active reference zone. From there, the script monitors whether price resolves above or below the structure, whether the move is confirmed by close, whether volume supports the breakout, and whether the breakout later fails and re-enters the range within a user-defined window. This is not designed as a generic “any breakout” marker. Its purpose is narrower and more specific: it focuses on a compact volatility contraction event, then measures how decisively price leaves that compression. In practical chart work, this helps separate a low-commitment range poke from a more convincing expansion move. The visual presentation is intentionally structured. Inside bar zones are boxed, breakout direction is marked, quality is scored, and fakeouts are labeled when the breakout reverses back into the monitored range. This makes the script suitable for traders who want a cleaner way to inspect inside bar behavior without manually drawing every structure. Unique Edge The main difference here is that the script does not treat every inside bar break as equally meaningful. Many tools stop at “pattern detected” or “level broken.” This script adds a second layer: breakout quality. That layer is derived from close position, volume context, candle body participation, and alignment with the parent candle’s directional bias. A second differentiator is the built-in fakeout logic. After a breakout is detected, the script continues to watch price for a limited number of bars. If the move quickly returns back through the breakout boundary, the event is tagged as a fakeout. This adds post-event context instead of only marking the first directional move. Another distinction is that the methodology is deterministic and chart-native. The logic is rule-based, visible, and reproducible from bar to bar. Users can decide whether to require close confirmation beyond the inside bar range, whether to require volume confirmation, and how strict they want the displayed threshold to be through the minimum score filter. In short, this script is not only about finding compression. It is about ranking the quality of the expansion attempt that follows the compression, while also acknowledging that some breakouts fail quickly and should be read differently. Methodology 1) Inside Bar Detection An inside bar is identified when the current bar’s high is lower than the previous bar’s high and the current bar’s low is higher than the previous bar’s low. This creates a strict containment definition based on the previous candle’s full range. 2) Reference Zone Once an inside bar is detected, the prior candle becomes the parent reference bar. Its high and low define the active breakout boundaries. That range can be visualized as a box, with an optional midpoint line to make the compression zone easier to read on chart. 3) Breakout Confirmation A bullish breakout occurs when price moves above the parent high. A bearish breakout occurs when price moves below the parent low. Users can choose whether breakout confirmation should be based on close beyond the range or on a less restrictive intrabar break condition. 4) Quality Score Each breakout can be scored on a 0–10 scale. The score is built from multiple components: - close position relative to the inside bar boundary - volume ratio versus the selected moving average - body participation within the breakout candle’s total range - directional alignment between the breakout and the parent candle bias This scoring model is designed to estimate how committed the breakout candle appears, rather than assuming all breaks have equal informational value. 5) Fakeout Detection If enabled, the script monitors a user-defined number of bars after breakout. A bullish breakout that returns back below the upper boundary within that window is labeled as a bull trap / fakeout. A bearish breakout that returns back above the lower boundary within that window is labeled as a bear trap / fakeout. 6) Visual Layer The script can display the inside bar zone, midpoint, breakout arrows, score labels, and fakeout markers. A summary panel tracks aggregate statistics such as total inside bars, total breakouts, breakout direction counts, fakeouts, and the latest breakout score. Signals & Alerts The script can provide alert conditions for: - bullish inside bar breakout - bearish inside bar breakout - fakeout detection - high-quality breakout events - any breakout event These alerts are intended to help users monitor the pattern and its resolution more efficiently. They do not replace trade planning, confirmation from broader market context, or independent risk management. Key Inputs Min Score to Show Breakout Filters displayed breakout labels by quality threshold. This can be useful for reducing low-quality visual noise. Volume Confirmation Required When enabled, breakout evaluation requires volume to be above its moving average threshold. This can help remove low-participation breaks. Volume MA Period Defines the lookback length for average volume comparison. Require Close Beyond IB When enabled, breakout confirmation depends on bar close beyond the parent range. This creates a more conservative and more stable breakout definition. Max IBs to Display Controls how many recent structures and related objects remain visible on chart. Show IB Box / Midline / Breakout Arrow / Score Label Lets users decide how much visual detail they want to keep on screen. Glow Effect on High Score Adds emphasis to stronger breakout events without changing the underlying logic. Fakeout Window Defines how many bars after breakout the script should continue monitoring for a return back through the breakout boundary. Limitations & Transparency This script studies inside bar compression and subsequent breakout behavior. It does not claim to identify all meaningful consolidations, and it does not attempt to classify every market regime. The methodology is intentionally focused on one structure. The score is a rule-based quality model, not an objective measure of future outcome. A high score does not guarantee continuation, and a lower score does not guarantee failure. It simply reflects how the breakout candle and its context behave according to the script’s internal criteria. Volume-based interpretation may vary across symbols and markets. On some instruments, especially those with inconsistent or synthetic volume data, volume confirmation may be less informative than on others. Users should evaluate whether volume filtering is appropriate for the asset they are studying. Fakeout detection is also definition-dependent. The script labels a fakeout when price returns through the breakout boundary within the selected lookback window. Different traders may prefer a different timing window or a different failure definition. As with any overlay, chart readability depends on market volatility, timeframe, and user settings. On lower timeframes or during highly active periods, more visual events may appear. The built-in filters and display controls are there to help manage that density. Risk Disclosure This script is an analytical tool for chart study. It is not financial advice, not a trade recommendation, and not a promise of future results. Inside bar breakouts can behave differently across timeframes, instruments, and market regimes. Users should not rely on a single pattern, score, or alert in isolation. Context still matters, including trend condition, liquidity environment, nearby structure, volatility regime, and execution discipline. Before using this script in any live decision process, it should be reviewed in the specific market and timeframe relevant to the user’s own approach. Testing, observation, and risk controls remain essential.
Indicador Pine Script®
por AGProLabs
2
AG Pro Donchian Breakout Quality [AGPro Series]AG Pro Donchian Breakout Quality Overview / What it does AG Pro Donchian Breakout Quality is an overlay indicator built around a simple but practical question: not every Donchian breakout carries the same informational quality, so how can that difference be visualized directly on the chart? Instead of treating every channel escape as equally meaningful, this script evaluates the structure of the breakout bar, the local channel condition, and the immediate follow-through context, then converts that information into a readable breakout quality framework. The goal is not to predict the future or to classify markets with certainty. The goal is to help the user separate cleaner breakouts from weaker ones inside a familiar Donchian channel structure. The indicator plots the Donchian upper band, lower band, optional midline, and channel fill, then adds a quality layer on top of the raw channel logic. When price closes through the previous Donchian boundary, the script evaluates the event and assigns a score. That score is then mapped to a simple grade scale so the breakout can be read quickly without losing access to the underlying channel context. This creates a workflow that remains visually intuitive for users who already understand Donchian channels, while adding a more structured interpretation layer for breakout review. A second focus of the script is post-breakout behavior. In practice, many breakouts are not decided by the break itself, but by what price does after the first expansion bar. For that reason, the indicator tracks an active breakout level, projects a retest zone around that level using ATR, and monitors whether price can hold that area. This makes the tool useful not only for identifying fresh breaks, but also for observing whether the market is accepting or rejecting the newly crossed boundary. The visual design is intentionally chart-first. The channel remains the primary frame, while breakout labels, retest markers, level tags, the setup tag, and the compact state panel provide context without turning the script into a crowded dashboard. Historical label clutter is reduced by default, and the script is designed so the most recent relevant structure remains readable on active charts. Unique Edge The distinctive feature of this script is that it does not stop at “price broke the channel.” Traditional Donchian usage often leaves the interpretation step entirely to the user. This script keeps the Donchian framework intact, but adds an explicit breakout quality model. That means the script is not merely showing an upper-band break or lower-band break; it is also evaluating how that break occurred. The quality model scores breakouts using multiple components rather than a single threshold. It considers breakout distance relative to ATR, breakout candle body participation, wick behavior, local channel compression, midline slope context, and optional volume confirmation. This matters because many weak breakouts can look similar to stronger ones at first glance, especially when the user is reviewing charts quickly. By ranking the event instead of only flagging it, the indicator introduces a more disciplined read on the same familiar Donchian concept. Another differentiator is the breakout-to-retest workflow. The script identifies the breakout, stores the active level, builds a retest zone around that level, and then tracks hold behavior within a limited life window. This makes the indicator less about a one-bar event and more about the structural sequence that often matters in live chart reading: approach, break, test, hold, or fail. That sequence is especially helpful for users who do not want a Donchian tool to act like a simple channel overlay with occasional arrows. The presentation layer is also part of the edge. Active-side emphasis, breakout shelf visualization, level tagging, a right-side setup tag, state detection, and selective event marking are included to help the chart communicate context more clearly. The script is therefore positioned as a Donchian breakout interpretation tool, not as a generic channel plotter. Methodology The script starts with a standard Donchian channel calculation using the selected lookback length. The highest high defines the upper boundary, the lowest low defines the lower boundary, and the midpoint between them forms the optional midline. A breakout is detected when the current close moves beyond the previous upper boundary for a bullish event, or beyond the previous lower boundary for a bearish event. Once a breakout is detected, the script calculates a quality score. The score is built from multiple normalized components. Breakout distance measures how far the close extends beyond the prior Donchian boundary relative to ATR. Candle body participation rewards bars where the real body contributes meaningfully to the range. Wick behavior penalizes less efficient breakout bars. Midline slope acts as a directional context proxy. Channel compression evaluates whether the breakout is emerging from a relatively tighter local structure. Volume, when enabled, adds an additional confirmation layer by comparing current volume to a moving average baseline. These components are weighted and combined into a single breakout quality score. The result is then translated into a grade scale: A+, A, B, C, or D. This grade is not a claim about trade outcome, and it is not a guarantee of continuation. It is a structured description of breakout quality according to the internal model used by the script. After the breakout, the indicator records the active breakout level and projects a retest zone around it using ATR-based half-width logic. This active zone remains visible for a user-defined number of bars. During that window, the script monitors whether price revisits the zone and holds it according to the directional logic. When a valid hold occurs, the script can mark that event on the chart. If price invalidates the zone, the active state is cleared. The panel summarizes the current state and the most recent breakout evaluation. Depending on chart context, the script can display conditions such as Long Breakout, Short Breakout, active retest states, watch states, or Neutral. It also reports the latest breakout score, grade, channel width relative to ATR, and the current volume ratio when volume confirmation is enabled. Signals & Alerts The script includes deterministic alert conditions tied to specific structural events rather than vague descriptive states. Long Breakout Triggered when price closes above the previous upper Donchian boundary. Short Breakout Triggered when price closes below the previous lower Donchian boundary. Long Retest Hold Triggered when a bullish breakout remains active and price revisits the retest zone without losing the active breakout level according to the script’s hold logic. Short Retest Hold Triggered when a bearish breakout remains active and price revisits the retest zone without reclaiming the active breakout level according to the script’s hold logic. These alerts are event-based and intended to describe what the script detects on the chart. They are not trade instructions, and they should not be interpreted as a complete execution plan on their own. Key Inputs Donchian Length Controls the lookback used for the channel boundaries. ATR Length Used in the quality model and for retest zone construction. Midline Slope Lookback Defines how the script measures midline slope for directional context. Use Volume Confirmation / Volume SMA Length Enables or disables the volume component and sets the averaging baseline. Break Distance Full-Score ATR Defines how far beyond the channel price must extend to receive a full distance score. Channel Width Full-Penalty ATR Controls how channel width contributes to the compression component. Watch Threshold Helps identify when price is approaching the upper or lower channel region. Retest Zone Life / Retest Half-Width ATR Sets how long the active retest zone remains valid and how wide it is. Minimum Score For Breakout Labels Helps reduce noise by showing breakout labels only above the chosen threshold. Label and Panel Controls Allow adjustment of label visibility, historical label behavior, label size, label shift, panel position, and panel font size. Visual Style Controls Enable or disable edge glow, breakout level tags, right-side setup tag, breakout shelf, and event candle tint. Limitations & Transparency This indicator is an analytical overlay, not a strategy, not an execution engine, and not a backtest report. It does not place orders, size positions, manage risk, or estimate expected return. A high breakout score does not mean price must continue, and a low breakout score does not mean reversal is guaranteed. The score only reflects how the breakout ranks according to the script’s internal weighting model. Donchian logic is inherently sensitive to lookback selection and market regime. A shorter channel can produce more frequent events and more noise, while a longer channel can reduce event frequency and delay signals. Volume-based confirmation also depends on the instrument and session structure. On some symbols, volume can be informative; on others, it may be less useful. Retest logic is also contextual. Not every breakout will retest, not every retest will be clean, and not every valid hold will produce meaningful continuation. The retest zone is an interpretive tool designed to help chart reading, not a universal rule set for all instruments or timeframes. The visual elements are intended to improve readability, but users may still want to tune label thresholds, style controls, and retest settings to fit their own workflow. As with any chart tool, results can vary across assets, volatility regimes, and timeframes. Risk Disclosure This script is for chart analysis and educational use. It is not financial advice, not investment advice, and not a promise of future performance. Markets can move unpredictably, and breakout structures can fail without warning. Any trading or investment decision should be made using independent judgment, personal risk controls, and additional confirmation where appropriate.
Indicador Pine Script®
por AGProLabs
1