Opening Auction Ledger [JOAT]Opening Auction Ledger
Introduction
Opening Auction Ledger is an open-source session framework built to standardize how the opening range is measured, locked, evaluated, and managed throughout the day.
The indicator is designed around a simple institutional question:
Once the opening auction is complete, is price accepting away from it or failing back into it?
The script answers that by combining:
session-specific opening range capture
high-low or body-based range construction
breakout qualification
relative volume confirmation
objective extension ladders
session profile rendering
adaptive continuation trail management
historical breakout tracking in a dashboard
This makes the opening range usable as more than a static box.
It becomes a complete session ledger.
Core Concepts
1. Opening Range Capture
The script builds the opening range only during the specified session window and then locks that range when the session ends.
This preserves a fixed reference for the rest of the day.
2. Source Flexibility
Users can define the opening range using raw highs and lows or candle bodies.
This changes how strict the opening auction frame is and can make the indicator more stable on noisy instruments.
3. Qualified Breakout Detection
Breaks are not accepted simply because price crosses a range boundary.
The script can require a minimum displacement beyond the range and, optionally, a relative-volume lift compared with recent activity.
4. Objective Laddering
Once a breakout is confirmed, the script projects three extension objectives above and below the opening range using multiples of the locked range size.
5. Continuation Management
An adaptive ATR trail follows the accepted breakout so continuation quality can be monitored after the initial move is underway.
Features
Configurable opening session: user-defined session window and timezone
Opening range lock: session range freezes after the auction ends
Body or high-low source mode: choose the structure used to build the range
Relative-volume breakout filter: optional confirmation prevents weaker breaks from being counted
Minimum displacement filter: breakout must exceed a configurable fraction of the locked range
Extension ladder: three upside and three downside objectives
Session profile: profile-style rendering of activity inside the opening auction
Continuation trail: adaptive ATR trail tracks accepted move quality
Historical outcome counters: dashboard tracks breakout counts and objective hit rates
Institutional dashboard: top-right summary of session state, range size, direction, and objective performance
Input Parameters
Opening Auction
Opening Range Session
Session Days
Timezone
Range Source
Minimum Break % Of Range
Require Relative Volume Lift
Relative Volume Threshold
Extension Ladder
Show Extension Ladder
Objective One
Objective Two
Objective Three
Show Price Labels
Auction Profile
Show Session Profile
Profile Rows
Profile Width Bars
Profile Offset Bars
Continuation Management
Show Adaptive Continuation Trail
Trail ATR Length
Trail ATR Multiplier
Display
Range Fill Transparency
Shade Session State
Dashboard Position
Dashboard Size
How to Use This Indicator
Step 1: Wait for the Range to Lock
Do not treat the opening range as final until the configured auction window is complete.
Before that point, the frame is still forming.
Step 2: Measure the Quality of the First Break
The first breakout matters most when it clears the minimum displacement rule and is supported by the configured relative-volume threshold.
Step 3: Use the Ladder as an Objective Map
The projected targets are not predictions.
They are structured expansion references derived from the opening range itself.
Step 4: Follow the Trail for Acceptance
The continuation trail helps determine whether price is still accepting away from the opening auction or beginning to fail back toward it.
Step 5: Review the Dashboard Statistics
The dashboard can help users understand how often objective ladders are being reached under the current settings and instrument behavior.
Indicator Limitations
The usefulness of the opening range depends heavily on the selected session and market traded
Relative-volume logic is chart-volume based and depends on the instrument's available volume series
Very narrow opening ranges can create closely spaced objectives in low-volatility sessions
A qualified breakout can still fail quickly in event-driven or thin-liquidity conditions
Originality Statement
Opening Auction Ledger extends the classic opening-range idea into a broader session framework by combining range locking, breakout qualification, objective ladders, profile context, continuation management, and outcome tracking in a single open-source script.
Disclaimer
This indicator is provided for educational and informational purposes only.
It is not investment advice and does not guarantee that any breakout or target sequence will succeed.
All calculations are based on historical chart data and should be interpreted with appropriate risk management and independent analysis.
Indicator
Trend Bias Oscillator**Trend Bias Oscillator (TBO)**
---
The Trend Bias Oscillator tracks where price sits within its current trend — not just whether it's bullish or bearish, but *how far along* it is within that move. It normalizes that position to a clean ±100 scale, so readings are consistent across any instrument or timeframe.
When the market is in a bullish structure, the oscillator rises toward +100 as price pushes toward the top of the established range, and pulls back toward zero on retracements. When structure is bearish, it falls toward -100 as price drops, and recovers toward zero on bounces. If price breaks beyond the known range entirely, the oscillator pins at ±100 — a sign of extension.
Structure shifts when price closes decisively above a prior swing high (bullish flip) or below a prior swing low (bearish flip). Once flipped, the bias holds until the opposite level is broken — so the oscillator stays on one side of zero for the entire duration of a trend, not just the bar the signal fired on.
The optional signal line smooths the raw oscillator, making it easier to spot when momentum is building or fading within the current bias. A widening gap between the histogram and signal line suggests continuation. Compression back toward the line suggests a pause or potential reversal ahead.
---
**What makes TBO different**
Most oscillators measure momentum or price position in isolation — they have no awareness of whether the market is in a defined trend or not. RSI, Stochastic, and similar tools will oscillate freely regardless of structure, which means a reading of 70 looks the same in a strong uptrend as it does in the middle of a range.
TBO is different because the oscillator only activates and measures depth *after* a confirmed structural break. Until price breaks a prior swing high or low with a closed bar, the oscillator stays at zero — explicitly signaling that no defined bias exists. Once a break is confirmed, TBO then continuously measures how deep price has traveled into that trend, using the opposing swing level as its reference point rather than an arbitrary lookback window or moving average.
This means TBO doesn't just tell you which direction the market is leaning — it tells you *how committed* it is to that direction at any given moment. A reading compressing back toward zero during an uptrend is a retracement warning. A reading pushing toward +100 is trend continuation. The context is structural, not statistical.
There are indicators on PulseWire that normalize price within a range, and others that detect market structure breaks. TBO combines both into a single, continuously updated reading — making it a genuinely different tool rather than a variation on existing oscillator formulas.
---
**Inputs**
**Bars Left** *(default: 20)*
How many bars to the left define a swing point. Higher values find bigger, more meaningful swings. Lower values are more sensitive and react faster.
**Bars Right** *(default: 5)*
How many bars to the right are needed before a swing is confirmed. Lower values confirm faster but can be noisier. This setting also controls how much lag the indicator has — a value of 5 means pivots confirm 5 bars after they form.
**Non-Repaint Mode** *(default: on)*
Ensures structure bias can only flip on a fully closed bar — a signal triggered intrabar will never fire and then disappear before the candle closes. The oscillator value itself will still update in real time as price moves within the current bar, which is normal and expected. What non-repaint protects is the structural flip — that moment when bias switches from bullish to bearish or vice versa. Turning this off allows real-time bias changes but signals may repaint on unclosed candles.
**Show Signal Line** *(default: on)*
Toggles the smoothed line over the histogram on or off.
**Signal Type** *(default: EMA)*
The smoothing method used for the signal line. EMA reacts fastest, SMA is straightforward, WMA weights recent bars more heavily, and RMA (Wilder's) is the smoothest and slowest. Personal preference — try EMA or RMA first.
**Signal Length** *(default: 5)*
How many bars the signal line looks back over. Shorter values follow the oscillator closely. Longer values produce a smoother line that only moves on sustained shifts.
**Signal Color** *(default: blue)*
The color of the signal line, adjustable via the color picker.
**Signal Line Width** *(default: 1)*
The thickness of the signal line. Ranges from 1 to 4.
---
**Reference Lines**
| Level | What it means |
|---|---|
| +100 | Price fully extended in bullish structure |
| +50 | Price in the upper half of the bullish range |
| 0 | No bias established, or structural midpoint |
| -50 | Price in the lower half of the bearish range |
| -100 | Price fully extended in bearish structure |
---
**A few things worth knowing**
Swing pivots confirm with a small natural delay — this is intentional and keeps the indicator from repainting. On very choppy or ranging markets, structure will flip frequently and the oscillator will hover near zero. This is the indicator working as designed, not a malfunction — it simply means no clean trend structure exists at that time. Stepping up to a higher timeframe usually clarifies the picture.
The oscillator value moving on the live bar is normal behavior and not repainting. Non-Repaint Mode specifically prevents structure bias from flipping until a bar fully closes, ensuring signals are never triggered and then taken back within the same candle. Indicator
Acceptance Failure Path Map [AGPro Series]Acceptance Failure Path Map
🧠 Core Idea
Did price truly accept beyond a market boundary, or did that acceptance fail and create a new reaction path?
📌 Overview / What it does
Acceptance Failure Path Map is a market-structure visualization tool designed to study acceptance, failed acceptance, reclaim attempts, and continuation behavior around a defined reference range.
The script maps an acceptance band, detects whether price holds above or below that band, and highlights when accepted price fails back through the boundary. It produces compact labels, a centered path zone, right-side state tags, and an AG Pro panel that summarizes the current acceptance context.
It does not predict price direction, automate decisions, or claim that any acceptance event must continue. Its purpose is to make acceptance quality easier to read.
🎯 Purpose & Design Philosophy
This script was built for traders who want to understand whether a move is being accepted by the market or rejected after a temporary push beyond structure.
Many breakout tools mark only the breakout event. This script focuses on what happens after the breakout: acceptance, failure, reclaim pressure, and continuation risk.
The design supports a patient, context-first workflow where the trader reads the path of price around a boundary instead of reacting to a single candle.
⚡ Why This Script Is Different
Most tools focus on breakout signals, support and resistance touches, or simple range breaks.
This script does NOT treat every break as meaningful acceptance.
Instead, it builds a path map around acceptance quality, failure timing, reclaim behavior, and current risk state. The result is a cleaner view of whether price is holding acceptance or losing it.
⚙️ Methodology
1. Context Detection
The script builds a reference range from recent market structure and applies an ATR-based buffer to reduce noise.
2. Reference Mapping
It defines upper and lower acceptance boundaries and tracks whether price closes beyond them for the required number of bars.
3. Reaction Evaluation
After acceptance appears, the script monitors whether price fails back through the boundary, attempts reclaim, or holds continuation.
4. Visual Output
The chart displays an acceptance path zone, event labels, right-side state tags, and a panel summarizing the current condition.
🗺️ How to Read the Chart
Zones show the current acceptance path area around the active boundary.
Labels highlight acceptance above, acceptance below, acceptance failure, reclaim tests, and held acceptance.
Colors separate bullish acceptance, bearish acceptance, neutral failure risk, and reclaim context.
The panel shows the current path state, acceptance side, failure risk, path quality, reference range, active boundary, and next context.
🚦 Signals & States
• ACCEPT ABOVE → Price has accepted above the reference boundary.
• ACCEPT BELOW → Price has accepted below the reference boundary.
• ACCEPT FAIL → Accepted price failed back through the boundary within the failure window.
• RECLAIM TEST → Price is testing reclaim after a failed acceptance event.
• ACCEPT HELD → Acceptance remained valid after the failure window.
🔔 Alerts Logic
Alerts trigger when the script detects acceptance above, acceptance below, acceptance failure, or reclaim testing.
These alerts are attention markers. They are not trade instructions, entry signals, or guaranteed outcomes.
🧩 Confluence Logic
The context becomes stronger when acceptance quality, distance from the reference range, participation, and follow-through direction align.
If acceptance appears without follow-through or quickly returns through the boundary, the failure context becomes more important.
📊 When to Use
• After range breaks
• Around support and resistance transitions
• During breakout retests
• When price is attempting to hold above or below a major boundary
• When evaluating whether market structure is accepted or rejected
⚠️ When NOT to Use
• Extremely illiquid markets
• Very noisy low-timeframe candles
• News-driven spikes with unstable spreads
• Markets with no meaningful reference range
• Situations where a single indicator is being used without broader context
🎛️ Key Inputs
• Reference Range Length → controls how much structure is used to build the acceptance boundary.
• Acceptance Bars → controls how many closes are required before acceptance is recognized.
• Failure Window → controls how quickly accepted price must fail back through the boundary.
• Boundary Buffer ATR → adjusts the buffer around the reference range.
• Label and Panel Font Size → adjust chart readability.
• Visible Band Bars and Band Projection Bars → control how the acceptance zone appears on the chart.
🖥️ Interface & Visual Design
The interface is designed for a premium, clean chart view.
The panel provides the current summary. The acceptance zone carries the main story. Labels are compact and spaced to avoid hiding candles.
The visual hierarchy is intentionally simple: zone first, current state second, event labels third.
🧪 Practical Usage Workflow
1. Read the AG Pro panel to identify the current path state.
2. Check whether price is above, below, or inside the acceptance path zone.
3. Review recent labels to understand whether acceptance held, failed, or reclaimed.
4. Compare the current failure risk and path quality with broader market context.
5. Use alerts only as attention markers for further review.
🔍 Interpretation Guidelines
Acceptance is stronger when price remains outside the boundary with follow-through.
Acceptance failure is more meaningful when price quickly returns through the boundary after appearing accepted.
Reclaim tests should be interpreted as context changes, not automatic reversal signals.
Held acceptance suggests the market is continuing to respect the accepted side, but it still requires confirmation from broader structure.
🚫 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 provide guaranteed buy or sell signals.
It does not replace risk management, market context, or independent analysis.
⚠️ Limitations & Transparency
Acceptance behavior can look different across timeframes.
High volatility can create temporary false readings.
Low-liquidity markets may produce unstable boundary behavior.
The script is rule-based and depends on the selected settings, symbol behavior, and chart timeframe.
🧠 Market Context Notes
Acceptance and failure are closely related to market structure, liquidity reaction, and participant commitment.
When price breaks a boundary but cannot hold it, the failed side may become the more important context.
When price accepts and holds, the market may be showing stronger directional commitment.
🧾 Use Case Examples
When price accepts above a range and holds beyond the failure window, the chart may show an ACCEPT HELD context.
When price accepts above a boundary but quickly closes back below it, the script may mark ACCEPT FAIL.
When price returns back toward a failed boundary, the script may show a RECLAIM TEST state.
🧱 System Philosophy
AGPro Series tools are built to visualize market context without turning analysis into prediction.
The goal is to make structure, risk, and reaction quality easier to observe in real time.
🔐 Non-Promise Statement
No script can guarantee market direction, timing, or outcome.
This tool provides structured visual context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and position sizing.
This script does not provide financial advice or guaranteed trading results.
📚 Educational Note
Use this script as a learning and analysis tool for studying acceptance, failed acceptance, reclaim pressure, and continuation behavior around market boundaries.
Indicator
Volatility Compression Release Map [AGPro Series]Volatility Compression Release Map
🧠 Core Idea
Is the market quietly building expansion energy, or has the release already failed back into the shelf?
📌 Overview / What it does
Volatility Compression Release Map is a volatility regime and compression shelf visualization tool built to identify quiet range contraction, release attempts, fake releases, and expansion quality.
The script maps a projected compression shelf when volatility rank and range size contract together. It then tracks whether price releases away from that shelf, returns back inside it, or continues to hold expansion pressure.
This script does not predict future price direction, automate trades, or produce guaranteed buy/sell signals. It is designed as a structured chart-reading layer for volatility compression, release quality, and contextual risk.
🎯 Purpose & Design Philosophy
The script was built for traders who care about the transition between quiet markets and expansion phases.
Many charts look calm before movement starts. The challenge is not simply seeing a tight range, but understanding whether that range is still building energy, whether the release is active, or whether the move has already failed back into the shelf.
The design philosophy is simple: reduce volatility noise into a readable map, preserve the important shelf story, and make the current regime understandable at first glance.
⚡ Why This Script Is Different
Most tools focus on breakout arrows, squeeze dots, or raw volatility bands.
This script does NOT treat every contraction as an immediate trade signal and does NOT frame every expansion candle as confirmation.
Instead, it builds a full compression-to-release map: the shelf, volatility rank, range size, release direction, fake-release risk, quality score, right-side state labels, and a compact AG Pro panel all work together.
⚙️ Methodology
1. Context Detection
The script evaluates ATR rank, recent range size, and whether price is still inside a quiet shelf.
2. Shelf Mapping
When compression conditions align, the active range is stored and projected forward as a compression shelf.
3. Release Evaluation
The script checks whether price leaves the shelf with enough candle body expansion to qualify as a release attempt.
4. Failure Tracking
If price quickly returns into the shelf during the fake-release window, the state changes to fake release.
5. Visual Output
The chart displays a projected shelf, dotted rails, a centered shelf-quality label, event labels, right-side state tags, and a compact AG Pro panel.
🗺️ How to Read the Chart
Zones represent the active compression shelf.
The shelf label shows the current shelf quality score using a compact `SHELF | Q` format.
Green/teal visual states generally indicate constructive expansion or defended release behavior.
Pink visual states highlight failed release or adverse volatility behavior.
Indigo/accent visuals represent compression and neutral shelf structure.
The panel summarizes compression state, release direction, volatility rank, range size, quality score, shelf range, and next context.
🚦 Signals & States
• COMPRESSION BUILD → a quiet shelf is forming and volatility is compressed
• RELEASE ACTIVE → price has moved away from the shelf with sufficient body expansion
• FAKE RELEASE → price returned back into the shelf after a release attempt
• SHELF WATCH → a shelf exists but the market has not produced a clean active release
• WAIT COMPRESSION → no valid compression shelf is currently active
🔔 Alerts Logic
Compression Build alert triggers when a new volatility compression shelf is detected.
Compression Release alert triggers when price releases from the active shelf with enough candle body expansion.
Fake Release alert triggers when price returns back into the shelf within the defined fake-release window.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when low volatility rank, compact range size, a visible shelf, and a strong release candle align.
The context becomes weaker when price fails back into the shelf shortly after release.
📊 When to Use
• Before potential expansion phases
• During quiet range compression
• Around breakout preparation zones
• When evaluating whether a move is expanding or failing
• On liquid markets where volatility structure is meaningful
⚠️ When NOT to Use
• Extremely illiquid symbols
• Very noisy low-timeframe charts
• News shock environments where volatility structure changes suddenly
• Markets with unreliable volume or large gaps
• Situations where a single indicator is being used without broader context
🎛️ Key Inputs
• Compression Lookback → controls the range window used to detect the shelf
• Volatility Rank Lookback → controls how ATR rank is measured
• Compression Rank Max → changes how selective compression detection is
• Range ATR Max → limits how wide a valid shelf can be
• Release Body ATR Min → defines how strong a release candle must be
• Fake Release Window → controls how quickly a release failure is detected
• Visual settings → control shelf projection, labels, panel, theme, and font sizes
🖥️ Interface & Visual Design
The interface is designed to look clean, premium, and publication-ready.
The shelf is the main visual anchor. Event labels are intentionally limited so the chart does not become crowded.
The AG Pro panel uses a merged blue header row and summarizes the state without covering the main chart story.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Locate the active compression shelf.
3. Check whether price is inside, releasing, or failing back into the shelf.
4. Compare the quality score with the visual structure.
5. Use broader market context before making any decision.
🔍 Interpretation Guidelines
Compression is not direction.
A shelf shows where volatility has contracted.
A release shows that price moved away from the shelf with expansion pressure.
A fake release shows that the market rejected the expansion and returned to the compression area.
The strongest interpretations come from combining the shelf, state, quality score, and surrounding market structure.
🚫 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 profitable trades.
It does not replace risk management or independent analysis.
⚠️ Limitations & Transparency
Timeframe differences can change how compression and release behavior appears.
High volatility news events may reduce the usefulness of shelf-based interpretation.
Low-liquidity markets can produce misleading shelves and sudden false releases.
The script is rule-based and should always be interpreted within broader market context.
🧠 Market Context Notes
Volatility often contracts before expansion, but compression alone does not define direction.
The shelf helps identify where the market has stored recent range energy.
Release quality helps separate stronger expansion attempts from weak movement outside the range.
🧾 Use Case Examples
When price remains inside a shelf while volatility rank is low, the market may still be building energy.
When price leaves the shelf with strong body expansion, the script marks release behavior.
When price returns into the shelf quickly, the script flags a fake-release context.
🧱 System Philosophy
AGPro Series tools are built to turn complex market behavior into structured visual maps.
The goal is not to simplify markets into certainty, but to make important context easier to read.
🔐 Non-Promise Statement
No script can know the future.
No signal is certain.
No visual state should be treated as a guaranteed outcome.
📉 Risk Disclosure
Trading involves risk.
Markets can move unexpectedly.
Users are responsible for their own decisions, risk management, and trade execution.
This script does not provide financial advice.
📚 Educational Note
This tool is intended for educational and analytical use. It can help traders study volatility compression, release behavior, fake-release risk, and shelf-based market context.
Indicator
Volatility Coil Edge [BullByte]Volatility Coil Edge is a reversal detection script designed for intraday traders operating in futures, indices, and crypto markets. It identifies a specific and repeatable market condition: price compressing into a tight range at the extreme boundary of a session, then breaking out of that compression in the opposing direction. The compression is the footprint. The break is the trigger. Everything else - entry, stop, and three scaled targets - is calculated automatically from the structure itself.
This script is built from custom logic rather than a simple wrapper of standard indicators. VCE is built from a custom volatility state machine designed specifically for detecting absorption-and-release patterns at session extremes. There is no RSI. No MACD. No Bollinger Band. The logic is derived entirely from price geometry, ATR ratio mathematics, and session range physics.
---
WHAT IS A VOLATILITY COIL
Price does not move in straight lines. It expands and contracts in cycles . When price reaches the edge of its established session range and begins contracting - forming smaller and smaller bars with decreasing volatility relative to recent history - it is coiling. This coil represents a temporary equilibrium between buyers and sellers at a structurally significant location.
The coil at a session high means sellers have been absorbing every attempt to push higher. The coil at a session low means buyers have been absorbing every attempt to push lower. When that absorption ends and price breaks through the coil boundary in the reversal direction, it signals that one side may be losing control and the opposite side may begin to take over.
VCE detects this moment and marks it on the close of the break bar. The script combines session-extreme context, multi-condition compression logic, violation tolerance, and post-impulse detection within one unified engine.
---
WHY THIS WORKS AND WHY IT IS ORIGINAL
Most volatility indicators measure contraction globally across the entire chart. VCE measures contraction locally and contextually - it only cares about compression that forms at the edges of the current session range. A tight range forming in the middle of a session is noise. The same tight range forming at the session high or low is a structural event.
The detection engine uses three simultaneous compression conditions:
The first is a ratio comparison between a short-period local ATR and a longer-period background ATR . When the local ATR falls below a calibrated percentage of the background ATR, the bar qualifies as contracted.
The second is a drift-floor condition that catches low-volatility regimes where the ratio test alone would miss genuine compressions. It compares the current bar range against the rolling median bar range.
The third is Catalyst Mode, which identifies compressions forming immediately after a volatility expansion - the post-impulse coil. These are often a strong setup type because they represent price stalling after a strong directional move, often marking exhaustion at the extreme.
All three conditions feed a state machine that tracks how many consecutive bars meet the compression criteria, applies violation tolerance so that minor range extensions do not invalidate real coils, and enforces a maximum coil length to prevent stale consolidations from triggering signals.
---
THREE SENSITIVITY TIERS
Conservative: Requires the tightest compression and the longest minimum coil duration. Generates fewer signals. Best for traders who prefer higher-filter setups and can wait.
Balanced: The recommended default. Moderate compression requirements and signal frequency. Suitable for most intraday traders across all supported markets.
Aggressive: Captures looser compressions and shorter coils. Higher signal frequency. Best for very active scalpers who want early entries and manage risk with tight stops.
All three tiers can be fully overridden with manual parameter control for experienced users who want to calibrate to a specific instrument.
---
CATALYST MODE
When enabled, Catalyst Mode adds a fourth detection layer. If any of the last five bars showed a range greater than 1.5 times the background ATR, the engine recognizes that a volatility expansion just occurred. Compressions forming immediately after an expansion are flagged even if the ratio test alone would not qualify them. These post-impulse coils frequently mark the confirmed point where momentum stalls and reversal begins.
---
SIGNAL MECHANICS
This tool provides a systematic framework for identifying the pattern and managing the trade once it fires. A historical bar is exactly what you would have seen in real time on that bar's close.
LONG signals fire when a qualified compression forms at the session low zone and price closes above the upper boundary of the coil on the break bar.
SHORT signals fire when a qualified compression forms at the session high zone and price closes below the lower boundary of the coil on the break bar.
---
ENTRY, STOP, AND TARGETS
Entry is the close price of the signal bar.
The stop loss is placed beyond the structural extreme of the coil - below the coil low for longs, above the coil high for shorts - with an ATR buffer added for breathing room. A minimum stop distance floor prevents dangerously tight stops on very small coils.
The stop distance itself is bounded between an ATR floor and an ATR ceiling so that all three targets remain proportionally realistic regardless of coil size. Targets are then calculated as pure R-multiples of the final bounded stop distance:
TP1 defaults to 1.0R - the point where the trade has covered its own risk.
TP2 defaults to 1.5R - the primary partial profit zone.
TP3 defaults to 2.0R - the full target. Hitting TP3 closes the trade and removes all drawings.
TP1 and TP2 are milestone targets. When hit, a yellow dot marks the price level and the trade remains open. The stop loss and all three target lines remain live until TP3 or the stop is reached.
All R-multiple values are user-adjustable. The stop buffer and minimum distance are also adjustable.
---
VISUAL ELEMENTS
Signal Card: A labeled marker appears at every signal bar showing direction (LONG or SHORT), the number of bars in the coil, and the TP2 R-multiple. In Minimalist mode, only the direction is shown. Signal cards are permanent - every historical signal remains visible for review.
Level Lines: At signal time, five horizontal lines are drawn - entry, stop loss, TP1, TP2, TP3 - each with a floating price label to the right. Lines extend forward bar by bar during the trade and terminate cleanly at the outcome bar.
Coil Box: While a compression is being watched, a dashed orange box outlines the coil range. The box updates in real time as the coil extends. A small tag shows direction bias and bar count.
Concentric Rings: Four nested rings are drawn around the signal bar at entry, scaling with ATR. They persist for the duration of the trade as a visual anchor and are removed automatically at outcome.
Milestone Dots: Yellow dots mark the exact bar and price where TP1 and TP2 are touched during the trade.
Signal Bar Highlight: The background of the signal bar is tinted green for longs and red for shorts.
---
THE DASHBOARD
The dashboard panel shows the current state of the engine at a glance. It updates on every bar close.
The header shows the ticker symbol and timeframe so the panel is always self-identifying across multiple open charts.
STATE shows one of four conditions: IDLE when no coil is active, FORMING with a bar count when compression is building but not yet qualified, WATCH LONG or WATCH SHORT when a qualified coil is positioned at an extreme and the engine is waiting for a break, and ACTIVE LONG or ACTIVE SHORT during a live trade.
COIL shows the current compression bar count and the local-to-background ATR ratio as a percentage. Lower percentage means tighter compression.
ZONE shows where the active coil is positioned - session high, session low, or mid-range for forming coils that have not yet reached an extreme.
ENTRY shows the direction and confirmed entry price of the active trade.
TARGETS shows three dots - one for each TP level. Dots fill yellow as each milestone is hit during the trade.
---
RECOMMENDED MARKETS AND TIMEFRAMES
VCE is designed for liquid intraday markets with defined session structure. It performs better on instruments that have clear daily range boundaries and regular volatility patterns.
Recommended markets: NQ, ES, MNQ, MES futures. BTC, ETH, SOL perpetual futures. Major crypto spot pairs. SPY, QQQ intraday.
Recommended timeframes: The script performs strongest on the 15 minute timeframe where session structure is cleanest and compression patterns carry the most weight. The 5 minute and 3 minute timeframes are well suited for standard intraday work. The 1 minute timeframe is for aggressive scalping and requires tighter risk management due to higher noise levels.
The Session Range Lookback input should be calibrated to approximately one full session worth of bars on your chosen timeframe. On a 5-minute chart, one RTH session is roughly 78 bars. On a 1-minute chart, approximately 390 bars. The default of 50 is a balanced starting point for 3-minute and 5-minute charts.
On a 15-minute chart one full RTH session is approximately 26 bars; set Session Range Lookback to 26 to 30 for clean session-extreme detection on this timeframe.
---
HOW TO READ A LIVE SETUP (USAGE)
Step one : Watch for the dashboard STATE to change from IDLE to FORMING. This means compression is building somewhere on the chart.
Step two: When STATE changes to WATCH LONG or WATCH SHORT, the coil has qualified and is positioned at a session extreme. The orange coil box becomes visible. The engine is now armed.
Step three: Do not act on WATCH alone. Wait for the signal card to appear. The signal only fires on bar close when the coil has been broken in the reversal direction. The signal card, level lines, and rings all appear simultaneously at that moment.
Step four: Entry is the close of the signal bar. Place your stop at the SL line. Your targets are TP1, TP2, and TP3 as shown on the chart.
Step five: TP1 and TP2 mark themselves with yellow dots as they are hit. The trade closes automatically in the visual display when TP3 or SL is reached, and all lines are removed cleanly.
CHART EXAMPLE
The Science of Price Coiling : Silver 5m
Price surged aggressively into the session high zone, driven by strong buying momentum. But at the extreme, buyers ran out of fuel. Over the next 4 bars, the range shrank bar by bar, candles got smaller, volatility dried up, and neither buyers nor sellers could dominate.
This is the coil: not random sideways movement, but compressed energy at an unstable equilibrium. The longer price holds at an extreme without continuing, the more it signals that the side that drove it there is exhausting. When sellers finally overwhelmed the weakened buyers, price broke below the coil floor in a single decisive bar, releasing all stored tension in one direction.
That break was not a prediction. It was a consequence. The compression was the warning, the location was the context, and the break was simply the market resolving the imbalance it had been building. This is what VCE detects, not the move itself, but the conditions that make the move inevitable.
---
ALERT SETUP
Two alert conditions are built in:
VCE Long Signal fires on bar close when a LONG setup triggers.
VCE Short Signal fires on bar close when a SHORT setup triggers.
To activate : open the Alerts panel, select Create Alert, choose VCE as the condition source, and select either Long Signal or Short Signal. Set the trigger to Once Per Bar Close. No additional configuration is needed.
---
INPUTS REFERENCE
Sensitivity: Conservative, Balanced, or Aggressive preset. Controls compression tightness, minimum coil length, zone threshold, and break definition simultaneously.
Catalyst Mode: Enables post-impulse coil detection. Recommended ON for all markets.
Use Manual Overrides: Replaces the sensitivity preset with the four manual parameters below it.
Min Bars: Minimum consecutive compression bars required before a coil qualifies.
Max Bars: Maximum coil length before the coil is invalidated and reset.
Contraction Ratio: Local ATR must be below this fraction of the background ATR to register as a compressed bar.
Extreme Zone Percent: Defines what fraction of the session range constitutes the high and low extreme zones.
Background ATR Period: Smoothing period for the volatility baseline used in compression detection.
Session Range Lookback: Number of bars defining the rolling session high and low.
ATR Period: Period for the ATR used in stop and target calculations.
Post-Outcome Bar Gap: Minimum bars of silence after a trade closes before the next signal can fire.
SL Buffer: ATR multiplier added beyond the coil extreme when calculating the structural stop.
Min SL Distance: Floor for the stop distance as an ATR multiple. Prevents unrealistically tight stops.
Max SL Distance: Ceiling for the stop distance as an ATR multiple. Prevents absurdly wide stops on tall coils and keeps all TP levels proportionally realistic for the chosen timeframe.
TP1, TP2, TP3: Take-profit levels as multiples of the stop distance.
Label Right Offset: Controls how far to the right floating price labels appear.
Minimalist Signal Card: Shows only LONG or SHORT on the signal card when enabled.
Show Coil Box: Toggles the live orange compression box.
Highlight Signal Bar: Toggles background tinting on signal bars.
Show Concentric Ring Signature: Toggles the nested ring visual at signal bars.
Show Dashboard: Toggles the status panel.
Theme: Dark or Light. Adjusts all label, line, and panel colors for chart background compatibility.
Position: Sets the dashboard anchor position on the chart.
---
NOTES ON PERFORMANCE AND EXPECTATIONS
VCE identifies a specific structural pattern. Not every coil produces a sustained reversal. Session context, macro flow, and news events all influence whether a given setup follows through. The tool provides a systematic framework for identifying the pattern and managing the trade once it fires. Risk management decisions remain with the trader.
The post-outcome bar gap input exists to prevent the engine from immediately re-entering after a stopped trade. This is a deliberate design choice, not a limitation.
---
DISCLAIMER
This script is published for educational and informational purposes only. It is not financial advice and does not constitute a recommendation to buy or sell any financial instrument. Past signal behavior does not guarantee future results. Trading involves significant risk of loss. Always conduct your own research and apply your own risk management framework before making any trading decision. Indicator
Failed Continuation Trap Map [AGPro Series]Failed Continuation Trap Map
🧠 Core Idea
Did a continuation attempt fail strongly enough to trap traders and create pressure in the opposite direction?
📌 Overview / What it does
Failed Continuation Trap Map is a rule-based price-action and market-structure visualization tool designed to study failed continuation attempts.
The script identifies trend-aligned continuation attempts, maps the attempted breakout zone, evaluates whether the move fails back through that zone, and highlights when trapped longs or trapped shorts may create opposite pressure.
It does not predict reversals, automate trades, or guarantee that a failed continuation will produce follow-through. It is a structured decision-support map for continuation failure, trap behavior, and opposite-pressure context.
🎯 Purpose & Design Philosophy
Many breakout and continuation tools focus on whether price moved beyond a level.
This script was built to answer a more selective question:
Did the continuation attempt fail in a way that changes the market narrative?
The design goal is to help traders read failed continuation as a trap context instead of treating every rejection as a reversal signal.
⚡ Why This Script Is Different
Most tools focus on breakouts, pullbacks, continuation signals, or reversal labels.
This script does NOT label every failed move as a trap.
Instead, it waits for a trend-aligned continuation attempt, tracks the attempt zone, evaluates failure quality, maps the trap pocket, and checks whether opposite pressure confirms after trapped participants are created.
⚙️ Methodology
1. Continuation Bias Detection
The script uses fast and slow EMAs to define the active continuation bias.
2. Attempt Mapping
When price attempts continuation beyond recent structure, the script records the attempt level and builds an attempt zone.
3. Failure Evaluation
After the attempt, the script watches a defined failure window to detect rejection back through the attempt level.
4. Trap and Pressure Scoring
Trap quality uses rejection wick behavior, relative volume, and failure timing.
5. Visual Output
The chart displays the attempt zone, trap pocket, opposite-pressure rail, centered trap label, event labels, right-side tags, alerts, and a compact AG Pro decision panel.
🗺️ How to Read the Chart
Attempt Zone = the area around the continuation level where breakout or continuation participants may enter.
Trap Pocket = the area where failed continuation can create trapped participants.
Opposite-Pressure Rail = the level used to read whether the failed continuation is turning into stronger pressure against the attempt.
Centered Trap Label = the main visual anchor inside the active trap pocket.
Event Labels = compact labels for attempts, long traps, short traps, and pressure confirmation.
Right-Side Tags = current trap state, attempt level, and pressure quality.
Panel = summarizes trap state, attempt type, trapped side, trap quality, pressure quality, next context, and timeframe.
🚦 Signals & States
• ATTEMPT ACTIVE → price attempted continuation and is still inside the failure evaluation window.
• TRAP ACTIVE → the continuation attempt failed back through the attempt level.
• OPPOSITE PRESSURE → price confirmed pressure away from the failed continuation attempt.
• CONTINUATION HOLD → the attempt is holding beyond the continuation zone.
• ATTEMPT EXPIRED → the attempt did not create a timely failure or pressure signal.
• WAIT ATTEMPT → no valid continuation attempt is active.
🔔 Alerts Logic
Alerts trigger when a major continuation-failure state appears.
• Continuation Attempt → price attempted continuation beyond recent structure.
• Failed Continuation Trap → continuation attempt failed back through the attempt zone with trap quality.
• Opposite Pressure Confirmed → opposite pressure confirmed after a failed continuation attempt.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• Continuation bias is clear
• Price attempts continuation beyond recent structure
• The attempt fails back through the zone quickly
• Rejection wick quality is strong
• Relative volume supports participation
• Opposite-pressure rail confirms after the trap
• The panel state agrees with the chart labels
If these elements do not align, the script avoids forcing a trap interpretation.
📊 When to Use
• Breakout failure analysis
• Failed continuation review
• Trend continuation trap studies
• Intraday and swing market-structure analysis
• Crypto, forex, stocks, and index markets
• 1H, 4H, and daily charts
• Markets where continuation attempts are common and readable
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely sideways markets with no continuation bias
• News-driven candles that distort rejection quality
• Ultra-low timeframes with excessive noise
• Markets where recent structure is too compressed to define a clean attempt zone
• Situations where a single failed attempt should not be treated as a standalone decision
🎛️ Key Inputs
• Fast EMA Length → defines the faster continuation-bias component.
• Slow EMA Length → confirms the broader continuation direction.
• ATR Length → normalizes attempt zones, trap pockets, labels, and failure levels.
• Continuation Breakout Lookback → defines recent structure used to identify continuation attempts.
• Failure Evaluation Window → controls how long after an attempt the script can classify failure.
• Attempt Zone ATR → controls the thickness of the continuation attempt zone.
• Trap Wick Threshold → defines how much rejection quality is needed before a failure becomes trap context.
• Use Volume Confirmation → adds relative volume to trap-quality scoring.
• Projection Bars → controls how far zones, rails, and right-side tags project.
• Label Font Size → controls chart label and tag text size.
• Panel Font Size → controls panel text size.
🖥️ Interface & Visual Design
The visual hierarchy is built around the failed-continuation story.
The attempt zone shows where continuation was attempted.
The trap pocket shows where trapped participants may become part of the next narrative.
The opposite-pressure rail gives a clean reference for pressure confirmation.
The centered badge keeps the active trap context readable at first glance.
The AG Pro panel summarizes the current trap state without forcing the user to decode every element manually.
🧪 Practical Usage Workflow
1. Let the script identify the active continuation bias.
2. Watch for an attempt beyond recent structure.
3. Check whether the attempt holds or fails back through the zone.
4. If trap context appears, watch the opposite-pressure rail.
5. Use the panel to confirm trap state, trapped side, and quality scores.
6. Interpret the output inside broader trend, liquidity, volatility, and support/resistance context.
🔍 Interpretation Guidelines
A continuation attempt does not guarantee follow-through. It means price attempted to move beyond recent structure in the trend direction.
A trap active state does not guarantee reversal. It means the continuation attempt failed back through the attempt zone with enough quality to deserve attention.
Opposite pressure does not guarantee trend change. It means trapped participants may be adding pressure against the attempted continuation.
The strongest readings occur when trap state, pressure rail, and broader market context align.
🚫 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 entry or exit signals.
It is not a generic breakout indicator.
It is not a simple reversal marker.
⚠️ Limitations & Transparency
EMA bias can lag during fast reversals.
Failure windows may miss slow-developing traps.
Low-liquidity markets can produce misleading wick behavior.
High volatility can make attempt zones wider or less stable.
Timeframe differences can change how continuation attempts appear.
The script is designed for structured interpretation, not certainty.
🧠 Market Context Notes
Failed continuation traps often matter most when traders are leaning heavily in one direction and price fails to reward that pressure.
The same failed attempt can have different meaning in a strong trend, range, liquidity sweep, or volatility shock.
The script should be read together with broader structure, volume, liquidity, and trend context.
🧾 Use Case Examples
• If price attempts upside continuation and then closes back below the attempt level with a strong upper wick, the script may show long-trap context.
• If price attempts downside continuation and then rejects back above the attempt level, the script may show short-trap context.
• If price continues beyond the pressure rail after a trap, the script may show opposite-pressure confirmation.
🧱 System Philosophy
Failed Continuation Trap Map is part of the AGPro Series approach to decision-support tools:
clear structure, premium chart readability, honest interpretation, and no promise of certainty.
The goal is to help traders see when continuation logic breaks, without turning every failure into a forced reversal signal.
🔐 Non-Promise Statement
No script can know the future.
No failed continuation guarantees reversal.
No signal should be interpreted without broader market context.
📉 Risk Disclosure
Trading involves risk.
Markets can move unpredictably.
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
📚 Educational Note
Use this script to study how continuation attempts fail and how trapped participants can affect the next phase of market behavior.
The value is not only in the trap label. The value is in learning when a continuation narrative is accepted, rejected, or converted into opposite pressure.
Indicator
Breakout Participation Gate [AGPro Series]Breakout Participation Gate
🧠 Core Idea
Does the breakout have enough participation and structure to deserve attention?
📌 Overview / What it does
Breakout Participation Gate is a breakout validation tool built to separate structured breakouts from weak breaks and fakeout-prone moves.
The script builds upper and lower breakout gate levels from recent structure, evaluates breakout candle quality, checks relative volume, body commitment, close location, trend context, retest behavior, expansion potential, and fakeout risk.
It does not predict price direction, automate trades, or claim that a gate-open event must continue. It is a structured visualization and decision-support tool for breakout participation review.
🎯 Purpose & Design Philosophy
Breakouts are among the most searched and most misunderstood market events.
Many tools mark every move above resistance or below support.
This script was built to ask a stricter question:
Did the breakout pass the participation gate?
The design goal is to help traders avoid treating every structural break as equally meaningful.
⚡ Why This Script Is Different
Most breakout tools focus on the break itself.
This script does NOT mark every breakout as valid.
Instead, it checks whether the breakout had enough relative volume, body commitment, close location, range expansion, trend context, and retest behavior. It also keeps the active gate visible so users can watch whether the breakout holds, expands, or fails back inside the structure.
⚙️ Methodology
1. Context Detection
The script identifies recent upper and lower gate levels using a structure lookback.
2. Breakout Qualification
When price closes beyond a gate, the script scores participation through volume, candle body, close location, range expansion, and trend context.
3. Gate Classification
High-quality breakouts can become GATE OPEN events. Lower-quality breaks can be classified as WEAK BREAK.
4. Retest Evaluation
After a gate opens, the script projects a retest shelf and watches whether price defends the shelf.
5. Fakeout and Expansion Review
The script tracks whether price closes back inside the gate shelf or expands beyond the active gate with acceptable participation.
6. Visual Output
The chart displays breakout gate lines, retest shelf, event labels, right-side tags, alerts, and a compact AG Pro panel.
🗺️ How to Read the Chart
Upper Gate = recent upper structure level that price must break to start an upside gate evaluation.
Lower Gate = recent lower structure level that price must break to start a downside gate evaluation.
Breakout Retest Shelf = the active zone around the gate where retest behavior is evaluated.
GATE OPEN = breakout passed the participation gate.
WEAK BREAK = price broke the gate but participation quality was not strong enough.
RETEST HOLD = price defended the active retest shelf after the breakout.
FAKEOUT RISK = price closed back inside the gate shelf after the breakout.
EXPANSION READY = price expanded beyond the gate while participation remained acceptable.
Panel = summarizes gate status, quality score, direction, relative volume, body commitment, retest health, fakeout risk, and next context.
🚦 Signals & States
• GATE OPEN → breakout passed the participation gate.
• WEAK BREAK → price broke structure but did not show enough participation quality.
• GATE WATCH → active gate is being monitored after a breakout.
• RETEST HOLD → active retest shelf was defended.
• FAKEOUT RISK → price closed back through the gate shelf.
• EXPANSION READY → price expanded beyond the gate with acceptable participation.
• WAIT BREAKOUT → no active gate has been triggered.
🔔 Alerts Logic
Alerts trigger when a major breakout-gate state appears.
• Breakout Gate Open → breakout passed the participation gate.
• Weak Breakout → price broke a gate level without enough participation quality.
• Breakout Retest Hold → active retest shelf was defended.
• Breakout Fakeout Risk → price closed back inside the gate shelf after the breakout.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• Price closes beyond a defined structure gate
• Relative volume is above normal
• Candle body commitment is strong
• Close location supports the breakout direction
• Range expands versus ATR
• The breakout direction agrees with trend context
• Retest behavior respects the active gate shelf
When these elements do not align, the script avoids treating the breakout as automatically valid.
📊 When to Use
• Breakout validation
• Failed breakout review
• Retest planning
• Trend continuation review
• Crypto, stocks, futures, forex, and liquid markets
• 15m, 30m, 1H, 4H, and 1D charts
⚠️ When NOT to Use
• Very low-liquidity assets
• Extremely noisy micro timeframes
• Symbols with unreliable volume
• News-driven spikes where structure can be distorted
• Markets where every wick break is being over-interpreted
• Situations where a single breakout label is expected to act as a guaranteed signal
🎛️ Key Inputs
• Gate Structure Lookback → defines the recent structure window used for upper and lower gates.
• Breakout Close Buffer ATR → controls how far beyond the gate price must close.
• Minimum Breakout Relative Volume → defines how much participation is required for strong volume credit.
• Minimum Body Commitment % → controls how much candle body participation is required.
• Gate Quality Threshold → separates gate-open breakouts from weak breaks.
• Retest Evaluation Window → defines how long the active gate shelf remains under review.
• Retest Shelf Width ATR → controls the thickness of the retest shelf around the active gate.
• Expansion Ready Distance ATR → defines when a breakout has expanded far enough to be monitored as continuation-ready.
• Event Label Mode → Premium focuses on higher-quality gate states. Detailed allows more weak-break labels.
🖥️ Interface & Visual Design
The visual hierarchy is built around the gate:
Gate lines define the structure.
The retest shelf shows where the breakout should hold.
Event labels mark gate-open, weak-break, retest-hold, fakeout-risk, and expansion-ready states.
Right-side tags keep the active gate context visible.
The AG Pro panel compresses the current breakout context into a fast, readable summary.
🧪 Practical Usage Workflow
1. Read the panel gate status.
2. Check whether price has broken the upper or lower gate.
3. Compare quality score with the event label.
4. Watch the active retest shelf.
5. Check whether price holds, expands, or fails back inside the gate.
6. Confirm with broader market structure, liquidity, volume, and risk planning.
🔍 Interpretation Guidelines
A gate-open label does not guarantee continuation.
A weak-break label does not guarantee reversal.
A retest-hold label means the active shelf was defended according to the script's rules.
A fakeout-risk label means the breakout structure weakened.
The script is best used as a breakout-quality layer, not as a standalone trading system.
🚫 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 entry or exit signals.
It is not a simple support/resistance breakout marker.
⚠️ Limitations & Transparency
Breakout quality depends on market structure and liquidity.
Volume behavior can differ across crypto, futures, stocks, and forex.
Choppy ranges can create repeated weak-break and fakeout states.
Different timeframes may show different gate behavior.
Highly volatile news events can distort breakout quality.
🧠 Market Context Notes
Breakouts are strongest when structure, candle commitment, participation, and retest behavior align.
The first break is only one part of the story.
The active gate shelf helps users watch whether the market accepts the breakout after the first impulse.
🧾 Use Case Examples
If price closes above the upper gate with strong participation, the script may mark GATE OPEN.
If price breaks a gate but quality is weak, the script may mark WEAK BREAK.
If price returns to the active shelf and defends it, the script may mark RETEST HOLD.
If price closes back through the shelf, the script may mark FAKEOUT RISK.
🧱 System Philosophy
The goal is not to chase every breakout.
The goal is to filter breakout attention.
This script treats breakout quality as a sequence:
structure break → participation gate → retest shelf → expansion or failure.
🔐 Non-Promise Statement
No breakout label guarantees continuation.
No weak-break label guarantees reversal.
No retest label guarantees a successful trend move.
All outputs should be interpreted as analytical context.
📉 Risk Disclosure
Trading involves risk.
This script is for educational and analytical purposes only.
It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users are fully responsible for their own decisions, risk management, and trade execution.
📚 Educational Note
Use the script to study which breakouts attract real participation and which breaks fail to hold their gate.
The most useful question is not only whether price broke structure.
The better question is whether the breakout deserved attention after the break.
Indicator
Volume Participation Shock Map [AGPro Series]Volume Participation Shock Map
🧠 Core Idea
Did the volume shock bring real participation, or did the move get absorbed after the first impulse?
📌 Overview / What it does
Volume Participation Shock Map is a volume-flow interpretation tool designed to study what happens after a major participation candle appears.
The script identifies high-quality volume shocks by combining relative volume, candle body participation, ATR-adjusted range expansion, and close location. It then projects the active shock zone, tracks follow-through, detects absorption risk, highlights thin continuation attempts, and summarizes the current participation state in an AG Pro panel.
It does not predict price direction, automate trades, or claim that every high-volume candle will continue. It is a structured visualization tool for reading participation quality after volume events.
🎯 Purpose & Design Philosophy
Many volume tools stop at the first spike.
This script was built to answer the next question:
Did the market continue to participate after the shock, or was the impulse absorbed?
The design goal is to help traders separate meaningful volume expansion from one-bar excitement, thin breakouts, and failed participation.
⚡ Why This Script Is Different
Most tools focus on volume spikes, climax candles, or simple high-volume alerts.
This script does NOT treat high volume as automatically bullish or bearish.
Instead, it checks whether the candle had real body participation, whether price followed through beyond the shock zone, whether the move was absorbed back through the zone, and whether later breakouts happened with weak participation.
⚙️ Methodology
1. Shock Detection
The script compares current volume with recent average volume, checks candle body share, evaluates ATR-adjusted range expansion, and scores close location.
2. Shock Zone Mapping
When a qualified shock appears, the candle range becomes an active participation shock zone.
3. Follow-Through Evaluation
After the shock, the script watches whether price accepts beyond the shock high or low with enough relative volume.
4. Absorption Evaluation
If price closes back through the shock zone after the impulse, the script can mark absorption risk.
5. Visual Output
The chart displays the active shock zone, midpoint participation rail, event labels, right-side context tags, alerts, and a compact AG Pro panel.
🗺️ How to Read the Chart
Participation Shock Zone = the active high-volume candle range being evaluated.
Participation Rail = the midpoint of the shock zone.
BULL VOLUME SHOCK = a bullish shock candle with strong volume, body participation, and range expansion.
BEAR VOLUME SHOCK = a bearish shock candle with strong volume, body participation, and range expansion.
REAL FLOW CONTINUATION = price followed through beyond the shock zone with acceptable participation.
ABSORPTION RISK = price moved back through the shock zone after the initial impulse.
THIN MOVE = price moved beyond the shock edge without enough relative volume. This appears in Detailed label mode.
Panel = summarizes participation state, quality score, shock type, relative volume, body participation, follow-through, absorption risk, and next context.
🚦 Signals & States
• BULL VOLUME SHOCK → bullish high-participation impulse appeared.
• BEAR VOLUME SHOCK → bearish high-participation impulse appeared.
• REAL FLOW UP → bullish shock followed through with acceptable participation.
• REAL FLOW DOWN → bearish shock followed through with acceptable participation.
• BULL SHOCK ABSORBED → bullish shock lost participation back through the zone.
• BEAR SHOCK ABSORBED → bearish shock lost participation back through the zone.
• SHOCK WATCH → an active shock is still being evaluated.
• QUIET FLOW → no active participation shock is currently dominant.
🔔 Alerts Logic
Alerts trigger when a major participation state appears.
• Volume Participation Shock → a high-quality volume shock appears.
• Real-Flow Continuation → price follows through beyond the active shock zone with acceptable participation.
• Absorption Risk → price closes back through the active shock zone after the shock.
• Thin Move → price moves beyond the shock edge without enough relative volume.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• Relative volume is clearly above normal
• Candle body participation is strong
• Candle range expands versus ATR
• Price closes near the directional side of the candle
• Follow-through appears before the evaluation window expires
• The panel state agrees with the chart label
If these elements do not align, the script avoids treating volume as automatic conviction.
📊 When to Use
• Breakout participation review
• Trend continuation validation
• Reversal impulse analysis
• High-volume candle interpretation
• Futures, stocks, forex, crypto, and liquid markets
• 15m, 30m, 1H, 4H, and 1D charts where volume data is meaningful
⚠️ When NOT to Use
• Symbols with unreliable or missing volume data
• Very low-liquidity markets
• Extremely noisy micro timeframes
• News spikes where volume behavior may be abnormal
• Markets where candle volume does not represent real participation well
• Situations where a single volume event should not be over-interpreted
🎛️ Key Inputs
• Relative Volume Length → defines the volume baseline.
• Shock Relative Volume → sets how strong volume must be before a shock can qualify.
• Minimum Body Participation % → controls how much candle body commitment is required.
• Minimum Range ATR → filters out small candles with high volume.
• Shock Quality Threshold → controls how selective the main shock labels are.
• Follow-Through Window → defines how long after a shock the script watches for continuation or absorption.
• Minimum Follow Relative Volume → defines whether continuation has enough participation.
• Absorption Midline Threshold % → controls how deeply price must return into the shock zone before absorption risk is marked.
• Event Label Mode → Premium focuses on major shock, continuation, and absorption events. Detailed also allows thin-move labels.
🖥️ Interface & Visual Design
The visual hierarchy is built around the active shock zone.
The zone shows the high-volume impulse range.
The midpoint rail helps judge acceptance versus absorption.
Event labels highlight the most important participation behavior.
Right-side tags keep the current shock context visible.
The AG Pro panel compresses the current state into a fast, readable decision-support summary.
🧪 Practical Usage Workflow
1. Read the panel participation state.
2. Check whether an active shock zone is present.
3. Watch whether price accepts beyond the shock high or low.
4. Evaluate whether follow-through has enough relative volume.
5. Watch for absorption back through the shock zone.
6. Confirm the chart context with structure, trend, liquidity, and risk planning.
🔍 Interpretation Guidelines
A volume shock is not automatically a valid trade signal.
Continuation is stronger when price accepts beyond the shock zone with participation.
Absorption matters when the first impulse cannot hold its zone.
Thin moves can warn that price is extending without enough participation.
The script is best used as a participation-reading layer, not as a standalone decision system.
🚫 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 entry or exit signals.
It is not a simple volume spike alert.
⚠️ Limitations & Transparency
Volume quality depends on the symbol and market.
Crypto, futures, stocks, and forex may represent volume differently.
High volatility can create sudden shock labels that need broader context.
Low-liquidity assets may produce misleading relative volume readings.
Different timeframes may show different participation behavior.
🧠 Market Context Notes
Volume can be useful only when it is read together with price behavior.
A strong candle with high volume may show participation.
But if price cannot follow through, that same candle may become an absorption reference.
This script is designed to make that difference easier to see.
🧾 Use Case Examples
If a strong bullish candle appears with high relative volume, large body participation, and range expansion, the script may mark BULL VOLUME SHOCK.
If price later closes above the shock high with enough participation, the script may mark REAL FLOW CONTINUATION.
If price closes back through the shock zone after the impulse, the script may mark ABSORPTION RISK.
If price breaks beyond the shock edge with weak relative volume, Detailed mode may mark THIN MOVE.
🧱 System Philosophy
The goal is not to make volume louder.
The goal is to make volume behavior more interpretable.
This script treats participation as a sequence:
shock → acceptance → follow-through → absorption or continuation.
🔐 Non-Promise Statement
No script can guarantee market direction.
No volume event guarantees continuation.
No absorption label guarantees reversal.
All outputs should be interpreted as analytical context.
📉 Risk Disclosure
Trading involves risk.
This script is for educational and analytical purposes only.
It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users are fully responsible for their own decisions, risk management, and trade execution.
📚 Educational Note
Use the script to study how markets behave after high-participation candles.
The most important question is not only whether volume appeared.
The better question is whether price continued to accept that participation afterward.
Indicator
Opening Auction Trap Map [AGPro Series]Opening Auction Trap Map
🧠 Core Idea
Did the opening auction accept value, reject an early extreme, or trap breakout participants?
📌 Overview / What it does
Opening Auction Trap Map is an intraday session-open analysis tool built to study the first auction window of the trading session.
The script builds an opening auction box, tracks the auction high and low, draws an acceptance rail, maps upper and lower failed-auction trap zones, and classifies whether price is accepting outside the auction or rejecting back into the range.
It does not predict price direction, automate trades, or claim that every opening trap will create a reversal. It is a structured visualization and decision-support tool for intraday auction context.
🎯 Purpose & Design Philosophy
Many opening-range tools focus only on breakout direction.
This script was built to answer a more precise auction question:
Was the opening move accepted, or did it trap traders who chased the first extreme?
The design goal is to help intraday traders read the opening range as an auction behavior map instead of treating it as a simple breakout box.
⚡ Why This Script Is Different
Most ORB tools mark the opening high and low, then wait for a breakout.
This script does NOT treat every opening breakout as valid.
Instead, it checks whether the move accepts beyond the auction edge, fails back inside the auction range, or retests a failed edge. The focus is auction behavior, trap risk, range control, and acceptance quality.
⚙️ Methodology
1. Opening Auction Window
The script tracks high, low, and midpoint during the selected opening auction window.
2. Auction Box and Rails
After the auction completes, the script projects the auction box, upper and lower trap zones, and the midpoint acceptance rail.
3. Failed-Auction Detection
If price breaks above the auction high and closes back inside the range with enough upper-wick rejection, the script can mark an upper auction trap.
If price breaks below the auction low and closes back inside the range with enough lower-wick rejection, the script can mark a lower auction trap.
4. Acceptance Evaluation
If price holds beyond the auction edge for the required number of closes, the script can mark accepted movement above or below the auction.
5. Visual Output
The chart displays the auction box, trap zones, acceptance rail, event labels, right-side tags, alerts, and a compact AG Pro panel.
🗺️ How to Read the Chart
Opening Auction Box = the high-low range created during the selected opening window.
Acceptance Rail = the midpoint of the opening auction range.
Upper Trap Zone = the area around the auction high where failed upside breakouts may be evaluated.
Lower Trap Zone = the area around the auction low where failed downside breakouts may be evaluated.
UPPER AUCTION TRAP = price failed above the auction high and closed back inside the range.
LOWER AUCTION TRAP = price failed below the auction low and closed back inside the range.
ACCEPT UP = price accepted above the auction high.
ACCEPT DOWN = price accepted below the auction low.
Panel = summarizes auction state, quality score, auction high/low, range control, trap risk, next context, session window, and timeframe scope.
TF Scope = shows whether the current chart timeframe is inside the supported auction-building range.
🚦 Signals & States
• UPPER TRAP → upside auction breakout failed back inside the range.
• LOWER TRAP → downside auction breakout failed back inside the range.
• ACCEPT UP → price accepted above the auction high.
• ACCEPT DOWN → price accepted below the auction low.
• RANGE CONTROL → price is trading inside the auction range.
• ABOVE AUCTION → price is above the auction high but not yet classified as accepted.
• BELOW AUCTION → price is below the auction low but not yet classified as accepted.
• BUILDING → the opening auction window is still forming.
🔔 Alerts Logic
Alerts trigger when a new major auction behavior state appears.
• Upper Opening Auction Trap → price failed above the auction high and closed back inside the range.
• Lower Opening Auction Trap → price failed below the auction low and closed back inside the range.
• Accepted Above Opening Auction → price accepted above the opening auction high.
• Accepted Below Opening Auction → price accepted below the opening auction low.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• The auction range is clearly formed
• Price probes an auction edge
• The close rejects back inside the range
• Wick quality is strong
• Relative volume confirms participation
• The panel state agrees with the event label
If these elements do not align, the script avoids forcing a trap interpretation.
📊 When to Use
• Intraday session-open analysis
• Opening range review
• ORB validation and failed-breakout detection
• Equity index, stock, futures, forex, and crypto session studies
• 1m, 3m, 5m, 15m, 30m, and 1H charts
• Markets where the selected opening session has meaning
⚠️ When NOT to Use
• Daily, weekly, or monthly charts
• Symbols without a meaningful session open
• Very low-liquidity assets
• Extremely noisy markets where wick behavior is unreliable
• Charts where the selected auction window does not match the actual market session
• Situations where a single opening range should not be over-interpreted
🎛️ Key Inputs
• Opening Auction Window → defines the session segment used to build the auction range.
• Active Session Window → defines the session where post-auction behavior is evaluated.
• Max Chart TF Minutes → defines the largest chart timeframe that should build the auction map. With the default 09:30-10:00 auction window, 30m and lower charts are the intended use.
• Acceptance Close Count → sets how many closes are required before a breakout is treated as accepted.
• Trap Evaluation Window → limits how long after the auction trap logic remains active.
• Trap Wick Quality Threshold → controls how strong the rejection wick must be before a trap label appears.
• Use Volume Confirmation → adds relative volume to quality scoring.
• Trap Zone Width ATR → controls the thickness of the upper and lower trap zones.
• Event Label Mode → Premium focuses on traps and accepted moves. Detailed also allows lower-priority retest labels.
• Projection Bars → controls how far the auction structure projects to the right.
🖥️ Interface & Visual Design
The visual hierarchy is built around the auction range:
The box defines the opening auction.
Trap zones frame the dangerous edges.
The midpoint rail shows range control.
Event labels mark important acceptance or failure behavior.
The AG Pro panel summarizes the current auction state without requiring the user to decode every element manually.
🧪 Practical Usage Workflow
1. Select the opening auction window that matches the market.
2. Wait until the auction box completes.
3. Watch how price behaves around the auction high and low.
4. Check whether price accepts beyond the edge or fails back inside the range.
5. Use the panel to confirm auction state, quality score, range control, and trap risk.
6. Interpret the output inside broader market context.
🔍 Interpretation Guidelines
An upper trap does not guarantee a selloff. It means the auction high was probed and rejected back inside the range.
A lower trap does not guarantee a rally. It means the auction low was probed and rejected back inside the range.
Accepted movement does not guarantee continuation. It means price has held beyond the auction edge according to the script’s rule set.
🚫 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 entry or exit signals.
It is not a standard ORB breakout strategy.
⚠️ Limitations & Transparency
Session settings matter. A poorly selected auction window can produce weak context.
Higher chart timeframes may not capture the opening auction precisely.
Low-liquidity markets may generate misleading wicks.
Gap-heavy markets may require wider interpretation.
The script is designed for intraday auction reading, not long-term chart analysis.
🧠 Market Context Notes
The opening auction is often useful because it reveals early participation, imbalance, and willingness to accept price outside the first range.
Failed extremes can matter because they show where early breakout attempts were rejected.
Acceptance can matter because it shows where the market was willing to continue trading beyond the auction edge.
🧾 Use Case Examples
If price breaks above the auction high but closes back inside the range with a strong upper wick, the script may mark UPPER AUCTION TRAP.
If price breaks below the auction low but closes back inside the range with a strong lower wick, the script may mark LOWER AUCTION TRAP.
If price closes above the auction high for the required number of bars, the script may mark ACCEPT UP.
If price closes below the auction low for the required number of bars, the script may mark ACCEPT DOWN.
🧱 System Philosophy
This script follows a behavior-first approach:
Auction first.
Edge reaction second.
Acceptance third.
Trap risk fourth.
The goal is to reduce blind breakout thinking and encourage structured opening-session interpretation.
🔐 Non-Promise Statement
No script can guarantee outcomes.
No auction edge, trap label, acceptance state, or quality score should be treated as certainty.
The output should always be interpreted with broader structure, liquidity, volatility, and personal risk rules.
📉 Risk Disclosure
Trading involves risk.
Markets can move against any interpretation.
This script is for educational and analytical purposes only.
Users are fully responsible for their own decisions.
📚 Educational Note
Use this script to study how the market behaves around the opening auction and whether early extremes are accepted or rejected.
Indicator
ATR Volatility Regime [NovaLens]Volatility regime tool built to separate two things ATR alone cannot tell you apart: where volatility currently sits in its own rolling history, and which direction the regime is rotating. Adds a velocity-gated release event on top, so the indicator flags fast coiled-spring releases on the confirmed bar - and refuses to fire on the slow leaks that only look like one.
Most volatility tools collapse one axis. A raw ATR plot tells you the bar range and nothing about whether that range is rare. A percentile-rank histogram tells you the rank but not whether vol is loading or unloading. ATR Volatility Regime separates the two by design:
Tier tracks where volatility sits in its own rolling history (Compression / Quiet / Normal / Elevated).
Phase tracks where volatility is rotating (Rising / Topping / Falling / Bottoming).
A Compression reading is not a breakout signal. It is the market saying "vol is loaded." Whether it actually releases depends on the next move. When a sustained compression actually breaks above mid-rank within a 5-bar velocity window, the indicator prints a Release diamond and pulses the pane background. Slow leaks that drift through Quiet for more than 5 bars are canceled, not reported. That single gate is what separates a real coiled-spring release from a sideways drift.
════════════════════════════════════════════
◉ HOW IT WORKS
The vol input. Wilder ATR over the chosen length, expressed as a percentage of close so the read is comparable across price levels and instruments. Mathematically guarded to stay clean across historical data gaps and unusual price series.
The percentile rank. The current ATR% is ranked against its own rolling lookback window (100 / 200 / 300 bars by Horizon). This is an asset-calibrated percentile - "P75 on BTC" means "vol higher than 75% of the last 200 BTC readings," not a market-wide cutoff. The same indicator works across SPY, BTC, EURUSD, and XAU without retuning. The raw rank drives the state engine; an EMA-smoothed copy drives the visual line so the plot reads calm without numbing event detection. Warm-up is honest: until the lookback fills, the panel shows "Warming up" and refuses to assign a tier. NA never collapses to a fake Normal.
The tier model. Four tiers cut on rawRank (P25, P50, P75) with asymmetric hysteresis: 1 confirmed bar to step up (so a vol breakout is not missed), 3 confirmed bars to step down (so a tier change only confirms when vol has actually died). The ribbon fill and oscillator line both color by tier. Extreme is a signal class, not a tier; it would flicker on and off at the P90 boundary if we colored the ribbon by it.
The phase model. Four phases (Rising / Topping / Falling / Bottoming) read off the rawRank slope. Slow rotations need 2 bars of confirmation to flip; violent moves with |delta rank| > 15 bypass the confirm and flip immediately. Peak and trough detection is plateau-aware: a strict ( greater-than on both sides) check missed the patterns where ATR percentile pins at 100 for multiple bars, so the algorithm uses greater-or-equal on the left side and greater-than on the right.
The events. Three signature events, each with its own gating:
Compression Release : velocity-gated. The Compression tier must run at least 10 bars to load the spring; on exit, rawRank must reach the mid (>= 50) within a 5-bar window. Slow leaks that drift through Quiet for more than 5 bars are canceled. Re-entering Compression also cancels the pending episode.
Extreme Touch : rawRank peaks at >= 90. Re-arm runs through a three-valve cascade (rank drop to <= 75, a higher pivot with a +2 rank headroom so a 98 peak after a 97 cannot re-fire, or 2x lookback time decay) so the same Extreme arc cannot duplicate-fire, but a genuinely higher pivot in the same arc still counts.
Cooling : armed when an Extreme fires; fires on the first confirmed bar after where rawRank falls below 75 within a 10-bar window. Disarms on fire or when the window expires. The armed-latch architecture means fast drops out of an Extreme are tracked after the Extreme event arms Cooling, instead of relying on a single fragile cross check that would miss the drop if the threshold was already crossed on the Extreme bar itself.
The Playbook Lens. Pure interpretation layer. Engine, percentile, tier, phase, and objective events are identical across lenses. The Lens recolors three visual surfaces only: the panel Playbook row text and tone, the Playbook Heatmap Strip at y = -5, and an optional Tint Price Candles by Playbook Fit overlay. Switching the Lens dropdown answers a different question against the same volatility truth: "does this regime align with the workflow I am running?" - context, never a directive.
════════════════════════════════════════════
◈ HOW TO READ IT
The pane shows the smoothed percentile rank line wrapped in a tier-colored ribbon with a Volatility Glow halo that breathes wider in the loaded zones (Compression and Extreme) and tightens in Normal. Threshold lines mark P25, P50, P75, and P90.
Deep blue (Compression): rawRank in [0, 25). Loaded spring.
Light blue (Quiet): rawRank in [25, 50). Below median, not stretched.
Gray (Normal): rawRank in [50, 75). Typical bar ranges.
Orange (Elevated): rawRank in . High vol relative to recent history.
Red (Extreme): event color, not a tier. Drives Extreme Touch markers.
Teal (Release): event color, not a tier. Drives Compression Release markers.
Markers, in order of conviction:
Compression Release (diamond on the line, Release color, with a matching pane background pulse): a >= 10 bar compression run resolved into Normal+ within 5 bars. Non-directional by design - a volatility state change, not a price direction call.
Extreme Touch (small circle anchored to the actual peak bar, Extreme color): rawRank just peaked at or above the 90th percentile of its rolling history. Reads as topping pressure of vol, not a directional reversal call.
Cooling (panel-only event, no chart marker): the first confirmed bar after an Extreme where rawRank fell back below 75 within a 10-bar window. Surfaces in the Last Event row and the Cooling alert.
The info panel synthesizes six rows: Volatility (tier + P-Score), Flow (phase), Age (bars in tier + the per-tier duration percentile so a 200-bar Quiet stretch is compared against historical Quiet stretches, not Elevated), Last Event / Context (state-based decay, no fixed timer), ATR Range (current bar range as % of price, with absolute price-unit ATR in the row tooltip), and Playbook (the Lens context read).
The Last Event row uses state-based decay , not an arbitrary 10-bar timer. A Compression Release stays visible while phase is Rising or tier is Normal+. An Extreme Touch stays visible while tier is Elevated. A Cooling read stays visible while tier is Normal or Elevated. When the event's regime context expires, the row returns to Context and summarizes the current regime instead of resizing or disappearing.
════════════════════════════════════════════
✦ HOW WE USE IT: THE COILED-SPRING ARC
This is the arc the indicator is built to catch - not the only path. Many compressions resolve sideways without a confirmed release, and the velocity gate is what filters those out.
A common pattern on a liquid index or crypto chart, Swing profile (default), Neutral lens: the line drops into Compression and parks there for 15-30 bars. The ribbon turns deep blue, the Glow widens, and the panel Age row may read something like "Mature · 22 bars" or "Extended · 22 bars" - meaning the current run has already lasted longer than most recent Compression stretches on this market. The spring is loaded.
The full arc reads in four panel updates:
Release. rawRank reaches 50+ within the 5-bar velocity window after exiting Compression. A Release diamond prints on the line, the pane background pulses teal for one bar, and the Last Event row reads "Compression Release".
Run. Within a few bars the tier transitions through Normal into Elevated, the phase row flips Rising, and the smoothed line climbs toward the upper distribution.
Touch. If the move keeps loading, rawRank peaks at 92-98 and an Extreme Touch circle prints on the peak bar - the smoothed line is now in the upper edge of its own rolling distribution. The Last Event row updates to "Extreme Touch".
Unwind. Within 10 bars rawRank falls below 75. Cooling fires and the Last Event row updates again.
The Playbook Lens reframes the same arc without changing a number. Flip to Breakout: the Heatmap Strip lights teal during the release window (favorable) and dims toward red as the move stretches into Extreme (less favorable). Flip to Mean Reversion: the strip stays red through the release (vol is the wrong direction for fading) and only lights teal when Cooling confirms and tier drifts back through Normal toward Quiet. Flip to Risk Control: Compression marks calmer bar-range context, Elevated and Extreme mark the wider-bar context. Same volatility truth, different playbook fit. The engine is identical across lenses; only the interpretation layer changes.
════════════════════════════════════════════
✦ OTHER APPLICATIONS
Breakout context : Compression Release diamonds after a loaded quiet regime, optionally combined with the Heatmap Strip reading favorable under the Breakout lens
Trend context : Rising Elevated or Rising Normal volatility as movement context for an external trend plan
Mean-reversion context : quieter or cooling regimes that may be more suitable for contained-range workflows
Volatility risk overlay : Elevated and Extreme states as wider-bar context when reviewing size, stops, or trade frequency
Vol regime classifier : use the Volatility row + Flow row in the panel as a top-down filter for any external trade plan, independent of the Lens
Alert-driven workflow : subscribe to Compression Release + Extreme Touch + Cooling and check the chart only when the volatility regime actually changes, not every bar
════════════════════════════════════════════
⚙ GETTING STARTED
ATR Volatility Regime ships with three pre-tuned Horizon profiles plus a Custom override. Pick a horizon and start reading the regime:
Intraday : ATR 14, lookback 100, smoothing 3. Faster events, lighter hysteresis (1 up / 2 down). Use on 1m through 1H charts.
Swing (default) : ATR 14, lookback 200, smoothing 5. Balanced. Start here on 1H through 1D charts.
Long-Term Hold : ATR 20, lookback 300, smoothing 5. Slower, rarer events, heavier hysteresis (2 up / 3 down). Use on 1D and above.
Custom : full manual control of ATR Period, Lookback Window, and Smoothing.
Core settings:
Horizon : selects the tuning bundle above. Start with Swing.
ATR Period (Custom) : Wilder ATR period for the volatility input, in BARS. 14 is the standard. Shorter = more reactive; longer = smoother. Applies only when Horizon = Custom.
Lookback Window (Custom) : rolling lookback the ATR% is percentile-ranked against. Larger = smoother distribution, fewer extreme reads, slower compression releases. Smaller = sharper, more events.
Smoothing (EMA) (Custom) : EMA bars applied to the percentile-rank for the visual DISPLAY layer (plot, ribbon, panel readouts). The RAW rank still drives tier, phase, and events - smoothing only calms the visual. Set to 1 to disable smoothing.
Playbook Lens:
Neutral (default) : factual regime read, heatmap stays gray. Use this to learn the engine.
Breakout : range-expansion context. Loaded Compression and Compression Release read favorable; already-stretched Elevated or Extreme states shift toward caution.
Trend : directional-movement context. Rising Elevated and Rising Normal regimes read favorable; topping or cooling volatility shifts toward caution.
Mean Reversion : contained-range context. Quiet, Cooling, and Normal/Falling regimes read favorable; Release, Elevated, and Extreme regimes shift toward caution.
Risk Control : stretched-volatility context. Compression reads calm; Elevated and Extreme states warn that bar ranges are wide.
The Lens NEVER changes the engine - same tier, same phase, same Compression Release, same Extreme Touch, same alerts. Only the panel Playbook row text, the Heatmap Strip color, and the optional candle tint move.
Display:
Show Compression Releases (hero): diamond on the line + pane background pulse on release. On by default.
Show Extreme Touches : circle on the peak bar at rawRank >= 90. On by default.
Show Price Chart Markers : mirrors Compression Release diamonds and Extreme bar tints onto the price chart. OFF by default to keep the price chart clean.
Show Raw Rank Line : faint unsmoothed percentile rank line behind the smoothed display line. OFF by default. Toggle on to debug fast vol changes.
Show Volatility Glow : halo that widens at the loaded extremes (Compression and Extreme) and tightens in Normal. On by default.
Show Info Panel : 6-row state panel. On by default.
Panel Position : Top Right (default), Top Left, Bottom Right, Bottom Left, Middle Right.
Theme : Auto (detect chart background), Dark, or Light.
Show Playbook Heatmap Strip : thick band at y = -5 that recolors with the Lens. On by default.
Tint Price Candles by Playbook Fit : paints price-chart candles with the Release / Extreme palette per the active Lens. OFF by default; disabled automatically when Lens = Neutral.
Appearance / Palette (6 color pickers):
Compression, Quiet, Normal, Elevated, Extreme, Release - each on its own line with a state-explainer tooltip. The Display Rank line, Raw Rank, Tier Ribbon fill, Volatility Glow, Heatmap Strip, panel tier text, candle tints, and event markers all reference these inputs so users can adapt the palette (color-blind, light-mode, brand themes) without forking the script.
════════════════════════════════════════════
△ LIMITATIONS
Warm-up : the lookback window must fill before any tier is assigned. On Swing (200) that is 200 bars; on Long-Term Hold (300) that is 300. Until then, the panel shows "Warming up" and the state engine refuses to fake a Normal read.
Visual smoothing lag : the visible line is intentionally calmer than the raw engine. ATR is a backward-looking Wilder-smoothed measure, and the display line is lightly EMA-smoothed on top, so fast volatility expansions can look slightly delayed in the visible plot. The rawRank engine is the sharper layer underneath and is what actually drives the tier, phase, events, and alerts. The smoothed line is the readable copy; do not read a slight visual delay as the event engine being slow.
Percentile is relative, not absolute : a "Compression" read on a chronically quiet asset can still be wider than an "Elevated" read on a chronically loud asset. The indicator compares each asset against ITS OWN history, not across markets.
Regime shifts shrink the window : a structural vol regime change (e.g. a quiet 2-year period followed by a sustained higher-vol regime) takes about one lookback window to fully recalibrate. The first few weeks after a regime shift can read noisier than the steady-state.
Compression Release is non-directional : the diamond and the pane pulse tell you the spring released, not which way price went. Combine with directional context (trend, structure, or a separate momentum tool) for direction.
Extreme Touch is a state read, not a reversal call : rawRank pinning above 90 means vol is rare for this market; it does not mean price is about to reverse. Cooling tells you the unwind has begun, not where the next leg goes.
Playbook Lens is interpretation, not validation : the Heatmap Strip recolors regime context based on the active Lens. It is not a backtested edge - it is a quick visual answer to "does my workflow want this regime?"
════════════════════════════════════════════
🔔 ALERTS
Four alert conditions are built in so you can monitor without checking every bar manually:
Compression Release : a sustained compression (>= 10 bars) confirmed above mid-rank within 5 bars. The hero event.
Extreme Touch : rawRank peaked above P90. Fires on the bar after the actual peak (peak detection requires the next bar to confirm the turn-down).
Cooling : the first confirmed bar after an Extreme where rawRank falls below 75 within 10 bars.
Compression Entry : rawRank dropped below P25 (sustained tier transition into Compression).
All four alerts fire on bar close (gated on barstate.isconfirmed). Each alert message is a pure JSON payload with ticker, price, timeframe, and timestamp fields for webhook routing.
Four alerts by design - concentrated on the signature events. Tier and phase transitions stay visible in the info panel for users who want them on the chart, but they do not fire alerts. Keeping the alert stream lean is what makes "subscribe and let the regime come to you" a useful workflow instead of a notification flood.
════════════════════════════════════════════
⌁ NOTES
Based on the classical ATR percentile-rank construction, with asymmetric hysteresis and a velocity-gated compression-release definition layered on top.
Repaint: intrabar-only. Closed-bar alerts are confirmed; current-bar visuals may update until the bar closes. All alert conditions are gated on barstate.isconfirmed. Peak-confirmed events (Extreme Touch) print on the bar AFTER the actual peak, on a one-bar offset, so the marker aligns with the true peak bar.
References: J. Welles Wilder Jr., New Concepts in Technical Trading Systems (1978), Trend Research; percentile-rank concept widely used across volatility studies.
Open-source under MPL 2.0. Free to use, fork, study.
NovaLens Indicator
Previous Day High/Low Breakout IndicatorPrevious Day High/Low Breakout Indicator
This indicator is built around a simple breakout concept:
• Bullish momentum is assumed when price closes above the Previous Day High (PDH)
• Bearish momentum is assumed when price closes below the Previous Day Low (PDL)
The script continuously tracks the previous session’s high and low levels and uses them as directional breakout triggers.
Unlike indicators that rely on multiple lagging filters, this approach focuses primarily on raw price action and market expansion beyond key reference levels.
━━━━━━━━━━━━━━━━━━
CORE LOGIC
Previous Day Range Detection
The script calculates:
• Previous Day High (PDH)
• Previous Day Low (PDL)
using the selected session settings.
These levels remain active until a new session completes and fresh PDH/PDL levels become available.
━━━━━━━━━━━━━━━━━━
LONG LOGIC
A BUY signal is generated when:
• Price closes above the Previous Day High
This indicates that price has broken beyond the prior session’s upper boundary, suggesting possible bullish continuation or expansion.
If an active short position exists internally, the script first generates a SELL EXIT signal before flipping to a BUY signal.
━━━━━━━━━━━━━━━━━━
SHORT LOGIC
A SELL signal is generated when:
• Price closes below the Previous Day Low
This indicates that price has broken beneath the prior session’s lower boundary, suggesting possible bearish continuation or downside expansion.
If an active long position exists internally, the script first generates a BUY EXIT signal before flipping to a SELL signal.
━━━━━━━━━━━━━━━━━━
EXIT LOGIC
The indicator uses an opposite-breakout exit model.
Long Exit
A BUY EXIT signal occurs when:
• A valid bearish breakout appears while a long state is active
Short Exit
A SELL EXIT signal occurs when:
• A valid bullish breakout appears while a short state is active
This creates a continuous flip-based structure where the market remains either:
• Bullish
• Bearish
• Neutral
depending on the latest breakout condition.
━━━━━━━━━━━━━━━━━━
MARKET COMPATIBILITY
This indicator is primarily designed for continuous 24-hour markets such as cryptocurrencies, where Previous Day High and Low levels often act as important breakout reference zones.
However, it can also be used on other markets such as:
• Indices
• Stocks
• Forex
• Futures
with appropriate session selection and trader discretion.
━━━━━━━━━━━━━━━━━━
FLOATING RUNNING P/L LABEL
While a trade state is active, the script displays a floating running P/L label on the chart.
The label updates dynamically and shows:
• Current trade direction
• Live unrealized percentage gain/loss
The label’s:
• Colors
• Position offset
• Visibility
can all be customized from settings.
━━━━━━━━━━━━━━━━━━
BACKTEST WINDOW
The indicator includes an optional custom backtest window.
When enabled:
• Signals
• Statistics
• Performance calculations
are restricted only to the selected date range.
This helps isolate specific market conditions or testing periods without affecting the rest of the chart.
━━━━━━━━━━━━━━━━━━
STATISTICS TABLE
A compact statistics table is included for quick performance reference.
The table displays:
• Total Trades
• Wins / Losses
• Win Rate %
• Average Win %
• Average Loss %
The table position and colors are fully customizable from settings.
━━━━━━━━━━━━━━━━━━
NOTES
• This script is an indicator, not a PulseWire strategy.
• Statistics are internally calculated and intended for analytical reference only.
• Performance can vary significantly across assets, sessions, and timeframes.
• Always combine breakout systems with proper risk management and market context analysis.
━━━━━━━━━━━━━━━━━━
DISCLAIMER
This indicator is provided for educational and informational purposes only and should not be considered financial advice.
Trading involves substantial risk, and past performance does not guarantee future results. Always perform your own research, test strategies thoroughly, and use appropriate risk management before trading with real capital. Indicator
Indicator
Body Close Break Planner [AGPro Series]TITLE
Body Close Break Planner
🧠 Core Idea
Did price break structure with real body-close acceptance, or was the move only a wick event with weak commitment?
📌 Overview / What it does
Body Close Break Planner is built to evaluate whether a structure break is being accepted with real candle-body commitment. Instead of reacting to every wick beyond a prior high or low, the script focuses on closes that actually establish acceptance beyond the rail.
The script maps the body break rail, an acceptance pocket, a retest shelf, a failure rail, and a first target-room reference. It also adds event labels, right-side tags, and a compact AG Pro panel that summarizes the quality of the active break with a 0-100 Body Break Score.
This script does not predict trend continuation, automate entries, or treat every breakout as valid. It is a rule-based analytical and visualization tool that helps users separate real body-close structure acceptance from weaker noise-driven break attempts.
🎯 Purpose & Design Philosophy
This script was built to solve a very common structural problem: many breakout candles look convincing in the moment, but the move fails because the market never achieved real closing acceptance beyond the level.
The tool was designed for traders who want to evaluate whether a break has genuine body-based commitment, whether the first retest is constructive, and where the structure fails if acceptance is lost.
The mindset behind the script is selective, disciplined, and evidence-based. It supports traders who want to read acceptance quality rather than react to every temporary excursion beyond a level.
⚡ Why This Script Is Different
Most breakout tools focus on level crossing, wick penetration, or generic break-and-retest behavior.
This script does NOT treat every breach of structure as a meaningful breakout.
Instead, it asks whether the move closed through structure with enough body commitment, whether price is still being accepted beyond the rail, whether the retest shelf improves the setup, and whether the move still has room before it becomes extended or fails.
⚙️ Methodology
1. Context Detection
The script maps recent structure highs and lows, then checks whether price closes beyond them with enough candle-body commitment and range expansion.
2. Reference Mapping
Once a valid body-close break is confirmed, the script locks the broken rail, builds an acceptance pocket, marks a retest shelf, and defines a failure line plus a first target-room reference.
3. Reaction Evaluation
Price is then reviewed against the body-break rail and the retest shelf. The script checks whether the move is still accepted, whether the retest improves the structure, or whether the breakout falls back through the failure boundary.
4. Visual Output
The final output includes the acceptance pocket, body-break rail, retest shelf, failure rail, room line, event labels, right-side tags, and dashboard panel.
🗺️ How to Read the Chart
Zones:
The acceptance pocket represents the active post-break area where structure acceptance is being judged.
Labels:
Labels identify new bullish or bearish body-close breaks, accepted structure, retest-ready behavior, target review, and failed breaks.
Colors:
Teal represents stronger constructive break behavior.
Pink represents bearish or failed context.
Gold represents review areas such as target-room interaction.
Indigo represents the main body-break rail.
Panel:
The panel summarizes the active break type, the Body Break Score, current acceptance quality, available room, and the current action state.
🚦 Signals & States
• Bull Break → A bullish body-close structure break has been detected.
• Bear Break → A bearish body-close structure break has been detected.
• Body Accepted → Price is still being accepted beyond the broken structure rail.
• Retest Ready → Price interacted with the retest shelf constructively and the setup quality improved.
• Target Review → The first projected room reference has been reached and context should be reassessed.
• Failed → Price moved back through the failure boundary and the break is no longer structurally clean.
• Wait Break → No valid active body-close break exists.
• Expired → The break is too old to remain active within the current framework.
🔔 Alerts Logic
Alerts can trigger when a new bullish or bearish body-close break is detected, when structure remains accepted, when a retest shelf strengthens the setup, when target room is reached, or when the break fails.
Alerts are attention markers only. They highlight structural events inside the script logic. They are not trade instructions, automated entries, or guarantees of follow-through.
🧩 Confluence Logic
The context becomes stronger when multiple conditions align together.
For example, a structure break with a strong body ratio, clean range expansion, stable hold beyond the break rail, and a constructive retest shelf interaction is much stronger than a shallow close that immediately falls back into the old range.
When body commitment, breakout range, retest quality, and available room align together, the context becomes structurally more reliable.
📊 When to Use
• Breakout or breakdown environments where close quality matters
• Markets with clean price structure and readable swing levels
• Crypto, forex, indices, and liquid stocks
• 1H, 4H, and 1D chart review
• Situations where wick-only breaks create repeated false positives
⚠️ When NOT to Use
• Illiquid markets with distorted price prints
• Extremely noisy sessions with poor candle quality
• Very low-range environments where closes carry little structural information
• Symbols dominated by gaps or erratic price jumps
• Conditions where the market repeatedly overshoots levels without clean follow-through
🎛️ Key Inputs
• Structure Lookback → Controls how recent highs and lows are mapped
• Minimum Range Ratio → Controls how much expansion is required before a break qualifies
• Minimum Body / Range → Filters out weak closes and wick-dominant candles
• Close Buffer ATR → Controls how far beyond structure the close must finish
• Acceptance Pocket ATR → Controls the depth of the post-break pocket
• Retest Shelf Buffer → Controls how shelf interactions are interpreted
• Failure Buffer ATR → Controls where the active break becomes invalid
• Visual Settings → Control labels, panel location, theme, font size, and optional chart styling
🖥️ Interface & Visual Design
The interface is designed to answer one question quickly: is this break actually being accepted?
The panel creates a clean information hierarchy so the user can understand break state, score, room, and current action without reading every chart element manually. The chart layer keeps the acceptance pocket, body-break rail, failure line, and room reference readable without overwhelming candles.
The visual intent is professional, premium, and publication-friendly rather than decorative.
🧪 Practical Usage Workflow
1. Read the panel to confirm whether a valid body-close break is active
2. Check the body-break rail and acceptance pocket
3. Evaluate whether price is simply holding or whether the retest shelf improved the structure
4. Review room to the target reference and distance to failure
5. Use labels and tags as context markers, not as direct commands
🔍 Interpretation Guidelines
A stronger score suggests better body commitment, healthier range expansion, and more reliable post-break structure.
A Body Accepted state means price is still holding beyond the broken rail, but it does not automatically mean the move is early or low-risk.
A Retest Ready state suggests the market pulled back in a controlled way and defended the structure more convincingly.
A Target Review state suggests that the first projected room objective has already been reached and the context should be reassessed rather than assumed to continue indefinitely.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an automated trading system.
This script does not place orders.
This script does not guarantee continuation, retest success, target reach, or profitability.
⚠️ Limitations & Transparency
This script is rule-based and depends on the quality of the underlying market structure.
Different timeframes can produce very different break quality profiles. In high-volatility or low-liquidity conditions, candle closes may appear meaningful while still failing quickly. In some markets, wick behavior may remain important even when the body-close break model is intentionally strict.
Outputs should always be interpreted within broader market context rather than in isolation.
🧠 Market Context Notes
Body-close acceptance often matters most around obvious swing highs, swing lows, range edges, and post-compression expansion points.
A wick beyond structure can attract attention, but a true close beyond structure often tells a more reliable story about commitment. Even so, not every accepted break becomes a trend. Some become retest traps, and some run directly into higher-timeframe resistance or support.
🧾 Use Case Examples
Example 1:
Price closes above a well-defined swing high with a strong body and good expansion. The script marks a bull break, builds the acceptance pocket, and later upgrades the context when the retest shelf holds.
Example 2:
Price breaks below a swing low with body commitment, but then quickly closes back through the failure boundary. The script marks the break as failed, signaling that the downside acceptance did not hold.
Example 3:
A strong body-close break remains accepted and quickly reaches the first target-room line. The script marks target review, reminding the user to reassess efficiency and extension.
🧱 System Philosophy
AGPro Series tools are built as decision-support frameworks, not generic signal generators.
The philosophy here is to reward quality over noise: stronger closes, cleaner acceptance, clearer structure, and more readable post-break behavior.
🔐 Non-Promise Statement
This script does not promise certainty.
It does not promise that a body-close break will continue, hold, retest cleanly, or reach its projected room. It only organizes the structure so the user can evaluate the break with more discipline and clarity.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly, and any analytical tool can become less reliable under shifting volatility, liquidity, or structural conditions. Users remain fully responsible for their own decisions, execution, and risk management.
This script is for educational and analytical purposes only. It does not provide financial advice.
📚 Educational Note
This tool is most effective when combined with broader market structure, liquidity awareness, and disciplined trade management.
It is designed to improve interpretation quality, not to replace critical thinking.
Indicator
Breakout Base Defense Planner [AGPro Series]Breakout Base Defense Planner
🧠 Core Idea
After a breakout, is the original base being defended or is price losing control back into the base?
📌 Overview / What it does
Breakout Base Defense Planner maps the structure price broke from and tracks whether the broken base edge is being defended.
The script displays the breakout base, a projected base defense zone, defense rail, failure shelf, room reference, defense labels, pressure labels, invalidation labels, right-side tags, and a compact AG Pro dashboard.
It does not predict that a breakout will continue. It helps organize the post-breakout base context: defense score, pressure, room, failure risk, and action state.
🎯 Purpose & Design Philosophy
Many breakout tools focus on the breakout candle or the first follow-through move.
This script was built for a different question: does the original base still matter after the breakout?
It helps traders separate clean base defense from weak breaks that fall back into the structure they came from.
⚡ Why This Script Is Different
Most breakout indicators highlight breakouts or target projections.
This script does NOT build a full R ladder, position planner, or generic breakout continuation system.
Instead, it focuses on the broken base itself: the base box, defense zone, pressure behavior, failure shelf, target room reference, and clear action state.
⚙️ Methodology
1. Base Detection
The script defines a recent base using completed bars and filters it by ATR-based width.
2. Breakout Lock
When price closes beyond the base edge with enough displacement and participation, the base is locked as the active reference.
3. Defense Evaluation
The broken base edge becomes a defense zone. The script checks whether price holds, pressures, or loses that zone.
4. Visual Output
The chart receives a breakout base box, defense zone, defense rail, failure shelf, room rail, labels, right-side tags, optional bar coloring, and a dashboard panel.
🗺️ How to Read the Chart
The breakout base shows the structure price broke from.
The defense zone marks the broken edge that should act as support in bullish breaks or resistance in bearish breaks.
The failure shelf marks where the base defense context fails.
The room rail marks the nearest swing-room reference beyond the breakout direction.
Labels highlight base lock, base defended, defense pressure, room tests, and base lost events.
Colors represent context:
• Teal → bullish base defense
• Pink → bearish base defense or invalidation
• Gold → room reference or waiting context
• Indigo → pressure or monitoring context
The panel summarizes:
• Base
• Defense Score
• Pressure
• Room
• Action
🚦 Signals & States
• Bull Base Breakout → price closed above the base with acceptable quality
• Bear Base Breakout → price closed below the base with acceptable quality
• Base Defended → price tested the broken edge and closed back in the breakout direction
• Defense Pressure → price is testing the defense zone without a clean hold
• Room Test → price reached the active room reference
• Base Lost → price closed beyond the failure shelf
• READY → base defense quality is strong enough to monitor
• MONITOR → price is actively testing the base defense zone
• WAIT → no strong active context exists
• INVALIDATED → the base defense context failed
• EXPIRED → the locked base is too old to remain active
🔔 Alerts Logic
Alerts can trigger when a breakout base is locked, when the base is defended, when READY state appears, when defense pressure appears, when the room rail is reached, or when the base is lost.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The base defense context becomes stronger when the breakout base is well-sized, the breakout close has quality, the defense zone holds, participation is acceptable, and target room remains available.
When base defense and room align, the structure is cleaner. When price presses through the defense zone toward the failure shelf, the context weakens.
📊 When to Use
• After clear breakout moves
• During breakout retests
• When price returns to a broken range edge
• In trending markets where base defense matters
• On liquid symbols with readable structure and volume
• On 4h and 1D charts where base boxes remain visually clear
⚠️ When NOT to Use
• Very low-liquidity markets
• Extremely noisy sideways ranges
• Breakouts without a meaningful base
• News candles with unstable spreads
• Late moves where the base is already too far away to matter
🎛️ Key Inputs
• Base Lookback Bars → controls how the breakout base is detected
• Minimum / Maximum Base Range ATR → filters bases that are too small or too large
• Break Buffer ATR → controls how far beyond the base price must close
• Minimum Break Body Ratio → filters weak wick-only breaks
• Minimum Relative Volume → filters low-participation breaks
• Defense Zone ATR → controls the defended zone around the broken edge
• Failure Buffer ATR → controls where base defense fails
• Target Room Lookback → controls the nearest swing-room reference
• Visual settings → control boxes, rails, labels, tags, panel, and bar colors
🖥️ Interface & Visual Design
The visual design is built around the original base.
The base box provides context, the defense zone shows the key retest area, the failure shelf defines where the idea weakens, and the panel compresses the state into a quick decision-support read.
The goal is a premium, structured chart that feels like a breakout defense map, not a crowded signal board.
🧪 Practical Usage Workflow
1. Check whether a breakout base is active
2. Read the defense score and action state
3. Inspect the defense zone
4. Compare pressure with room
5. Watch the failure shelf for invalidation
6. Confirm the context with broader market structure
🔍 Interpretation Guidelines
A READY state means the base defense context has enough structure to monitor.
Defense pressure means price is testing the broken base edge and the context needs attention.
Base defended means price reacted at the edge, but it does not guarantee continuation.
Room measures available structure beyond the current price, not a promised target.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a guaranteed breakout system.
It is not an R-ladder tool.
It is not a position sizing tool.
It is not an automated trading tool.
It does not provide financial advice.
It does not guarantee continuation, reversal, profit, or a specific target.
⚠️ Limitations & Transparency
Breakout base behavior depends on market structure, volatility, liquidity, timeframe, and participation.
Some defended bases may later fail.
Some failed bases may reclaim again later.
The score is a rule-based context score, not a certainty model.
🧠 Market Context Notes
Breakout bases often become important memory zones.
When price breaks out and later defends the original edge, the structure can remain organized.
When price falls back through the edge and failure shelf, the breakout context becomes weaker.
🧾 Use Case Examples
When price breaks above a recent base, the script locks the base and projects a defense zone around the broken edge.
If price returns to the defense zone and closes back above the edge, the script can mark base defense.
If price closes through the failure shelf, the script marks the base as lost.
🧱 System Philosophy
This script follows the AGPro Series approach: turn one important market structure question into a focused decision-support map.
The focus is not prediction. The focus is base context, defense quality, pressure awareness, failure logic, and visual clarity.
🔐 Non-Promise Statement
No script can remove uncertainty from markets.
This tool does not promise accuracy, profitability, or future price movement.
Its purpose is to organize breakout base defense context so the user can interpret the chart more clearly.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly, and any analytical output can fail.
Users are responsible for their own decisions, risk management, and trade execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
A breakout is not complete just because price leaves a base.
The quality of the first base defense can often provide more useful context than the breakout candle alone.
Indicator
Post-Breakout Risk Ladder [AGPro Series]Post-Breakout Risk Ladder
🧠 Core Idea
After a breakout happens, is the move still offering clean target room or is pullback risk taking control?
📌 Overview / What it does
Post-Breakout Risk Ladder maps a breakout base, locks the breakout edge, and converts the post-breakout move into a structured R-based risk ladder.
The script displays a breakout base, pullback risk shelf, entry rail, invalidation rail, 1R / 2R / 3R target rails, target defense labels, pullback test labels, and a compact AG Pro dashboard.
It does not predict that a breakout will continue. It helps organize what happens after a breakout: current R, pullback risk, target room, invalidation, and action state.
🎯 Purpose & Design Philosophy
Many breakout tools focus only on the breakout candle.
This script was built for the part that comes next: the risk management phase after the breakout is already visible.
It helps traders read whether the breakout is still structured, whether the pullback is healthy, whether the next target has room, and whether the breakout context has failed.
⚡ Why This Script Is Different
Most breakout indicators highlight the break itself.
This script does NOT treat the breakout as the end of the analysis.
Instead, it builds a post-breakout planning map with a base, entry reference, invalidation shelf, R ladder, pullback risk score, target room, and target defense context.
⚙️ Methodology
1. Breakout Base Detection
The script defines a recent base using completed bars and checks whether price closes beyond the base edge with enough displacement quality.
2. Breakout Lock
When the breakout qualifies, the script locks the base high/low, breakout edge, entry reference, and invalidation edge.
3. Risk Ladder Mapping
Risk is standardized into R units from the breakout entry to invalidation. Target rails are projected as 1R, 2R, and 3R references.
4. Pullback and Defense Evaluation
The script tracks pullback tests into the breakout shelf, current R, target room, and target defense behavior.
🗺️ How to Read the Chart
The breakout base shows the structure that price broke from.
The pullback shelf marks the zone where a retest may remain constructive or become risky.
The entry rail and invalidation rail define the R unit.
The 1R, 2R, and 3R rails show post-breakout target references.
Labels highlight breakout locks, pullback tests, target defense, and invalidation.
The panel summarizes:
• Breakout state
• Current R
• Pullback risk
• Target room
• Action state
🚦 Signals & States
• Bull Breakout → price closed above the breakout base with acceptable quality
• Bear Breakout → price closed below the breakout base with acceptable quality
• Pullback Test → price is testing the post-breakout shelf
• Target Defense → price has reached or interacted with an R target rail
• Invalidated → price lost the active breakout structure
• Expired → the breakout ladder is too old to remain active
🔔 Alerts Logic
Alerts can trigger when a breakout ladder is locked, when the breakout context is READY, when price tests the pullback shelf, when the ladder invalidates, or when target defense appears.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The breakout context becomes stronger when base quality, breakout body strength, relative volume, pullback shelf behavior, and target room align.
The R ladder helps separate structured continuation from late or overextended movement.
📊 When to Use
• After clear range breaks
• During breakout retests
• In trending markets with continuation attempts
• When evaluating post-breakout risk-to-room structure
• On liquid symbols with readable candles and volume
⚠️ When NOT to Use
• Very low-liquidity markets
• Extremely noisy sideways ranges
• Random spike candles without structure
• News candles with unstable spreads
• When no meaningful base exists before the breakout
🎛️ Key Inputs
• Base Lookback Bars → controls how the breakout base is detected
• Break Buffer ATR → controls how far beyond the base price must close
• Minimum Break Body Ratio → filters weak wick-only breaks
• Minimum Relative Volume → filters low-participation breaks
• Retest Shelf ATR → controls the pullback shelf around the broken edge
• Invalidation Buffer ATR → controls where the ladder fails
• Target R Settings → control the 1R / 2R / 3R ladder rails
🖥️ Interface & Visual Design
The visual hierarchy is designed around post-breakout planning.
The base defines context, the shelf defines pullback risk, the rails define R structure, and the panel provides a quick state read.
The goal is to keep the chart useful, structured, and premium without turning it into a cluttered signal board.
🧪 Practical Usage Workflow
1. Check whether a breakout ladder is active
2. Read current R in the panel
3. Inspect the pullback shelf
4. Compare target room with pullback risk
5. Watch invalidation and target defense labels
🔍 Interpretation Guidelines
A READY state means the breakout ladder has enough structure to monitor.
Current R helps measure how far price has moved from the breakout reference.
Pullback risk helps evaluate whether price is still respecting the breakout shelf.
Target room helps avoid treating late moves the same as early moves.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a guaranteed breakout system.
It is not an automated trading tool.
It does not provide financial advice.
It does not guarantee continuation, reversal, targets, or profit.
⚠️ Limitations & Transparency
Breakout quality depends on market structure, volatility, liquidity, and timeframe.
Some breakouts may fail quickly.
Some slow breakouts may not trigger if candle quality or volume is too weak.
R levels are planning references, not guaranteed destinations.
🧠 Market Context Notes
Breakouts are often strongest when structure, participation, and follow-through align.
A breakout with clean target room and controlled pullback risk is different from a late breakout already pressing into extension.
Use the ladder as context, not certainty.
🧾 Use Case Examples
When price breaks above a recent base, the script locks the breakout edge and projects 1R / 2R / 3R references.
If price later pulls back into the shelf, the script marks pullback risk so the user can evaluate whether the structure remains intact.
If price reaches a target rail, target defense labels help identify where the move may need confirmation.
🧱 System Philosophy
AGPro Series tools are built as decision-support engines.
The purpose is to organize market behavior into structure, score, state, and risk context rather than providing blind buy or sell calls.
🔐 Non-Promise Statement
No breakout is certain.
No target rail is guaranteed.
No script can remove risk.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, decisions, risk management, and execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use this tool to study how breakout bases, retests, invalidation, current R, and target room interact across different markets and timeframes.
Indicator
Supply Demand Flip Planner [AGPro Series]Supply Demand Flip Planner
🧠 Core Idea
Has an old supply or demand zone changed role and started acting as the opposite side of the market?
📌 Overview / What it does
Supply Demand Flip Planner is a role-change price action tool designed to identify when a prior supply zone turns into demand, or when a prior demand zone turns into supply.
The script detects pivot-based supply and demand zones, monitors breaks through those zones, maps the active flip zone, evaluates retest acceptance, and displays a structured 0-100 score. It also shows invalidation shelves, target rails, centered zone text, labels, and a compact AG Pro dashboard.
It does not predict future price movement, automate trades, or provide guaranteed buy/sell signals. It is a visual decision-support framework for reading supply-demand flip behavior.
🎯 Purpose & Design Philosophy
This script was built for traders who watch support/resistance role reversal but want a cleaner way to separate meaningful flips from ordinary breaks.
Many zones break and never matter again. Some zones break, retest, and start acting as the opposite side of the market. This planner focuses on that role-change moment.
The design supports a structured workflow: map supply and demand, wait for break, monitor retest, evaluate acceptance, then track invalidation.
⚡ Why This Script Is Different
Most supply and demand tools draw zones and leave interpretation fully manual.
This script does NOT simply flood the chart with historical zones.
Instead, it focuses on the active role-change zone, measures retest quality, scores acceptance, and presents the result through a clear READY / MONITOR / WAIT / INVALIDATED framework.
⚙️ Methodology
1. Context Detection
The script detects pivot-based supply and demand zones using configurable left/right pivot confirmation.
2. Reference Mapping
It maps source supply and demand shelves, then converts a broken zone into an active flip zone.
3. Reaction Evaluation
When price retests the flip zone, the script evaluates break strength, retest depth, wick response, body quality, source-zone quality, freshness, and relative volume.
4. Visual Output
The active flip zone is shown with centered text, invalidation shelf, target rails, right-side tags, labels, and an AG Pro panel.
🗺️ How to Read the Chart
Supply zones represent pivot-based resistance shelves.
Demand zones represent pivot-based support shelves.
Demand Flip means old supply has been broken and is being evaluated as new demand.
Supply Flip means old demand has been broken and is being evaluated as new supply.
READY FLIP labels mark retests that pass the selected acceptance score.
Invalidation shelf marks where the flip context weakens or fails.
The AG Pro panel summarizes Flip State, Acceptance, Retest, Failure Risk, and Action.
🚦 Signals & States
• DEMAND → pivot-based demand zone mapped.
• SUPPLY → pivot-based supply zone mapped.
• DEMAND FLIP → old supply was broken and is being watched as new demand.
• SUPPLY FLIP → old demand was broken and is being watched as new supply.
• FLIP RETEST → price is interacting with the active flip zone.
• READY FLIP → retest acceptance reached the required score threshold.
• INVALIDATED → the active flip lost its invalidation edge.
• READY → qualified flip acceptance is active.
• MONITOR → the flip zone is active or retesting.
• WAIT → no qualified flip acceptance is active.
🔔 Alerts Logic
Demand Flip Locked triggers when price breaks above a prior supply zone.
Supply Flip Locked triggers when price breaks below a prior demand zone.
Demand Flip Acceptance Ready triggers when a bullish flip retest reaches the score threshold.
Supply Flip Acceptance Ready triggers when a bearish flip retest reaches the score threshold.
Supply Demand Flip Retest triggers when price interacts with the active flip zone.
Supply Demand Flip Invalidated triggers when the flip loses its invalidation shelf.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest flip contexts appear when break strength, retest depth, wick response, close quality, source-zone quality, freshness, and relative volume align.
When a broken zone is retested cleanly and accepted from the opposite side, the score improves and the panel shifts toward a stronger action state.
📊 When to Use
• Support/resistance role reversal
• Breakout retests
• Trend continuation after zone breaks
• Failed range boundaries that become new reaction zones
• Markets with clear swing structure
⚠️ When NOT to Use
• Extremely noisy markets with weak pivot structure
• Very low liquidity symbols
• Markets with large spread or unreliable candles
• News spikes where zones break and fail too quickly
• Timeframes where pivot zones are too dense or too sparse
🎛️ Key Inputs
• Pivot Left / Right Bars → control how strict the source zone detection is.
• Zone Depth ATR → controls the thickness of supply and demand shelves.
• Break Buffer ATR → requires price to break beyond the source zone by a volatility-adjusted amount.
• Retest Window Bars → controls how long the flip remains relevant.
• Acceptance Buffer ATR → defines how much confirmation is required after retest.
• Invalidation Buffer ATR → controls the failure shelf beyond the flip zone.
• Minimum Ready Score → sets how strict READY labels should be.
• Visual Settings → control zones, labels, centered zone text, target rails, and right-side tags.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is designed to make role-change structure readable without overwhelming the chart.
The active flip zone uses centered text so the purpose of the zone is immediately visible. Source zones are subtle, while READY labels and target rails stand out only when a valid acceptance context appears.
The panel gives a quick summary of the current flip state and risk context.
🧪 Practical Usage Workflow
1. Identify the latest supply and demand zones.
2. Wait for a zone to break and become a flip candidate.
3. Watch for retest interaction inside the flip zone.
4. Check the READY FLIP label and acceptance score.
5. Compare price with invalidation shelf and target rails.
6. Confirm broader trend, volatility, and liquidity before making decisions.
🔍 Interpretation Guidelines
A high acceptance score means the role-change reaction is cleaner according to the script's rules.
A pending retest means price has returned to the zone but has not yet shown enough acceptance.
A failed flip means price lost the invalidation edge and the role-change context should be treated as weakened.
🚫 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 guarantee entries, exits, profits, or outcomes.
⚠️ Limitations & Transparency
Pivot-based zones are confirmed after the selected right-side bars, so source zones appear after confirmation.
Different timeframes can create very different supply and demand structures.
High volatility can cause quick break-and-fail behavior around zones.
No rule-based script can fully account for news, liquidity shocks, or sudden market structure changes.
🧠 Market Context Notes
Supply-demand flips are a form of role reversal.
Old resistance can become new support after acceptance. Old support can become new resistance after acceptance.
The script is strongest when used with broader market structure, trend context, liquidity, and volatility analysis.
🧾 Use Case Examples
When price breaks above a supply zone, returns to the zone, and holds above it with clean reaction quality, the script may mark a Demand Flip acceptance.
When price breaks below a demand zone, retests it from below, and rejects cleanly, the script may mark a Supply Flip acceptance.
🧱 System Philosophy
Supply Demand Flip Planner follows the AG Pro Series approach: transform a common market concept into a structured decision map with context, score, risk reference, and clean visuals.
The goal is not to replace judgment. The goal is to make role-change analysis easier to read.
🔐 Non-Promise Statement
No script can provide certainty.
No signal should be treated as guaranteed.
Outputs should always be interpreted with independent analysis and responsible risk control.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly.
Users are responsible for their own decisions, risk management, and trade execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
This script is designed to help traders study how supply zones, demand zones, breakout retests, and role-change acceptance behave across different market conditions.
Indicator
Donchian Retest Readiness [AGPro Series]# Donchian Retest Readiness
🧠 Core Idea
After price breaks a Donchian Channel boundary, is the broken edge ready to act as a clean retest and continuation reference?
📌 Overview / What it does
Donchian Retest Readiness is a breakout-boundary decision-support script built around Donchian Channels.
The script maps the rolling Donchian high, low, and midpoint, detects channel breaks, builds a retest pocket around the broken edge, scores retest quality from 0 to 100, and projects continuation lanes with target rails.
It does not predict price direction, automate trades, or provide guaranteed signals. It organizes Donchian break context, retest quality, channel edge, risk, and action state into a clean visual workflow.
🎯 Purpose & Design Philosophy
Many breakout tools mark the moment price leaves a range, but the difficult part often comes after the break: deciding whether the broken edge is being respected.
This script was built for traders who want to evaluate Donchian breakout retests without treating every new high or new low as a complete trading idea.
The design supports structured observation: break first, retest pocket second, hold quality third.
⚡ Why This Script Is Different
Most Donchian tools focus on channel highs and lows.
This script does NOT stop at drawing the Donchian Channel.
Instead, it converts the broken channel edge into a decision zone, evaluates whether price returns to that area, measures hold quality, and summarizes readiness with a clear 0-100 score.
⚙️ Methodology
1. Donchian Channel Mapping
2. Breakout Boundary Detection
3. Retest Pocket Construction
4. Hold / Failure Evaluation
5. 0-100 Retest Readiness Score
6. Panel And Alert Output
🗺️ How to Read the Chart
The Donchian Channel shows the rolling high, low, and midpoint.
The retest pocket appears around the broken channel edge after a breakout.
READY RETEST labels appear when price interacts with the broken edge and holds with enough quality.
Continuation lanes and target rails show the projected area beyond the accepted retest context.
The panel summarizes Break State, Retest Score, Channel Edge, Risk, and Action.
🚦 Signals & States
• READY → A qualified Donchian retest has formed.
• MONITOR → A Donchian break is active and retest behavior is being evaluated.
• WAIT → The channel is valid, but no active break / retest context is present.
• INVALIDATED → Price failed back through the broken channel edge.
• BLOCKED → The Donchian channel is not suitable for evaluation under current settings.
🔔 Alerts Logic
Bullish Donchian Retest Ready triggers when price breaks above the Donchian high, returns to the broken edge, and holds with enough score quality.
Bearish Donchian Retest Ready triggers when price breaks below the Donchian low, returns to the broken edge, and holds with enough score quality.
Donchian Break Watch alerts mark the first boundary break when enabled.
Donchian Retest Invalidated triggers when price fails back through the broken edge.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The retest score combines wick response, close pressure beyond the broken edge, proximity to the retest pocket, breakout impulse, relative volume, and channel width quality.
When several of these conditions align, the retest context becomes stronger.
📊 When to Use
• Breakout markets
• Trend continuation setups
• Pullbacks after new highs or new lows
• Donchian Channel structure analysis
• Intraday or swing contexts where retest behavior matters
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy chop
• Abnormal spread conditions
• News spikes where retest behavior is unstable
• Markets where every boundary break immediately reverses
🎛️ Key Inputs
• Donchian Length → controls the rolling channel high and low.
• ATR Length → controls retest pocket depth, buffers, targets, and label spacing.
• Minimum Channel Width → blocks weak channels that are too narrow.
• Retest Pocket ATR → controls how wide the broken-edge retest pocket is.
• Minimum Ready Score → controls how selective READY states are.
• Projection Bars → controls how far pockets and targets extend.
• Visual settings → control channel, fill, pocket, lane, labels, tags, and panel.
🖥️ Interface & Visual Design
The script uses a clean AG Pro panel to summarize the current Donchian context.
The visual hierarchy is designed to keep the channel visible while making the active retest pocket and READY label easy to see.
Default settings keep failed and early watch labels off so publication screenshots remain clean.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check the Donchian channel boundary.
3. Wait for a break and retest pocket.
4. Evaluate whether price holds the broken edge.
5. Review target rails and failure risk.
🔍 Interpretation Guidelines
A READY retest means the broken Donchian edge is being respected according to the script rules.
It does not mean price must continue.
An invalidated retest means price failed back through the broken edge and the breakout context lost quality.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a buy or sell signal generator.
It is not an automated trading system.
It does not guarantee breakouts, continuation, or reversals.
⚠️ Limitations & Transparency
Donchian behavior can vary by symbol, timeframe, volatility, and liquidity.
Shorter timeframes may produce more noise.
Longer Donchian lengths may react more slowly.
The script should be interpreted within broader structure, market regime, and risk context.
🧠 Market Context Notes
Donchian edges often become meaningful when market participants react to new highs, new lows, and breakout continuation attempts.
The strongest contexts usually combine a clean boundary break, controlled retest, and enough continuation room.
🧾 Use Case Examples
When price breaks above the Donchian high and later retests the broken edge without closing back through it, the script may mark a bullish READY RETEST.
When price breaks below the Donchian low and retests the edge from below with enough quality, the script may mark a bearish READY RETEST.
When price breaks out and then closes back through the broken edge, the retest can become invalidated.
🧱 System Philosophy
This script follows the AGPro Series approach: structured context, practical scoring, clean visuals, and decision-support states instead of noisy prediction claims.
🔐 Non-Promise Statement
No script can provide certainty.
No output should be treated as guaranteed.
All states are rule-based analytical markers.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and position sizing.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The purpose of this script is to help users study Donchian Channel breakout and retest behavior through a structured visual framework.
Indicator
Keltner Squeeze Release Planner [AGPro Series]# Keltner Squeeze Release Planner
🧠 Core Idea
Is volatility compression turning into a clean Keltner Channel release, or is price still trapped inside the squeeze?
📌 Overview / What it does
Keltner Squeeze Release Planner is a volatility compression and expansion decision-support script built around Keltner Channels.
The script detects compressed Keltner width, evaluates whether price releases beyond the channel with enough expansion quality, scores the release from 0 to 100, and maps an expansion corridor with target rails and failure context.
It does not predict price direction, automate trading, or provide guaranteed signals. It organizes squeeze, release quality, volatility rank, direction bias, and action state into a cleaner workflow.
🎯 Purpose & Design Philosophy
Many traders can see a breakout after it happens, but the difficult part is separating real volatility expansion from a weak push outside the channel.
This script was built for traders who want a structured way to read Keltner squeeze behavior, release strength, and early failure risk.
The design supports patience during compression and cleaner observation when price finally leaves the channel.
⚡ Why This Script Is Different
Most Keltner tools draw the channel and leave interpretation to the user.
This script does NOT treat every channel break as meaningful.
Instead, it evaluates compression depth, expansion ratio, close pressure, candle body quality, relative volume, and basis slope before marking a release as READY.
⚙️ Methodology
1. Keltner Channel Mapping
2. Compression Detection
3. Release Edge Evaluation
4. Expansion Quality Scoring
5. Corridor And Failure Mapping
6. Panel And Alert Output
🗺️ How to Read the Chart
The Keltner Channel shows the active volatility envelope around price.
Compression shading marks periods where channel width is low relative to recent history.
BULL RELEASE and BEAR RELEASE labels appear when price leaves the channel with enough release quality.
The release corridor projects possible expansion space after a qualified release.
The panel summarizes Squeeze, Release Score, Volatility, Direction Bias, and Action.
🚦 Signals & States
• READY → A qualified Keltner squeeze release has formed.
• MONITOR → A release context is active and should be observed.
• WAIT → Compression may exist, but release quality is not confirmed.
• INVALIDATED → A release failed back into the channel context.
• BLOCKED → The script cannot define a valid Keltner context.
🔔 Alerts Logic
Bullish Keltner Squeeze Release Ready triggers when price releases above the upper Keltner Channel after compression with enough score quality.
Bearish Keltner Squeeze Release Ready triggers when price releases below the lower Keltner Channel after compression with enough score quality.
Keltner Compression Active triggers when channel width is low enough to qualify as squeeze context.
Keltner Squeeze Release Failed triggers when an active release loses quality and moves back into the failure area.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The release score combines compression depth, expansion ratio, close pressure beyond the channel, candle body quality, relative volume, and basis slope.
When these conditions align, the release context becomes stronger.
📊 When to Use
• Markets moving from low volatility to expansion
• Breakout environments
• Consolidation-to-trend transitions
• Intraday or swing contexts where volatility contraction matters
⚠️ When NOT to Use
• Extremely illiquid symbols
• Random high-noise chop
• News spikes with unstable spreads
• Symbols where Keltner width is distorted by abnormal candles
🎛️ Key Inputs
• Keltner Basis Length → controls the EMA basis of the channel.
• ATR Length → controls channel width and volatility normalization.
• Keltner ATR Multiplier → adjusts how wide the channel is.
• Squeeze Threshold → defines how deep compression must be.
• Minimum Ready Score → controls how selective READY releases are.
• Projection Bars → controls how far the corridor extends.
• Visual settings → control labels, channels, zones, panel, and chart density.
🖥️ Interface & Visual Design
The script uses a compact AG Pro panel to make the current state readable at a glance.
The visual hierarchy is designed to keep the chart clean: channel context first, release label second, corridor and targets third.
Default settings are tuned for readable publication screenshots without hiding the core volatility story.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check whether compression is active.
3. Wait for a qualified release label.
4. Review the corridor and target rails.
5. Watch whether price holds or fails back into the channel.
🔍 Interpretation Guidelines
A READY release means volatility expansion conditions aligned according to the script rules.
It does not mean price must continue.
A weak or failed release means the channel break lost quality and should be interpreted within broader market context.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a buy or sell signal generator.
It is not an automated trading system.
It does not guarantee breakouts, continuation, or reversals.
⚠️ Limitations & Transparency
Keltner behavior can change across symbols, sessions, and timeframes.
Compression may last longer than expected.
Strong news events can create release signals that behave differently from normal volatility expansion.
The script should be used with broader structure, liquidity, and risk context.
🧠 Market Context Notes
Keltner squeeze behavior is most useful when volatility has contracted enough to create a visible transition point.
The best contexts often combine compression, clean channel release, participation, and enough room for expansion.
🧾 Use Case Examples
When price compresses inside the Keltner Channel and then closes beyond the upper band with strong expansion, the script may mark a bullish release.
When price breaks below the lower band after compression and the release score is strong enough, the script may mark a bearish release.
When price breaks out but quickly moves back into the channel, the release can lose quality.
🧱 System Philosophy
This script is part of the AGPro Series approach: clean visual context, practical scoring, and decision-support states instead of noisy prediction labels.
🔐 Non-Promise Statement
No script can provide certainty.
No signal should be treated as guaranteed.
All outputs are rule-based analytical markers.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and position sizing.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
The purpose of this script is to help users study volatility compression and release behavior through a structured Keltner Channel framework.
Indicator
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.
Indicator
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.
Indicator
Pymander's EZ Breakout FinderThe Momentum Breakout Highlighter is a versatile price-action tool designed to identify high-conviction breakout candles. Unlike standard breakout indicators that trigger on any breach of a high or low, this script uses a multi-layered filtering system to ensure that signals represent genuine market commitment rather than "noise" or low-volume fakeouts.
How It Works
The script monitors a user-defined lookback period to establish local resistance (highs) and support (lows). A signal is generated only when three distinct conditions are met:
The Breakout: Price must breach the highest high or lowest low of the lookback period. Users can choose whether this requires a Wick breach or a full Close beyond the level.
The Momentum Filter: The candle’s body size (Open to Close) is compared against the average body size of the lookback period. A signal only triggers if the candle shows "effort"—meaning its body is significantly larger than the recent average.
The Trend Context: Signals are filtered via a Volume Weighted Moving Average (VWMA). By default, it follows the trend (Longs above VWMA, Shorts below), but it also includes a Mean Reversion Mode for contrarian traders.
Key Features
Momentum Verification: Uses an adjustable multiplier to ensure breakout candles have the necessary "thrust" to sustain a move.
Mean Reversion Mode: A unique toggle that flips the trend logic, allowing you to find high-momentum exhaustion moves back toward the VWMA.
Advanced Signal Management:
Cooldown Timer: Prevents "signal clustering" by requiring a set number of bars to pass before a new signal can trigger.
Opposite Direction Filter: An optional mode that forces signals to alternate between Bullish and Bearish, perfect for swing traders looking for "one-way" entries.
Visual Clarity: Features bar highlighting, triangular plotshapes (arrows), and optional reference lines for the previous high/low levels.
What Makes It Stand Out?
Most breakout indicators fail during choppy markets because they lack a volatility component. This script solves that by integrating Body-to-Average momentum logic. By requiring the "breakout" candle to be larger than its predecessors, it filters out "exhaustion wicks" and low-liquidity drifts.
Furthermore, the inclusion of VWMA Trend Bias ensures you are always trading with volume-weighted support, and the Cooldown/Directional filters make it an excellent tool for automating alerts without being overwhelmed by repetitive signals during high-volatility spikes.
How to Use
For Trend Following: Use the default settings to catch high-momentum entries in the direction of the trend.
For Mean Reversion: Enable "Mean Reversion Mode" to catch "Blow-off tops" or "Panic bottoms" that break local ranges against the primary trend.
For Scalping: Lower the lookback period and cooldown for faster signals on lower timeframes.
Good luck and enjoy!
Indicator
Black Tie ORB MTFOpening Range Breakout for Tokyo, London, and New York sessions. Marks the high and low of the first N minutes of each major trading session, fills the range as a translucent box, and projects 1R / 2R / 3R extension levels above and below.
ORB is a documented institutional strategy (Toby Crabel, "Day Trading with Short Term Price Patterns", 1990). The opening range establishes the day's initial supply/demand balance. Sustained breakouts beyond it tend to continue; failed breakouts often reverse to the opposite side.
WHAT IT PLOTS
A translucent box covering the high-to-low range of the first N minutes of each enabled session.
Range high and range low lines, drawn from session open through session close.
1R, 2R, and 3R extensions above and below the range, projected as horizontal levels (only after the range is locked).
Optional breakout triangles on the bar where price first closes above or below the range. Green triangle below the bar = bullish breakout. Red triangle above the bar = bearish breakout.
USAGE
NY session ORB: most documented use case. Best on US equities, US futures (ES, NQ, YM, CL, GC), and during US session for major forex pairs.
London session ORB: best on European indices and forex during European hours.
Tokyo session ORB: typically less reliable due to thin liquidity but useful for JPY pairs.
A clean ORB long setup is: price builds the range during the first N minutes, breaks above with conviction (volume, no immediate retest), and reaches 1R within the session. The 1R / 2R / 3R extensions serve as profit targets. Failed breakouts (price returns inside the range and then breaks the opposite side) are also commonly traded.
This indicator does not generate trade signals. The breakout triangles mark the first close beyond the range; whether that close is a valid trade entry depends on context (volume, HTF trend, prior structure) that this indicator does not evaluate.
SETTINGS
Range Duration: 5, 15, 30, or 60 minutes. 15 min is the standard for US equities. 60 min is more common for forex and indices.
Fill Range as Box: shows the OR area as a translucent background. Recommended on, makes the range visually obvious.
Show Extensions: 1R, 2R, 3R toggles individually. Default 1R and 2R on.
Show Breakout Markers: optional triangles on the first close beyond the range.
Per-session colors are fully customizable.
By default only the NY session is enabled. Tokyo and London can be enabled in the SESSIONS group when needed. Indicator
Volume Trap Reversal Planner [AGPro Series]Volume Trap Reversal Planner
🧠 Core Idea
Did a volume spike trap one side of the market and reverse with enough confirmation to deserve attention?
📌 Overview / What it does
Volume Trap Reversal Planner is a chart-first reversal planning tool built around high-volume trap behavior.
Instead of treating every volume spike or wick sweep as a reversal signal, the script checks whether price expands through a recent reference, prints unusual relative volume, fails to hold the move, recovers back through the reference, and then confirms with a follow-through candle.
The output includes volume trap pockets, reclaim rails, risk edges, target-room bands, compact event labels, alerts, and a clean AGPro decision panel. It does not predict price, automate trades, or claim that every trap will reverse.
🎯 Purpose & Design Philosophy
The script was built for traders who want to separate meaningful high-volume trap events from ordinary noisy spikes.
Many reversal tools focus only on a wick, a candle pattern, or a support/resistance touch. This planner focuses on the decision layer after a volume trap forms: whether the trap is confirmed, where the risk edge sits, where target-room review begins, and what the next action state should be.
The design supports a structured review mindset: identify the trap, wait for confirmation, monitor the risk edge, and read the context through a 0-100 score instead of reacting to a single candle.
⚡ Why This Script Is Different
Most tools focus on volume spikes as standalone events or classify every sweep as a reversal attempt.
This script does NOT operate as a generic stop-run scanner, a broad liquidity sweep map, or a simple volume climax labeler.
Instead, it combines relative volume, wick sweep behavior, close recovery, confirmation candle quality, follow-through, risk edge placement, and target-room context into one planner-style reversal model.
⚙️ Methodology
1. Context Detection
The script builds a rolling high/low reference range and watches for unusual volume expansion near those references.
2. Trap Mapping
When price sweeps beyond the reference with elevated volume and recovers back inside, the script maps the volume trap pocket.
3. Reversal Evaluation
The planner evaluates wick quality, recovery strength, confirmation candle structure, follow-through distance, and the active risk edge.
4. Visual Output
The result is translated into a 0-100 reversal score, a next-action state, on-chart labels, risk/target guides, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = volume trap pockets created by a high-volume sweep and recovery.
Labels = trap watch, reversal ready, trap failed, or target review states.
Colors = bull-side reversals use teal, bear-side reversals use pink, watch states use amber, and review/target context uses indigo.
Panel = current trap side, volume spike multiple, reversal score, risk edge, and next action.
🚦 Signals & States
• VOL TRAP WATCH → a high-volume trap candidate formed and needs confirmation.
• REVERSAL READY → the trap received confirmation and reached the required score.
• TRAP FAILED → price closed beyond the risk edge and the active trap context weakened.
• TARGET REVIEW → price reached the target-room review band for the active plan.
🔔 Alerts Logic
Alerts trigger when a volume trap watch appears, when reversal confirmation reaches the required score, when the active trap fails through the risk edge, or when price reaches the target-room review band.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when volume spike quality, wick sweep behavior, close recovery, confirmation candle structure, and follow-through align in the same direction.
The score is intentionally multi-factor so a single dramatic candle does not dominate the interpretation.
📊 When to Use
• 4H charts for the cleanest public visual balance
• Markets with reliable volume data
• High-volume reactions around recent highs or lows
• Reversal review after failed breakout or failed breakdown attempts
• Active intraday or swing charts where trap behavior is visible
⚠️ When NOT to Use
• Very low-liquidity symbols
• Markets with unreliable or missing volume data
• Extremely noisy ranges where every candle sweeps both sides
• News-driven volatility where candle structure can distort normal context
🎛️ Key Inputs
• Trap Reference Lookback → controls the rolling high/low range used for trap detection.
• Volume Spike RVOL → adjusts how much relative volume is required.
• Sensitivity → changes sweep, wick, and volume selectivity.
• Confirmation Mode → controls how strict the confirmation candle must be.
• Risk / Target Logic → controls risk edge buffers and target-room bands.
• Visual Settings → control zones, rails, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around a clean AGPro panel and chart-first visual hierarchy.
Trap pockets show where the volume trap occurred. Labels identify the current state without overcrowding the chart. Risk and target guides make the output easier to interpret as a planning tool rather than a raw signal board.
🧪 Practical Usage Workflow
1. Read the panel and check the active trap side.
2. Inspect the volume trap pocket and reclaim rail.
3. Wait for reversal confirmation instead of reacting to the spike alone.
4. Compare the current state with the risk edge and target-room band.
5. Interpret the score within broader market context.
🔍 Interpretation Guidelines
A high score means the trap structure, volume spike, recovery, and confirmation are aligned more cleanly.
A watch state means the event is still developing.
A failed state means the active trap context has weakened or invalidated according to the script's rules.
Use the output as structured context, not as a standalone decision.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed reversal signal
• Not a generic liquidity sweep scanner
⚠️ Limitations & Transparency
Volume quality varies by symbol, exchange, and asset class.
Different timeframes may produce different trap pockets and confirmation states.
High volatility can make traps appear and fail quickly.
The script is rule-based and cannot know news, order flow intent, execution quality, or broader discretionary context.
🧠 Market Context Notes
Volume traps often matter most when they occur at obvious participation points, such as recent highs, recent lows, failed breakouts, or failed breakdowns.
The strongest use case is not the spike itself. The strongest use case is the sequence after the spike: recovery, confirmation, risk edge, and follow-through.
🧾 Use Case Examples
When price sweeps below a recent low on elevated volume, closes back above the reference, and confirms upward within the allowed window, the planner can mark a bullish reversal context.
When price sweeps above a recent high on elevated volume, fails to hold, and confirms downward, the planner can mark a bearish reversal context.
🧱 System Philosophy
Volume Trap Reversal Planner belongs to the AGPro planner-style workflow: detect the event, score the evidence, define the risk edge, map the review zone, and guide the next chart-reading step.
🔐 Non-Promise Statement
No trap, score, label, or alert can guarantee a reversal.
No script can provide certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and market interpretation.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the script to study how high-volume failed moves behave after sweeping recent references. The most useful insights come from comparing confirmed traps, failed traps, and ignored spikes across different markets and timeframes.
Indicator
