Premarket OTT TriggerPremarket OTT Trigger
Premarket OTT Trigger is a multi-timeframe indicator designed to identify important premarket price zones using a 15-period OTT and then use those zones for structured break-and-retest setups after the market opens.
The concept is simple:
Higher timeframe = Find the setup
Lower timeframe = Find the entry
During premarket, the indicator looks for the most recent candle that crosses or touches the OTT. That candle is automatically boxed from its high to low, with a 50% midline, and the box extends to the right throughout the trading session.
If another qualifying premarket candle appears later, the older box is removed and the newest candle becomes the active zone.
Why Look for an OTT Cross?
A symbol with a premarket candle crossing or interacting with the OTT may be showing increased price activity and the potential for meaningful movement during the session.
This does not guarantee a move, but it can help identify symbols worth adding to a watchlist.
The resulting box creates a clearly defined trading area with three important levels:
Box High
50% Midline
Box Low
Instead of entering randomly, traders can use these levels to wait for price to show direction.
Break & Retest Method
A simple approach is to use the 30-minute timeframe to identify the box and the 5-minute timeframe for entries.
Bullish Setup
Wait for price to break above the box high.
Do not chase the initial breakout.
Allow price to pull back and retest the top of the box.
If the old resistance level holds as support and the 5-minute chart shows bullish confirmation, this can provide a potential long setup.
Break Above → Retest → Hold → Long
Bearish Setup
Wait for price to break below the box low.
Allow price to retest the broken level from underneath.
If the old support level acts as resistance and the 5-minute chart shows bearish confirmation, this can provide a potential short setup.
Break Below → Retest → Reject → Short
If price remains inside the box, the idea is simply to wait for direction.
AAPL Example
In the AAPL example shown, the 30-minute timeframe was used to establish the premarket OTT box, while the 5-minute chart was used for trade execution.
The higher timeframe provided the important premarket structure, while the lower timeframe provided a more precise view for the breakout, retest, and entry.
This is the core idea behind the indicator:
OTT Interaction → Potential Movement → Defined Zone → Break → Retest → Entry
Features
Selectable indicator timeframe
15-period OTT
Adjustable OTT percentage
Adjustable premarket session
Wick Touch, Body Cross, or Close Cross detection
Automatic most-recent premarket box
Automatic daily reset
Box High, Low, and 50% Midline
Dynamic box colors
Solid, Dashed, or Dotted box borders
Customizable midline style
Optional candle-close confirmation
Box extends through the trading session
Important
The OTT cross is not intended to predict direction by itself.
Its purpose is to help identify symbols that may be showing meaningful premarket activity and create a defined trading zone where entries, invalidation, and risk can be planned more clearly.
The trader still waits for price to confirm direction through the break and retest.
30M for structure.
5M for execution.
Let price confirm the trade.
This indicator is intended as a structure and confirmation tool and should be combined with proper risk management, position sizing, and your own trading plan.
For educational purposes only. Not financial advice.
Credits: This indicator incorporates the Optimized Trend Tracker (OTT) concept originally developed by Anıl Özekşi. Credit is also given to Kıvanç Özbilgiç for bringing OTT implementations to the TradingView/Pine community. This script extends the concept into a multi-timeframe premarket zone and break-and-retest framework.
Indicator
Fractal ZigZag with Retest & Filters By WiselyWealthIndicator ; Fractal ZigZag with Retest & Filters
Introduction
Welcome to the comprehensive guide for the 'Fractal ZigZag with Retest & Filters' indicator. This custom-built Pine Script indicator is an advanced technical analysis tool designed explicitly for the TradingView platform. At its core, the primary objective of this script is to provide traders with high-probability entry signals by systematically filtering out market noise, avoiding false breakouts, and ensuring alignment with the overarching macroeconomic trend.
Many retail traders fall into the trap of entering positions during sudden, volatile price spikes, only to suffer heavy drawdowns when the market naturally pulls back. This script mitigates that risk by enforcing a strict, rules-based approach: identifying structural shifts, confirming the initial breakout, and mathematically demanding a pullback (or "retest") before issuing a final trading signal. Additionally, it features built-in alert conditions, making it perfectly suited for algorithmic traders who wish to automate their strategies via Webhooks, Telegram bots, or MT5 API integrations.
Technical Mechanism
The mechanical operation of this script is multi-layered, relying on a confluence of structural mapping, trend filtering, and volatility-based retest calculations. Here is a detailed, step-by-step technical breakdown of how the script detects and generates its buy and sell signals:
Mapping Market Structure with Williams Fractals:The foundation of the script relies on identifying key swing highs and swing lows using Williams Fractals. By default, the indicator evaluates a 5-bar lookback and look-forward period to pinpoint these structural pivots. Once a valid upward or downward fractal is identified, the script connects them using a dynamic ZigZag line. This creates an unambiguous visual map of the market's underlying structure, cleanly displaying the sequence of higher highs or lower lows.
Initial Breakout Identification: The indicator actively monitors the current closing price in relation to the most recently confirmed fractal levels. A raw bullish breakout is registered the moment a candle closes definitively above the last established fractal high. Conversely, a raw bearish breakout is noted when the closing price drops below the most recent fractal low. To prevent redundant alerts, the script locks the current trend state upon a successful breakout.
The ATR-Based Retest Engine: This is the most sophisticated aspect of the indicator. When "Enable Retest Mode" is activated, the script refuses to issue an immediate entry signal at the exact moment of the breakout. Instead, it uses the Average True Range (ATR) over a 14-period lookback to measure current market volatility. For a bullish setup, it calculates a "Retest Target" by subtracting a user-defined ATR multiplier (default 1.0) from the breakout close price. It then starts a countdown timer, allowing a maximum number of candles (default 3) for the price to drop back down and touch this target. If the pullback is successful within the time limit, the raw buy signal is triggered. If the time expires without a retest, the setup is safely invalidated.
Macro Trend Filtering: Before finalizing any signal, the script consults a 200-period Exponential Moving Average (EMA). If the trend filter is enabled, a buy signal is entirely suppressed unless the closing price is strictly above the EMA200. Sell signals similarly require the price to remain below the EMA200. Users can also force the script into a "Buy Only" or "Sell Only" mode to align with their long-term directional bias.
How to Use and Best Practices
To extract maximum profitability and accuracy from this script, traders must apply the correct settings and deploy it in appropriate market environments.
Recommended Settings and Configuration:
Conservative Swing Trading: Ensure the EMA200 Trend Filter remains enabled to keep you on the side of institutional momentum. You may also want to increase the Fractal Periods from 5 to 7 or 9. This filters out minor price fluctuations and forces the script to base its breakouts on major structural swing points.
Retest Calibration for Volatility:** The default ATR multiplier is 1.0, and the wait limit is 3 candles. If you are trading on lower timeframes (e.g., 5-minute or 15-minute charts), breakouts can take slightly longer to retest. Consider increasing the "Max Candles to wait" to 5 or 6. For highly volatile assets, increasing the ATR Multiplier to 1.5 can help you secure a deeper, more favorable pullback entry.
Directional Lock: If higher timeframe analysis dictates a strong bull market, use the "Trade Direction" setting to restrict signals to "Buy Only," eliminating counter-trend noise during minor market corrections.
Suitable Markets and Timeframes:
Forex and Indices: This indicator performs exceptionally well on major Forex pairs (EUR/USD, GBP/JPY) and Global Indices (US30, NAS100) on the 1-Hour and 4-Hour timeframes. These assets heavily respect market structure, and liquidity grabs (retests) are highly common after structural breakouts.
Cryptocurrency: Bitcoin and Ethereum on the 15-minute to 1-Hour charts are excellent candidates, provided you adjust the ATR multiplier to account for crypto's volatile, whipsaw movements.
Markets to Avoid: Avoid using this script in heavily consolidated, range-bound, or sideways markets. Breakout and trend-continuation logic inherently struggles during prolonged periods of low volatility, where price chops indiscriminately around the 200 EMA without clear directional follow-through. Indicator
Breakout & Retest Entry Signals & the Break-vs-RetestOVERVIEW
"Wait for the retest" is the most repeated piece of advice in breakout trading. It is also, as far as I can tell, completely untested by the people who repeat it.
This tool settles it — on your instrument, with your settings — by taking BOTH entries on the SAME breaks and grading them against the same control:
PER-TRADE EDGE expectancy vs control · n
Break entry +0.09R +0.02R · n=412
Retest — CLEAN +0.31R +0.02R · n=118
Retest — DEEP -0.04R +0.02R · n=76
clean vs deep (t) 3.41 CLEAN IS BETTER
BUT — HOW OFTEN DO YOU GET IT?
Breaks that ever retested 47.0% (194/412)
after a run of >3 closes 31.2% vs 55.8% otherwise
False-break rate 13.3%
EXPECTED VALUE PER BREAK
Take every break +0.09R (100% of breaks)
Wait for the retest +0.06R (47% of breaks)
VERDICT NO DIFFERENCE — pick either
That last block is the entire point. A better per-trade edge is worthless if you only get the trade half the time — so the WAIT policy is scored as P(retest) x E , because on every break that never retests you get NOTHING. The two are then compared with a significance test, and the verdict is allowed to be "no difference".
It is a research and framing tool. NOT a strategy, NOT a signal service, NOT a validated edge.
WHAT IT ALREADY FOUND — measured live on NIFTY futures
timeframe breaks retested false breaks verdict
1m 334 49.4% 29.6% NO DIFFERENCE
3m 323 53.3% 13.6% NO DIFFERENCE
5m 328 53.4% 14.0% NO DIFFERENCE
15m 306 51.0% 12.7% TAKE THE BREAK
1h 274 50.0% 16.4% NO DIFFERENCE
TWO THINGS JUMP OUT.
The retest rate is 50-53% on every timeframe. Bulkowski, measuring throwbacks across 10,348 chart patterns on US daily stocks, found 50-60%. A completely different market, a completely different method, and the same number. That is a real phenomenon, not an artefact of the detector.
The false-break rate is 26.5% on the 1m and 13-15% everywhere else. THE ONE-MINUTE BREAK IS TWICE AS LIKELY TO BE A LIE. That is not folklore, it is this instrument's own number, and it is exactly the kind of thing a trader should know before choosing a timeframe.
And the verdict, on four of the five: NO DIFFERENCE — pick either. Once the geometry is honest and the test is a real one, the great break-versus-retest argument simply does not resolve on this instrument at most speeds. On the 15m it does resolve — and it says TAKE THE BREAK, which is the opposite of what almost everyone will tell you.
That is what a measurement looks like. It disagrees with the folklore on one timeframe, refuses to take a side on four others, and does not care what you were hoping for. No tool that needs to sell you a signal would ever print "NO DIFFERENCE".
THE ONE THING EVERYONE GETS BACKWARDS
Thomas Bulkowski measured throwbacks and pullbacks across 10,348 chart patterns. His finding:
"Do throwbacks hurt performance? YES: 97% of the time chart patterns with upward breakouts
perform better post-breakout WITHOUT a throwback."
"Do pullbacks hurt performance? YES: 91% of chart pattern types with downward breakouts
perform better if a pullback does NOT occur."
Read that again. The retest is not a gift. It is a SYMPTOM — evidence that the move is weak, that supply came back, that the break did not have the strength to run.
And yet "wait for the retest" is good advice for a completely different reason: it gives you a better price and a tighter stop.
BOTH ARE TRUE AT ONCE. They are two opposing effects on the same trade, and they have never been put on one scale and netted out. That is what this script does. The retest may still win — a better entry can outweigh a weaker move — but nobody has ever checked, and the answer is different on every instrument and every timeframe.
A CLEAN RETEST AND A DEEP ONE ARE NOT THE SAME EVENT
Bulkowski again, and this is his sharpest single finding on the subject: during a throwback, if price REMAINS ABOVE the breakout price the subsequent rise averages 40%. If it drops BELOW the breakout price and then recovers, the rise averages 29%. That is 400 samples versus 2,767.
Pooling those two throws away the strongest signal in the whole idea. So they are separated:
CLEAN retest — price came back and touched the level, but never CLOSED back through it.
DEEP retest — price CLOSED back through the level, then recovered.
They are graded separately, tested against each other, and labelled separately on the chart. If clean beats deep on your instrument, then "wait for the retest" is not one rule — it is two, and only one of them works.
AND CAN YOU SEE IT COMING?
The real, unpriced cost of a WAIT policy is that roughly half the time you never get filled. So it matters enormously whether you can predict which breaks will retest.
Bulkowski found that if price has more than three consecutively higher closes ending the day before the breakout, the throwback probability drops materially. So the panel reports the retest rate SPLIT BY THAT:
after a run of >3 closes 31.2% vs 55.8% otherwise
If the split is real on your instrument, then after a strong run into the break you should simply TAKE IT — because the retest you are waiting for is probably never coming.
IS YOUR VOLUME FILTER EARNING ITS KEEP?
Every trader is taught that a breakout must be confirmed by volume. Bulkowski's volume study says that after an ABOVE-average-volume breakout, FAILURES DOUBLE and the likelihood of a throwback TRIPLES, while the move itself is barely better.
That is testable — but only if the low-volume breaks are allowed into the sample. So VOLUME IS NOT A GATE ON THE RECORD. Every break is recorded; volume gates only the SIGNAL. The panel then reports what your filter is actually worth:
Break ON volume +0.11R n=246
Break OFF volume +0.06R n=166
on vs off (t) 0.82 no difference — it is doing nothing
The record is a fact about the market. The filter is a decision about the trade. They are kept apart, and this is what happens when you stop assuming and start measuring.
IDENTICAL GEOMETRY — and why this is not a detail
The target used to be THE NEXT OPPOSING LEVEL. That quietly destroyed the entire experiment.
The BREAK entry sits PAST the level (it closed through it). The RETEST entry sits BACK AT the level. So the retest is systematically FARTHER from the next opposing level, and was therefore being handed a BIGGER R:R for the SAME RISK — on every single trade, by construction. Live, that produced an R:R of 5.0 on one timeframe and 0.66 on another, and the on-chart key was cheerfully claiming "identical geometry" while the geometry was tilted toward the retest.
The trade now uses a FIXED R multiple, identical for the break, the retest and the control. The next opposing level is still drawn, and still tested — separately, as a descriptive statistic, with its hit rate reported next to its distance in R.
THE ANTI-BIAS GUARDS
ENTRY IS THE CLOSE, for both entries and for the control. Entering the retest AT the level — a better price than the close — while the break enters at its close would hand the retest a free head start on every trade, and settle the oldest argument in trading by rigging it.
THE CONTROL IS DIRECTION-MATCHED. Breaks run with the trend, so a direction-skewed event set measured against a symmetric 50/50 control inherits the drift for free and calls it an edge. Longs are compared only with control longs, shorts only with control shorts, and the control is blended back using the events' OWN direction mix.
EVERY VERDICT IS A TEST, NOT A COMPARISON. Break-vs-wait, clean-vs-deep, volume-on-vs-off — each is a Welch t-test that has to clear |t| > 1.96 before it is allowed to be a finding. For the wait policy, the variance of P(retest) x E is propagated by the delta method, because it is a product of two estimates and both carry error. A verdict that flips on a tenth of an R is not a verdict, it is noise wearing a costume.
Both barriers on one bar: the STOP is assumed first — conservative, and the only assumption that cannot flatter the result. Unresolved trades at the horizon are marked to market, not booked as losses.
THE LEVELS
Levels come from the extrema of a KERNEL-SMOOTHED price series (Nadaraya-Watson) rather than raw pivots, so they track the structure rather than the noise. A break requires a CLOSE beyond the level with displacement, not a wick. A false break is one that closes back inside quickly. All of it is computed on confirmed bars; the kernel is causal and never looks forward.
NON-REPAINT
The kernel confirms an extremum a half-window late, so a level appears some bars AFTER the swing that created it. That lag is the price of not repainting and it is paid deliberately. Levels, breaks, false breaks, retests, signals and every calibration event are computed on CONFIRMED bars only. Nothing is drawn and then moved.
DATA AND SCOPE
Any symbol, any timeframe. ATR-normalised throughout. Volume improves the SIGNAL but is not required, and it never gates the RECORD.
EXPORTS (Data Window — consume from other scripts via input.source())
EXP_Level, EXP_Break, EXP_FalseBreak, EXP_Retest, EXP_Entry, EXP_Stop, EXP_Target, EXP_NextLevel, EXP_WaitEdge
CONCEPT CREDIT
Support/resistance, polarity and the breakout-retest idea are long-standing public trading concepts with no single author; the written tradition runs through Charles Dow, Richard Wyckoff and Edwards & Magee. The formal TRADING-RANGE BREAK was first tested at scale by William Brock, Josef Lakonishok and Blake LeBaron, Journal of Finance 47(5), 1992 — and their results were later shown to be vulnerable to data-snooping (Sullivan, Timmermann and White, 1999), which is exactly why this tool measures the rule on YOUR instrument rather than asserting it.
The throwback and pullback statistics that motivate the clean/deep split, the run-length predictor and the volume test are from Thomas Bulkowski ("Encyclopedia of Chart Patterns"; thepatternsite.com). His numbers are measured on US daily stocks. Whether they hold on YOUR instrument is precisely the question this script exists to answer — and it may well answer "no".
Nadaraya-Watson kernel regression — Nadaraya and Watson (1964); its use for technical pattern recognition — Lo, Mamaysky and Wang, Journal of Finance 55(4), 2000. Triple-barrier forward labelling — Marcos Lopez de Prado. Welch's t-test — B. L. Welch. ATR — J. Welles Wilder.
The break-vs-wait availability weighting, the delta-method significance test, the clean/deep retest split, the volume-filter test and the direction-matched control are the author's own. Clean-room implementation; no third-party Pine code is reused. Not affiliated with, nor endorsed by, any of the above.
HONESTY AND LIMITATIONS
Calibration is IN-SAMPLE, with no costs or slippage, and uses overlapping windows. A proven in-sample edge is NOT a guarantee out-of-sample. Real fills, spreads and commissions will reduce it — and they will hurt the break entry more than the retest entry, because the break enters into momentum.
Bulkowski's throwback statistics are measured on US daily stocks over decades. They are the reason the questions are asked. They are NOT the answer, and this tool will tell you so if your instrument disagrees.
The verdict is allowed to be "NO DIFFERENCE — pick either", and on many instruments it will be. That is a real result. A tool that cannot report its own failure is an advertisement, not a measurement.
Nothing in this script predicts price.
DISCLAIMER
Research and educational tool only. NOT financial advice, NOT a recommendation, and NO guarantee of results. Entry, stop and target output is arithmetic, not advice. Trading carries risk of loss. Test out-of-sample and make your own decisions. The author accepts no liability for any use.
Indicator
Trendline Architect [Quantum Algo]Trendline Architect
====================================================
🔶 OVERVIEW
Trendline Architect is an automatic trendline indicator that does what most trendline tools skip: it validates every line before drawing it, makes each line earn its status through real touches, grades every breakout by quality, and then automates the break-and-retest sequence that trendline traders normally track by hand. Lines are born as dotted candidates, promoted to solid confirmed trendlines only after the market validates them with a third touch, graded on breakout, kept on a retest watch after they break, and paired into parallel channels automatically — all with a deliberately quiet chart: one-letter signals whose full context lives in hover tooltips.
The problem this script solves is trendline spaghetti and trendline noise. Automatic trendline tools typically draw every pivot-to-pivot connection and alert on every violation. This engine rejects invalid lines at birth, refuses duplicates, caps how many lines can exist per side, silences the breaks of unproven lines by default, and filters weak breakouts by grade — so what remains on the chart is only what the market has actually respected.
🔶 WHAT IS A TRENDLINE BREAK AND RETEST?
A trendline connects successive swing points and acts as dynamic support or resistance while price respects it. A breakout occurs when price closes decisively through the line. The retest is what disciplined traders wait for next: price returning to the broken line from the other side and rejecting — old support acting as new resistance, or old resistance reclaimed as support. That return-and-reject is one of the most traded patterns in classical charting, and this engine detects the entire sequence automatically: validated line, graded break, watch window, confirmed retest.
🔶 WHY THIS SCRIPT IS ORIGINAL
1. Geometric validity at birth. A candidate line is rejected before it is ever drawn if any candle close violated the segment between its two anchor pivots. Lines that were never respected never reach the chart.
2. Touch-earned lifecycle. Every line starts as a dotted, untagged candidate. Each validated touch — a wick into tolerance with a close that respects the line — is counted, and only at the configured touch count is the line promoted: solid, thicker, fully colored, with a live ×N touch tag. The chart itself shows which lines the market obeys.
3. Anti-spaghetti engineering. Duplicate candidates with similar slope and position are refused, each side is capped at a configurable number of active lines with the weakest evicted first, and stale lines expire by age. The chart stays readable on every timeframe.
4. Breakout quality grading. Every breakout is scored from three observable components — volume z-score, penetration depth in Average True Range units, and breakout candle body ratio — into grades A, B, and C. Grade A signals highlight in the accent color.
5. A retest engine. Broken lines are not deleted; they turn into gray watch lines for a configurable window. A return to the broken line with a rejecting close prints the Retest signal — the classic polarity flip, automated.
6. Silence by default, depth on demand. Signals print as single letters — B for breakout, R for retest — with the full context (direction, grade, volume, penetration) in the hover tooltip. Two noise filters ship enabled: breaks of unconfirmed lines retire silently, and breakouts below a minimum grade stay off the chart and out of the alerts.
7. Automatic channel detection. When an active support line and resistance line run parallel within a slope tolerance, the engine fills the channel between them and reports it on the dashboard.
8. A live architecture dashboard. Active support and resistance counts, the nearest line with its distance in Average True Range units, a trend read derived from confirmed line slopes, the last break grade, the retest watch count, and channel status — in a compact, fully themeable panel.
🔶 HOW IT WORKS
Line construction: Confirmed swing pivots anchor every candidate line. Each new pivot is paired with the previous same-side pivot, the segment is checked for historical violations, duplicates are rejected, and side capacity is enforced before the line is created.
Touch validation: A touch counts only when the wick enters the tolerance band around the line and the close still respects it. Touches accumulate on the line's tag; the confirming touch promotes the line and, from that point, validated touches are marked with dots.
Breakouts: A close through the line beyond the buffer triggers the break. Confirmed lines produce graded signals; forming lines retire silently when the default filter is on. The broken line converts to a gray dashed watch line.
Retests: Within the watch window, a return to the broken line with a rejecting close prints R — upward reclaim of broken resistance, or downward rejection at broken support. Watch lines that see no retest expire quietly.
Channels: Active opposite-side lines are compared by slope; the closest parallel pair within tolerance is filled as a channel.
Non-repainting: Pivots require confirmation, and all touches, promotions, breaks, and retests are evaluated on closed bars only. Once printed, nothing moves.
Chart hygiene: Completed lines, touch dots, and signals are all capped by input, keeping the chart clean and the auto-scale anchored to current price.
🔶 HOW TO USE IT
1. Works on any market — cryptocurrency, forex, gold, indices, stocks, futures — and any timeframe. Raise the pivot length for larger structures.
2. Trust the visual hierarchy: dotted lines are candidates, solid lines with ×N tags are market-validated, gray dashed lines are broken and on retest watch.
3. Treat B signals as regime information: grade A breakouts with volume and penetration carry far more weight than the minimum-grade ones, and the grade is one hover away.
4. The R signal is the classic entry location: the broken line has flipped roles and price has confirmed the flip. Stops belong on the far side of the retested line.
5. Use the dashboard's Nearest row to know how far price is from the closest active line in Average True Range units before it gets there.
6. If you want the raw, unfiltered feed, disable the two noise filters in Signals — the engine detects everything either way.
🔶 SETTINGS
- Detection: pivot length, maximum anchor span, active lines per side, line expiry, completed lines to keep.
- Touches, breaks and retests: touch tolerance, touches to confirm, breakout buffer, retest watch window.
- Signals: breakout and retest toggles, confirmed-lines-only filter, minimum breakout grade.
- Channel detection with slope similarity tolerance.
- Full color customization, extension length, touch dots toggle.
- Themeable dashboard: position, four text sizes, title band, background, frame, grid, and three text colors.
🔶 ALERTS
- Trendline Confirmed — a line collected its confirming touch.
- Bullish / Bearish Trendline Breakout — a qualified close through a line, honoring the grade filter.
- Bullish / Bearish Retest Confirmed — a broken line was retested and rejected.
- Parallel Channel Detected — an active support and resistance pair is running as a channel.
🔶 FREQUENTLY ASKED QUESTIONS
Does the indicator repaint? No. Anchors are confirmed pivots and every touch, break, and retest is evaluated at bar close. Pivot confirmation introduces intentional lag equal to the pivot length.
Why do I see so few lines? By design. Between geometric validation, duplicate rejection, side caps, and expiry, only lines with genuine market respect survive. Raise the per-side cap or lower the confirmation count for a busier chart.
What do B and R mean? B is a graded breakout and R is a confirmed retest of the broken line. Hover either label for direction, grade, volume, and penetration details.
Why did a breakout print no signal? Either the line was still unconfirmed while the confirmed-only filter is on, or the break graded below your minimum. The line still changed state; only the signal was filtered.
What makes a grade A breakout? Elevated volume, deep penetration beyond the line in Average True Range terms, and a strong-bodied breakout candle — all three together.
🔶 CREDITS
Trendline analysis, breakout trading, and the break-and-retest pattern are classical charting techniques in the public domain, refined by generations of technicians. This script gratefully acknowledges that shared lineage. The geometric validity engine, touch-earned lifecycle, breakout grading model, retest watch engine, channel detection, noise-filtering architecture, and all code in this script are original work — no third-party or open-source script code was reused.
🔶 LIMITATIONS
Trendlines are geometry, not guarantees: valid lines break and graded breakouts fail. Pivot confirmation delays anchor recognition by design. Volume grading is less meaningful on symbols with unreliable volume reporting. Channel detection reports the closest parallel pair, not every possible channel. No indicator replaces independent analysis.
🔶 DISCLAIMER
This script is provided strictly for educational and informational purposes. It is not financial advice, an investment recommendation, or a solicitation to buy or sell any financial instrument. Past behavior of any trendline, breakout, or retest does not guarantee future results. Trading involves substantial risk. Always do your own research and manage risk independently.
Indicator
Retest & Break Setup [LuxAlgo]The Retest & Break Setup indicator identifies and tracks price action structures where price breaks a pivot level, retests it multiple times, and subsequently breaks out to confirm the trend.
🔶 USAGE
The indicator identifies "Retest & Break" patterns by monitoring pivot levels (Pivot Highs for bullish setups and Pivot Lows for bearish setups). A setup begins when a pivot is broken by price. The script then tracks whether price returns to "retest" this broken level as support or resistance.
A setup is considered "completed" once the required number of retests is met and price breaks out past the newly formed extreme established during the retest phase. For bullish setups, this means price must close above the highest high reached during the retest period. For bearish setups, price must close below the lowest low reached during the retest period.
A completed bullish setup suggests that price is likely to continue moving higher, while a bearish setup suggests a move lower. The logic behind this is often linked to liquidity; as price retests a level multiple times without breaking back through, liquidity (such as stop-loss orders) builds up just beyond the retest extremes.
When price finally breaches these levels, this concentrated liquidity can act as fuel, accelerating the breakout and confirming the new trend direction.
🔹 Parameters and Setup Sensitivity
The behavior of the indicator is highly dependent on four primary settings:
Length: Determines the significance of the initial pivot. A higher value identifies major swing points, while a lower value identifies minor intraday levels.
Required Consecutive Retests (K): Specifies how many times price must touch the broken level without breaking back through it. Increasing this value requires more confirmation before a setup is considered valid.
Max Bars between Retests (P): Controls the "tightness" of the retest phase. If price takes too long to return for a retest, the setup is invalidated.
Max Bars for Break (N): Defines the window of opportunity for the final breakout. After the required retests are met, price must break the recent extreme (high for bullish, low for bearish) within this many bars.
🔹 Finding Long-Term vs. Short-Term Setups
For users looking for longer-term, more significant setups, it is recommended to increase the Length (e.g., 10-20) and the Max Bars parameters ( N and P ) to allow for the slower price development typical of higher timeframes or major trend shifts.
Conversely, for scalping or fast-moving markets, lower values for Length and P will highlight quick "touch-and-go" patterns.
🔶 DETAILS
The indicator includes a comprehensive dashboard to help users evaluate the historical reliability of the identified structures on the current chart and timeframe.
🔹 Dashboard Metrics
Total: This counts the number of setups that successfully completed the initial break and all required K retests. It represents the "Potential" setups that reached the final stage.
Completion: This tracks how many of the "Total" setups actually achieved a confirmed breakout past the retest extreme within the N bars limit.
Win Rate: This is a predictive performance metric. For every "Completed" setup, the script records the price at the moment of breakout. After N bars have passed since that breakout, it checks if price is still above (bullish) or below (bearish) the breakout level.
🔹 Visualization
The script uses dashed lines to represent the broken pivot level being retested. Solid lines represent the "trigger" level (the extreme of the retest phase). When a setup is completed, a shaded box appears, and a "Break" label is plotted. If "Only Show Complete Setups" is disabled, invalidated setups will remain on the chart in a faded gray color for study.
🔶 SETTINGS
Length: The lookback period used to detect Pivot Highs and Lows.
Max Bars for Break (N): The maximum time allowed for price to break out after the final retest.
Max Bars between Retests (P): The maximum time allowed between the initial break and the first retest, or between subsequent retests.
Required Consecutive Retests (K): The number of successful retests required to validate the zone.
Only Show Complete Setups: When enabled, removes setups from the chart that failed to meet the retest or breakout criteria.
Setup Colors: Customizable colors for bullish, bearish, and invalidated patterns.
Dashboard Settings: Options to toggle the dashboard visibility, change its position on the chart, and adjust its size.
Indicator
Gravity Trend Levels [BOSWaves]Gravity Trend Levels - Acceleration-Derived Gravity Modeling with Adaptive Cloud Trail and Fail Level Projection
Overview
Gravity Trend Levels is a momentum acceleration-based trend system that models directional gravity through the normalized rate of change of an EMA-derived velocity measurement, where cloud thickness, trail distance, and trend state are continuously adapted based on whether gravitational pull is building, sustained, or decaying rather than through fixed volatility multipliers or static band thresholds.
Instead of relying on conventional moving average crossovers or ATR-scaled bands that treat all market conditions identically, trend state and cloud positioning are determined by measuring price acceleration relative to MAD-normalized volatility, converting that acceleration into a gravity score that decays exponentially when momentum diminishes and drives adaptive band interpolation between configurable tight and wide trail distances.
This creates a trend framework where the cloud reflects genuine momentum dynamics rather than arbitrary indicator levels. The cloud tightens and hugs price during high gravity periods when acceleration is strong and directional pull is confirmed, expands during gravity decay when momentum is weakening, and generates gravity fail levels at the precise price points where trend state changed, marking the exact locations where prior gravitational force collapsed and direction reversed.
Price is therefore evaluated against a cloud that continuously updates its distance from price based on measured acceleration dynamics, producing a trail that reflects the actual pull state of the current trend rather than applying a uniform band regardless of momentum conditions.
Conceptual Framework
Gravity Trend Levels is founded on the principle that trend confidence should be measured through the acceleration characteristics of price momentum rather than through price position relative to fixed indicators, and that the distance between price and its trailing cloud boundary should dynamically reflect whether momentum is actively pulling price in the trend direction or losing gravitational force.
Traditional trend-following tools apply consistent band distances regardless of whether momentum is surging or stalling, producing identical visual representations for high-conviction and deteriorating trend conditions. This framework replaces uniform band geometry with an acceleration-driven gravity model where band distance shrinks under strong gravitational pull and expands as gravity decays, communicating trend health through cloud behavior rather than requiring separate momentum indicators for context.
Three core principles guide the design:
Gravitational pull should be derived from normalized price acceleration rather than from price position alone, ensuring that cloud behavior reflects actual momentum intensity rather than the mere direction of a smoothed average.
Cloud thickness and trail distance should adapt continuously to the measured pull state, contracting during strong gravity and expanding during decay to provide a visual representation of trend conviction at all times.
Gravity fail levels should be projected from the precise price points where trend state changed, marking the locations where gravitational force reversed as permanent structural references for future price interaction.
This shifts trend analysis from static band monitoring into continuous gravitational force measurement where cloud dynamics communicate momentum state and fail levels preserve the structural evidence of prior gravity collapses.
Theoretical Foundation
The indicator combines EMA-based trend baseline construction, MAD volatility measurement, velocity and acceleration derivation from baseline rate of change, gravity scoring with exponential decay, and adaptive trail interpolation that maps pull strength to band distance.
The trend baseline is calculated as an EMA of close over the configured length, providing a smoothed directional reference. Velocity measures the change in baseline over the gravity lookback period, and acceleration measures the bar-to-bar change in velocity. Acceleration is normalized by MAD to produce a dimensionless score that reflects momentum change intensity relative to current volatility. When normalized acceleration exceeds the minimum threshold, gravity is set proportionally to the acceleration reading and capped at a maximum value. When acceleration falls below the threshold, gravity decays multiplicatively by the configured decay rate each bar. Pull converts gravity to a normalized 0-1 range that drives trail multiplier interpolation between the minimum tight distance and the maximum wide distance.
Four internal systems operate in tandem:
Gravity Detection Engine : Derives velocity from EMA baseline change over the gravity lookback, calculates acceleration as the bar-to-bar velocity change, normalizes against MAD, and updates the gravity state either by setting it proportional to current acceleration or applying exponential decay when acceleration subsides.
Adaptive Trail Construction : Converts gravity to a normalized pull value and interpolates the trail multiplier between the configured minimum and maximum settings, scaling MAD to produce upper and lower band distances from the baseline that tighten with strong pull and widen with decay.
Gravity Cloud System : Constructs a one-sided cloud positioned below price in uptrends and above price in downtrends, with cloud thickness scaling proportionally to current pull strength through a separate MAD-scaled thickness calculation that produces a visually dynamic pull indicator.
Gravity Fail Level Engine : On each trend state switch, projects a horizontal line from the flip bar's low for bullish flips and high for bearish flips, extending forward for the configured projection length to mark the price level where prior gravitational force collapsed and direction changed.
This design allows the cloud and trail to respond continuously to gravity dynamics while fail levels accumulate as a historical record of structural gravity collapses.
How It Works
Gravity Trend Levels evaluates price through a sequence of acceleration-aware and gravity-driven processes:
Baseline Calculation : EMA smoothing of close over the configured trend length produces the directional reference from which velocity and acceleration are derived.
MAD Volatility Measurement : Mean Absolute Deviation over the configured length provides the adaptive volatility unit that normalizes acceleration and scales all band and cloud distances.
Velocity Derivation : The difference between the current baseline and the baseline a configurable number of bars ago provides the velocity reading that captures the rate of directional change in the smoothed trend.
Acceleration Calculation : The bar-to-bar change in velocity produces the acceleration reading, which captures whether directional momentum is intensifying or diminishing.
Gravity State Update : Normalized acceleration above the minimum threshold sets gravity proportionally to the acceleration magnitude scaled by eight and capped at two. Below the threshold, gravity decays by multiplying by the configured decay rate each bar.
Pull Normalization : Gravity is divided by 1.5 and capped at one to produce a normalized pull value that maps the full gravity range to a 0-1 scale for trail interpolation.
Trail Multiplier Interpolation : The pull value interpolates between the maximum trail distance at zero pull and the minimum trail distance at full pull, producing a continuously adapting multiplier that scales MAD into upper and lower band distances.
Trend State Logic : Price crossing above the upper band triggers bullish state. Price crossing below the lower band triggers bearish state. State persists until the opposing band is breached.
Cloud Construction : The active cloud positions at the lower band in uptrends and upper band in downtrends, with an inner boundary offset by a pull-scaled thickness producing a two-edge cloud whose depth visually reflects current gravitational pull.
Gravity Fail Level Projection : On each trend switch, a horizontal line is projected from the flip bar at the bar's low for bullish flips and high for bearish flips, extending forward for the configured projection length as a structural fail reference.
Retest Diamond Detection : After the configured signal buffer period from the most recent flip, price touching the cloud inner edge triggers a retest diamond marker with a configurable minimum bar cooldown between consecutive signals on the same side.
Together, these elements form a continuously updating gravity-driven trend system where cloud dynamics reveal pull strength, fail levels mark structural collapse points, and retest diamonds identify price interactions with the inner cloud boundary throughout the trend.
Interpretation
Gravity Trend Levels should be interpreted as a momentum-gravity conviction system with dynamically adaptive cloud geometry and structural fail level mapping:
Bullish Trend State (Green) : Established when price closes above the upper adaptive band, with the gravity cloud positioned below price reflecting the upward gravitational pull state.
Bearish Trend State (Red) : Established when price closes below the lower adaptive band, with the gravity cloud positioned above price reflecting the downward gravitational pull state.
Gravity Cloud : The one-sided filled zone between the outer and inner cloud boundaries reflects current pull strength through its thickness. A thick cloud indicates strong gravitational pull with high trend conviction. A thin cloud indicates gravity decay and diminishing directional force.
Cloud Outer Edge : The primary structural boundary of the gravity cloud, positioned at the active adaptive band and colored fully in the trend direction, representing the outer limit of the gravitational field.
Cloud Inner Edge : The pull-scaled inner boundary of the cloud, representing the nearer edge of the gravitational zone and the threshold for retest diamond detection.
Gravity Fail Levels : Horizontal lines projected from trend flip bars at the flip bar's low for bullish flips and high for bearish flips, marking the exact price level where prior gravitational force collapsed. These levels persist as structural references for the configured projection length.
𝑩 Buy Signals : Green labels appearing below the bar when trend state switches from bearish to bullish, marking the gravity flip bar where upward pull has been established.
𝑺 Sell Signals : Red labels appearing above the bar when trend state switches from bullish to bearish, marking the gravity flip bar where downward pull has been established.
✦ Retest Diamonds : Small star diamonds plotted below bars during bullish retests and above bars during bearish retests when price touches the cloud inner edge after the signal buffer period, identifying interactions with the gravitational boundary during the trend.
Colored Candles : Optional bar coloring reflects current trend state direction, providing continuous directional context independent of cloud proximity or signal generation. Note: The original chart candles must be disabled in chart settings for the trend-colored candles to display properly.
Cloud thickness dynamics, fail level locations, and retest diamond positioning collectively provide more information than trend direction alone.
Signal Logic & Visual Cues
Gravity Trend Levels presents two primary trend transition signals alongside continuous cloud retest monitoring:
Buy Signal (𝑩) : Green label appears when trend state switches from bearish to bullish via upper band crossover, indicating gravitational pull has reversed to the upside and a fail level is projected from the flip bar's low.
Sell Signal (𝑺) : Red label appears when trend state switches from bullish to bearish via lower band crossunder, indicating gravitational pull has reversed to the downside and a fail level is projected from the flip bar's high.
Retest diamond detection provides continuous secondary monitoring, marking price touches of the cloud inner edge throughout the established trend after the signal buffer period with per-side cooldown enforcement.
Alert generation covers bullish and bearish gravity trend flips and any retest diamond occurrence for systematic monitoring workflows.
Strategy Integration
Gravity Trend Levels fits within momentum-informed and adaptive trend-following approaches:
Gravity Flip Entries : Use trend state switches as primary entry triggers where gravitational acceleration has driven price through the adaptive band, entering in the flip direction with the projected fail level providing an immediate structural reference for invalidation.
Cloud Thickness Conviction Reading : Monitor cloud thickness as a real-time gravity strength gauge. A thick, prominent cloud indicates strong active pull supporting the trend. A thin, contracting cloud warns of gravitational decay and warrants reduced confidence in trend continuation.
Fail Level Framework : Use gravity fail levels as structural references for subsequent price interaction, monitoring whether price respects or violates the level where prior gravity collapsed to assess the structural significance of the most recent trend change.
Retest Diamond Re-entry : Treat cloud inner edge retests after the signal buffer period as potential continuation opportunities within the established trend, using the diamond signal as a lower-risk re-entry reference relative to the initial flip signal.
Cloud Proximity Risk Management : Use the outer cloud edge as a dynamic trailing reference for position management, maintaining directional bias while price remains beyond the cloud and reassessing when price approaches or enters the gravitational zone.
Multi-Timeframe Gravity Alignment : Apply higher-timeframe gravity trend state as a directional bias filter, engaging with lower-timeframe flip signals only when they align with the established higher-timeframe gravitational direction.
Technical Implementation Details
Core Engine : EMA baseline with MAD volatility measurement for adaptive scaling
Gravity Model : Velocity from baseline rate of change, acceleration from velocity change, MAD normalization, proportional gravity setting with exponential decay
Adaptive Trail : Pull-normalized interpolation between configurable minimum and maximum MAD multipliers
Cloud Construction : One-sided pull-scaled thickness fill between outer and inner boundaries with EMA smoothing on both edges
Fail Levels : Flip-triggered horizontal line projection from bar extreme at configurable length and width
Retest System : Inner cloud edge proximity detection with signal buffer and per-side cooldown enforcement
Visualization : Gravity cloud fill, fail level lines, trend flip labels, retest diamond markers, and optional trend candle coloring
Performance Profile : Optimized for real-time execution across all timeframes with stateful gravity variable maintaining continuous decay between acceleration events
Optimal Application Parameters
Timeframe Guidance:
1 - 5 min : Intraday gravity tracking for scalping with shorter trend length and gravity lookback for faster acceleration detection and responsive cloud behavior
15 - 60 min : Session-level trend identification with balanced gravity decay and moderate trail settings for reliable intraday directional framing
4H - Daily : Swing-level gravity trend mapping with longer trend length and higher decay rate for sustained gravitational pull persistence across multi-session moves
Suggested Baseline Configuration:
Trend Length : 14
Gravity Lookback : 19
Gravity Decay : 0.96
MAD Length : 24
Trail Min (Strong Pull) : 1.0
Trail Max (Weak Pull) : 1.0
Show Gravity Cloud : Enabled
Show Gravity Fail Levels : Enabled
Show Buy/Sell Signals : Enabled
Retest Diamonds : Enabled
Color Bars : Enabled (requires disabling original chart candles in chart settings)
These suggested parameters should be used as a baseline; their effectiveness depends on the instrument's momentum characteristics, volatility behavior, and preferred signal frequency, so fine-tuning is expected for optimal performance.
Parameter Calibration Notes
Use the following adjustments to refine behavior without altering the core logic:
Cloud too wide throughout : Decrease Trail Max to reduce band distance during low gravity periods, bringing the cloud closer to price during momentum decay phases.
Cloud too tight throughout : Increase Trail Max to allow greater band expansion during gravity decay, producing a more visually prominent cloud separation during low-conviction conditions.
Gravity builds too slowly : Decrease Gravity Lookback toward 5 for a shorter velocity measurement window that captures acceleration shifts more rapidly, producing faster gravity activation on momentum changes.
Gravity activates too frequently : Increase Gravity Lookback to smooth the velocity measurement across more bars, requiring more sustained directional change before acceleration registers as gravitational pull.
Gravity decays too quickly : Increase Gravity Decay toward 0.99 to sustain gravitational pull longer between acceleration events, maintaining cloud contraction for more bars after acceleration subsides.
Gravity lingers too long : Decrease Gravity Decay toward 0.80 for faster pull dissipation, allowing the cloud to expand more quickly when momentum weakens and reducing lag between gravity collapse and visual cloud response.
Too many retest diamonds : Increase Retest Cooldown to enforce greater bar separation between consecutive diamond markers, or increase Signal Buffer Period to delay retest detection further from each flip event.
Adjustments should be incremental and evaluated across multiple session types rather than isolated market conditions.
Performance Characteristics
High Effectiveness:
Trending markets with clear momentum phases where gravitational acceleration builds and sustains across multiple bars, producing thick, persistent clouds that visually confirm directional pull throughout the move
Instruments with consistent volatility behavior where MAD normalization accurately calibrates acceleration significance and cloud distance across varying market conditions
Momentum continuation strategies where cloud retest diamonds identify lower-risk re-entry points within established gravity trends after the initial flip signal
Structural reference frameworks where gravity fail levels provide meaningful historical markers at the exact price points where prior directional momentum collapsed
Reduced Effectiveness:
Choppy, low-momentum markets where acceleration readings oscillate without sustained directional pull, producing frequent gravity flips and thin clouds that fail to establish meaningful directional framing
Extremely volatile environments where individual bar acceleration spikes generate momentary gravity readings that decay before producing sustained cloud contraction or reliable trend state persistence
News-driven or gap-heavy instruments where instantaneous momentum changes trigger gravity activation and immediate flip signals without the gradual acceleration buildup the model is designed to detect
Consolidation and sideways conditions where velocity and acceleration remain near zero, preventing meaningful gravity generation and causing the cloud to remain in its expanded low-pull state without directional conviction
Mean-reversion dominant markets where band crossovers trigger frequent state changes that repeatedly project fail levels without the subsequent directional follow-through that validates their structural significance
Integration Guidelines
Confluence : Combine with BOSWaves order flow tools, volume analysis, or structural indicators to validate gravity flip signals with participation context before committing to directional positions
Cloud Thickness Monitoring : Track cloud thickness evolution throughout the trend as an ongoing gravity health assessment. Consistently thick clouds support continuation confidence while progressive thinning signals approaching decay and warrants defensive position management.
Fail Level Awareness : Monitor price behavior when it returns to prior gravity fail levels. These levels mark the exact prices where directional force previously collapsed, making them structurally meaningful references for future support, resistance, or reversal reactions.
Decay Anticipation : Use cloud thinning as an early warning of approaching gravity decay before a formal flip signal is generated. Thinning during an extended trend suggests acceleration is subsiding and the probability of a state change is increasing.
State Discipline : Maintain directional bias aligned with current gravity trend state until a confirmed band crossover flip occurs. Cloud retests and fail level interactions within an established trend do not constitute state changes and should be interpreted as continuation context rather than reversal signals.
Disclaimer
Gravity Trend Levels is a professional-grade momentum acceleration and trend conviction analysis tool. It uses acceleration-derived gravity modeling with adaptive cloud construction and structural fail level projection but does not predict future price movements. Results depend on market conditions, instrument momentum characteristics, parameter selection, and disciplined execution. BOSWaves recommends deploying this indicator within a broader analytical framework that incorporates order flow context, volume analysis, and comprehensive risk management. 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
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
Range Expansion Risk Planner [AGPro Series]Range Expansion Risk Planner
🧠 Core Idea
Does a range expansion offer clean room, or is price moving into immediate failure risk?
📌 Overview / What it does
Range Expansion Risk Planner is a chart-first breakout quality and risk-planning tool built for one specific moment: price has left a defined range, and the trader needs to understand whether the expansion has enough structure to deserve attention.
Instead of printing generic breakout signals, the script maps the source range, freezes the broken edge, builds an expansion runway, tracks a failure rail, estimates target room, evaluates retest behavior, and converts those conditions into a 0-100 planner score.
The script produces a source range box, expansion runway, failed-expansion review band, risk/target rails, full-state labels, deterministic alerts, and a clean AGPro panel. It does not predict future price movement, automate execution, or guarantee that a breakout will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate range expansion quality after price leaves a structure, not simply react to the first candle outside the range.
Many tools mark breakouts, draw range boxes, or highlight volatility expansion. The gap is the planning layer after the break: Is the source range mature? Was the expansion candle strong enough? Did price close clearly beyond the edge? Is the retest accepted or weak? Is there enough room before the next target-side reference?
The design supports a decision-first workflow. It helps users separate a clean range expansion from a weak release, blocked room, failed expansion, or early unconfirmed movement.
⚡ Why This Script Is Different
Most tools focus on breakout arrows, range highs/lows, volatility spikes, or support/resistance zones.
This script does NOT become a generic range breakout signal, a generic S/R zone map, a squeeze indicator, or a target predictor.
Instead, it evaluates the quality of the expansion plan after the range edge is broken. The main output is not a trade command. It is a planning state that helps the user decide whether the current expansion is CLEAN, on REVIEW, waiting for retest, blocked by room risk, or failing back into the source range.
⚙️ Methodology
1. Context Detection
The script maps the active source range using a user-defined lookback and detects whether price has closed beyond the upper or lower edge with enough ATR-normalized distance.
2. Reference Mapping
When a qualified expansion appears, the script freezes the source range, the broken edge, the failure rail, and the target-room marker so the plan can be reviewed consistently.
3. Reaction Evaluation
The model scores range maturity, expansion candle quality, close beyond edge, retest quality, target-room distance, and failure-rail distance.
4. Visual Output
The result is displayed through a source range box, expansion runway, failed-expansion band, risk/target rails, full-state event labels, alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the source range shows where the expansion came from. The expansion runway shows the path between the broken edge and the target-room marker. The failed-expansion band shows the area where the release may be losing structure.
Labels = full-state markers show Range Expansion, Clean Expansion, Expansion Review, Retest Accepted, Failed Expansion, Target Room Reached, Failure Risk, or Range Watch context.
Colors = teal highlights cleaner bullish expansion, pink highlights bearish or failed contexts, amber highlights review/risk states, and indigo highlights watch or target-edge states.
Panel = the panel summarizes Range Maturity, Expansion Risk, Room Risk, Confirmation, and Action.
🚦 Signals & States
• CLEAN EXPANSION → range expansion quality is strong enough to deserve active review.
• REVIEW → expansion context is developing, but confirmation or target room is incomplete.
• WAIT RETEST → price has expanded, but the broken edge has not yet been accepted clearly.
• ROOM BLOCKED → target-side room is limited relative to the current risk structure.
• FAILURE RISK → price is back inside the range or close to the failed-expansion area.
• FAILED → price crossed the failure rail and the prior expansion plan should be reviewed.
• TARGET EDGE → price reached the active target-room marker.
• RANGE WATCH → the range is mature enough to monitor, but no qualified expansion is active yet.
🔔 Alerts Logic
Alerts trigger when the planner enters clean expansion, review state, retest accepted state, failed-expansion warning, or target-room reached state.
These alerts are attention markers only. They are not trade instructions, entry signals, automated strategy commands, or guaranteed outcomes.
🧩 Confluence Logic
The strongest context appears when a mature source range releases with a strong expansion candle, price closes clearly beyond the edge, target-side room remains open, the failure rail is not too far away, and the broken edge receives constructive retest behavior.
When those components align, the planner score improves and the action state becomes cleaner.
📊 When to Use
• After price leaves a clear range
• During breakout-review workflows
• When comparing whether a release has enough room to justify attention
• When price retests the broken range edge
• On liquid symbols where ATR, range, and volume behavior are readable
• Especially on 4H swing charts, where range release, retest behavior, failure risk, and target-room context remain visually readable
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes
• News-driven candles that distort the range edge
• Markets with frequent gaps or unreliable volume
• Situations where the user expects a simple buy/sell signal
🎛️ Key Inputs
• Expansion Side → controls Auto, Long Expansion, or Short Expansion planning.
• Sensitivity → changes how selective the range maturity and edge-close requirements are.
• Source Range Lookback → defines the range used before expansion.
• ATR Length → normalizes failure rail, label spacing, expansion distance, and room risk.
• Retest Review Bars → controls how long an edge retest can improve confirmation quality.
• Target-Side Obstacle Lookback → searches for older target-side references before using the measured target.
• CLEAN / REVIEW Scores → adjust how strict the state model is.
• Visual settings → control boxes, runway, rails, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around one primary decision path: source range → expansion runway → failure rail → target room.
The panel uses the AGPro public-release standard with one merged blue header row containing only the script name. It keeps the decision fields readable without turning the chart into a crowded dashboard.
Labels keep full professional state names, are offset away from candles, and are limited by cooldown and max-visible controls.
🧪 Practical Usage Workflow
1. Read the panel action state.
2. Check whether the source range was mature enough before expansion.
3. Review the expansion runway and target-room marker.
4. Check whether price accepted the broken edge or moved back into failure risk.
5. Use alerts as attention markers, then evaluate the broader market context.
🔍 Interpretation Guidelines
A higher score means the model sees better alignment between source range quality, expansion candle quality, edge close, retest behavior, and target room.
CLEAN EXPANSION does not mean a trade must be taken. It means the expansion structure is clean enough to deserve active review.
REVIEW means the release may be developing, but the user should check confirmation and room quality before treating it as clean.
FAILED and FAILURE RISK are caution states. They help identify when an expansion is losing structure after leaving the range.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed signals.
It does not replace user judgment, risk management, or broader market analysis.
⚠️ Limitations & Transparency
Timeframe differences can change how range maturity, retests, and target-room references appear.
Volatility changes can widen failure rails or reduce clean target room.
Fast market conditions can move from CLEAN to FAILED quickly if price returns into the source range.
The script is rule-based and should be interpreted as an analytical planning layer, not as certainty.
🧠 Market Context Notes
Range expansion quality is not only about breaking the edge. A cleaner expansion usually needs a readable source range, a decisive close beyond the edge, enough room before obstruction, and a failure reference that is not too wide.
The planner is most useful when it prevents users from treating every breakout as equal.
🧾 Use Case Examples
When price closes beyond a mature range and the target-room marker remains far enough away, the planner may move into REVIEW or CLEAN EXPANSION.
When price retests the broken edge and holds outside the range, confirmation can improve.
When price closes back through the failure rail, the planner marks FAILED so the old expansion idea is not treated as clean anymore.
🧱 System Philosophy
Range Expansion Risk Planner follows the AGPro Series decision-engine approach:
Context first.
Risk before reaction.
Structure before signal.
Attention markers instead of promises.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No score, state, label, alert, range box, runway, or rail should be interpreted as guaranteed market direction.
📉 Risk Disclosure
Trading involves risk.
All decisions remain the responsibility of the user.
This script is for educational and analytical chart review only and does not provide financial advice.
📚 Educational Note
Use this script to study how range expansions develop, how broken edges behave after release, and how failure risk can be organized visually before making discretionary decisions.
Indicator
Breakout Retest Readiness [AGPro Series]Breakout Retest Readiness
🧠 Core Idea
Is the post-breakout retest being accepted with structure, or is the breakout losing quality at the risk edge?
📌 Overview / What it does
Breakout Retest Readiness is a chart-first planning tool built to evaluate what happens after a confirmed breakout and after price starts interacting with the retest pocket.
The script maps the broken structure level, builds a retest pocket around it, places a risk-edge shelf beyond the pocket, and projects a target-room guide for context. It then scores the active retest environment with a 0-100 Acceptance Score and displays a clear next-action state in the AG Pro panel.
This script does not predict continuation. It does not automate entries. It is designed to organize post-breakout retest context so traders can review acceptance, rejection, risk edge, and plan quality in a cleaner way.
🎯 Purpose & Design Philosophy
Most breakout tools focus on the moment price crosses a level. In practice, many useful decisions happen after the break, when price returns toward the broken level and either accepts it or fails around it.
This script was built for traders who want a structured retest planning layer rather than another basic breakout marker. It supports a patient workflow: wait for structure, observe the pocket, evaluate acceptance, and review risk before reacting.
The design philosophy is simple: the chart should answer what state the retest is in, how strong the acceptance context is, where risk is being tested, and what the next review step should be.
⚡ Why This Script Is Different
Most tools focus on detecting a breakout or grading the first retest as a standalone signal.
This script does NOT try to clone a classic break-retest quality grader, and it does not print simple buy or sell commands.
Instead, it works as a post-breakout readiness planner. It arms a retest pocket after a confirmed breakout, waits for price to interact with that pocket, evaluates acceptance versus rejection, tracks the risk edge, and keeps the next-action state visible in the panel.
The difference is the decision layer. The script is less about saying "a retest happened" and more about answering whether the active retest environment is constructive enough to keep reviewing.
⚙️ Methodology
1. Context Detection
The script identifies a confirmed break beyond recent structure using a prior high or prior low reference. The breakout must clear the structure by an ATR-normalized buffer so minor pokes are filtered.
2. Reference Mapping
After a valid break, the script stores the breakout line, builds a retest pocket around it, places an invalidation shelf beyond the broken level, and projects a target-room guide from the prior structure range.
3. Reaction Evaluation
When price interacts with the retest pocket, the script evaluates breakout quality, retest depth, wick rejection, volume change, and trend agreement. These components combine into a 0-100 Acceptance Score.
4. Visual Output
The chart shows the active retest pocket, breakout line, risk edge, target guide, compact event labels, and the AG Pro panel. The panel summarizes retest state, acceptance score, breakout quality, risk edge, and action.
🗺️ How to Read the Chart
Retest Pocket = the zone around the broken structure level where price is being evaluated after the breakout.
Breakout Line = the structure level that was crossed and now anchors the retest plan.
Risk Edge = the invalidation shelf beyond the retest pocket. It is a planning reference, not a stop recommendation.
Target Guide = a target-room marker projected from the prior range. It is context only, not a forecast.
Labels = compact state markers such as ARMED, TEST, ACCEPT, REJECT, RISK EDGE, or EXPIRE.
Colors = bullish retest plans use the AGPro teal tone, bearish plans use the AGPro pink tone, watch states use indigo or amber, and risk conditions use red.
Panel = the main decision interface showing retest state, acceptance score, breakout quality, risk edge, and next action.
🚦 Signals & States
• Breakout Armed → a breakout retest plan has been created after price cleared structure.
• Testing Pocket → price is interacting with the active retest pocket and acceptance is being evaluated.
• Accepted Retest → the retest has held the pocket with enough acceptance quality to deserve review.
• Rejected Retest → the retest has failed around the pocket and quality has weakened.
• Risk Edge Hit → price has moved beyond the mapped risk shelf.
• Expired → the retest window aged out before a constructive interaction.
🔔 Alerts Logic
Alerts are available for breakout plan arming, retest pocket interaction, accepted retest readiness, rejected retest or risk-edge pressure, and expired retest plans.
Each alert is an attention marker. Alerts do not represent trade instructions, guaranteed outcomes, or automated strategy decisions.
🧩 Confluence Logic
The strongest acceptance context appears when the breakout quality, retest depth, wick rejection, volume behavior, and trend agreement support the same side.
When these components align, the retest score improves. When the pocket is too deep, volume behavior is poor, trend context disagrees, or the risk edge is pressured, the readiness state weakens.
📊 When to Use
• After clean breakouts from recent structure
• During trend continuation review
• When price returns toward a broken level
• When the trader wants to separate constructive retests from weak post-break reactions
• On liquid symbols where structure, volume, and candle behavior are readable
⚠️ When NOT to Use
• Extremely low-liquidity instruments
• Highly noisy lower timeframes
• News-driven volatility spikes
• Markets with no clear structure reference
• Situations where the breakout level is too close to major external obstruction
🎛️ Key Inputs
• Breakout Structure Lookback → controls the prior structure reference used for breakout detection.
• Maximum Bars To Retest → controls how long the script waits for the retest pocket to matter.
• Sensitivity → adjusts how strict the breakout and acceptance model should be.
• Minimum Acceptance Score → defines the score needed before accepted readiness can appear.
• Retest Pocket Width ATR → controls the width of the post-breakout pocket.
• Invalidation Shelf ATR → controls the mapped risk-edge distance beyond the broken level.
• Target Guide Range Multiple → controls the forward target-room guide.
• Visual Settings → control pockets, lines, labels, label density, label size, and forward rendering.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is built around a clean AG Pro panel and one main chart object family: the retest pocket.
The pocket label is centered inside the zone so the active state is visible without needing extra clutter. The breakout line, invalidation shelf, and target guide create a simple visual hierarchy: level, risk, and room.
Labels are intentionally compact and controlled by cooldown and maximum-visible settings so the chart remains active without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Locate the active retest pocket.
3. Check whether price is testing, accepting, rejecting, or pressing the risk edge.
4. Compare the Acceptance Score with the breakout quality.
5. Use the action row as a review prompt, not as an instruction.
🔍 Interpretation Guidelines
The Acceptance Score should be read as context quality, not certainty.
A higher score means the current retest has cleaner structural behavior under the script's rules. A lower score means the retest is less constructive, too deep, poorly supported, or not aligned with trend context.
The Risk Edge matters because a retest can look acceptable for a few bars and still lose structure if price pushes beyond the invalidation shelf. The panel keeps that condition visible.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an auto-trading system.
This script does not provide guaranteed signals.
This script is not a generic support and resistance map.
This script is not a clone of a first-retest grading tool.
⚠️ Limitations & Transparency
The script is rule-based and depends on the selected lookback, timeframe, and market structure.
Different symbols can produce different retest behavior. Lower timeframes may show more noise. Higher timeframes may produce fewer but stronger events.
Volatility changes can affect pocket size, risk-edge distance, and event frequency. Users should interpret every output within broader market context.
🧠 Market Context Notes
Breakout retests are most useful when structure is clear, liquidity is sufficient, and price has enough room to continue without immediate obstruction.
Volume behavior can add context, but volume data quality varies across markets. When volume is unreliable, the script treats that component more neutrally.
The retest pocket is not a guaranteed support or resistance zone. It is a structured review area around the broken level.
🧾 Use Case Examples
When price breaks above recent structure and later returns to the pocket with a controlled pullback, the script can mark the retest as Testing Pocket or Accepted Retest depending on score quality.
When price breaks below structure but quickly pushes back above the pocket and pressures the mapped risk edge, the script can mark rejection or risk-edge pressure.
When a breakout never returns to the pocket within the selected time window, the script can expire the plan instead of keeping old context alive.
🧱 System Philosophy
AGPro tools are designed to support structured chart reading. The goal is not to add more random signals, but to turn market behavior into clearer states, cleaner context, and better review discipline.
Breakout Retest Readiness follows that philosophy by turning a common post-breakout question into a visible planning workflow.
🔐 Non-Promise Statement
No script can confirm future price direction with certainty.
This tool organizes retest context. It does not promise continuation, reversal, profit, or accuracy.
📉 Risk Disclosure
Trading involves risk.
All outputs from this script are educational and analytical in nature.
Users are responsible for their own decisions, risk management, position sizing, and market interpretation.
This script does not provide financial advice.
📚 Educational Note
Use the script to study how breakouts behave after price returns to the broken level. The most useful insight is often not the breakout itself, but how the market reacts when the level is tested again.
Indicator
1-2-3 Reversal Map [AGPro Series]1-2-3 Reversal Map
🔹 OVERVIEW
1-2-3 Reversal Map is a focused TradingView overlay built for traders who want a clean, structured way to follow one of the most recognizable reversal formations in price action: the confirmed 1-2-3 reversal.
This tool maps the full life cycle of a 1-2-3 structure. It identifies the confirmed swing sequence, marks Point 1, Point 2, and Point 3, projects the neckline from Point 2, evaluates the neckline break, and highlights the retest pocket after confirmation. The goal is not to fill the chart with generic reversal signals. The goal is to make the actual 1-2-3 process easier to see, compare, and track.
The script is designed around visual clarity. The latest active structure stays readable through numbered swing labels, restrained guide lines, a clearly identified neckline, and a concept-specific retest pocket. The panel then summarizes the current stage, neckline status, retest status, and reversal score in a compact AG Pro layout.
🔹 WHAT MAKES IT DIFFERENT
Most reversal tools try to do too many things at once. They mix candle patterns, double tops, double bottoms, head and shoulders structures, failed breakouts, generic support and resistance zones, trend filters, and broad reversal markers into one crowded chart.
1-2-3 Reversal Map takes a more disciplined approach. It stays inside one lane: the confirmed 1-2-3 reversal sequence.
The script does not mark every possible turning point. It waits for a defined swing chain:
1. Point 1 establishes the original swing extreme.
2. Point 2 forms the neckline reference.
3. Point 3 confirms that price has created a structurally relevant retracement.
4. The neckline break turns the structure from a setup into a confirmed map.
5. The retest pocket shows where the broken neckline can be evaluated again.
This creates a cleaner workflow than broad reversal scanners. Instead of asking the chart to show everything, the script asks one focused question: has a valid 1-2-3 structure progressed from swing formation to neckline break and retest behavior?
🧭 WHY THIS DOES NOT OVERLAP WITH OTHER AGPRO TOOLS
This script was intentionally built to avoid overlapping with other AGPro public tools.
It is not a broad reversal pattern scanner. It does not combine double top, double bottom, head and shoulders, inverse head and shoulders, wedge, or candle-pattern logic. It focuses only on the 1-2-3 reversal sequence.
It is not a Turtle Soup or failed-breakout tool. It does not begin with a failed range break or liquidity sweep. Its starting point is a confirmed three-point swing structure.
It is not a wedge reversal tool. It does not evaluate converging trendlines, compression geometry, or wedge breakout behavior.
It is not a generic support and resistance map. The rectangle is not a general zone engine. It is a neckline retest pocket that appears only after a valid 1-2-3 neckline break.
It is not a breakout dashboard. Breakout logic exists only as one stage inside the 1-2-3 reversal process.
This makes the script narrow enough for a differentiated AGPro release while still being visually useful and searchable for traders who specifically look for 1-2-3 reversal structure, neckline break, and retest confirmation workflows.
⚙️ METHODOLOGY
The script uses confirmed pivot structure to define each 1-2-3 sequence.
For a bullish 1-2-3 structure:
- Point 1 is a confirmed swing low.
- Point 2 is the recovery swing high and neckline reference.
- Point 3 is a higher low that holds above Point 1.
- The neckline break requires price to close beyond Point 2 with a configurable ATR buffer.
- The retest pocket is projected around the broken neckline after confirmation.
For a bearish 1-2-3 structure:
- Point 1 is a confirmed swing high.
- Point 2 is the reaction swing low and neckline reference.
- Point 3 is a lower high that holds below Point 1.
- The neckline break requires price to close beyond Point 2 with a configurable ATR buffer.
- The retest pocket is projected around the broken neckline after confirmation.
The reversal score is structure-native. It evaluates:
- P1-P2 leg size relative to ATR
- Point 3 hold quality
- P3 retracement balance
- Timing symmetry between structure legs
- Break distance beyond the neckline
- Break candle body quality
- Close location inside the break candle
- Optional volume participation
The score is not designed as a prediction model. It is a ranking layer for comparing the quality of structures that meet the script's own rules.
📊 PANEL
The AG Pro panel is built to keep the structure status readable without forcing the user to interpret every chart object manually.
Panel rows:
- Stage: shows whether the structure is waiting, armed, broken, retested, expired, or invalidated.
- Neckline Break: shows whether the neckline has been confirmed.
- Retest: shows whether the retest pocket is inactive, being watched, or held.
- Reversal Score: shows the current 0-100 score and quality grade.
The panel uses the AGPro standard format:
- One merged blue header row
- Only the script name in the first row
- Adjustable panel location
- Adjustable panel theme
- Adjustable panel font size
🎛️ KEY INPUTS
Pivot Left Bars / Pivot Right Bars:
Controls how mature the swing points must be before the 1-2-3 structure can form. Higher values create fewer and cleaner structures. Lower values make the script more responsive.
Minimum P1-P2 Leg ATR:
Filters out small structures by requiring a minimum distance between Point 1 and Point 2.
Minimum Point 3 Hold ATR:
Defines how much Point 3 must hold relative to Point 1. This helps separate valid structural retracements from weak retests of the original extreme.
Minimum / Maximum P3 Retracement:
Controls the acceptable retracement range for Point 3. This prevents both shallow noise and near-failed structures from being accepted too easily.
Neckline Break Buffer ATR:
Adds a configurable buffer beyond the neckline before the break is accepted.
Retest Pocket Width ATR:
Controls the height of the retest pocket around the broken neckline.
Retest Pocket Projection Bars:
Controls how far the pocket is projected forward.
Show Context Tags:
Adds compact labels such as Neckline and Retest Pocket so the visual elements are easier to identify.
Show Recent Structure Traces:
Keeps a small rolling set of recent structure lines and pockets while keeping numbered swing labels focused on the latest active setup.
Label Font Size:
Controls all chart labels, including swing numbers, context tags, and optional event labels.
Panel Font Size:
Controls the AG Pro panel text size separately from chart labels.
🔍 HOW TO READ IT
Start with the numbered swing labels.
Point 1 marks the original structural extreme. Point 2 marks the neckline reference. Point 3 marks the retracement that must hold for the 1-2-3 structure to remain valid.
Next, watch the neckline.
The neckline is the main confirmation level. Before it breaks, the panel shows the structure as armed or waiting. After it breaks, the structure becomes a confirmed 1-2-3 map.
Then watch the retest pocket.
The retest pocket appears around the broken neckline after confirmation. This is the script's key context zone. It helps the user observe whether price can return to the neckline area and hold the structure instead of treating every move after the break as equally important.
Finally, use the panel score as a quality filter.
A high score means the structure has stronger internal balance according to the script's rules. A lower score means the 1-2-3 sequence may still exist, but its structure quality is weaker.
🧩 BEST USE CASES
This script is best suited for:
- Traders who use classic 1-2-3 reversal logic
- Swing traders who want confirmed pivot structure
- Price-action traders who track neckline breaks
- Traders who prefer breakout-retest workflows
- Users who want fewer, clearer chart objects instead of broad reversal scanners
- Multi-timeframe chart review where structure clarity matters
- Public chart sharing where visual cleanliness is important
It can be useful on crypto, forex, indices, equities, and commodities, especially on charts where swing structure and neckline behavior are visually meaningful.
🧠 VISUAL DESIGN PHILOSOPHY
The design goal is clarity through restraint.
The script avoids a crowded signal-board style. It uses numbered labels only for the current active swing structure. It separates the neckline from the retest pocket with distinct visual language. Recent traces are kept limited and softened so they provide context without dominating the chart.
The active neckline is drawn with a stronger accent color. The retest pocket is shown as a clean rectangle around the broken neckline. Structure legs are dotted and restrained, helping the user understand the geometry without overpowering price.
The chart should feel premium, readable, and publication-ready. The indicator is built to support a clean TradingView screenshot rather than create visual noise.
🔔 ALERTS
The script includes alerts for the main 1-2-3 lifecycle events:
- 1-2-3 structure armed
- Bullish 1-2-3 neckline break
- Bearish 1-2-3 neckline break
- 1-2-3 retest pocket held
- 1-2-3 structure invalidated
These alerts are designed around structure progression, not generic reversal marking.
🔹 LIMITATIONS AND TRANSPARENCY
The script uses confirmed pivots, which means swing points appear only after the required right-side confirmation bars. This is intentional. It prioritizes confirmed structure over instant but unstable markings.
The script does not attempt to identify every possible reversal pattern. It does not evaluate macro trend, fundamentals, order flow, news, or external liquidity conditions.
The reversal score is a structured quality model, not a certainty model. It helps compare 1-2-3 structures inside this script's framework, but it does not forecast outcomes.
Retest pockets are contextual areas around the broken neckline. They are not universal support or resistance zones, and they are not designed to replace broader market analysis.
✅ IDEAL USER
This script is ideal for traders who:
- Understand classic 1-2-3 reversal structure
- Prefer confirmed market structure over early noise
- Want a clean neckline and retest workflow
- Value visual clarity and chart discipline
- Use TradingView for structured price-action review
- Want a focused public-free AGPro tool that does one concept well
1-2-3 Reversal Map is built for users who want a focused reversal map, not a crowded reversal scanner.
🔹 RELEASE NOTES
- Initial public release of 1-2-3 Reversal Map .
- Added confirmed Point 1, Point 2, and Point 3 swing mapping.
- Added neckline projection with close-based break confirmation.
- Added breakout retest pocket around the broken neckline.
- Added context tags for Neckline and Retest Pocket.
- Added AG Pro panel with Stage, Neckline Break, Retest, and Reversal Score.
- Added adjustable panel location, panel theme, label size, and panel font size.
- Added recent structure traces with softened historical visuals.
- Added alerts for armed structures, neckline breaks, retest holds, and invalidations. Indicator
Auto Trendline Break Quality [AGPro Series]Auto Trendline Break Quality
🔹 OVERVIEW
Auto Trendline Break Quality is a structural break-quality engine. It automatically detects bullish and bearish trendlines from swing pivots, monitors every break event in real time, and assigns each break a 0–100 quality score derived from four independent quantitative factors. The tool separates Major (structural) and Minor (tactical) trendlines, so the same break can be evaluated against multiple layers of market structure at once.
The script is purpose-built to answer the single most practical question a price-action trader faces at a trendline break: "Is this break real, or is it a fake-out?"
🧭 UNIQUE EDGE
Most trendline scripts either draw trendlines or flag a break. They stop there. This indicator continues where they stop — and measures the break.
Key differentiators:
• Four-factor composite quality score (Volume · Slope · Impulse · Retest) calibrated to ATR, so the scoring is consistent across assets and timeframes.
• Major/Minor trendline hierarchy. A Major structural break automatically earns a score bonus and is visually flagged with a "MAJ" tag, so structural breaks are never confused with noise breaks.
• State-based visual language. Active trendlines render in a neutral tone. On break, the trendline transitions to the break-direction color (bullish break = bull color, bearish break = bear color), so the chart communicates state without ambiguity.
• Retest logic built directly into the score. A break that is retested and holds within the defined window receives an upgrade; a failed retest downgrades the score. The chart label reflects the final, updated quality.
• Optional zone-band rendering around Major trendlines, letting the user see each structural line as a reaction zone rather than a bare line.
• Label confluence grouping to prevent chart clutter when multiple breaks occur near the same price level.
⚙️ METHODOLOGY
1) Trendline detection
Pivots are identified using standard pivot-high and pivot-low logic with two configurable lookbacks — one for Major trendlines and one for Minor. A new trendline is validated between the two most recent same-side pivots when the slope (ATR-normalized) exceeds the minimum threshold. Nearly-flat trendlines are rejected by design.
2) Break detection
A trendline is considered broken when the current candle closes on the opposite side of the projected line while the previous candle closed on the valid side. This one-bar confirmation rule avoids intra-bar flicker.
3) Quality scoring (0–100)
• Volume expansion vs 20-bar average — up to 25 points
• ATR-normalized slope steepness — up to 20 points
• Break-bar impulse measured in ATR from the line — up to 25 points
• Retest base score — 18 points, upgraded by +15 on a held retest, or reduced by 10 on a failed retest
• Major trendline bonus — +10 points
4) Retest tracking
After a break, the script watches a configurable window (default 3–8 bars) for price to return to the broken trendline within an ATR tolerance. Held retests and failed retests are tracked independently and reflected in the panel's Retest Held Rate. Retest markers are offset from the trendline in ATR units to prevent overlap with candles.
📊 SIGNALS & STATES
• Break label: "BREAK Q: · " and an optional "MAJ" tag for Major trendlines. Label color tier: High quality renders in full state color, Medium quality in neutral amber, Low quality in a muted tone.
• Retest marker: Small circular marker with "retest held" or "retest failed" text, offset from the trendline for clarity.
• Break bar border: Optional candle-border color that reflects break direction.
• Panel: Active trendlines per side, last break score and direction, overall break-direction breakdown, retest held rate, quality distribution (High/Medium/Low), total breaks tracked, and the current detection mode.
• Alerts: "High Quality Trendline Break" and "Major Trendline Break" — both standard alertcondition entries.
🎛️ KEY INPUTS
• Major / Minor Pivot Length — controls how many bars each side of a pivot must be a local extreme.
• Show Minor Trendlines — toggle tactical layer on top of structural layer.
• Max Active Trendlines per Side — caps the chart clutter.
• Volume Spike Threshold (x Avg) — ratio at which a volume expansion is considered full.
• Retest Min/Max Bars — bar range for a valid retest.
• Retest Tolerance (ATR) — how close price must come to the broken line to count as a retest.
• High / Medium Quality Thresholds — cutoffs for the three quality tiers (defaults: 70 / 50).
• Show Trendline Zone Band — renders a subtle ATR-based band around Major trendlines.
• Zone Band Width (ATR) — controls the thickness of the zone band.
• Label Confluence Grouping (ATR) — merges break labels that land within this ATR distance on nearby bars.
• Label Offset (ATR) — vertical padding so labels never embed in candles.
• Label / Panel / Help font sizes — all default to Normal.
• Panel Position and Theme — six positions, Dark/Light theme.
🧩 HOW TO USE
The indicator is a decision-support layer, not a standalone trading system.
• Treat a break with Q ≥ 70 and a "MAJ" tag as a structural event worth reviewing the higher-timeframe bias for.
• Use the retest window as a patience filter. A break with Q 55–69 that retests and holds often upgrades to a higher-quality setup after the retest.
• Failed retests are not "bad" — they are information. A failed retest on a low-quality break is a strong hint that the break was noise.
• The neutral-color active trendlines are intentional — they tell you where structure exists without biasing your read. Color appears only when structure breaks.
• Combine with your own confluence (volume profile, horizontal support/resistance, higher-timeframe trend). The script does not enter trades; it tells you how reliable a break looks at the moment it happens.
⚠️ LIMITATIONS & TRANSPARENCY
• Quality scores describe historical pattern behavior. They are not predictive probabilities.
• Trendlines are generated from pivots; the final pivot is always confirmed after the pivot-length bars have elapsed. This is standard pivot behavior and is not a repaint of historical marks — past labels remain fixed once a break bar closes.
• The script draws up to the platform's line/label limits. Older trendlines are removed when the active cap is reached.
• Parameter defaults target 4H–1D charts; lower timeframes benefit from smaller pivot lengths and tighter retest windows.
📜 RISK DISCLOSURE
This script is an analytical tool. It does not provide financial advice, investment recommendations, or a trading strategy. Past performance of any pattern, including trendline breaks, does not guarantee future results. Always perform your own analysis and apply proper risk management before making any trading decision. Indicator
Liquidity Trail Signals [BOSWaves]Liquidity Trail Signals - Structural Trend Engine with Liquidity Zone Detection and Position Management
Overview
Liquidity Trail Signals is a structure-aware trend following system that tracks directional price movement through an adaptive trailing stop anchored to a baseline EMA, where signal generation is governed by trail crossovers and confirmed by price structure rather than lagging oscillators or fixed threshold conditions.
Instead of relying on isolated momentum readings or static support and resistance plotting, trend state, signal generation, and level management are determined through volatility-scaled trail construction, pivot-based liquidity zone detection, and configurable position sizing that adapts entries to either immediate signal changes or trail retest confirmations.
This creates a continuously updating trend framework that reflects actual structural conviction rather than noise-reactive triggers - maintaining directional bias while price respects the trail, detecting meaningful liquidity pools at swing pivot levels, and automatically constructing risk-defined position overlays when trend state shifts occur.
Price is therefore evaluated relative to a dynamic trail boundary anchored in volatility and price structure rather than arbitrary fixed-distance rules or subjective level placement.
Conceptual Framework
Liquidity Trail Signals is founded on the principle that durable trend signals emerge when price respects a volatility-scaled trailing stop anchored to a baseline EMA, while actionable liquidity zones form at historical swing pivot highs and lows where institutional order flow is likely concentrated.
Traditional trend following tools either use fixed-distance trails that ignore volatility context or rely on static support and resistance levels that require manual placement. This framework replaces both with a unified system built on normalized trail logic, automated pivot-based zone detection, and an integrated position tool that converts every signal into a structured, risk-defined trade setup.
Three core principles guide the design:
Trend direction should be determined by an EMA-anchored trailing stop that advances in the favorable direction and never retreats until price closes through the trail boundary.
Liquidity zones should form automatically at swing pivot highs and lows, tracking breakout and retest behavior to identify when structural order flow has been absorbed or rejected.
Every trend signal should be immediately translatable into a defined trade with entry, stop loss, and multiple take profit levels without requiring manual measurement.
This shifts trend analysis from reactive signal-following into a structured, position-aware framework with automated liquidity context.
Theoretical Foundation
The indicator combines EMA baseline smoothing, Average True Range volatility measurement, unidirectional trailing stop logic, pivot-based liquidity zone construction, and configurable position sizing methodology.
A fixed-length EMA provides the trend baseline for directional reference and trail anchor calculation, while ATR offers volatility-normalized scaling for trail distance and zone thickness. Pivot detection identifies swing highs and lows that become liquidity zones, tracking break and retest conditions as price interacts with these levels. The position tool converts signal events into visually complete trade setups with risk-proportional take profit projections.
Four internal systems operate in tandem:
Trend Engine : Computes EMA baseline and maintains a volatility-scaled unidirectional trailing stop that advances with trend and reverses only on a confirmed close-based crossover.
Liquidity Zone System : Detects swing pivot highs and lows using a configurable lookback, constructs zones at each pivot, and monitors break and retest behavior with dynamic visual state updates.
Break and Retest Engine : Identifies when price closes through existing liquidity zones, marks broken zones with faded appearance, and detects subsequent retests for continuation confirmation signals.
Position Tool : Generates entry, stop loss, and three configurable R-multiple take profit levels on every signal, with selectable entry mode and optional left-edge pinning behavior.
This design allows each system component to inform the others - trail position sets stop loss distance, liquidity zones provide structural context, and break or retest events produce additional signal conditions beyond the primary trail crossover.
How It Works
Liquidity Trail Signals evaluates price through a sequence of structure-aware processes:
Baseline Calculation : EMA smoothing of close price over a configurable length creates a directional trend reference used as the trail anchor point.
Trail Positioning : In bullish trend, the trail sits below the EMA acting as dynamic support; in bearish trend, the trail sits above the EMA acting as dynamic resistance.
Trail Advancement Logic : The bullish trail can only rise, never fall; the bearish trail can only fall, never rise, creating a unidirectional risk boundary that locks in favorable progress.
Trend State Switches : Price closing below the bullish trail triggers a bearish state switch with a diamond signal marker; price closing above the bearish trail triggers a bullish state switch with a diamond signal marker.
Pivot Detection : Swing highs and lows identified using a configurable lookback window are registered as liquidity zone anchor points at their respective price levels.
Zone Construction : Each pivot creates a forward-extending box sized to current volatility, colored to reflect whether the level represents supply (swing high) or demand (swing low).
Break Detection : A close above a zone's upper boundary triggers a bullish break; a close below the lower boundary triggers a bearish break, updating the zone's appearance to a broken state.
Retest Detection : After a confirmed break, price re-entering the zone and closing back on the correct side registers a retest event, updating the zone label and reinforcing the border.
Zone Management : Maximum zone count is enforced using FIFO rotation; broken zones are optionally retained or removed immediately based on user preference.
Position Tool Construction : On the signal entry bar, close price is used as entry, the trail level is used as stop loss, and R-multiple projections are calculated for three configurable take profit targets.
Position Extension : All position lines, labels, and the risk box extend to the current bar each tick with optional left-edge pinning to the current bar or locking to the original entry bar.
Together, these elements form a continuously updating structural framework that connects trend state, liquidity context, and trade management into a single coherent system.
Interpretation
Liquidity Trail Signals should be interpreted as a unified trend and structure system with integrated position management context:
Bullish Trend State (Green) : Established when price remains above the adaptive trailing stop, indicating sustained upward momentum with the trail acting as dynamic rising support.
Bearish Trend State (Red) : Established when price remains below the adaptive trailing stop, signaling sustained downward momentum with the trail acting as dynamic falling resistance.
Trend Cloud : Gradient-filled zone between the EMA baseline and trailing stop provides visual reference for the structural gap between smoothed price and the dynamic risk boundary.
◆ Buy Signals : Green diamond markers appear on the trail when trend state switches from bearish to bullish, indicating a confirmed structural momentum shift to the upside.
◆ Sell Signals : Red diamond markers appear on the trail when trend state switches from bullish to bearish, signaling a confirmed structural momentum shift to the downside.
Colored Candles : Bar coloring reflects current trend state for immediate directional reference across the full price history.
Supply Zones (Red Boxes) : Volatility-sized zones at swing pivot highs marking areas of likely overhead supply or historical selling pressure.
Demand Zones (Green Boxes) : Volatility-sized zones at swing pivot lows marking areas of likely structural support or historical buying interest.
Broken Zone Appearance : Faded fill with reduced border opacity indicates price has closed through the zone, signaling absorption or displacement of that liquidity pool.
Retested Zone Labels : Updated label text and thickened border indicates a broken zone has been successfully retested, confirming role reversal from support to resistance or vice versa.
Position Tool Overlay : Visual trade layout showing entry level, stop loss at the current trail, and TP1/TP2/TP3 at configurable R-multiples with color-graded lines and labeled price levels.
Trail direction, zone interaction behavior, and the structural position of price relative to liquidity pools outweigh isolated candle patterns or short-term price oscillations.
Liquidity Zones
The liquidity zone system detects swing pivot highs and lows using a configurable lookback window and constructs forward-extending boxes at each pivot level, creating an automated structural map of likely supply and demand concentrations without manual placement.
Zone behavior follows a defined lifecycle:
Active Zones : Newly created zones display with standard fill opacity, indicating an untested liquidity pool that price has not yet interacted with following creation.
Broken Zones : When price closes through a zone boundary, the box transitions to a faded broken state using configurable opacity, signaling that the liquidity pool has been absorbed or displaced. Bullish breaks of supply zones and bearish breaks of demand zones each generate distinct alert conditions.
Retested Zones : After a confirmed break, if price returns to the zone and closes back on the originating side, the zone is marked as retested with updated label text and a reinforced border, confirming role reversal behavior.
Zone Rotation : When the maximum zone count is reached, the oldest zone is removed to maintain chart clarity. Broken zones can optionally be retained using the Keep Broken Zones setting, allowing historical structural context to remain visible until naturally rotated out.
Zone thickness is controlled by the Zone Thickness multiplier, allowing adjustment of how wide each liquidity band appears relative to current volatility. Extending the forward projection through the Extend Bars parameter keeps zones visible further into the right side of the chart for ongoing reference.
Liquidity zone alerts include bullish and bearish break conditions for immediate displacement detection, and bullish and bearish retest conditions for role-reversal confirmation, enabling systematic monitoring of structural level interactions without constant manual observation.
Position Tool
The position tool automatically constructs a complete trade layout on every signal bar, converting trend state switches or trail retest entries into structured, risk-defined setups with entry, stop loss, and three take profit levels calculated from the current risk distance.
Two entry modes are available:
Signal Change : The position tool draws immediately on the bar where trend state flips, using close as entry and the current trail as stop loss. This mode prioritizes responsiveness and captures the full move from the initial crossover.
Trail Retest : After a trend flip, the system waits for price to pull back and touch the trail before triggering, using the touch bar's close as entry. This mode prioritizes confirmation and typically offers a tighter risk-to-reward setup by entering at a structurally tested trail level rather than the initial crossover candle.
Stop loss is always set at the trail level at the time of entry, ensuring the risk boundary reflects the dynamic structural floor or ceiling rather than a fixed distance.
Three take profit levels are calculated as R-multiples of the entry-to-stop distance:
TP1 : First partial target at configurable R, typically used for early profit protection or a break-even scale-out level.
TP2 : Second target at configurable R, representing a standard reward objective relative to the defined risk.
TP3 : Third target at configurable R, displayed with a full-opacity line as the extended profit objective and runner target.
The risk zone between entry and stop loss is shaded with a subtle background fill to provide immediate visual reference for the defined risk area on each setup. Left-edge behavior is controlled by the Pin to Current Bar setting - when disabled, the left edge locks to the original entry bar preserving the historical trade layout; when enabled, it slides with the current bar for a compact forward-looking view. All lines, labels, and the risk box extend automatically to the current bar plus the configured Extend Bars offset.
Signal Logic & Visual Cues
Liquidity Trail Signals presents four primary interaction signals:
Buy Signal (◆) : Green diamond appears when trend state switches from bearish to bullish via trailing stop crossover, suggesting momentum shift to upside with a new dynamic support level established.
Sell Signal (◆) : Red diamond displays when trend state switches from bullish to bearish via trailing stop crossunder, indicating momentum shift to downside with a new dynamic resistance level established.
Liquidity Break : Generated when price closes through an active supply or demand zone, signaling displacement of the identified liquidity pool and potential continuation in the breakout direction.
Liquidity Retest : Generated when price returns to a broken zone and closes back on the originating side, confirming role reversal and offering secondary entry confirmation in the breakout direction.
Alert generation covers all four signal categories - bull and bear trend signals, bull and bear zone breaks, bull and bear zone retests, and bull and bear trail retest entries - enabling systematic monitoring across all interaction types.
Strategy Integration
Liquidity Trail Signals fits within structural trend-following and liquidity-aware approaches:
Trail-Based Risk Management : Use the trailing stop as the primary risk boundary - close long positions when price closes below the bullish trail, close short positions when price closes above the bearish trail.
Liquidity Zone Confluence : Enter trend-aligned positions when price retests broken demand zones during bullish trend states or broken supply zones during bearish trend states for structural confirmation.
Position Tool Execution : Use the automatically generated entry, stop loss, and take profit levels as trade management anchors rather than manually measuring risk-reward from each signal.
Trail Retest Entry Refinement : Switch to Trail Retest mode for entries requiring structural confirmation, accepting a slightly later entry in exchange for a higher-probability setup at a tested trail level.
Zone Cluster Analysis : Monitor areas where multiple liquidity zones stack in close proximity as these represent denser structural memory with heightened probability of meaningful price reactions.
Multi-Level Take Profit Laddering : Use TP1 as an initial scale-out to reduce risk, TP2 as the primary profit objective, and TP3 as a runner target held while the trail continues to advance.
Multi-Timeframe Confirmation : Apply higher-timeframe trend state as a directional filter for lower-timeframe entries, ensuring zone interactions and trail crossovers are taken in the direction of broader structural momentum.
Technical Implementation Details
Core Engine : Configurable EMA baseline with ATR volatility measurement and adjustable trail distance multiplier
Trail Model : Unidirectional advancing logic anchored to EMA, reversing only on confirmed close-based crossover
Pivot System : Configurable swing lookback for high and low detection with forward-extending zone construction
Zone Lifecycle : Active, broken, and retested states with automatic appearance transitions and FIFO rotation at maximum zone capacity
Position Tool : Dual entry mode system (Signal Change / Trail Retest) with R-multiple take profit calculation and optional left-edge pinning
Visualization : Trend cloud fill between EMA and trail, diamond signal markers, colored candles, and full position tool overlay
Signal Logic : State-switch detection for trend signals, close-based break detection for zone signals, and touch-then-close retest confirmation
Performance Profile : Optimized for real-time execution across all timeframes with efficient zone management and minimal object overhead
Optimal Application Parameters
Timeframe Guidance:
1 - 5 min : Scalping with responsive trail settings and tighter zone thickness for high-frequency structural interaction
15 - 60 min : Intraday momentum following with balanced trail distance and standard zone management
4H - Daily : Swing-level structural trend identification with wider trail tolerance and extended zone projection
Suggested Baseline Configuration:
MA Length : 28
ATR Length : 15
Trail Distance : 1.25 ATR
Swing Lookback : 12
Zone Thickness : 0.35 ATR
Max Zones : 3
Extend Bars : 50
Keep Broken Zones : Enabled
Broken Zone Fade : 88
Entry Mode : Signal Change
TP1 : 1.0R | TP2 : 2.0R | TP3 : 3.0R
Bullish Color : Green (#00ff00)
Bearish Color : Red (#ff0000)
These suggested parameters should be used as a baseline; their effectiveness depends on the asset's volatility profile, trending characteristics, and preferred signal frequency, so fine-tuning is expected for optimal performance.
Parameter Calibration Notes
Use the following adjustments to refine behavior without altering the core logic:
Trail too close or loose : Adjust Trail Distance to modify how far the trailing stop sits from the EMA baseline - lower values create tighter trails with more frequent flips, higher values create looser trails with greater trend persistence.
Too many liquidity zones cluttering the chart : Reduce Max Zones to focus on the most recent structural levels, or decrease Swing Lookback to reduce pivot detection sensitivity.
Zones breaking too frequently : Reduce Zone Thickness to narrow zone bands, requiring price to move further through the level before a break is registered.
Missing important swing levels : Increase Swing Lookback to detect only the most significant pivots rather than minor swings, creating fewer but higher-conviction zone levels.
Broken zones too distracting : Increase Broken Zone Fade toward 95-100 to make broken zones nearly invisible while retaining chart history, or disable Keep Broken Zones to remove them immediately upon break.
Position tool entries too aggressive : Switch Entry Mode to Trail Retest to require price to return to and confirm the trail before constructing the position layout.
Take profit levels too conservative or extended : Adjust TP1, TP2, and TP3 R-multiple values to match the typical reward structure of the traded instrument and timeframe.
Position tool lines extending too far : Reduce Position Tool Extend Bars to keep the forward projection compact relative to recent price action.
Adjustments should be incremental and evaluated across multiple session types rather than isolated market conditions.
Performance Characteristics
High Effectiveness:
Trending markets with clear directional persistence where the trail advances continuously without frequent state reversals
Instruments with defined swing structure where pivot highs and lows create meaningful liquidity concentrations
Momentum continuation strategies using broken and retested liquidity zones as structured re-entry points
Swing trading approaches benefiting from automated position tool construction and multi-R take profit laddering
Markets where role reversal behavior at broken supply and demand zones occurs with sufficient regularity for zone retest signals to add value
Reduced Effectiveness:
Choppy, range-bound markets with frequent trail crossovers producing whipsaw signals and repeated position tool resets
News-driven or gapped markets with discontinuous price action that bypasses trail logic and creates incomplete zone interactions
Markets with irregular swing structure where pivot detection produces levels at unsuitable price points
Consolidation and sideways price action where trend-following methodologies inherently struggle due to absence of sustained directional movement
Integration Guidelines
Confluence : Combine with BOSWaves structure analysis, volume indicators, or session-based levels for additional zone confirmation
Trail Respect : Honor the trailing stop as the primary risk boundary - maintain positions while price respects the trail and close positions on confirmed breach
Zone Prioritization : Focus on liquidity zones that align with the current trend state - demand zones during bullish trends, supply zones during bearish trends
Position Tool Discipline : Use the automatically constructed position levels as pre-defined management anchors, avoiding manual adjustment of stop loss beyond the trail level
Retest Patience : Where zone retest signals are present in trend direction, treat them as higher-conviction continuation setups relative to raw trail crossover entries
State Discipline : Maintain directional bias aligned with current trend state until a confirmed trail breach occurs, regardless of short-term oscillation within the cloud
Multi-Timeframe Alignment : Use higher timeframe trend state as a directional filter for lower timeframe entries to ensure structural confluence across time horizons
Disclaimer
Liquidity Trail Signals is a professional-grade trend following and structural liquidity detection tool. It uses volatility-normalized trailing stops, pivot-based zone construction, and integrated position sizing but does not predict future price movements. Results depend on market conditions, parameter selection, and disciplined execution. BOSWaves recommends deploying this indicator within a broader analytical framework that incorporates price structure, volume context, and comprehensive risk management. Indicator
Indicator
LogTrend Retest EngineLogTrend Retest Engine (LTRE)
LogTrend Retest Engine (LTRE) is an advanced trend-continuation overlay designed to identify high-probability breakout retests using logarithmic regression , volatility-adjusted deviation bands , and market regime filtering .
Unlike traditional channels or moving averages, LTRE models price behavior in log space , allowing it to adapt naturally to exponential market moves common in crypto, indices, and long-term trends.
🔹 How It Works
Logarithmic Regression Core
Performs linear regression on log-transformed price and time
Produces a structurally accurate trend midline that scales with price growth
Volatility-Adjusted Deviation Bands
Dynamic upper and lower zones based on statistical deviation
ATR weighting expands or contracts bands as volatility changes
Adaptive Lookback (Optional)
Automatically adjusts regression length using volatility pressure
Faster response in high-volatility environments, smoother in consolidation
🔹 Market Regime Detection
LTRE actively filters conditions using:
R² trend strength (trend quality, not just slope)
Volatility compression vs expansion
User-defined minimum trend strength threshold
Signals are disabled during ranging or low-quality conditions .
🔹 Breakout → Retest Signal Logic
LTRE does not chase breakouts.
Signals trigger only when:
1. Price breaks cleanly outside the deviation band
2. Market regime is confirmed as trending
3. Price performs a controlled retest within a user-defined tolerance
BUY
Break above upper band → retest → trend confirmed
SELL
Break below lower band → retest → trend confirmed
This structure is designed to reduce false breakouts and late entries.
🔹 Visual & Projection Tools
Clean midline and deviation bands
Optional filled zones
Optional future trend projection for forward structure planning
On-chart statistics for trend strength and volatility compression
🔹 Best Use Cases
Trend continuation & pullback strategies
Crypto, Forex, Indices, and equities
Works best on 15m and higher timeframes
⚠️ Disclaimer
LTRE is a decision-support tool , not a complete trading system. Always use proper risk management and confirm signals with additional structure, volume, or higher-timeframe context.
Built for traders who wait for structure — not noise.
Indicator
Library
Indicator
