Começar

Range

Auction Lattice Reserve [JOAT]Auction Lattice Reserve Introduction Auction Lattice Reserve is an open-source auction-context indicator built to classify where price is trading relative to accepted value. It maps a fixed-lookback volume distribution, calculates Point of Control and Value Area boundaries, scores the current auction state, and then projects that information back onto the chart using profile slices, equilibrium bands, acceptance boxes, and an optional confirmed-bar TP/SL scaffold. The main problem this script solves is location. Many directional tools can detect trend, but they do not explain whether price is trading above value, below value, or rotating around equilibrium. Auction Lattice Reserve provides that context directly from a rolling auction profile and combines it with trend and volume expansion scoring so the user can distinguish balance, markup, and distribution states. Core Concepts 1. Fixed-Range Auction Profile The script scans a configurable lookback window, divides the price span into bins, and apportions each candle's volume into the bins it overlaps. This creates a rolling distribution of where volume was accepted: int firstBin = math.max(0, math.min(auctionBins - 1, math.floor((localLow - auctionLow) / auctionBin))) int lastBin = math.max(0, math.min(auctionBins - 1, math.floor((localHigh - auctionLow) / auctionBin))) 2. Point of Control and Value Area The highest-volume bin becomes the Point of Control. Value Area is expanded outward from the POC until the chosen percentage of total profile volume is captured. This makes the script useful for identifying accepted value and dislocation: auctionPoc := auctionLow + (auctionPocBin + 0.5) * auctionBin auctionVaLow := auctionLow + leftBin * auctionBin auctionVaHigh := auctionLow + (rightBin + 1.0) * auctionBin 3. Auction State Scoring The indicator does not rely on value alone. It blends distance from POC, trend spread, and short-vs-long volume expansion into an auction score. This creates a more robust state engine than simply checking whether price is above or below the value area. 4. Acceptance and Rejection Context Price trading outside the value area for consecutive confirmed bars is treated as accepted migration rather than a brief probe. When acceptance is confirmed, the script can project an acceptance box forward and optionally build a TP/SL ladder from the event. 5. Institutional Visualization The script uses right-side profile slices, layered clouds around value, an equilibrium band, candle-state coloring, and a compact top-right dashboard instead of retail-style arrows or decorative markers. Features Rolling auction profile: Fixed-lookback volume profile rendered at the right edge of the chart Point of Control and Value Area: POC, VA High, and VA Low plotted directly on price Auction score: Blends volume expansion, trend spread, and distance from equilibrium Equilibrium band: Mid-band around POC for visual balance context Acceptance boxes: Forward-projected boxes when price confirms value acceptance above or below the value area Optional TP/SL scaffold: Confirmed-bar entry, stop, TP1, TP2, TP3 rails with risk/reward fill Top-right dashboard: Shows current state, POC, value location, volume pressure, trend, and score Dark-mode visual design: Layered teal, rose, and gold tones tailored to auction concepts How to Use This Indicator Step 1: Check whether price is above value, below value, or inside value. Step 2: Review the auction score and dashboard state. Strong positive values indicate markup pressure. Strong negative values indicate distribution or liquidation pressure. Step 3: Watch for acceptance boxes. These show that price is no longer only probing value but may be migrating to a new area of acceptance. Step 4: Use the optional TP/SL scaffold only as a contextual planning aid. It is not a promise of outcome. Indicator Limitations Because the profile is rolling, value levels adapt over time and are not static A short lookback can make the auction map overly sensitive in volatile markets Acceptance logic requires confirmed bars, so some moves will already be underway when the state changes The TP/SL scaffold is informational and does not execute trades Originality Statement Auction Lattice Reserve is original in the way it combines a rolling auction profile, an equilibrium band, value-acceptance migration logic, and an institutional-style execution scaffold into one open-source indicator. The publication is intended to provide a reusable context layer for traders who want value-based location rather than a standalone entry system. Disclaimer This indicator is provided for educational and informational purposes only. It is not financial advice or a recommendation to buy or sell any financial instrument. Auction context and value-area behavior are derived from historical price and volume data and do not guarantee future results. Always use independent judgment and risk management. -Made with passion by jackofalltrades
Indicador Pine Script®
por officialjackofalltrades
XAUUSD Session Range [MatsukazeAlgo]🇬🇧 ENGLISH A session analysis tool optimized for Gold (XAUUSD). Surfaces the relationship between Asia, London, and NY sessions, classifies the daily regime, and shows how NY historically behaves within that context. Built for traders who use ICT-influenced or session-based frameworks. Concepts The 25% Level — Most session-based tools use the midpoint (50%) of a range as the key level. The 25% level is different: it marks the directional commitment zone. On a bullish session, the upper 25% of the body is where price proved it was willing to close strong. If a subsequent session penetrates this zone and recovers, it signals that the directional conviction still holds. If it fails to recover, the structure has shifted. This is the foundation of the wick interaction statistics in the table. Regime Classification — Every trading day, the Asia→London relationship falls into one of five structural patterns. "London Engulfs Asia" means London broke both Asia's high and low — a sign of strong directional intent. "Inside" means London stayed within Asia's range — a compression pattern. The regime determines which historical statistics are shown, because NY behaves differently under each structure. Asia Sweep — On Gold, London frequently takes out Asia's high or low before reversing. This is a liquidity grab: stop orders clustered above/below the Asia range get triggered, providing fuel for the real move. The indicator tracks how often this sweep predicts NY's direction. DXY Inverse Correlation — Gold and the US Dollar Index typically move in opposite directions. When DXY falls, Gold tends to rise. The indicator tracks this correlation historically and displays today's DXY direction as a macro bias filter. How It Works 1. Session Tracking: Asia (18:00–02:00 ET), London (02:00–08:00 ET), and NY (08:00–17:00 ET) OHLC are tracked live and displayed as composite candlesticks to the right of the chart. 2. 25% Level: For each completed session, a direction-aware level is calculated at the upper or lower 25% of the candle body. This marks where price delivery shifts from neutral to committed. 3. Regime Classification: At NY open, the indicator classifies the Asia-to-London relationship into one of five regimes: London Engulfs Asia, Asia Engulfs London, London Partial Up, London Partial Down, or Inside. 4. Stats Table: Historical NY behaviour is filtered by today's regime. NY bullish probability, London High/Low take rates, wick interaction with the London 25% level, and more. Gold-Specific Features Psychological Level Confluence — $50/$100 round-number levels are automatically plotted near price. When a psychological level aligns with a session's 25% level, a ★ CONFL marker appears. Gold respects round numbers. Confluence = higher probability zone. Asia Sweep Statistics — Tracks when London sweeps Asia's high or low, then measures NY's directional response. The stats table shows "Asia H Swept → NY Bull" and "Asia L Swept → NY Bear" probabilities. A core ICT Gold pattern that the original NQ-focused version didn't capture. DXY Inverse Correlation — Real-time DXY direction display in the TODAY section, with historical inverse correlation percentage in the GOLD ANALYSIS section. London Fix Marker — Vertical line at 15:00 GMT (10:00 ET) marking the London Gold Fix. One of the most significant intraday price events for Gold. Range in Pips — Session ranges displayed in pips (Gold standard) rather than points. Togglable in settings. Session Open Markers — Vertical lines at Asia / London / NY open times with configurable colour, style, and labels. These mark session boundaries. They are not trade signals. Alerts 5 alert types: Regime Confirmed (fires at NY open), NY Touches London 25%, London High Taken, London Low Taken, Psych Level Confluence. Set alerts and walk away. Input Reference Setup — Show Session Candle Panel: master toggle for the composite candlestick display. Show Chart Lines: master toggle for H/M/L/O and 25% lines on the chart. Asia / London / NY Session — Each session group contains: Show Candle (on/off), Session Open Line (vertical marker at session start with colour, style, width, and label toggle), H/M/L/O Lines (individual toggles for High, Mid, Low, Open with shared colour, style, width), 25% Level (colour, style, width for the directional commitment line). London Session — additionally includes London Fix Line (vertical marker at 15:00 GMT) and Fix Label toggle, both defaulting to line on / label off. Gold Settings — Psychological Levels: toggle $100 and $50 levels independently with separate transparency. Confluence Distance ($): how close a psych level must be to a 25% level to trigger the ★ marker (default 3.0). DXY Direction: toggle the DXY display in the stats table. Range in Pips: switch between pip display (Gold standard, 1 pip = $0.10) and point display. Stats Table — Show Table, Position (9 positions), Text Size (Tiny/Small/Normal), Text Colour, Title Colour. Lookback: number of historical sessions used for percentage calculations (default 252, roughly one trading year). Alerts — Individual toggles for each of the 5 alert conditions. All default to on. Conclusion XAUUSD Session Range gives Gold traders a structured, data-driven view of how the three major sessions interact. Instead of guessing whether NY will continue or reverse London's move, the stats table shows what happened historically under today's exact regime. The Gold-specific additions — psychological level confluence, Asia sweep tracking, and DXY correlation — layer institutional context that generic session tools miss. Every element is independently configurable and colour-customizable. Recommended timeframe: 1min–15min on XAUUSD. --- Based on Session Range Candles + 25% Level by lucymatos . This version adds Gold psychological level confluence, Asia sweep statistics, DXY inverse correlation, London Fix marker, pip display, alert conditions, and MatsukazeAlgo colour palette. --- 🇯🇵 日本語 ゴールド（XAUUSD）に特化したセッション分析ツールです。東京・ロンドン・NYの3セッション構造を分析し、日々のレジームを分類、NYが過去どのように動いたかを統計的に表示します。ICTやセッションベースのフレームワークを使うトレーダー向け。 コンセプト 25%レベル — 多くのセッションツールはレンジの中間点（50%）を基準にします。25%レベルは異なります。方向性のコミットメントゾーンを示します。強気セッションでは、ボディの上位25%は「価格が強く引けることを証明した場所」です。後続のセッションがこのゾーンに侵入して回復すれば、方向性の確信が継続しています。回復しなければ、構造が変化したということです。テーブルのウィック相互作用統計の基盤です。 レジーム分類 — 毎日、東京→ロンドンの関係が5つの構造パターンのいずれかに分類されます。「London Engulfs Asia」はロンドンが東京の高値と安値の両方を突破したことを意味し、強い方向性の意図を示します。「Inside」はロンドンが東京のレンジ内に留まったことを意味する圧縮パターンです。レジームによって表示される統計が変わります。各構造の下でNYの挙動が異なるためです。 東京スイープ — ゴールドでは、ロンドンが東京の高値/安値を取ってから反転することが頻繁にあります。流動性の掃き出しです。東京レンジの上下に集まったストップオーダーがトリガーされ、本当の動きの燃料になります。このスイープがNYの方向をどの程度予測するかを追跡します。 DXY逆相関 — ゴールドとドルインデックスは通常逆方向に動きます。DXYが下落するとゴールドは上昇する傾向があります。過去の相関率を統計的に追跡し、今日のDXY方向をマクロバイアスフィルターとして表示します。 仕組み 1. セッション追跡：東京（18:00–02:00 ET）、ロンドン（02:00–08:00 ET）、NY（08:00–17:00 ET）のOHLCをリアルタイム追跡。合成ローソク足としてチャート右側に表示。 2. 25%レベル：完了したセッションのローソク足ボディの方向に応じた25%レベルを計算。価格が中立からコミットに切り替わるゾーン。 3. レジーム分類：NYオープン時に、東京→ロンドンの関係を5つのレジームに分類（ロンドンが東京を包み込む、東京がロンドンを包み込む、ロンドン上方部分突破、ロンドン下方部分突破、インサイド）。 4. 統計テーブル：今日のレジームでフィルタリングされたNYの過去の挙動を表示。NY強気確率、ロンドン高値/安値テイク率、ロンドン25%レベルとのウィック相互作用統計など。 ゴールド専用機能 心理的価格帯の合流 — $50/$100のラウンドナンバーを価格付近に自動表示。セッションの25%レベルと心理的価格が近接すると★ CONFLマーカーが出現。ゴールドはラウンドナンバーを強くリスペクトします。合流 = 高確率ゾーン。 東京スイープ統計 — ロンドンが東京の高値/安値をスイープした後、NYがどの方向に動くかの確率を統計テーブルに表示。元のNQ向けバージョンにはなかったICTゴールドの重要パターン。 DXY逆相関 — TODAY欄にDXY方向のリアルタイム表示。GOLD ANALYSIS欄に過去の逆相関率を表示。 ロンドンフィックスマーカー — 15:00 GMT（10:00 ET）に縦線を表示。ゴールドの最も重要な日中イベントの一つ。 pips表示 — セッションレンジをゴールド標準のpips単位で表示。設定で切替可能。 セッション開始マーカー — 東京/ロンドン/NYの開始時刻に縦線を表示。セッション境界のマーカーであり、売買シグナルではありません。色・スタイル・ラベルは設定で変更可能。 アラート 5種類：レジーム確定（NYオープン時）、NY 25%タッチ、ロンドン高値突破、ロンドン安値割れ、心理的価格合流。アラートを設定してチャートから離れられます。 入力パラメータ 設定 — セッションキャンドルパネル表示：合成ローソク足のマスタートグル。チャートライン表示：H/M/L/Oと25%ラインのマスタートグル。 東京/ロンドン/NYセッション — 各グループ：キャンドル表示、セッション開始ライン（色・スタイル・太さ・ラベル）、H/M/L/Oライン（High/Mid/Low/Openの個別トグル、共有色・スタイル・太さ）、25%レベル（色・スタイル・太さ）。 ロンドンセッション — 追加でロンドンフィックスライン（15:00 GMT）とラベルトグル。デフォルトはラインON / ラベルOFF。 ゴールド設定 — 心理的価格帯：$100と$50レベルを個別にトグル、透明度別設定。合流距離（$）：★マーカーのトリガー距離（デフォルト3.0）。DXY方向：統計テーブルのDXY表示トグル。pips表示：pip表示（1 pip = $0.10）とポイント表示の切替。 統計テーブル — テーブル表示、位置（9か所）、文字サイズ（Tiny/Small/Normal）、文字色、タイトル色。ルックバック：統計計算に使用する過去のセッション数（デフォルト252、約1取引年分）。 アラート — 5種類のアラート条件それぞれに個別トグル。すべてデフォルトON。 まとめ XAUUSD Session Rangeは、ゴールドトレーダーに3セッションの相互作用をデータに基づいて分析する構造化されたビューを提供します。NYがロンドンの動きを継続するか反転するかを推測する代わりに、今日のレジームの下で過去に何が起きたかを統計テーブルで確認できます。心理的価格帯の合流、東京スイープ追跡、DXY相関というゴールド固有の機能は、汎用的なセッションツールでは見えない機関投資家の文脈を重ねます。すべての要素は独立して設定・色変更が可能です。 推奨時間足：1分〜15分（XAUUSD） --- Based on Session Range Candles + 25% Level by lucymatos . 心理的価格帯の合流検出、東京スイープ統計、DXY逆相関、ロンドンフィックスマーカー、pips表示、アラート、MatsukazeAlgoカラーパレットを追加。
Indicador Pine Script®
por MatsukazeAlgo
Range Equilibrium Rotation Planner [AGPro Series]Range Equilibrium Rotation Planner 🧠 Core Idea Is price rotating cleanly away from range equilibrium toward an edge, or is the midpoint still controlling the auction? 📌 Overview / What it does Range Equilibrium Rotation Planner maps mature range structure and focuses on the midpoint equilibrium area instead of treating every range as a breakout setup. The script displays the active range box, equilibrium band, edge rails, rotation room rail, failure rail, event labels, right-side tags, optional bar coloring, and a compact AG Pro dashboard with a 0-100 Rotation Score. It does not predict range breaks. It helps organize range balance, midpoint control, directional rotation, edge room, failure risk, and next-action state. 🎯 Purpose & Design Philosophy Many range tools focus on support, resistance, or breakout alerts. This script was built for a different question: what happens inside the range before price reaches the edge? It helps traders review whether price is still trapped around equilibrium or beginning a clean rotation from the midpoint toward the upper or lower edge. ⚡ Why This Script Is Different Most range indicators draw a box and wait for a breakout. This script does NOT center the workflow on range escape. Instead, it evaluates range maturity, midpoint control, rotation quality, edge room, and failure back through equilibrium. The goal is rotation planning, not breakout prediction. ⚙️ Methodology 1. Range Maturity Detection The script builds a rolling range using recent high and low structure, then checks whether the height and edge interactions are meaningful. 2. Equilibrium Mapping The midpoint band is calculated around the center of the range and becomes the key control zone. 3. Rotation Evaluation Price must move away from equilibrium with enough buffer before directional rotation is considered active. 4. Risk / Room Structure The active edge becomes the room reference, while the opposite side of equilibrium becomes the failure area. 5. Visual Output The chart receives a range box, equilibrium band, edge rails, room rail, failure rail, labels, right-side tags, optional bar coloring, and dashboard panel. 🗺️ How to Read the Chart The range box marks the current high-to-low structure. The equilibrium band shows the midpoint area where rotation control is evaluated. The upper and lower rails mark the active range edges. The room rail marks the edge being targeted by the active rotation. The failure rail marks where rotation has moved back through the wrong side of equilibrium. Labels highlight mature ranges, rotations from midpoint, equilibrium holds, edge reviews, and failed rotations. Colors represent context: • Teal → bullish rotation • Pink → bearish rotation or failure • Gold → equilibrium, room, or edge review • Indigo → range structure or waiting context The panel summarizes: • Range • Rotation Score • Balance • Room • Action 🚦 Signals & States • Range Ready → a mature range structure is available • Bull Rotation → price rotated upward from equilibrium • Bear Rotation → price rotated downward from equilibrium • Midpoint Hold → price remains controlled by the equilibrium band • Edge Review → price reached the active range edge • Failed → rotation moved back through the failure rail • READY → rotation quality and room are strong enough to monitor • MONITOR → rotation is active but not fully ready • WAIT RANGE → no mature range exists • WAIT ROTATION → range exists but no clean rotation has started 🔔 Alerts Logic Alerts can trigger when a mature range appears, when bullish or bearish rotation begins, when READY state appears, when midpoint hold appears, when an edge is reached, or when the rotation fails. Alerts are attention markers only. They are not trade instructions. 🧩 Confluence Logic The context becomes stronger when range maturity, balanced edge interaction, midpoint departure, edge room, and failure distance align. The script avoids treating midpoint noise as a clean rotation without confirmation. 📊 When to Use • Sideways markets with visible range structure • Crypto, forex, indices, and liquid stocks • 1H, 4H, and 1D market structure review • Mean-reversion planning inside a range • Range edge preparation without waiting for breakout-only logic ⚠️ When NOT to Use • Strong one-directional trends with no range structure • Thin symbols with unreliable highs and lows • News-driven candles that distort range boundaries • Very small ranges where spread or tick noise dominates • Markets with unstable data or irregular sessions 🎛️ Key Inputs • Range Lookback → controls the structure used to build the range • Minimum / Maximum Range Height ATR → filters ranges that are too small or too wide • Edge Touch Tolerance → controls how edge interactions are counted • Equilibrium Band ATR → controls midpoint band width • Rotation Break Buffer → controls how far price must move beyond equilibrium • Minimum Ready Score → controls READY strictness • Projection Bars → controls how far boxes, rails, and tags extend • Visual settings → control labels, tags, panel location, theme, and font size 🖥️ Interface & Visual Design The panel is designed to show the range state, rotation quality, balance, room, and action without overloading the chart. The first row uses a merged AG Pro header. The chart layer keeps the range and equilibrium structure visible while leaving room for price action. Labels are controlled with cooldown and maximum count settings to preserve a premium screenshot style. 🧪 Practical Usage Workflow 1. Read the panel. 2. Confirm a mature range exists. 3. Check whether price is still at equilibrium or rotating away. 4. Review room to the active edge. 5. Watch the failure rail if rotation loses control. 🔍 Interpretation Guidelines A high score means range maturity, midpoint departure, and edge room are aligned. A midpoint hold means equilibrium is still controlling the auction. An edge review means the rotation has reached the active range edge and should be interpreted as context, not as an automatic exit. A failed state means the active rotation moved back through its failure boundary. 🚫 What This Script Is NOT This script is not a prediction engine. It is not financial advice. It is not an automated trading system. It does not place orders. It does not guarantee edge reach, reversal, breakout, or profitability. ⚠️ Limitations & Transparency Range boundaries can shift as new highs or lows appear. Different timeframes may show different range structures. Large volatility events can temporarily distort range height and edge touch quality. Low liquidity may create unreliable equilibrium or edge behavior. The script is rule-based and should be interpreted within broader market context. 🧠 Market Context Notes Equilibrium is often where the market decides whether price will rotate toward an edge or remain balanced. The strongest rotation contexts usually appear when price leaves midpoint with room, while failure remains clearly defined. This script is designed to make that inside-range decision point easier to read. 🧾 Use Case Examples When price holds near midpoint and then closes above the equilibrium band, the script can begin tracking bullish rotation toward the upper range edge. When price rotates downward from equilibrium and reaches the lower edge, the context shifts into edge review rather than fresh entry signaling. When price moves back through the failure rail, the active rotation context fails. 🧱 System Philosophy AGPro Series tools are built as decision-support systems. They aim to convert market structure into readable context: what is active, what improves the plan, what invalidates it, and what should be reviewed next. 🔐 Non-Promise Statement No script can provide certainty. No signal guarantees outcome. This tool provides structured context only. 📉 Risk Disclosure Trading involves risk. Markets can move quickly and unexpectedly. Users are responsible for their own analysis, risk management, and decisions. This script does not provide financial advice. 📚 Educational Note Use this tool to study how range equilibrium, midpoint control, rotation quality, and edge room interact across different symbols and timeframes.
Indicador Pine Script®
por AGProLabs
Absorption Range Ledger [JOAT]Absorption Range Ledger Introduction Absorption Range Ledger is an open-source range and participation overlay built to detect high-participation ranges, estimate internal bull-vs-bear ownership, track weighted equilibrium, and monitor whether the market is being absorbed, contained, reclaimed, or broken. It is designed for traders who want richer range context than a basic support/resistance box. The script identifies high-participation candles, merges overlapping activity into persistent range zones, tracks a weighted equilibrium line inside the zone, and then highlights whether that zone is acting as supportive absorption, resistant absorption, or a two-way transfer area. Optional TP/SL rails are created when weighted reclaims or range breaks occur on confirmed bars. Core Concepts 1. High Participation Detection The script compares current volume to a baseline moving average. When participation exceeds the threshold, the candle is eligible to build or extend an absorption range. 2. Range Merging New high-participation candles are merged into existing ranges when overlap conditions are satisfied. This creates broader institutional-style transfer zones rather than isolated candle markers. 3. Ownership Split Each active range tracks approximate bullish and bearish ownership internally. This is displayed visually using sub-boxes and summarized numerically in the dashboard. 4. Weighted Equilibrium A weighted equilibrium line is maintained inside the dominant active range. This level serves as a practical internal reference for reclaim and failure behavior. 5. Range Events The script distinguishes containment, weighted-line reclaims, and outright range breaks. These states are used for dashboard context and optional TP/SL scaffolding. Features High-participation range detection: Builds active ranges when volume exceeds the baseline threshold Range merging: Overlapping participation bars are combined into richer zones Bull/bear ownership split: Internal sub-boxes show approximate participation balance Weighted equilibrium line: A central reference inside the active range Dominant active range logic: Tracks the most relevant current range for context Range reclaim and break states: Distinguishes contained trade from directional escape Optional TP/SL ladder: Builds informational risk rails on confirmed reclaims and breaks Top-right dashboard: Shows state, active count, weighted level, balance, range width, and event condition How to Use This Indicator Step 1: Identify whether a dominant active range exists. Step 2: Check the ownership balance. Strong positive balance suggests bid-side absorption. Strong negative balance suggests offer-side absorption. Step 3: Watch how price behaves around the weighted equilibrium line. Reclaims and failures often provide better context than touching the raw box boundary alone. Step 4: Use confirmed breaks of the dominant range as state changes, not as guaranteed trend starts. Indicator Limitations Ownership balance is an internal estimate, not a true order-flow measurement Range merging depends on the chosen volume threshold and can be too broad or too narrow if poorly configured Old ranges expire by design and will not remain indefinitely on the chart The TP/SL ladder is informational and not an execution engine Originality Statement Absorption Range Ledger is original in the way it combines participation-based zone merging, internal ownership splitting, weighted equilibrium governance, and event-driven scaffolding into one open-source range tool. It is published as a contextual market-transfer indicator rather than a simple breakout box. Disclaimer This indicator is provided for educational and informational purposes only. It is not financial advice. Participation, ownership, and absorption states are inferred from historical price and volume behavior and may not reflect future outcomes. Use independent analysis and risk management. -Made with passion by jackofalltrades
Indicador Pine Script®
por officialjackofalltrades
Weekly Range Break Planner [AGPro Series]# Weekly Range Break Planner 🧠 Core Idea Is the weekly range break strong enough to monitor, or is price likely to fail back inside the range? 📌 Overview / What it does Weekly Range Break Planner is a weekly range decision-support script built to evaluate whether price is breaking beyond the previous week's high or low with enough structural quality. The script maps the previous weekly high, low, and midpoint, detects bullish or bearish breaks, builds a retest shelf around the broken boundary, scores the break from 0 to 100, and summarizes the current state inside a compact AG Pro panel. It does not predict price direction, automate trades, or provide guaranteed signals. It is designed to organize weekly range context, break quality, retest behavior, target room, and invalidation risk into a clean visual workflow. 🎯 Purpose & Design Philosophy Weekly highs and weekly lows are widely watched reference points, but not every break beyond them is meaningful. This script was built for traders who want to separate a clean weekly range break from a weak expansion, failed breakout, or noisy return back into the prior range. The design supports structured observation: range first, break quality second, retest behavior third, and action state last. ⚡ Why This Script Is Different Most tools mark weekly highs and lows or show simple breakout signals. This script does NOT stop at drawing weekly levels. Instead, it evaluates what happens after price breaks the range: whether the break has enough close quality, whether the retest shelf is respected, whether target room remains, and whether the context is still valid. ⚙️ Methodology 1. Previous Weekly Range Mapping 2. Break Boundary Detection 3. Retest Shelf Construction 4. Break Quality Scoring 5. Target Room Evaluation 6. Invalidation And Expiration Handling 7. Panel And Alert Output 🗺️ How to Read the Chart The weekly range box marks the previous week's high-low structure. The high and low rails show the main break boundaries. The midpoint line helps users understand where price is relative to the prior weekly balance. The retest shelf appears around the broken boundary after a weekly range break. READY BREAK labels appear when the break context meets the required score threshold. Target rails show projected continuation references after a qualified break. The panel summarizes Range State, Break Score, Retest, Room, and Action. 🚦 Signals & States • READY → A qualified weekly range break has formed. • MONITOR → Price has broken a weekly boundary and the script is evaluating quality. • WAIT → The previous weekly range is valid, but no active break context is present. • INVALIDATED → Price failed back inside the weekly range after a break. • EXPIRED → The break window closed without a qualified context. • BLOCKED → The previous weekly range is not suitable for evaluation. 🔔 Alerts Logic Bullish Weekly Range Break Ready triggers when price breaks above the previous weekly high with enough quality. Bearish Weekly Range Break Ready triggers when price breaks below the previous weekly low with enough quality. Weekly Range Break Invalidated triggers when price fails back inside the prior weekly range after a break. Weekly Range Break Expired triggers when the evaluation window closes without a qualified break state. Alerts are attention markers, not trade instructions. 🧩 Confluence Logic The break score combines weekly range fit, close distance beyond the boundary, retest shelf behavior, time quality, relative volume, and available target room. When these elements align, the context becomes stronger. When they do not align, the script remains in WAIT, MONITOR, INVALIDATED, EXPIRED, or BLOCKED state. 📊 When to Use • Weekly high and weekly low break analysis • Breakout-retest workflows • Intraday monitoring around prior weekly extremes • Swing context planning • Trend continuation after a range expansion ⚠️ When NOT to Use Avoid relying on this script in extremely low-liquidity markets, very noisy symbols, holiday sessions, or conditions where the previous weekly range is not meaningful. It should not be used as a standalone decision tool without broader market context, risk planning, and independent confirmation. 🎛️ Key Inputs • Minimum Weekly Range filters weak or compressed prior weekly ranges. • Break Buffer ATR controls how far price must close beyond the weekly boundary. • Retest Shelf ATR controls the depth of the shelf around the broken boundary. • Invalidation Buffer ATR controls how far price must close back inside the range before invalidation. • Minimum Ready Score controls how strong the score must be before READY appears. • Target inputs define continuation reference rails from the broken boundary. • Visual settings control boxes, rails, labels, right-side tags, panel location, and font size. 🖥️ Interface & Visual Design The interface is designed to make the weekly range context readable at a glance. The chart shows the prior weekly range, the active break boundary, the retest shelf, and target-room references without turning the screen into a generic breakout overlay. The AG Pro panel gives compact decision context while preserving chart visibility. 🧪 Practical Usage Workflow 1. Check whether the previous weekly range is valid. 2. Watch for a close beyond the weekly high or low. 3. Observe the retest shelf around the broken boundary. 4. Read the break score, retest state, and room value. 5. Treat READY as an attention state and confirm with broader market context. 🔍 Interpretation Guidelines A higher break score means the weekly range break is cleaner according to the script logic. A clean retest shelf response can strengthen the context. Low remaining room means the move may already be extended relative to the projected target. READY means the context deserves attention, not that price must continue. 🚫 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 risk management or independent analysis. ⚠️ Limitations & Transparency Weekly range behavior changes across markets, timeframes, volatility regimes, and liquidity conditions. The score is rule-based and depends on current chart timeframe, ATR normalization, volume behavior, and the previous weekly range. Different symbols may require different sensitivity settings. 🧠 Market Context Notes Weekly range breaks can be more meaningful when aligned with trend, liquidity response, volume participation, and clean retest behavior. Breaks that quickly return inside the prior weekly range often need extra caution. 🔐 Non-Promise Statement No script can guarantee future price behavior. This tool provides structured visual context only. 📉 Risk Disclosure Trading involves risk. Users remain responsible for their own decisions. This script is for educational and analytical purposes only and does not provide financial advice or guaranteed trading outcomes.
Indicador Pine Script®
por AGProLabs
Opening Range Retest Planner [AGPro Series]# Opening Range Retest Planner ## Core Idea Did the opening range breakout return to its boundary and hold with enough quality to deserve attention? ## Overview / What It Does Opening Range Retest Planner is an intraday opening range decision-support script built for traders who want to evaluate the quality of the first meaningful retest after an opening range breakout. The script builds the opening range, tracks the first bullish or bearish breakout, maps a focused retest pocket around the broken boundary, grades the retest from 0 to 100, and displays a clear action state in a compact AG Pro panel. It does not predict price direction, automate execution, or provide guaranteed outcomes. Its purpose is to organize structure, acceptance, invalidation, and retest quality in a clean visual workflow. ## Purpose & Design Philosophy Many opening range tools focus only on the initial break. In practice, the first retest after the break is often where the structure becomes more meaningful. This script was built for traders who want to separate a clean retest hold from a weak pullback, failed breakout, or expired setup. The design supports structured observation instead of impulsive reaction. ## Why This Script Is Different Most opening range tools stop at the range or breakout itself. This script does not stop there. Instead, it focuses on what happens after the break: whether price returns to the broken boundary, respects it, fails back inside the range, or runs out of time before a qualified retest appears. ## Methodology 1. Opening Range Mapping 2. Breakout Detection 3. Retest Pocket Construction 4. Retest Quality Scoring 5. Acceptance, Invalidation, or Expiration State 6. Panel and Alert Output ## How To Read The Chart The opening range remains the main session reference. The retest pocket marks the area where the script evaluates whether the broken boundary is being respected or rejected. Labels highlight qualified retests, invalidations, and key state changes. Target rails project possible continuation space after a qualified retest. The panel summarizes OR state, retest score, acceptance side, failure risk, and current action. ## Signals & States READY -> A retest touched the pocket, held the broken boundary, and met the minimum quality threshold. MONITOR -> A breakout occurred and the script is tracking whether a qualified retest develops. WAIT -> The opening range is still building, has just locked, or is waiting for a valid post-break condition. INVALIDATED -> Price failed back inside the opening range after the breakout. EXPIRED -> The retest window closed without a qualified retest. BLOCKED -> The opening range is not valid enough to evaluate. ## Alerts Logic Bullish Opening Range Retest Ready triggers when a bullish breakout retest holds the broken range high with enough score. Bearish Opening Range Retest Ready triggers when a bearish breakout retest holds the broken range low with enough score. Opening Range Retest Invalidated triggers when price fails back inside the opening range after a breakout. Opening Range Retest Expired triggers when the retest window expires without a qualified hold. Alerts are attention markers, not trade instructions. ## Confluence Logic The retest score combines pocket touch quality, close response, retest timing, relative volume, opening range volatility fit, and available target room. When these conditions align, the context becomes stronger. When they do not align, the panel remains in MONITOR, WAIT, INVALIDATED, or EXPIRED state. ## When To Use This script is most useful in liquid intraday markets where the opening range matters and session structure is clear. It fits breakout-retest workflows, opening drive continuation, failed breakout monitoring, and structured intraday planning. ## When NOT To Use Avoid relying on this script in very low-liquidity symbols, extremely noisy sessions, holiday trading, or chart conditions where the opening range session cannot be represented cleanly. ## Key Inputs Opening Range Mode controls whether the script uses an exact session window or the first chart bars of each day. Auto mode uses session-window logic on lower intraday charts and switches to first-bars-of-day logic on higher timeframes. Retest Pocket ATR controls the depth of the retest zone around the broken boundary. Minimum Ready Score controls how strong the 0-100 retest score must be before READY appears. Panel and label controls let users adjust position, theme, and visual density. ## Interface & Visual Design The visual design is chart-first. The opening range stays readable, the active retest pocket becomes the focus area, and the panel provides compact decision context without covering the whole chart. The first panel row uses the AG Pro blue header style and shows only the script name. ## Practical Usage Workflow 1. Wait for the opening range to lock. 2. Watch for a breakout beyond the range boundary. 3. Observe whether price returns to the retest pocket. 4. Check the retest score and action state. 5. Treat alerts as attention markers and confirm context with your broader process. ## 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 guarantee outcomes. It does not replace independent risk management or market context. ## Limitations & Transparency Opening range behavior changes across markets, sessions, liquidity conditions, and timeframes. The score is rule-based and depends on the configured session, ATR normalization, volume behavior, and retest window. Different chart timeframes may display session structure differently. ## Risk Disclosure Trading involves risk. Users remain responsible for their own decisions. This script is for educational and analytical purposes only and does not provide financial advice or guaranteed trading outcomes.
Indicador Pine Script®
por AGProLabs
Meridian Regime Overlay [JOAT]JOAT Meridian Regime Overlay Introduction JOAT Meridian Regime Overlay is an open-source market context overlay built to classify whether price is operating in directional expansion, balanced auction, or compression. It is designed as a chart-first regime engine rather than a standalone trigger study. The script combines local baseline alignment, confirmed higher-timeframe bias, pivot structure, opening-range acceptance, realized volatility state, and session VWAP location into one integrated regime map. The problem it solves is context. Many indicators can say whether price is above or below an average. Far fewer explain whether the move is supported by volatility expansion, structural acceptance, value migration, and higher-timeframe alignment. Meridian Regime Overlay focuses on that exact problem. It grades the live auction bar by bar. It also shows what is supporting the grade. That makes it useful as a decision filter before interpreting any lower-level signal source. This script is not trying to predict the future. Its job is to organize the present market condition. It helps answer practical questions: Is the market trending with real conviction? Is price only drifting above a baseline without expansion? Is the market compressing near a likely release point? Is higher-timeframe structure aligned with the current move? Is price accepting away from value or simply rotating around it? Core Concepts 1. Baseline Stack Alignment Fast, slow, and anchor baselines define the local directional stack. Directional strength improves when those baselines align in sequence and their slopes support the move. fastBase = ta.ema(close, fastLen) slowBase = ta.ema(close, slowLen) anchorBase = ta.ema(close, anchorLen) 2. Confirmed Higher-Timeframe Bias Higher-timeframe context is pulled using confirmed values only. This avoids depending on unfinished HTF candles. htfFast = request.security(syminfo.tickerid, biasTf, ta.ema(close , fastLen), lookahead = barmerge.lookahead_on) htfSlow = request.security(syminfo.tickerid, biasTf, ta.ema(close , slowLen), lookahead = barmerge.lookahead_on) htfAnchor = request.security(syminfo.tickerid, biasTf, ta.ema(close , anchorLen), lookahead = barmerge.lookahead_on) 3. Compression and Expansion State The script compares Bollinger width and Keltner position to identify squeeze behavior and release behavior. ADX and realized variance refine the classification. 4. Pivot Structure State Confirmed pivots define recent structural reference points. Breaks through those pivots update the structural state. 5. Session VWAP Context Distance from session VWAP is normalized in ATR units. This helps reveal whether price is auctioning away from value with intent or just rotating around it. 6. Opening-Range Acceptance The opening range is tracked and plotted. Acceptance above or below that range adds useful early-session context. 7. Composite Regime Score Multiple directional variables are folded into a single regime score. The score is a context summary, not a standalone trade signal. 8. Confirmed Event Labels The overlay prints confirmed auction-up, auction-down, and squeeze-release labels directly on the chart. Features Directional regime classification: bullish expansion, bearish expansion, balance, and compression states Baseline cloud system: fast and slow cloud for local trend stack Confirmed HTF alignment: higher-timeframe bias uses confirmed values only Opening-range plotting: high, low, and midpoint are tracked Session VWAP context: value migration is integrated into the read Pivot structure state: recent structural breaks are tracked Compression and release logic: squeeze and expansion state are visualized Bar-state coloring: candles transition with regime intensity Confirmed event labels: auction and expansion markers print on the chart Dashboard: summarizes regime, score, HTF, structure, volatility, and VWAP context Input Parameters Trend Engine: Fast Baseline Slow Baseline Anchor Baseline Adaptive Mean Length Bias Timeframe Slope Lookback Slope Threshold ATR RVOL Impulse Threshold Volatility Engine: ATR Length Compression Length Band Deviation Keltner Length Keltner Multiplier ADX Length ADX Floor Expansion Threshold Realized Variance Length How to Use This Indicator Step 1: Read the regime color, cloud, and dashboard state. Step 2: Check higher-timeframe alignment before trusting directional continuation. Step 3: Compare structure and VWAP position to see whether price is accepting away from value. Step 4: Watch squeeze-release transitions closely because those often precede cleaner directional movement. Step 5: Use the script as a context filter for other tools rather than as a complete trading system. Indicator Limitations Pivot structure confirms after the pivot fully forms, which is intentional non-repainting behavior Higher-timeframe values are confirmed and therefore intentionally delayed Compression can persist longer than expected in slow auction environments Directional classification does not guarantee continuation Originality Statement This publication is original in the way it integrates baseline structure, confirmed higher-timeframe bias, compression state, realized variance, session VWAP, opening-range acceptance, and pivot structure into one unified regime overlay. The components are not combined arbitrarily. They all answer the same core question: what is the current quality of the auction? Disclaimer This indicator is provided for educational and informational purposes only. It is not financial advice. Market regimes can shift quickly. All readings are based on historical and current bar data and do not guarantee future performance. Always use independent analysis and risk management. Best Use Cases Directional trend filtering before using a separate trigger model Session context analysis during London and New York activity Volatility transition analysis when compression begins to release Structure-aware regime filtering for discretionary execution Interpretation Notes The strongest readings usually occur when the local stack, confirmed higher-timeframe stack, VWAP position, and volatility expansion agree. If only one or two of those are aligned, the chart can still move, but the regime read is weaker. Compression should not be treated as a bearish or bullish state by itself. It is a warning that the market is withholding directional commitment. Opening-range acceptance adds value because many directional sessions reveal their intent early. When price cannot hold outside the opening range, the regime should usually be treated more cautiously. Publication Notes This script is intended to be published with a clean chart where the cloud, baselines, opening range, and event labels are clearly visible. The chart should not be cluttered with unrelated overlays. If showing an example image, the regime state and at least one structural transition should be identifiable at a glance. -Made with passion by jackofalltrades
Indicador Pine Script®
por officialjackofalltrades
Daily Range Intelligence (DRI)Daily Range Intelligence (DRI) is an intraday context tool designed to help traders understand how much of the expected daily range has already been used. It measures the current day’s range relative to the Average True Range (ATR) and presents this information in a clean, visual format to support decision-making. This indicator does not generate trading signals. It is intended to provide context about volatility and range expansion. Core Concept Markets tend to move within a statistical range. By comparing the current range to ATR, traders can evaluate whether price still has room to expand or if it is operating in extended conditions. How to Interpret the Range Below 50% of ATR The market has used a relatively small portion of its expected range. This indicates that price may still have room to expand. Between 80% and 120% of ATR The market is operating in a decision zone, where both continuation and rotation scenarios are possible. Above 120% of ATR The market has exceeded its typical range. This is commonly associated with slower conditions or consolidation. Important Note on ATR Levels Reaching 100% of ATR does not imply that price must reverse or stop moving. Markets can continue to expand beyond their average range, especially during strong directional sessions. The ATR level is a reference point for context, not a limit or constraint. What the Indicator Displays Current day range relative to ATR (percentage) A simplified status view (Expansion, Decision, Exhaustion) A compact dashboard for quick interpretation An optional ATR 100% level to highlight when the expected range has been reached Reference zones based on previous day and session ranges How It Helps DRI helps answer key intraday questions such as: Has the market already moved significantly today? Is there still room for expansion? Are current conditions better suited for continuation or patience? Usage Notes This tool is designed to be used alongside price action and technical analysis. It does not predict direction and should not be used in isolation. Always combine it with your own analysis and risk management approach. Market conditions can vary, and no single metric should be used as a standalone decision tool.
Indicador Pine Script®
por mlicero
Range Zones ATR Range Zones ATR Range Zones ATR is an open-source indicator designed to detect, validate, score, and maintain sideways price zones using ATR-normalized structure analysis. The script is built for one specific purpose: identifying areas where price is behaving like a genuine horizontal range rather than a brief pause inside an ongoing trend. Instead of marking every local consolidation, it evaluates whether price is compressed relative to current volatility, whether directional pressure remains limited, whether the market is interacting with both sides of the structure, and whether internal movement stays balanced enough to justify treating the area as a meaningful zone of acceptance. In practical terms, this indicator highlights parts of the chart where price is rotating within a contained area instead of moving cleanly in one direction. That makes it useful for studying balance, consolidation, containment, and possible expansion after compression. What this indicator is This indicator is a volatility-adjusted range structure detector. Its main task is to answer a structural question: Is price actually trading inside a valid sideways regime, or is the apparent consolidation too directional, too unstable, or too impulsive to be treated as a real range? To answer that, the script does not rely on a single condition. It combines multiple filters and measurements into one process. A visible zone is only created after the candidate structure survives tests related to compression, trend pressure, slope behavior, duration, touch activity, oscillation, drift, and local expansion. What this indicator shows The script draws zones directly on the chart as horizontal boxes representing areas where price is being accepted inside a relatively contained environment. The indicator can classify zones in three different ways: Base Range A confirmed sideways zone that passed the core validation logic. Prime Range A higher-quality confirmed zone with a stronger final score. These zones generally show cleaner balance, stronger containment, and better internal structure than a standard range. HTF Confluence A confirmed local zone that also overlaps with a valid higher-timeframe range context when the optional multi-timeframe feature is enabled. These labels are structural descriptions, not trade commands. They are intended to help the user understand the character and quality of the detected range. What the script measures The indicator is built around the idea that a valid range should appear compressed, balanced, and relatively non-directional. To evaluate that, it measures several parts of market behavior. Range width relative to ATR The script compares the width of recent price envelopes to ATR. This allows the indicator to interpret range width relative to current volatility instead of using a fixed distance. A narrow range on one symbol may be wide on another, and a usable range on one timeframe may be insignificant on another. ATR normalization helps the script stay adaptive across different chart conditions. Multiple internal envelopes The script builds short-, medium-, and long-lookback envelopes from recent highs and lows. It then compares those candidates and selects the one that provides the best structural fit. This makes the detection process more flexible than relying on only one fixed lookback. ADX trend pressure A stable range normally should not exist in a strongly directional environment. The script uses ADX as part of its filter and scoring process to reduce the chance of classifying strong directional movement as sideways structure. EMA slope and linear regression slope A market can appear flat while still drifting directionally. To reduce that problem, the script checks both EMA slope and linear regression slope. This helps filter out sloped price action that does not behave like a clean horizontal range. Minimum persistence A valid range should remain stable for a meaningful number of bars before it is trusted. The script therefore includes minimum-bar confirmation logic so that very brief pauses do not become fully confirmed zones too early. Touch behavior A healthy range usually shows repeated interaction with its boundaries. The script tracks touches near the upper and lower edges of the candidate zone to confirm that price is actually rotating through the structure rather than clustering on one side. Internal oscillation A sideways regime should contain some back-and-forth movement. The script evaluates oscillatory behavior within the candidate zone to avoid treating a slow directional drift as balanced consolidation. Drift and efficiency The script checks how directly price is moving from one point to another. If movement becomes too efficient or too directional, that is less consistent with a true range. If movement is choppier and more rotational, the structure is more likely to qualify. Impulsive movement Strong impulsive candles can weaken or invalidate the idea of a stable range. The script uses expansion and impulse-related checks to reject candidates that are behaving too aggressively. Higher-timeframe overlap When the optional MTF context feature is enabled, the script checks whether the local zone overlaps a confirmed higher-timeframe range area. If the overlap is meaningful, the zone can receive a score boost and be classified with higher structural context. How the detection process works At a high level, the script follows this workflow: First, it builds recent envelopes from highs and lows using several internal lookbacks. Second, it measures whether those envelopes are sufficiently compressed relative to ATR. Third, it combines that compression with trend and slope conditions such as ADX, EMA slope, and linear regression slope. Fourth, if the environment looks suitable, it starts tracking a candidate zone instead of drawing a confirmed zone immediately. Fifth, while the candidate is active, it evaluates persistence, touch count, oscillation, drift, path efficiency, and impulsive behavior. Sixth, if the candidate survives enough structural tests, it becomes a visible zone on the chart. Seventh, once a zone is active, it can continue, refine, merge with a nearby compatible zone, or terminate if price no longer behaves like the same sideways regime. Finally, if breakout alerts are enabled, the script only considers a breakout confirmed after price closes beyond the zone edge plus an ATR-based buffer. This process is important because the indicator is not designed to draw every small pause. It is designed to identify consolidations that behave like actual balance. How to read the zones A visible zone should be interpreted as an area where the script sees containment, acceptance, and relatively balanced price behavior. That can help the user evaluate: whether the market is still consolidating rather than trending, whether price is continuing to rotate inside the same area, whether one side of the structure is weakening, whether the range remains healthy, or whether the market may be transitioning from compression into expansion. A Base Range means the structure passed the standard confirmation requirements. A Prime Range means the same structure passed with a stronger overall score. An HTF Confluence zone means the local structure also aligns with a broader higher-timeframe range area. These classifications describe current market structure. They do not guarantee that price will remain inside the zone or that the next movement will occur in a particular direction. How to use this indicator This indicator is best used as a market-structure and chart-context tool. One practical use is to study where price is being accepted inside a contained area. When price remains inside a confirmed zone and continues to interact with both edges, the market may still be operating in a balanced regime. Another use is to monitor edge behavior. The upper and lower zone boundaries can serve as structural reference areas. Repeated rejection near one side, repeated return toward the middle, or clean acceptance outside the zone may help the user judge whether the range is still functioning or beginning to fail. The breakout logic can also be used for structure monitoring. Because the script requires price to move beyond the zone edge with an ATR-based buffer, it is more selective than a simple boundary touch. This helps reduce reactions to small wick-only violations and shallow overshoots. The optional higher-timeframe context can be used to compare local balance with broader structure. A local range that overlaps a confirmed higher-timeframe range may be more relevant than an isolated local pause. The script can also be used to filter low-quality consolidation. Many apparent ranges are only temporary slowdowns inside a directional move. This indicator tries to reject many of those cases by requiring better balance, persistence, touch behavior, and non-directional structure before a zone is confirmed. What makes this indicator different This script differs from simpler range tools in several ways. ATR-normalized detection The indicator evaluates range width relative to ATR instead of using fixed-width boxes. This helps the same logic adapt to different volatility conditions, symbols, and timeframes. Multi-factor validation The script does not rely on a single trigger. It combines compression, trend pressure, slope analysis, persistence, touch activity, oscillation, drift, and efficiency into one structural decision process. Candidate-to-confirmation workflow Many range tools mark a zone as soon as price becomes temporarily narrow. This script first tracks a candidate, then confirms it only if the structure continues to behave like a true sideways regime. Quality classification The script separates normal confirmed ranges from stronger confirmed ranges. This helps distinguish ordinary structure from zones that achieve better internal scores. Zone merge logic Nearby zones that belong to the same horizontal regime can be merged. This is useful because real consolidations are often fragmented by minor interruptions or short empty gaps that still belong to the same broader balance area. Higher-timeframe confluence The optional MTF feature is used as structural context rather than as a separate signal engine. This allows local zones to be strengthened when they align with a broader confirmed range. Active zone maintenance Once confirmed, a zone is not simply frozen in place. The script can continue refining and extending the zone while price remains compatible with the same range logic. Input overview Mode Conservative, Balanced, and Aggressive modes control how selective the detection process is. Conservative mode generally favors fewer and stricter zones. Aggressive mode allows broader coverage. Preset Scalping, Intraday, and Swing presets adjust internal lookbacks and structural behavior for different trading horizons. Price Series The script can use close, hl2, hlc3, or ohlc4 as its selected price source in parts of the scoring and filtering process, while envelopes remain based on highs and lows. Sensitivity Sensitivity changes how tightly or loosely candidate structures are interpreted. Min Bars and Min Score These settings define how much persistence and quality a candidate needs before it can qualify as a visible zone. Trend Filter This filter reduces the chance of labeling strong directional movement as sideways structure. Merge controls Merge Zones, Merge Threshold, Merge Gap Bars, and Bridge Merge control whether nearby compatible zones should be combined into one broader regime. MTF controls MTF Context, Higher TF, and MTF Boost allow local structure to be compared against confirmed higher-timeframe range structure. Visual controls The script includes settings for fill, borders, labels, theme handling, and score visibility. Alerts Optional alerts are available for newly confirmed zones and for breakout events beyond an active zone. Best use cases This indicator is designed for users who want to study consolidation structure rather than only directional trend behavior. It can be useful for identifying balanced price areas, monitoring acceptance inside a horizontal regime, watching for continuation or breakdown of an existing range, studying compression before expansion, and comparing local structure with higher-timeframe context. Important limitations This script is an indicator, not a strategy. It does not execute trades and it does not provide backtest results. Like any range-based method, it can become less effective in environments dominated by persistent directional expansion, abrupt trend transitions, or sudden volatility shocks. A detected zone is the script’s structural interpretation of current price behavior, not a guarantee that price will remain contained. Open-source note This script is published as open-source so users can inspect the logic, understand how the methodology works, and build on the idea in accordance with TradingView’s publication and reuse rules.
Indicador Pine Script®
por malibuuu
1
Range Breakdown Readiness [AGPro Series]Range Breakdown Readiness 🧠 Core Idea Is the range breakdown valid, early, or likely to fail? 📌 Overview / What it does Range Breakdown Readiness is a support-side breakdown planning tool built to evaluate whether price is actually accepting below a mature range or only probing below support and returning. The script maps a prior range, tracks the support-side breakdown, draws a breakdown acceptance band, projects a target-room corridor, marks reclaim risk, and summarizes the setup through a 0-100 Breakdown Score. It does not predict price direction, automate decisions, or turn every low into a tradeable support level. It is a rule-based chart-reading and planning framework. 🎯 Purpose & Design Philosophy Many breakdown tools only mark the moment price moves below a level. That is usually not enough. This script was built for traders who want to review breakdown quality before reacting. It focuses on acceptance, failure risk, target room, and the next planning action rather than printing generic bearish signals. The mindset is simple: a breakdown should be reviewed as a structured decision context, not as a one-bar event. ⚡ Why This Script Is Different Most tools focus on break markers, support/resistance lines, or broad breakout confirmation. This script does NOT clone Consolidation Breakout Quality, Range Escape Planner, Compression Breakout Readiness, or a generic S/R zone map. Instead, it stays narrow: it evaluates the support-side breakdown of a mature range and asks whether the break has enough acceptance to deserve review, or whether reclaim/failure risk is still too high. ⚙️ Methodology 1. Context Detection The script maps the prior range high and range support edge, then checks whether the structure is mature enough to evaluate. 2. Reference Mapping It uses the support edge as the breakdown reference, then draws a range box, acceptance band, reclaim rail, and target-room corridor. 3. Reaction Evaluation The score combines range age, close below support, candle close quality, volume support, retest rejection, and target room. 4. Visual Output The chart receives clean planning zones, compact labels, guide lines, alerts, and a premium AGPro panel with state, score, acceptance, risk, and action. 🗺️ How to Read the Chart Zones = the mapped range, the breakdown acceptance band, and the target-room corridor. Labels = support watch, breakdown, breakdown ready, retest rejection, follow-through, reclaim risk, and failure risk states. Colors = teal and indigo for constructive planning context, pink for active breakdown pressure, amber for caution and failure-risk review. Panel = the planning summary: Range State, Breakdown Score, Acceptance, Failure Risk, and Action. 🚦 Signals & States • Support Watch → price is near the support side of a mature range. • New Range Breakdown → price closed below the mapped support edge. • Breakdown Ready → score and failure-risk context support a stronger breakdown review. • Retest Rejection → price revisited the broken support area and rejected from the acceptance band. • Failure Risk Review → acceptance is weak or reclaim pressure increased. • Breakdown Reclaim → price moved back above the reclaim rail and the active review is invalidated. • Target Corridor Reached → price reached the projected target-room area. 🔔 Alerts Logic Alerts trigger when the script detects support watch, a new breakdown, breakdown ready state, retest rejection, failure-risk review, follow-through, reclaim, or target-corridor contact. Alerts are attention markers. They are not trade instructions. 🧩 Confluence Logic The breakdown context becomes stronger when range maturity, close distance below support, bearish close quality, relative volume, retest rejection, and target room align. The context weakens when the move stays too close to support, forms a large lower wick, lacks volume support, or reclaims back above the support rail. 📊 When to Use • Mature ranges that begin to test the lower boundary. • Breakdown review after a support-side close outside the range. • Markets where target room below the range matters. • Charts where a trader wants failure-risk context before reacting. ⚠️ When NOT to Use • Extremely illiquid symbols. • Very noisy micro timeframes with unreliable range structure. • News spikes where ATR and volume become distorted. • Markets that gap through the entire range before a readable review forms. 🎛️ Key Inputs • Range Lookback → controls the range reference window. • Minimum Range Age → controls how mature the range must be before readiness improves. • Minimum Close Below Support ATR → controls the required close distance below support. • Acceptance Band ATR → controls the width of the breakdown acceptance band. • Reclaim Buffer ATR → controls the invalidation rail above support. • Target Corridor Range Multiple → controls the projected target-room corridor. • Label and Panel Font Size → controls publication readability. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The range box, acceptance band, and target corridor provide the main visual structure. The panel stays compact and decision-oriented, with one merged blue AGPro header row and five planner rows. Labels are limited, offset away from candles, and controlled by cooldown and max-visible settings to preserve a premium chart view. 🧪 Practical Usage Workflow 1. Read the panel state. 2. Check whether the range is mature or only building. 3. Review the support-side acceptance band after a close below support. 4. Compare Breakdown Score with Failure Risk. 5. Watch the reclaim rail and target-room corridor as context references. 🔍 Interpretation Guidelines Think in terms of quality and failure risk. A low score does not mean price cannot continue. It means the current breakdown context is not yet clean. A high score does not mean certainty. It means the script sees stronger alignment between range maturity, acceptance, volume, candle quality, retest behavior, and target room. 🚫 What This Script Is NOT • Not a prediction engine. • Not financial advice. • Not auto trading. • Not guaranteed signals. • Not a generic support/resistance scanner. • Not an Order Block, Fair Value Gap, BOS/CHOCH, or broad SMC map. ⚠️ Limitations & Transparency Range quality can change by timeframe. High volatility can make reclaim and target-room references move quickly. Low liquidity can reduce the usefulness of volume support. The script is rule-based and should be interpreted within broader market context. 🧠 Market Context Notes Breakdowns are often most useful when the prior range is mature, the support edge is clear, and price has enough room below the range to develop. Weak breakdowns often appear as a quick pierce below support followed by a reclaim back inside the range. This script focuses on that difference. 🧾 Use Case Examples When price closes below range support with strong close quality, elevated relative volume, and a clean target corridor, the panel may move toward Breakdown Ready. When price pierces below support but closes back near or above the edge, the script may show Failure Risk or Reclaim Review. 🧱 System Philosophy AGPro planning tools are built to reduce chart ambiguity. The goal is not to add another signal, but to organize the decision context around structure, risk, acceptance, and next action. 🔐 Non-Promise Statement No script can provide certainty. No score should be interpreted as a guaranteed outcome. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions. This script does not provide financial advice, investment advice, or guaranteed trading outcomes. 📚 Educational Note Use the script as an educational planning layer to study breakdown quality, reclaim risk, and target-room context across different symbols and timeframes.
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
Range Rejection Planner [AGPro Series]Range Rejection Planner 🧠 Core Idea Is price rejecting a range edge with enough quality to monitor back toward the midline? 📌 Overview / What it does Range Rejection Planner is a chart-first range reaction decision engine built to evaluate whether price is rejecting the active range edge with enough structure to deserve attention. The script maps one relevant range edge, a focused edge-reaction zone, wick rejection behavior, close-back-inside quality, midline room, invalidation shelf, failure risk, event labels, alerts, and a clean AGPro planning panel. These components are converted into a 0-100 Rejection Score and a clear next-action state. It does not predict price movement, automate trades, draw a full support/resistance library, or guarantee that a range edge will hold. Its purpose is to organize the range-edge rejection review process with practical risk and midline context. 🎯 Purpose & Design Philosophy This script was built for traders who want to evaluate range-edge reactions without turning the chart into a crowded level map. Many range tools show boundaries, fills, or breakout markers, but they often stop before answering the practical planning question: did price actually reject the edge, is there room back to the midline, and where does the idea fail? The design philosophy is simple: a range-edge rejection is only useful when the edge interaction, wick response, close-back-inside behavior, midline room, and failure shelf can be read together. ⚡ Why This Script Is Different Most tools focus on drawing support/resistance zones, marking every range touch, or highlighting breakouts. This script does NOT clone Support Resistance Reaction Map, does not build a multi-level S/R inventory, and does not act as a broad breakout or break-retest scanner. Instead, it focuses on one active range and one active edge. The main output is not a buy/sell signal. It is a planning state that helps users decide whether the edge rejection deserves review, whether midline room exists, and whether failure risk is rising. ⚙️ Methodology 1. Context Detection The script builds an active range from previous bars and identifies whether price is interacting with the upper or lower edge. 2. Reference Mapping It maps the relevant edge zone, the range midline, and an invalidation shelf beyond the rejected edge. 3. Reaction Evaluation The model scores edge proximity, wick rejection, close-back-inside quality, relative volume response, midline room, and active range quality. 4. Visual Output The result appears as a centered range-edge zone, a midline review path, guide lines, compact state labels, alerts, and a premium AGPro panel. 🗺️ How to Read the Chart Zones = the active range-edge zone shows the relevant upper or lower boundary being evaluated. The zone label is centered inside the shape. Midline Path = the projected review area between the rejected edge and the range midline. It helps show whether there is enough room for interpretation. Labels = compact markers show EDGE WATCH, REJECT READY, MIDLINE REVIEW, MIDLINE HIT, or FAILURE RISK context. Colors = teal supports lower-edge rejection context, pink supports upper-edge rejection context, amber highlights review states, and indigo marks midline references. Panel = the panel summarizes Range Edge, Rejection Score, Midline Room, Failure Risk, and Action. 🚦 Signals & States • EDGE WATCH → price is probing a range edge and early rejection conditions are developing. • REJECT READY → range-edge rejection quality reached the selected score threshold. • MIDLINE REVIEW → an active rejection context is being monitored toward the range midline. • MIDLINE HIT → price reached the active range midline after a rejection context. • FAILURE RISK → price crossed the invalidation shelf beyond the rejected edge. • RANGE WAIT → a range exists, but the edge interaction is not strong enough yet. 🔔 Alerts Logic Alerts trigger when the planner enters EDGE WATCH, REJECT READY, MIDLINE REVIEW, MIDLINE HIT, or FAILURE RISK. Each alert is an attention marker. Alerts are not trade instructions, entry commands, exit commands, or automated strategy rules. 🧩 Confluence Logic The strongest context appears when several conditions align: Range edge probe + strong rejection wick + close back inside the range + supportive relative volume + meaningful room back to the midline + a clear invalidation shelf. When these components weaken, the planner can stay in EDGE WATCH, return to RANGE WAIT, or shift into FAILURE RISK. 📊 When to Use • During range-bound markets where edge reactions matter • When price probes the upper or lower boundary of a recent range • When evaluating whether an edge rejection has enough midline room • When a trader wants risk and invalidation context around a range reaction • On liquid symbols where wicks, volume, and range boundaries are readable ⚠️ When NOT to Use • Extremely low-liquidity symbols with unreliable wicks or volume • Very noisy micro-timeframes where range edges shift too often • News-driven volatility spikes that distort normal range behavior • Strong trend expansion where range rejection is no longer the main context • Situations where the user expects automatic buy/sell signals 🎛️ Key Inputs • Range Edge Mode → chooses Auto, Upper Edge Rejection, or Lower Edge Rejection. • Active Range Lookback → controls the previous-bar range used for edge evaluation. • Range Edge Zone ATR → controls the width of the focused edge-reaction zone. • Close-Back-Inside ATR → defines how much price should close back inside after probing an edge. • Invalidation Shelf ATR → controls the failure-risk reference beyond the rejected edge. • REJECT READY Threshold → sets the minimum 0-100 score for the strongest rejection state. • Label and Panel Font Size → controls visual readability. 🖥️ Interface & Visual Design The interface is designed to stay chart-first. The active edge zone gives the main visual reference. The midline path shows the review area. The invalidation shelf defines where the rejection context becomes weaker. The panel provides a compact decision summary without replacing the chart. The AGPro panel follows the standard first row format: one merged blue title row containing only the script name. 🧪 Practical Usage Workflow 1. Read the panel state and Rejection Score. 2. Check which range edge is active. 3. Review the wick rejection and close-back-inside context. 4. Compare the midline room with the invalidation shelf. 5. Treat alerts as attention markers, then evaluate broader market context. 🔍 Interpretation Guidelines Think in terms of rejection quality, not prediction. A stronger score means multiple range-reaction conditions are aligned. A weaker score means the edge interaction may be early, noisy, too close to the midline, or vulnerable to failure. Failure Risk does not forecast a breakout. It means the active rejection context has crossed its rule-based failure shelf and should be reviewed. 🚫 What This Script Is NOT • Not a prediction engine • Not financial advice • Not an auto-trading system • Not a guaranteed signal tool • Not a generic support/resistance map • Not a full range breakout scanner ⚠️ Limitations & Transparency The script is rule-based and depends on recent price, range, wick, volatility, and volume behavior. Timeframe changes can alter the active range, score, edge zone, midline room, and invalidation shelf. Volatility spikes can temporarily distort range boundaries. Symbols with unreliable volume may produce weaker participation readings. Outputs should always be interpreted with broader market structure, liquidity conditions, and independent risk planning. 🧠 Market Context Notes Range-edge rejection is most useful when the market is respecting a bounded structure and still has meaningful space toward the middle of the range. If price starts expanding beyond the edge, this tool intentionally shifts attention from rejection quality toward failure risk instead of calling continuation or reversal with certainty. 🧾 Use Case Examples When price probes above the active range high, prints a strong upper wick, closes back inside, and still has clear room toward the midline, the planner may classify the context as REJECT READY. When price touches the lower edge but closes weakly, lacks wick response, or sits too close to the midline, the planner may remain in EDGE WATCH or RANGE WAIT. When price crosses the invalidation shelf beyond the rejected edge, the planner marks FAILURE RISK for review. 🧱 System Philosophy AGPro planning tools are designed to help traders make a decision, not simply see another signal. This script follows that philosophy by turning range rejection into a practical decision question: Is the edge interaction valid? How strong is the rejection? Where is the midline reference? Where is the failure shelf? What should I review now? 🔐 Non-Promise Statement No script can remove uncertainty. No state, score, label, zone, line, or alert guarantees a future market outcome. 📉 Risk Disclosure Trading involves risk. Market conditions can change quickly, and no script can eliminate 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 range edges behave across different markets and timeframes. The most useful reading comes from comparing the edge zone, wick response, midline room, failure shelf, panel state, and broader market context together.
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
Opening Drive Quality [AGPro Series]Opening Drive Quality 🧠 Core Idea Is the first directional drive of the session strong enough to plan around, or is it already losing execution quality? 📌 Overview / What it does Opening Drive Quality is a session execution planner that evaluates the first directional drive after the market opens. It studies the opening drive channel, early follow-through, pullback acceptance, risk-line integrity, and target-room structure in one clean decision framework. The script produces a 0-100 quality score, a clear next-action state, an opening drive channel, a pullback acceptance zone, an invalidation risk line, target guide, compact chart labels, alerts, and a premium AGPro panel. It does not predict price direction, automate trades, or mark every opening range breakout. Its purpose is to help traders evaluate whether the early session drive has enough structure, acceptance, and risk clarity to deserve attention. 🎯 Purpose & Design Philosophy The script was built for traders who need more than an opening range box or a simple breakout marker. The first session move often sets the tone, but the useful question is not only whether price moved. The useful question is whether that move produced clean follow-through, controllable risk, and a meaningful pullback area. Opening Drive Quality fills that gap by turning the opening move into a structured planning map. It supports traders who study session execution, intraday momentum, and pullback planning without relying on generic signals. The design philosophy is simple: evaluate the quality of the first drive, define the risk line, project the pullback acceptance zone, and make the next state readable at a glance. ⚡ Why This Script Is Different Most tools focus on opening range breakouts, session boxes, fixed kill zones, or failed-break signals. This script does NOT try to clone a generic ORB tool, a kill-zone session engine, or an opening range failure map. Instead, it focuses on the quality of the first directional drive itself. It asks whether the drive has real thrust, whether follow-through appears after the drive locks, whether price accepts a pullback zone, where the risk line sits, and what the next planning state should be. ⚙️ Methodology 1. Context Detection The script builds the opening drive from either a fixed session window or the first bars of a new day. This keeps the tool useful across regular-market assets and 24/7 markets. 2. Reference Mapping After the drive locks, the script maps the opening drive channel, pullback acceptance zone, invalidation risk line, and target-room guide. These references come from the opening drive structure, not from generic support and resistance pivots. 3. Reaction Evaluation The engine scores drive thrust, close location, range expansion, optional relative volume, follow-through distance, pullback behavior, and risk-line integrity. 4. Visual Output The chart shows the active drive channel, projected pullback zone, risk line, target guide, state labels, and a compact panel with the key planning reads. 🗺️ How to Read the Chart Opening Drive Channel = the locked first directional drive of the session. Pullback Acceptance Zone = the area where a controlled pullback can be evaluated after a valid drive. Risk Line = the invalidation line derived from the drive base, pullback zone, and ATR buffer. Target Guide = a projected target-room reference based on the opening drive range. Labels = compact markers for drive lock, follow-through, pullback acceptance, weak drive, risk break, and target check. Colors = teal for bullish drive context, pink for bearish drive context, amber for review states, and indigo for structural emphasis. Panel = the decision layer showing Drive Side, Follow-Through, Pullback Quality, Risk Line, and Action. 🚦 Signals & States • DRIVE Q → the opening drive has locked and received a 0-100 quality score. • FOLLOW Q → the drive has produced directional follow-through after locking. • PULLBACK ACCEPTED → price is reacting constructively inside the projected pullback acceptance zone. • WEAK DRIVE → follow-through has not developed inside the review window. • RISK BROKEN → the active drive has violated its invalidation line. • TARGET CHECK → price has reached the projected target-room guide. 🔔 Alerts Logic The script includes alerts for: • Opening Drive Quality Locked → a qualified opening drive has completed. • Drive Follow-Through → directional extension appears after the drive locks. • Pullback Accepted → price reacts inside the projected pullback acceptance zone. • Risk Line Broken → price violates the active drive risk line. • Target Guide Reached → price reaches the projected target-room guide. Alerts are attention markers. They are not trade instructions. 🧩 Confluence Logic The context becomes stronger when opening drive thrust, close location, session volatility, relative volume, follow-through, and pullback acceptance align. The context becomes weaker when the opening drive locks with poor thrust, cannot extend, pulls back too deeply, or breaks the risk line. 📊 When to Use • Intraday session planning. • Opening-drive analysis after the first market push. • Markets where the opening session often defines early direction. • Pullback planning after a strong first drive. • Session review where risk line and target-room context matter. ⚠️ When NOT to Use • Very low-liquidity markets. • Extremely noisy opens with unstable spreads. • News-driven bars where the first drive is unusually distorted. • Assets where the selected opening session is not meaningful. • Higher timeframes where the opening drive window has no practical session context. 🎛️ Key Inputs • Opening Drive Mode → chooses first bars of day or a fixed session window. First Bars Of Day is the default so the chart loads with visible drive structure across more symbols. • Opening Drive Session → defines the drive-building window. • Tracking Session → defines when follow-through and pullback logic remains active. • Minimum Quality Threshold → controls when stronger planning labels appear. • Follow-Through ATR → defines the extension needed for follow-through confirmation. • Pullback Acceptance Depth → controls the projected pullback zone depth. • Risk Line Buffer ATR → adjusts the invalidation line beyond the drive structure. • Target Guide Multiple → controls the projected target-room guide. • Panel / Label Settings → control panel location, theme, font size, label size, visible label count, minimum label quality, label cooldown, and optional compact plot markers. 🖥️ Interface & Visual Design The interface is built around a clean AGPro panel and chart-first planning visuals. The panel uses a single merged blue header row with only the script name, then five practical rows: Drive Side, Follow-Through, Pullback Quality, Risk Line, and Action. The chart uses one opening drive channel, one pullback acceptance zone, one risk line, one target guide, and compact labels. The goal is a premium session-planning view without clutter. 🧪 Practical Usage Workflow 1. Read the panel after the opening drive locks. 2. Check whether the drive side and score show a valid planning context. 3. Watch follow-through quality after the drive locks. 4. Evaluate whether price pulls back into the acceptance zone constructively. 5. Use the risk line and target guide as planning references, not automatic decisions. 🔍 Interpretation Guidelines A strong score means the opening drive has better structure, cleaner close location, stronger volatility context, and better follow-through support. A pullback acceptance label means price is reacting inside the projected drive-based zone. It does not mean price must continue. A risk-line break means the original drive plan has lost structural integrity and should be reassessed. The most useful interpretation comes from combining the panel state with broader market context, liquidity, and timeframe alignment. 🚫 What This Script Is NOT • Not a prediction engine. • Not financial advice. • Not an auto-trading system. • Not guaranteed signals. • Not a generic support and resistance mapper. • Not a clone of an ORB breakout tool. • Not a kill-zone timing dashboard. • Not an opening range failure scanner. ⚠️ Limitations & Transparency Timeframe selection affects the opening drive shape. A 5-minute chart and a 15-minute chart can produce different drive channels. Volatility changes can expand or compress the pullback zone and risk line. Session definitions matter. The selected opening window should match the asset being studied. High-impact news, abnormal spreads, and low liquidity can reduce the reliability of the opening drive map. 🧠 Market Context Notes Opening drives are most useful when liquidity is active and the first session push creates a clear directional reference. A clean drive does not guarantee continuation, but it can create a structured area for evaluating pullback acceptance and invalidation. The script intentionally keeps its references tied to the opening drive. It avoids pivot maps, order block language, broad S/R zones, and generic failed-break logic. 🧾 Use Case Examples When price locks a strong bullish opening drive, extends beyond the channel, and then pulls back into the acceptance zone without breaking the risk line, the panel may shift toward a constructive planning state. When price locks a drive but cannot create follow-through inside the review window, the script can mark the drive as weak and shift the action state toward bias reduction. When price violates the risk line, the original opening drive plan is no longer structurally intact inside this model. 🧱 System Philosophy Opening Drive Quality follows the AGPro decision-engine philosophy: a script should help the trader evaluate validity, strength, risk, target room, and next state instead of only printing another signal. The tool is designed to make the opening session easier to interpret through structured references and clean visual hierarchy. 🔐 Non-Promise Statement No script can provide certainty. No opening drive model can guarantee continuation, reversal, or profitability. This script provides structured context only. 📉 Risk Disclosure Trading involves risk. Users are responsible for their own decisions. This script does not provide financial advice, investment advice, or guaranteed trading outcomes. 📚 Educational Note Use this script as an educational planning and visualization tool. The strongest use comes from reading the opening drive together with broader market structure, liquidity, volatility, and personal risk rules.
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
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
Compression Breakout Readiness [AGPro Series]Compression Breakout Readiness 🧠 Core Idea Is compression mature enough for a breakout watch state, or is the range still early, noisy, or structurally weak? 📌 Overview / What it does Compression Breakout Readiness is a chart-first breakout planning tool designed to evaluate whether a compressed range has developed enough maturity to deserve active attention. Instead of printing a generic breakout signal, the script studies range contraction, ATR compression, pivot tightening, volume dry-up, directional side bias, invalidation-edge distance, and projected breakout room. These components are converted into a 0-100 Readiness Score and a clear next-action state. The script produces an active compression box, breakout watch corridor, invalidation edge, target guide, compact state labels, alerts, and a clean AGPro planning panel. It does not predict direction, automate execution, or guarantee that a breakout will follow through. 🎯 Purpose & Design Philosophy This script was built for traders who want to evaluate the quality of compression before reacting to a breakout attempt. Many breakout tools only mark the moment price crosses a level. The more useful planning question often comes earlier: is the range actually tight, mature, quiet, and biased enough to watch, or is the structure still too loose? The design supports a decision-first workflow: identify compression, measure readiness, check risk edge, review the watch side, then decide whether the chart deserves attention. ⚡ Why This Script Is Different Most tools focus on squeeze dots, breakout arrows, generic consolidation boxes, or simple high/low range breaks. This script does NOT act as a generic squeeze indicator, a choppiness filter, a support/resistance mapper, or a direct buy/sell signal generator. Instead, it evaluates compression maturity before and around the breakout edge. The main output is not a trade command. It is a readiness state that helps the user separate READY WATCH conditions from early, neutral, overheated, or invalidated compression contexts. ⚙️ Methodology 1. Context Detection The script maps the active compression range and evaluates whether current volatility and range width are contracting relative to their baselines. 2. Reference Mapping It builds the compression box, active breakout watch corridor, invalidation edge, and target guide from the current structure. 3. Reaction Evaluation The model scores range contraction, ATR compression, pivot tightening, volume dry-up, side bias, and compression age. It also checks whether the invalidation edge is too tight, too wide, or balanced. 4. Visual Output The result is shown through centered zone text, compact chart labels, clean edge lines, deterministic alerts, and a premium AGPro panel. 🗺️ How to Read the Chart Compression Box = the active range being evaluated for breakout readiness. Breakout Watch Corridor = the planning area beyond the active compression edge. Invalidation Edge = the opposite-side reference used to judge risk context. Labels = compact state markers such as READY WATCH, WATCH, EDGE REVIEW, PREMATURE, HOT RISK, and INVALID EDGE. Colors = teal for bullish watch context, pink for bearish or invalid context, amber for caution, and indigo for watch/neutral emphasis. Panel = the panel summarizes Compression Age, Readiness Score, Expansion Side, Risk Edge, and Action. 🚦 Signals & States • READY WATCH → compression is mature, biased, and risk edge distance is balanced enough for active review. • WATCH → compression is developing, but at least one readiness component remains incomplete. • EDGE REVIEW → price has moved beyond the compression edge and the user should verify the close and broader context. • PREMATURE → compression has not lasted long enough to build strong maturity. • HOT RISK → volatility has expanded too aggressively for clean readiness interpretation. • NO BIAS → compression exists, but the directional side is not clear enough in Auto mode. • INVALID EDGE → price crossed the active invalidation edge and the prior context may need reset. 🔔 Alerts Logic Alerts trigger when the planner enters READY WATCH, WATCH, EDGE REVIEW, HOT RISK, or INVALID EDGE state. These alerts are attention markers. They are not trade instructions, entry signals, broker actions, or automated strategy commands. 🧩 Confluence Logic The strongest readiness state appears when multiple components align: Range contraction + ATR compression + pivot tightening + volume dry-up + directional side bias + balanced risk edge. When those components improve together, the score can rise toward READY WATCH. If volatility becomes too hot, risk becomes distorted, or the active edge fails, the state downgrades. 📊 When to Use • Before evaluating a possible breakout setup • During narrow ranges where volatility is compressing • Around coiling structures that need maturity review • When comparing whether one compression range is cleaner than another • On liquid symbols where range, ATR, and volume behavior are meaningful ⚠️ When NOT to Use • Extremely low-liquidity markets • Highly noisy micro-timeframes • News-driven volatility spikes • Symbols with unreliable or missing volume data • Situations where the user wants a simple breakout arrow or automated trade signal 🎛️ Key Inputs • Breakout Watch Side → selects Auto, Bullish Watch, or Bearish Watch evaluation. • Compression Lookback → defines the active range used for readiness scoring. • ATR Baseline → controls volatility compression comparison. • Volume Dry-Up Length → evaluates whether participation is contracting inside compression. • Minimum Compression Age → controls how mature a range must be before stronger readiness states appear. • READY / WATCH Thresholds → adjust how selective the planner is. • Visual settings → control compression box, breakout corridor, range edges, invalidation edge, projection length, labels, and candle tint. • Panel settings → control panel visibility, location, theme, and font size. 🖥️ Interface & Visual Design The interface is intentionally chart-first. The compression box uses centered text so the user can read score and age directly inside the structure. The breakout corridor provides a clean forward planning reference without filling the chart with many competing levels. The AGPro panel uses a single merged blue header row and a compact five-row decision layout. Label and panel font sizes are adjustable, with Normal as the default. 🧪 Practical Usage Workflow 1. Read the panel Readiness Score and Action. 2. Check whether the compression box is mature or premature. 3. Review the Expansion Side and breakout watch corridor. 4. Compare the Risk Edge with the visible structure. 5. Treat labels and alerts as review prompts, not trade commands. 🔍 Interpretation Guidelines A higher score means the script sees stronger compression maturity according to its rule set. READY WATCH does not mean price must break out. It means the compression context is organized enough to deserve attention. WATCH means the structure may be developing but is not fully mature. HOT RISK and INVALID EDGE are caution states. They warn that the range may no longer be clean enough for the same readiness read. 🚫 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 is not a generic squeeze indicator. It is not a choppiness dashboard. It is not a support/resistance scanner. It is not a direct breakout entry tool. ⚠️ Limitations & Transparency Compression quality depends on the selected lookback, timeframe, volatility baseline, and market condition. Volume dry-up may be less reliable on symbols with inconsistent exchange volume. Fast volatility expansion can quickly change the readiness state. Different timeframes can show different compression ranges and side-bias context. The script is rule-based and should be interpreted as an analytical planning layer, not as certainty. 🧠 Market Context Notes Compression by itself is not enough. A useful breakout watch context also needs maturity, reduced noise, a readable side, and a practical invalidation edge. This script keeps those elements visible so users can review breakout readiness before reacting emotionally to a candle crossing a range edge. 🧾 Use Case Examples When a range contracts, ATR falls below baseline, volume dries up, and side bias becomes clear, the planner may move toward WATCH or READY WATCH. When price pushes beyond the edge while readiness is acceptable, the script can mark EDGE REVIEW so the user can verify the close and broader context. When ATR expands too aggressively before structure is mature, the planner can show HOT RISK instead of treating every move as a clean breakout context. 🧱 System Philosophy Compression Breakout Readiness follows the AGPro Series decision-engine approach: Context first. Readiness before reaction. Risk edge before target guide. Attention markers instead of promises. 🔐 Non-Promise Statement No script can remove uncertainty. No state, score, label, alert, box, corridor, or line 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 the script to study how compression matures, weakens, breaks, or invalidates around range edges. The strongest reading comes from combining the panel state with the visible chart structure and broader market context.
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
Pre-Breakout Pressure Planner [AGPro Series]Pre-Breakout Pressure Planner 🧠 Core Idea Is pressure building before a breakout, or is the setup still premature? 📌 Overview / What it does Pre-Breakout Pressure Planner is a chart-first breakout readiness tool designed to evaluate pressure before price leaves a range. The script maps an active pressure box, upper and lower trigger corridors, directional buildup side, volume support, fakeout-risk context, invalidation reference, and target-room projection. These factors are converted into a 0-100 Pressure Score with a clear next-action state such as Bull Pressure, Bear Pressure, Coil Watch, Premature, Fakeout Risk, or Trigger Review. It does not predict breakouts, automate entries, or confirm post-breakout acceptance. It is built to help traders organize the pre-breakout decision process before reacting to price movement. 🎯 Purpose & Design Philosophy This script was built for traders who want to evaluate whether a breakout setup is becoming valid before the breakout actually happens. Many traders notice a range only after price has already moved. This tool focuses on the earlier planning phase: Is the range compressed? Is one side applying pressure? Is volume supportive? Is the candle behavior constructive? Is there fakeout risk near the boundary? The design supports a planning mindset. It helps the user read pressure quality, risk location, target room, and next-action context without turning the chart into a generic signal board. ⚡ Why This Script Is Different Most breakout tools focus on the moment price breaks a level. This script does NOT focus on post-breakout confirmation, measured move corridors, generic support/resistance boxes, or simple buy/sell labels. Instead, it evaluates the setup before the break. The core question is whether pressure is building in a structured way or whether the range is still too early, too wide, too weak, or vulnerable to a fakeout. This keeps the concept separate from consolidation breakout tools. The purpose is not to grade a completed breakout. The purpose is to organize the pre-breakout readiness window. ⚙️ Methodology 1. Context Detection The script builds a live pressure range from prior bars and evaluates whether price remains inside the active box, probes a boundary, or enters a trigger corridor. 2. Reference Mapping It maps the pressure box, upper trigger corridor, lower trigger corridor, active-side invalidation reference, and projected target-room reference. 3. Reaction Evaluation The model scores range compression, higher-lows or lower-highs buildup, relative volume behavior, candle pressure, and close location inside the box. 4. Visual Output The script displays the active pressure box, centered status label, trigger corridors, optional risk/target guides, compact event labels, alerts, and a premium AGPro panel. 🗺️ How to Read the Chart Pressure Box = the active range where pre-breakout pressure is being evaluated. Trigger Corridors = narrow upper and lower zones where breakout review becomes relevant. Risk / Target Guides = active-side invalidation and target-room references used for planning context. Labels = compact state markers showing pressure, watch, fakeout risk, or trigger-review context. Colors = teal supports bullish buildup, pink supports bearish buildup, amber marks neutral or developing pressure, and red marks elevated fakeout risk. Panel = summarizes Pressure Score, Buildup Side, Volume Support, Fakeout Risk, Risk / Target, and Action. 🚦 Signals & States • Bull Pressure → bullish buildup is forming inside the pressure box near the upper trigger context. • Bear Pressure → bearish buildup is forming inside the pressure box near the lower trigger context. • Coil Watch → compression or pressure exists, but the directional side is not clear enough yet. • Premature → the setup does not yet meet the pressure score or structural requirements. • Fakeout Risk → a boundary probe appears with weak support, poor candle pressure, or elevated rejection risk. • Trigger Review → price has entered or crossed a trigger corridor and deserves context review. 🔔 Alerts Logic Alerts can trigger when bullish pressure appears, bearish pressure appears, fakeout risk appears, or price enters trigger-review context. Each alert is an attention marker. Alerts are not trade instructions, entry commands, exit commands, or automated strategy rules. 🧩 Confluence Logic The strongest pressure read appears when multiple conditions align: Range compression + directional buildup + supportive relative volume + constructive candle pressure + close location near the active trigger side. When these conditions weaken, the planner can shift toward Coil Watch, Premature, or Fakeout Risk. 📊 When to Use • Before evaluating a potential range breakout. • During tight ranges where pressure may be building on one side. • Around breakout watchlists where fakeout risk needs context. • During volatility compression before expansion attempts. • On liquid symbols where ATR, range boundaries, and relative volume are meaningful. ⚠️ When NOT to Use • Extremely low-liquidity symbols with unreliable candles or volume. • Very noisy micro-timeframes where range boundaries change too often. • News-driven volatility spikes where pre-breakout pressure can distort quickly. • Markets where the recent range is too wide to represent meaningful compression. • As a standalone reason to enter or exit a trade. 🎛️ Key Inputs • Pressure Range Lookback → controls the prior range used to build the active pressure box. • Buildup Slope Lookback → controls how the script measures rising lows or falling highs. • Sensitivity → changes how strict the compression model is. • Minimum Pressure Score → sets the score needed for Bull Pressure or Bear Pressure states. • Volume Support Level → defines constructive relative volume before breakout. • Trigger Corridor ATR Width → controls the size of the upper and lower trigger corridors. • Invalidation Buffer ATR → controls the active-side invalidation reference. • Target Room Multiple → projects target-room context from the pressure range height. • Visual settings → control boxes, guides, labels, panel visibility, panel location, theme, and font sizes. 🖥️ Interface & Visual Design The interface is designed to be chart-first. The main visual object is the active pressure box with a centered status label. Trigger corridors are narrow and controlled so the chart does not become a generic zone map. Event labels are compact, offset away from candles, and limited by cooldown and maximum-visible settings. The AGPro panel follows the standard publication layout with a single merged blue title row, adjustable panel location, adjustable theme, and adjustable font size. 🧪 Practical Usage Workflow 1. Read the panel Pressure Score and Action. 2. Check whether the pressure box is tight or still too wide. 3. Review the Buildup Side and Volume Support rows. 4. Check whether Fakeout Risk is Low, Moderate, or Elevated. 5. Compare the active trigger corridor with invalidation and target-room context. 6. Treat labels and alerts as attention markers inside broader analysis. 🔍 Interpretation Guidelines A high Pressure Score means the pre-breakout setup is more organized according to the script's rule set. It does not mean price must break out. Bull Pressure and Bear Pressure describe directional buildup, not guaranteed direction. Fakeout Risk means the boundary behavior deserves caution and context review. It does not mean a breakout cannot continue later. Trigger Review means price is interacting with a corridor. It is a review state, not a command. 🚫 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 a post-breakout confirmation engine. • Not a generic support/resistance zone map. • Not an order-block, FVG, or supply/demand scanner. ⚠️ Limitations & Transparency The script depends on selected lookback values, ATR normalization, relative volume behavior, and current timeframe. Different symbols may compress differently. Some markets can show pressure for a long time before expansion. Others may probe a boundary and return inside the range several times. The model is rule-based. Outputs should always be interpreted with broader structure, volatility, liquidity, and trader-defined risk controls. 🧠 Market Context Notes Pre-breakout pressure is useful because the quality of a range can change before the breakout candle appears. Rising lows can show pressure toward the upper boundary. Falling highs can show pressure toward the lower boundary. Volume support and candle pressure help judge whether that buildup is constructive or weak. The script organizes these factors into a clean planner view so the user can decide whether the setup deserves attention, patience, or caution. 🧾 Use Case Examples When price remains inside a tight range and the panel shifts to Bull Pressure with supported volume, the upper trigger corridor becomes the main review area. When price presses into a boundary but the panel shows Elevated Fakeout Risk, the user can recognize that the probe may be weak or vulnerable to rejection. When the score stays low and the state remains Premature, the range may need more time before it deserves attention. 🧱 System Philosophy Pre-Breakout Pressure Planner follows the AGPro decision-engine approach: a script should help traders evaluate setup quality, risk, target room, and next action without promising an outcome. The goal is not to add another signal. The goal is to improve the quality of the planning process before the chart forces a decision. 🔐 Non-Promise Statement No script can guarantee direction, continuation, breakout success, or outcome. This tool provides structured pre-breakout 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 pressure builds inside ranges before breakout attempts. The strongest learning value comes from comparing the panel state, pressure box, trigger corridors, and fakeout-risk labels with the broader chart context.
Indicador Pine Script®
por AGProLabs
Choppiness Setup Planner [AGPro Series]Choppiness Setup Planner 🧠 Core Idea Is this choppy market still a no-trade environment, or has it matured into a valid setup with defined risk, invalidation, and targets? 📌 Overview / What it does Choppiness Setup Planner is a planner-style overlay built for one of the most common decision problems in technical analysis: what should a trader do when price is trapped inside a choppy range, but pressure starts building near the edge? The script detects no-trade chop conditions, builds a decision range around the active structure, scores setup quality from 0 to 100, and turns a mature range release into a clear planning map with invalidation and target levels. Instead of only saying "the market is choppy," it answers whether the setup is still avoidable, preparing, weak, valid, active, or invalidated. The cleanest visual use case is higher-timeframe planning. Weekly and daily charts allow the full range-to-plan lifecycle to breathe: no-trade structure, preparation, release, target, and invalidation can all be read without the chart feeling crowded. It does not automate execution, predict future price, or replace personal trade selection. It is an analytical planner designed to organize context, risk, and next-action state directly on the chart. 🎯 Purpose & Design Philosophy This script was built because many market-state tools show information without helping the user make a decision. A Choppiness Index value, ADX filter, or range box can be useful, but those outputs often stop before the practical question: what now? Choppiness Setup Planner fills that gap by connecting chop detection with a structured planning workflow. It is intended for discretionary traders, breakout traders, and range-to-expansion traders who want to avoid low-quality noise while preparing for stronger releases from mature ranges. The design philosophy is simple: first protect attention, then qualify the setup, then map risk only when the structure deserves it. ⚡ Why This Script Is Different Most tools focus on detecting chop, drawing a box, or marking a breakout. This script does NOT act like a generic signal indicator, generic support/resistance tool, or simple Choppiness Index panel. Instead, it turns a choppy market into a decision sequence: 1. Detect the no-trade environment. 2. Track range age and pressure. 3. Grade setup validity with a 0-100 score. 4. Define the next action state. 5. Map invalidation and targets only after a valid release. That makes the script closer to a decision engine than a visual marker. It is also intentionally separated from manual position planners: users do not enter their own position parameters. The script derives its planning levels from the detected chop range and the release quality model. ⚙️ Methodology 1. Context Detection The engine blends Choppiness Index, directional weakness, path efficiency, range tightness, wick noise, and volatility behavior to determine whether the market is inefficient enough to qualify as a no-trade chop environment. 2. Reference Mapping When chop persists long enough, the script builds a decision range around the active structure. This range is not a generic support/resistance zone; it is a planning container for the current no-trade condition. 3. Reaction Evaluation The script evaluates whether pressure is improving through range age, chop release, ADX lift, path-efficiency improvement, ATR lift, edge pressure, candle body quality, close quality, and optional volume participation. 4. Visual Output The chart displays the no-trade ribbon, decision range box, centered zone label, preparation markers, valid plan markers, weak-release markers, invalidation level, target levels, and a compact AGPro planner panel. 🗺️ How to Read the Chart Zones represent the active no-trade decision range. A centered label inside the box shows whether the structure is still a no-trade zone or has moved into preparation mode. Labels represent state changes. PREP marks a mature range with improving setup quality. PLAN UP and PLAN DN mark valid releases. SKIP marks a release that happened but failed the minimum plan-quality threshold. T1, T2, and INVALID track the active plan lifecycle. Colors follow the AGPro state palette. Teal is used for stronger upside planning states, pink for downside or invalidation states, amber for caution and no-trade states, and indigo for preparation/readiness. The panel shows Setup Quality, Next Action, Chop / Ready, Range Age, Invalidation, and Targets. 🚦 Signals & States • Avoid: Chop → the market is inefficient and still belongs in no-trade mode. • Prepare: Edge Watch → the range has matured and internal readiness is improving. • Skip: Low Quality → price released from the range, but the quality score was not strong enough. • Track Upside Plan → upside release met the minimum valid plan score. • Track Downside Plan → downside release met the minimum valid plan score. • Manage: T1 Reached → the active plan reached its first target level. • Review: T2 Reached → the active plan reached its second target level. • Reset: Invalidated → the active plan crossed its invalidation level. 🔔 Alerts Logic Alerts are available for preparation state, valid upside plan, valid downside plan, weak release, Target 1 reached, Target 2 reached, and invalidation. Each alert is an attention marker. Alerts are not trade instructions, not automation rules, and not execution commands. 🧩 Confluence Logic The setup becomes stronger when a mature chop range aligns with improving readiness, edge pressure, candle body participation, release distance, and optional volume participation. When these components align, the script can convert the release into a valid plan. When price releases without enough score, the script marks the event as SKIP instead of treating every breakout as useful. 📊 When to Use • Choppy markets where the user needs a no-trade filter. • Weekly, daily, and 4H planning where range structure matters more than micro-noise. • Mature ranges that may be preparing for expansion. • Breakout-preparation workflows. • Range-to-trend transition monitoring. • Symbols where invalidation and target structure should be visible before acting. ⚠️ When NOT to Use • Extremely illiquid markets with unreliable candles. • Symbols where volume data is misleading, unless volume participation is disabled. • News-driven spikes where a single candle can distort range logic. • Very low timeframes with excessive spread noise. • Scalping workflows that require rapid-fire signals instead of structural planning. • Markets where the user has no broader context for trend, liquidity, or session behavior. 🎛️ Key Inputs • Choppiness Length → controls the chop-detection backbone. • Decision Range Length → controls how the active no-trade range is framed. • Minimum Range Age → controls how long chop must persist before planning begins. • Preparation Threshold → controls when the range moves from avoid mode to preparation mode. • Minimum Valid Plan Score → controls how selective valid plan labels should be. • Release Buffer ATR → controls how far price must move beyond the range boundary. • Invalidation Buffer ATR → controls the distance behind the released boundary used for invalidation. • Target 1 / Target 2 R Multiples → control target projection from the plan risk. • Panel Location / Theme / Font Size → control the AGPro panel interface. • Label Font Size / Cooldown / Maximum Visible Labels → control chart readability. 🖥️ Interface & Visual Design The interface is designed around fast decision reading. The chart carries the range box, no-trade ribbon, centered zone label, event labels, and active risk/target levels. The panel summarizes the same workflow without becoming a large dashboard. The first panel row follows the AGPro standard: one merged blue header row containing only the script name. Visual density is intentionally moderate. The chart should not look empty, but it should also avoid crowded signal spam. 🧪 Practical Usage Workflow 1. Read the panel. Check Setup Quality and Next Action first. 2. Check the decision range. If the box says NO-TRADE, the structure is still inefficient. If it says PREP, the range is maturing. 3. Evaluate the release. A valid PLAN label means the release met the quality threshold. A SKIP label means the release was not strong enough. 4. Review invalidation and targets. When a plan is active, use the plotted levels to understand structure, not as automatic orders. 5. Confirm broader context. Combine the planner output with trend, liquidity, timeframe, session, and personal execution rules. For publication screenshots, higher-timeframe examples are usually the cleanest because they show the complete planning sequence without compressing labels and boxes into a noisy layout. 🔍 Interpretation Guidelines Think in states, not isolated signals. NO-TRADE protects attention. PREP means the market is becoming more interesting. PLAN means the release has enough structure to track. SKIP means the release happened but did not earn quality. INVALID means the plan lost its structural premise. 🚫 What This Script Is NOT This script is not a prediction engine. It is not financial advice. It is not auto trading. It is not guaranteed signals. It is not a strategy tester. It is not a replacement for independent analysis. ⚠️ Limitations & Transparency The script is rule-based and depends on selected inputs, timeframe, volatility, and available market data. Different symbols and sessions can produce different behavior. Low liquidity, sudden volatility shocks, and abnormal gaps can reduce the usefulness of range-based planning. Volume participation is optional because volume quality differs across markets and feeds. 🧠 Market Context Notes Chop is not always weakness. Sometimes it is absorption, sometimes indecision, and sometimes simple noise. The script does not claim to know the cause. It organizes the observable structure so the user can decide whether the environment is worth attention. 🧾 Use Case Examples When price spends several bars inside a tight inefficient range and the panel says Avoid: Chop, the script is acting as a no-trade filter. When the range matures and the centered label changes to PREP, the script is showing that pressure has improved enough to monitor the edge. When price releases and receives PLAN UP or PLAN DN, the script maps invalidation and targets from the structure. When price releases but receives SKIP, the script is saying the event did not meet the model's quality threshold. On weekly charts, a single valid plan can show the entire decision chain: range maturity, preparation, release, target reaction, and invalidation. This is the strongest showcase environment for the script. 🧱 System Philosophy AGPro tools are built around structured decision support: define the condition, score the quality, map the relevant structure, and keep the chart readable. Choppiness Setup Planner follows that philosophy by turning a noisy no-trade environment into a cleaner decision workflow. 🔐 Non-Promise Statement No script can provide certainty. No score guarantees follow-through. No label guarantees an outcome. 📉 Risk Disclosure Trading involves risk. Market conditions can change quickly, planned setups can fail, and losses can occur. This script is provided for educational and analytical use only. It does not provide financial advice or guaranteed trading outcomes. Users remain responsible for their own analysis, decisions, risk management, and execution. 📚 Educational Note Use this script to study how choppy markets mature, how range releases differ in quality, and how invalidation and target logic can be organized visually before a decision is made.
Indicador Pine Script®
por AGProLabs
Measured Move Projection Zones [AGPro Series]Measured Move Projection Zones 🔹 OVERVIEW Measured Move Projection Zones is a premium price-action visualization tool built around one clear sequence: impulse, base, projection, and invalidation. The script detects a qualified impulse leg, waits for a compact base range, then projects a measured-move target band from the base boundary. It also displays invalidation context, event labels, and a compact AGPro panel so the structure can be reviewed quickly on the chart. The default profile is tuned for 1-hour charts, where measured-move structures need enough responsiveness to appear consistently while still avoiding low-quality micro-swings. The result is a clean projection map for traders who want structured continuation context without turning the chart into a dense extension grid. This script is not designed to promise outcomes or mark every possible target. It is designed to make the measured-move workflow easier to see, compare, and audit. 🔹 WHAT MAKES IT DIFFERENT Most projection tools start from a manual anchor, a generic extension grid, or a simple breakout distance. Measured Move Projection Zones is more selective. It requires a directional impulse first. It then waits for a compact base. Only after the base qualifies does it create the projected target band and invalidation framework. That sequence matters because it prevents the chart from becoming a collection of random forward boxes. The visual logic is always tied to a specific price-action chain: Impulse leg -> base range -> projection band -> invalidation context. The script also avoids the look of a traditional support/resistance map. The rectangles are not generic zones. They represent measured-move components: impulse body, base range, projected target band, and invalidation reference. For public TradingView presentation, the script is deliberately visual but controlled: moderated labels, visible structure boxes, no expired-label flood, and a compact panel that summarizes the current state. 🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS This script stays in a narrow measured-move projection lane. It does not overlap with ATR compression or volatility-map scripts because the core logic is not volatility contraction, expansion, or envelope behavior. ATR is only used for normalization, tolerance, and spacing. It does not overlap with breakout-quality tools because it does not score a breakout event as the main product. Breakout beyond the base boundary only changes the measured-move state from armed to active. It does not overlap with premium/discount or valuation-zone tools because it does not map equilibrium, discount, OTE, rebalance pockets, or fair value areas. Its target band is derived from an impulse leg and base boundary, not a valuation model. It does not overlap with wedge, reversal, or pattern-scanner tools because it does not require converging rails, neckline behavior, double tops, double bottoms, head-and-shoulders logic, or multi-pattern classification. It does not overlap with liquidity heatmap, bias dashboard, or volume-profile tools because it does not estimate liquidity fields, higher-timeframe directional bias, POC gravity, acceptance ladders, or volume shelves. The differentiator is simple and specific: this is an impulse-base measured-move projection visualizer with target-band and invalidation context. ⚙️ METHODOLOGY The methodology is built in stages: 1. Swing Confirmation The script uses pivot confirmation to identify meaningful swing points. The default pivot setting is tuned for 1-hour chart rhythm. 2. Impulse Qualification After a valid pivot sequence appears, the script measures the leg size in ATR units. The impulse must be large enough and must form within a reasonable bar window. 3. Base Validation Once the impulse is confirmed, the script waits for a compact base range. The base must stay within a defined ATR height and avoid excessive retracement from the impulse end. 4. Projection Construction When the base qualifies, the script projects a measured-move target band from the base boundary. The default multiplier is 1.00, representing a classic equal measured move. 5. Invalidation Context The opposite side of the base receives an ATR-buffered invalidation guide. This does not create a trade command; it simply marks where the measured-move structure is no longer clean. 6. State Tracking The setup moves through clear states: Waiting, Building Base, Armed, Projecting, Target Band, Invalidated, and Expired. 7. Visual Management The script keeps a moderated amount of historical structure visible. Event labels are capped, expired labels are disabled by default, and the projection guide line is optional to keep the chart clean. 📊 PANEL The AGPro panel is designed for quick structure review. Panel rows include: - State - Direction - Impulse Quality - Projection Progress - Target Distance - Target Band - Base Range - Invalidation The first panel row follows the AGPro public-release standard: one merged blue header row containing only the panel title. Panel location is adjustable. Panel theme is adjustable. Panel font size is adjustable. The default size is Normal for a clean public-chart look. 🎛️ KEY INPUTS 1H Pivot Confirmation Length Controls the swing confirmation used to anchor impulse legs. Lower values are more responsive. Higher values are more selective. 1H Minimum Impulse Size Defines the minimum impulse strength in ATR units. The default is tuned to keep 1-hour charts active without accepting very small swings. 1H Base Range Bars Controls how many bars are used to validate the post-impulse base. The default is shorter for hourly chart pacing. 1H Maximum Base Height Limits how tall the base can be in ATR terms. This prevents wide ranges from being treated as clean measured-move bases. 1H Maximum Base Retracement Controls how deeply price can retrace from the impulse end while still qualifying as a measured-move structure. Measured Move Multiplier Controls the projection distance. The default value of 1.00 represents an equal measured move. 1H Target Band Width Controls the ATR-based visual tolerance around the projected target. Invalidation Buffer Places the invalidation guide beyond the opposite side of the base range. 1H Projection Bars Controls how far the projected target band and base extension reach forward. 1H Projection Expiration Controls how long an armed or active projection can remain open before it expires. 1H Event Label Retention Controls whether the chart keeps a moderated history of event labels or only the latest event label. 1H Balanced Event Labels Caps event labels so the chart remains informative but not overloaded. Show Projection Guide Line Optional dotted guide from the base boundary to the target band. Disabled by default on 1-hour charts to reduce diagonal clutter. 🔍 HOW TO READ IT Waiting No valid impulse-base sequence is active. Building Base An impulse has been detected and the script is watching for a compact base. Armed A valid base has formed. The projection framework is ready, and the target band is mapped forward. Projecting Price has moved beyond the base boundary and the measured-move structure is active. Target Band Price has interacted with the projected target band. Invalidated Price has closed beyond the invalidation guide, meaning the measured-move framework is no longer clean. Expired The projection did not complete within the selected expiration window. Event labels provide a fast visual timeline. The boxes show where the measured structure came from, where the base formed, and where the projected band sits. 🧩 BEST USE CASES This script is best used on 1-hour charts where traders want a clean view of impulse-base-continuation behavior. Strong use cases include: - Measuring continuation structures after a directional leg - Comparing active projections against nearby price action - Reviewing whether a base is compact enough to support a projection - Mapping projected target zones without using a full extension grid - Studying failed measured moves through invalidation labels and zones - Creating cleaner screenshots for price-action review The script can also be used on other timeframes, but the default settings were intentionally tuned around 1-hour structure density and visual balance. 🧠 VISUAL DESIGN PHILOSOPHY The visual design is built around premium restraint. The chart should not look empty, but it also should not look like every candle is receiving a signal. Measured Move Projection Zones keeps the main structural elements visible: - Impulse boxes - Base range boxes - Projected target bands - Invalidation zones or guides - Moderated event labels - Compact AGPro panel Expired labels are disabled by default because they can quickly become noisy on hourly charts. Event labels are still preserved in a moderated amount so the chart has enough visual context. The optional projection guide line is disabled by default because long diagonal lines can dominate a 1-hour screenshot. Users can enable it when they want a more explicit projection path. The goal is a chart that looks structured, premium, and publication-ready while still being easy to read. 🔔 ALERTS The script includes alert conditions for the core lifecycle events: - Measured Move Armed - Projection Active - Target Band Interaction - Projection Invalidated - Projection Expired These alerts are designed around structure states, not trade commands. They help users monitor when a measured-move framework forms, activates, interacts with the projected band, invalidates, or expires. 🔹 LIMITATIONS AND TRANSPARENCY Measured Move Projection Zones is a structural visualization tool. It does not predict future price and does not claim that a projected target band will be reached. Pivot-based swing logic confirms structure after the necessary bars have formed. This creates cleaner anchors, but it also means the script is not trying to label every move in real time before confirmation. The target band is a measured projection derived from the impulse and base, not a certainty zone. Invalidation and expiration states are part of the design because failed measured moves are also useful information. Settings matter. More aggressive inputs will create more structures. More conservative inputs will create fewer, cleaner structures. ✅ IDEAL USER This script is ideal for traders who: - Use 1-hour charts for price-action review - Study impulse-base-continuation behavior - Want measured-move target zones without a cluttered extension grid - Prefer visual structure over heavy signal text - Want a clean AGPro-style panel for quick state review - Care about invalidation and failed projection context - Need a public-chart-friendly tool that looks polished, focused, and easy to understand Measured Move Projection Zones is built for users who want a disciplined projection framework on the chart: enough structure to be useful, enough restraint to stay premium.
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