Time Stop Planner [AGPro Series]Time Stop Planner
🧠 Core Idea
Has a setup spent too much time without enough progress?
📌 Overview / What it does
Time Stop Planner is a chart-first trade management overlay designed to evaluate the lifecycle of a triggered setup after price breaks from a prior structure. Instead of showing another generic signal, it asks whether the setup is actually making enough progress before the time window starts working against it.
The script builds a forward lifecycle box, maps a trigger reference, an invalidation rail, and a progress target reference, then scores the active setup from 0 to 100 using elapsed bars, distance traveled, follow-through quality, volatility decay, and invalidation proximity.
It does not predict future price movement, automate trade decisions, or promise that a setup will continue. Its purpose is to turn time, progress, and risk context into a cleaner visual decision framework.
🎯 Purpose & Design Philosophy
This script was built for traders who already have a setup idea but need a cleaner way to judge whether that setup is still alive, losing quality, or becoming stale.
Many tools focus on entries or targets. Time Stop Planner focuses on the often-overlooked middle stage: what happens after a setup activates but before the outcome is clear. It supports a disciplined review process by showing whether progress is keeping pace with elapsed time.
The design philosophy is simple: a setup should not remain interesting forever just because it once looked valid. The chart should make lifecycle quality visible.
⚡ Why This Script Is Different
Most tools focus on trigger signals, stop levels, or target projections.
This script does NOT behave like a generic timer dashboard, a stop-loss optimizer, a full position planner, or a profit-target ladder.
Instead, it connects time directly to progress quality. A setup is evaluated through a visible lifecycle window, a progress score, time-risk pressure, invalidation context, and a clear next-action state.
⚙️ Methodology
1. Context Detection
The script detects a directional setup lifecycle when price breaks beyond a prior structure boundary with sufficient candle body strength, close location quality, and optional trend support.
2. Reference Mapping
After activation, the script maps the trigger reference, invalidation rail, and ATR-based progress target reference. These levels create the lifecycle framework used for progress and risk evaluation.
3. Reaction Evaluation
The engine measures elapsed bars, directional travel, close-based follow-through, volatility behavior, and distance from invalidation. These components are converted into a 0-100 quality score and a separate time-risk reading.
4. Visual Output
The chart displays a lifecycle box, rails, checkpoint labels, state labels, and a compact AGPro panel. The active box text is centered inside the lifecycle area for clean chart reading.
🗺️ How to Read the Chart
Zones = the lifecycle box shows the active time window in which the setup should show reasonable progress.
Rails = the trigger reference, progress target reference, and invalidation rail define the active setup map.
Labels = setup, checkpoint, continue, time-risk, expired, and invalidated labels mark important lifecycle events.
Colors = green/teal suggests constructive progress, amber suggests time-risk or expiry pressure, pink suggests invalidation or failed lifecycle context, and indigo marks neutral active structure.
Panel = the panel summarizes Bars Active, Progress Score, Time Risk, Invalidation, and Action.
🚦 Signals & States
• New Time Stop Lifecycle → a new setup lifecycle window has been detected.
• Continue Review → progress and quality are strong enough to keep the lifecycle under constructive review.
• Time Risk → elapsed time is high relative to progress, so the setup deserves closer review.
• Lifecycle Expired → the active lifecycle reached its time boundary without enough progress.
• Lifecycle Invalidated → price closed beyond the invalidation rail.
🔔 Alerts Logic
The script includes alerts for:
• New Time Stop Lifecycle
• Continue Review State
• Time Risk State
• Lifecycle Expired
• Lifecycle Invalidated
These alerts are attention markers. They are not trade instructions, automated orders, or guaranteed outcome signals.
🧩 Confluence Logic
The strongest lifecycle context appears when structure break quality, candle body strength, close location, trend support, progress travel, and invalidation distance align.
When progress improves while time-risk stays low, the active lifecycle becomes more constructive. When elapsed bars increase while progress remains weak, the setup becomes more vulnerable to time-stop review.
📊 When to Use
• After a clean structure break
• During breakout follow-through review
• During trend continuation management
• When a setup is active but progress is unclear
• When you want a rule-based way to identify stale setups
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy markets with repeated false breaks
• News-driven spikes where ATR behavior becomes distorted
• Markets where structure boundaries are not meaningful
• As a standalone entry or exit system
🎛️ Key Inputs
• Sensitivity → controls how strict the setup activation logic is.
• Structure Lookback → defines the prior boundary used for lifecycle activation.
• Lifecycle Window Bars → sets how long a setup can remain active before time-risk becomes dominant.
• Minimum Progress % → defines how much progress is expected before expiry pressure matters.
• Progress Target ATR → sets the ATR-based progress reference.
• Invalidation Buffer ATR → controls the distance of the invalidation rail.
• Label Font Size and Panel Font Size → control visual readability.
• Panel Location and Panel Theme → customize the AGPro summary panel.
🖥️ Interface & Visual Design
The interface is built around a clean chart-first workflow. The lifecycle box is the primary visual object, and its centered text summarizes the active state without requiring extra dashboard interpretation.
The panel is compact and uses the AGPro standard first row: one merged blue header row containing only the panel title. The remaining rows focus on time, progress, risk, invalidation, and the next review state.
Labels are limited by cooldown and max-visible controls so the chart remains informative without becoming crowded.
🧪 Practical Usage Workflow
1. Read the panel to identify the current lifecycle state.
2. Check the lifecycle box and rails to understand the active structure.
3. Compare Bars Active with Progress Score.
4. Watch whether Time Risk rises before meaningful progress appears.
5. Use invalidation context to decide whether the setup is still structurally relevant.
🔍 Interpretation Guidelines
A high score does not mean price must continue. It means the active lifecycle is progressing well under the script's rules.
A high time-risk reading does not mean price must reverse. It means time is becoming less favorable relative to progress.
An expired lifecycle does not judge the broader market. It only says the active setup window did not produce enough progress within the configured time boundary.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a stop-loss optimizer
• Not a full position planner
• Not a profit-target promise tool
⚠️ Limitations & Transparency
The script uses rule-based structure detection and ATR-based references, so results can vary across symbols, sessions, and timeframes.
Confirmed lifecycle states depend on the selected lookback, sensitivity, ATR settings, and volatility conditions.
During sideways chop, repeated structure breaks may produce lifecycles that expire quickly. During extreme volatility, time and progress readings may change rapidly.
🧠 Market Context Notes
Time is part of risk. A setup that does not progress can become less useful even if it has not technically invalidated.
This script is designed to make that time component visible without turning it into a direct trade command.
🧾 Use Case Examples
When price breaks above a prior structure and the lifecycle box appears, the trader can watch whether progress develops before the time window matures.
When progress remains weak and the Time Risk state appears, the trader can reassess whether the original setup idea still deserves attention.
When price closes beyond the invalidation rail, the lifecycle is marked invalidated and the context resets.
🧱 System Philosophy
Time Stop Planner belongs to the AGPro decision-engine style: it does not simply show data. It organizes setup validity, progress quality, risk context, and next-action state into one readable workflow.
🔐 Non-Promise Statement
This script does not provide certainty.
It does not guarantee continuation, reversal, profit, or protection from loss.
📉 Risk Disclosure
Trading involves risk.
All outputs from this script are educational and analytical only.
Users remain responsible for their own decisions, risk management, and market interpretation.
This script does not provide financial advice.
📚 Educational Note
Use the script as a structured way to study time, progress, and invalidation behavior after a setup activates. The value is in consistent interpretation, not in treating any state as a command.
Indicator

Exit Readiness Planner [AGPro Series]Exit Readiness Planner
🧠 Core Idea
Is the active move showing enough decay to prepare an exit review?
📌 Overview / What it does
Exit Readiness Planner is a chart-first trade management tool built to evaluate whether an active move is losing enough quality to deserve closer review. Its cleanest default use case is 4H swing-management review, where structure, target proximity, and decay are usually easier to read than on very small timeframes.
The script converts momentum decay, candle-efficiency loss, target proximity, volatility contraction, and reversal pressure into a 0-100 Exit Readiness Score. It produces an exit-pressure zone, target and risk-shift rails, exhaustion fade context, compact state labels, alerts, and a clean AGPro panel.
It does not predict price direction, automate exits, or print direct sell commands. Its purpose is to organize exit-review context while the user remains responsible for all decisions.
🎯 Purpose & Design Philosophy
Many traders plan entries carefully but review exits only after momentum has already faded. This script was built to make the exit-review question more structured.
It helps traders who manage active moves and want a cleaner way to monitor whether the move still has room, strength, and volatility support, or whether it is shifting into a review state.
The design supports a management mindset: read the current pressure, check remaining room, review exhaustion, then decide what deserves attention.
⚡ Why This Script Is Different
Most tools focus on take-profit ladders, trailing stops, or direct exit signals.
This script does NOT build a profit-target ladder, a Chandelier Exit clone, a stop-loss optimizer, or a buy/sell command system.
Instead, it asks a narrower decision question: is the active move showing enough decay, target proximity, or risk-shift pressure to prepare an exit review?
⚙️ Methodology
1. Context Detection
The script identifies the active move side using Auto Context, Long Move, or Short Move.
2. Reference Mapping
It maps target-side structure, remaining room, a fast trend reference, and an exit-pressure zone around the active target rail.
3. Reaction Evaluation
The model scores momentum decay, candle-efficiency loss, target proximity, volatility contraction, and reversal pressure.
4. Visual Output
The output appears as a forward exit-pressure zone, exhaustion fade band, compact labels, alert conditions, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the forward exit-pressure area near the active target rail.
Labels = clear attention markers such as EXIT REVIEW, EXIT WATCH, TARGET NEAR, RISK SHIFT, or PRESSURE EASED.
Colors = teal suggests calmer monitor context, amber suggests watch or target proximity, pink/red suggests stronger exit-review pressure.
Panel = summarizes Exit Pressure, Remaining Room, Exhaustion State, Risk Shift, and Action.
🚦 Signals & States
• EXIT REVIEW → the score and supporting conditions show stronger decay or pressure.
• EXIT WATCH → review context is developing but is not yet in the stronger review state.
• TARGET NEAR → price is close to the active target-side reference.
• RISK SHIFT → pressure appeared against the active move near the trend reference.
• MONITOR → exit pressure is not strong enough for active review attention.
🔔 Alerts Logic
• Exit Readiness Review → triggers when the planner enters Exit Review state.
• Exit Readiness Watch → triggers when watch context appears.
• Target Near → triggers when price becomes close to the active target rail.
• Risk Shift → triggers when pressure appears against the active move.
• Pressure Eased → triggers when active pressure returns to monitor context.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The strongest review context appears when momentum decay, candle-efficiency loss, target proximity, volatility contraction, and reversal pressure align.
When only one factor appears, the state may remain Watch or Monitor. When several factors align, the score can move toward Exit Review.
📊 When to Use
• During active trade management.
• Especially on 4H swing-management charts.
• When price is approaching a target-side reference.
• During trend moves that may be losing momentum.
• After strong directional candles begin to compress.
• On liquid symbols where ATR and pivot references are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable candles.
• News spikes where volatility changes too quickly.
• Very noisy micro-timeframes with unstable wick behavior.
• As a standalone reason to close a position.
• When the user has no broader trade plan or risk framework.
🎛️ Key Inputs
• Active Move Side → selects Auto Context, Long Move, or Short Move.
• Sensitivity → controls how quickly decay and pressure affect the score.
• Lookback → defines the structure window for target references and room.
• Exit Review Score → sets the threshold for the stronger review state.
• Exit Watch Score → sets the lower attention threshold.
• Visual Settings → control zones, rails, fade bands, labels, optional move-side prefixes, optional micro markers, panel visibility, theme, location, and font sizes.
🖥️ Interface & Visual Design
The interface is chart-first and built around one primary visual object: the exit-pressure zone.
The panel uses the AGPro publication layout with a single merged blue title row, adjustable location, adjustable theme, and adjustable font size.
Labels use clear full-text state names, offset from candles, and are controlled by cooldown and maximum-visible settings to keep the chart active without becoming crowded. Move-side prefixes and tiny micro markers are available but disabled by default for a cleaner 4H publication preset.
🧪 Practical Usage Workflow
1. Read the panel Action state.
2. Check the Exit Pressure score.
3. Review the remaining room to the active target rail.
4. Compare the exhaustion state with candle behavior.
5. Treat alerts and labels as review prompts, not trade commands.
🔍 Interpretation Guidelines
A high score means the script sees more exit-review pressure according to its rules. It does not mean price must reverse.
Target Near means remaining room is compressed relative to ATR. It does not mean the target must hold.
Risk Shift means pressure appeared against the active move. It should be interpreted with timeframe, volatility, and broader structure.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a sell-signal service.
• Not a take-profit ladder.
• Not a trailing-stop strategy.
⚠️ Limitations & Transparency
Exit-readiness behavior depends on the selected lookback, ATR length, target pivot length, sensitivity, timeframe, and market condition.
Low volatility can make target proximity more frequent. High volatility can widen references and delay review states. Small timeframes can produce more frequent state changes.
The script is rule-based and should be read as an analytical management layer inside a broader plan.
🧠 Market Context Notes
An active move can remain valid while still deserving review.
Exit readiness is not the same as bearish or bullish prediction. It is a structured way to notice when the move may be losing quality, nearing a reference, or showing pressure against the active side.
🧾 Use Case Examples
When price approaches the target rail and candle efficiency falls, the planner may move from Monitor to Exit Watch.
When target proximity, momentum decay, and reversal pressure align, the planner may mark Exit Review.
When pressure eases and the move regains quality, the script can return to Monitor.
🧱 System Philosophy
Exit Readiness Planner follows the AGPro decision-engine approach:
Context before reaction.
Review before emotion.
Attention markers instead of commands.
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, target behavior, or exit timing.
This tool provides structured chart context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk controls, position sizing, and trading decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use the script to study how exit-review pressure changes as momentum fades, room compresses, volatility contracts, and pressure appears against the active move.
Indicator

Breakeven Review Planner [AGPro Series]Breakeven Review Planner
🧠 Core Idea
Has the move progressed enough to review breakeven protection, or is the context still too early, weak, or exposed?
📌 Overview / What it does
Breakeven Review Planner is a trade-management overlay designed to evaluate post-activation move progress. Instead of asking users to manually draw a full entry, stop, and take-profit plan, the script detects a qualified directional move, anchors an activation reference, builds a structural invalidation shelf, and measures live R progress from that context.
The output is a clean breakeven review workflow: a BE review zone, activation reference, invalidation shelf, current R reading, trend-support state, pullback-risk state, event labels, alerts, and a premium AGPro panel.
It does not predict price direction, place trades, calculate position size, build a take-profit ladder, or tell users to move a stop. Alerts and labels are attention markers for review context only.
🎯 Purpose & Design Philosophy
This script was built for traders who already manage active moves and need a cleaner way to evaluate whether the move has earned a breakeven review.
The gap it fills is not pre-trade risk/reward planning. AGPro already has tools for that. This script focuses on the management phase after a move is active: progress, structure, trend support, and pullback risk.
The design supports a disciplined review mindset. It helps users read whether the chart has built enough progress to deserve attention without turning that review into an automated instruction.
⚡ Why This Script Is Different
Most risk/reward tools focus on manual entry, stop-loss, targets, position sizing, and breakeven probability.
This script does NOT build a full trade plan, does NOT create TP ladders, and does NOT tell users to move a stop.
Instead, it watches the live chart for a qualified management context, scores the move's progress toward a breakeven review threshold, and keeps the user focused on whether the current structure is strong, weak, stale, or invalidated.
⚙️ Methodology
1. Context Detection
The script detects directional activation when price escapes recent structure with enough ATR-normalized impulse, candle commitment, close-location quality, and trend support.
2. Reference Mapping
After activation, the script anchors an activation reference and builds an invalidation shelf from the latest confirmed swing plus an ATR buffer.
3. Reaction Evaluation
The engine measures current R, best favorable R, trend support, candle quality, volatility fit, and pullback depth after progress.
4. Visual Output
The chart displays the BE review zone, progress fill, context lines, event labels, candle tint, alerts, and the AGPro panel.
🗺️ How to Read the Chart
Zones = the BE review area around the configured R trigger. It is a review zone, not a command.
Labels = context markers such as armed context, progress milestones, BE review, pullback watch, stale context, and invalidation.
Colors = teal for bullish-supported context, pink for bearish or invalid context, amber for caution, and indigo for breakeven review focus.
Panel = the current decision cockpit. It shows Review Score, Current R, BE Trigger, Progress State, Trend Support, and Action.
🚦 Signals & States
• Bull Context Armed → a bullish management context was activated after structure escape.
• Bear Context Armed → a bearish management context was activated after structure escape.
• BE Review Active → current progress reached the configured R threshold for breakeven review.
• Review + Pullback → price reached review progress but has pulled back enough to require closer attention.
• Stale → the context spent too many bars without enough progress.
• Invalidated → price reached the structural invalidation shelf.
🔔 Alerts Logic
Alerts trigger when a new management context activates, the BE review zone is reached, the review quality is high, pullback risk increases after review progress, the invalidation shelf is reached, or the context becomes stale.
Alerts are attention markers. They are not trading instructions, broker actions, or automated stop-management commands.
🧩 Confluence Logic
The strongest review context appears when R progress, trend support, candle close quality, controlled pullback depth, and normal volatility fit align.
When these conditions align, the Review Score rises and the panel state becomes easier to interpret.
📊 When to Use
• Active directional moves after structure expansion
• Trend continuation environments
• Breakout follow-through review
• Trade-management review after favorable progress
• Charts where users want R-style context without a full manual RR planner
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy ranges
• News shock candles with distorted ATR behavior
• Non-standard chart types that alter candle structure
• Situations where the user needs exact broker-level stop management
🎛️ Key Inputs
• Sensitivity → changes how quickly or strictly the script activates a management context.
• Structure Lookback → controls the recent structure boundary used for activation.
• BE Review Trigger (R) → sets the R threshold for review-zone activation.
• Invalidation Shelf Buffer ATR → controls how much ATR padding is added beyond the latest swing.
• Pullback Warning Depth (R) → controls when post-review pullback risk is marked.
• Visual settings → control labels, zones, progress fill, line extension, candle tint, and object limits.
• Panel settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The panel follows the AGPro public-release standard with one merged blue header row containing only the script name.
The chart is designed to stay active but not crowded. It uses a single review zone, clean context lines, a subtle progress fill, and capped event labels.
Label and panel font sizes are adjustable, with Normal as the default.
🧪 Practical Usage Workflow
1. Read the panel Review Score and Progress State.
2. Check whether price is below, inside, or beyond the BE review zone.
3. Compare Current R with best favorable R to understand whether progress is expanding or pulling back.
4. Confirm whether trend support is still aligned.
5. Treat alerts as review prompts, not as automated trade actions.
🔍 Interpretation Guidelines
A high score means the move has progressed toward the review zone with stronger internal structure according to the script's rules.
A low score means the move is early, weak, stale, pulling back, or structurally invalidated.
The most useful interpretation comes from reading score, state, trend support, and invalidation together instead of relying on a single label.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a position sizing calculator
• Not a manual risk/reward visualizer
• Not a take-profit planner
⚠️ Limitations & Transparency
The activation model is rule-based and depends on recent structure, ATR, candle behavior, and trend filters.
Different timeframes can produce different activation references and invalidation shelves.
Fast volatility expansion can make R progress move quickly, while low volatility can keep contexts stale.
No rule-based tool can know a user's actual broker order, risk tolerance, or execution plan.
🧠 Market Context Notes
Breakeven review is most useful when progress, structure, and volatility are read together.
A move can reach a review zone while still having weak trend support or heavy pullback risk.
The script is designed to keep those differences visible.
🧾 Use Case Examples
When price breaks recent structure, trend support is aligned, and current R approaches the BE review threshold, the panel may shift from Building to Approaching Review.
When current R reaches the configured BE trigger and the score is strong, the script marks the review zone and can trigger a high-quality review alert.
When best favorable R was strong but current R pulls back by the configured amount, the script marks Pullback Watch instead of treating the move as automatically healthy.
🧱 System Philosophy
The AGPro approach is to turn chart information into structured decision context.
This script follows that philosophy by converting move progress into a clean review framework: activation, invalidation, R progress, trend support, pullback risk, and next review state.
🔐 Non-Promise Statement
This script does not provide certainty.
It does not guarantee that a breakeven review will improve trade outcome.
It only organizes the conditions that may make breakeven review context more visible.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, execution, risk management, and decisions.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the tool to study how active moves progress, stall, pull back, or invalidate around a structured management threshold.
Indicator

Reward Room Analyzer [AGPro Series]Reward Room Analyzer
🧠 Core Idea
Does the chart offer enough clean reward room before the next major obstacle?
📌 Overview / What it does
Reward Room Analyzer is a chart-overlay planning tool designed to evaluate whether the current price area has enough practical space before the next meaningful obstacle.
Instead of projecting a take-profit ladder or calculating position size, the script studies the distance from current price to the nearest target-side obstacle, the opposite invalidation reference, room-to-risk ratio, trend support, clean-air structure, and volatility fit. These inputs are converted into a 0-100 Reward Room Score with a clear state such as Open Room, Watch Room, Thin Room, Blocked Path, Risk Heavy, or No Room.
The script produces a forward reward room corridor, nearest obstacle rail, invalidation reference rail, compact chart labels, alert conditions, and a clean AGPro planning panel. It does not predict price movement, automate execution, or promise that any target will be reached.
🎯 Purpose & Design Philosophy
This script was built to solve a common planning problem: a setup can look attractive, but the path ahead may already be blocked by nearby structure, poor room-to-risk, or excessive invalidation distance.
Reward Room Analyzer helps traders review the quality of the space ahead before treating a setup as actionable. It supports a planner mindset: check the available room, identify the obstacle, compare room against risk, and then decide whether the chart deserves more attention.
It is designed for traders who care about trade planning, target path quality, risk awareness, and cleaner decision structure rather than another generic signal marker.
⚡ Why This Script Is Different
Most tools focus on drawing take-profit levels, R-multiple ladders, Fibonacci extensions, or basic risk/reward boxes.
This script does NOT build a TP ladder, position-size calculator, profit tracker, or entry signal system.
Instead, it asks a narrower decision question: is there enough clean reward room before the next obstacle, or is the path already too thin, blocked, or risk-heavy?
⚙️ Methodology
1. Context Detection
The script selects the active target side using Auto Side, Long Room, or Short Room. Auto Side weighs trend support and available room.
2. Reference Mapping
It maps confirmed obstacle pivots, the nearest target-side rail, the opposite invalidation reference, and ATR-normalized reward room.
3. Reaction Evaluation
It scores the room using distance to obstacle, room-to-risk ratio, clean-air structure, trend agreement, risk distance, and volatility fit.
4. Visual Output
It displays the active reward corridor, centered corridor label, obstacle/invalidation rails, compact labels, alerts, and an AGPro panel.
🗺️ How to Read the Chart
Reward Room Corridor = the forward space between current price and the nearest target-side obstacle.
Nearest Obstacle Rail = the first meaningful structural barrier in the selected target direction.
Invalidation Reference = the opposite-side reference used to estimate risk distance.
Labels = compact state markers showing the current reward-room condition and score.
Colors = teal and indigo suggest stronger room quality, amber suggests caution, and pink/red suggests weak or blocked room.
Panel = summarizes reward score, reward room, obstacle, room-to-risk, target side, and next action.
🚦 Signals & States
• Open Room → reward room is wide enough, room-to-risk is acceptable, and risk is not excessive.
• Watch Room → context is acceptable but not strong enough for the open-room state.
• Thin Room → the nearest obstacle is too close.
• Blocked Path → room-to-risk is weak relative to the invalidation reference.
• Risk Heavy → invalidation distance is too large compared with the available room.
• No Room → conditions are not strong enough for planning attention.
🔔 Alerts Logic
• Open Reward Room → triggers when the script enters the Open Room state.
• Watch Reward Room → triggers when watchable room appears without reaching Open Room.
• Blocked Reward Path → triggers when room-to-risk becomes structurally blocked.
• Thin Reward Room → triggers when the nearest obstacle is too close.
• Risk Heavy Room → triggers when invalidation distance is heavy relative to room.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
Reward room quality improves when the target-side distance, room-to-risk ratio, clean-air structure, trend agreement, balanced risk distance, and stable volatility align.
The strongest read appears when the corridor is visibly open and the panel confirms sufficient room with a strong score.
Indicator

Trade Location Quality [AGPro Series]Trade Location Quality
🧠 Core Idea
Is price in a clean trade location, or is it too close to obstruction, invalidation, or noisy range edges?
📌 Overview / What it does
Trade Location Quality is a chart-overlay risk-location planner designed to evaluate whether the current price area is practical for setup review.
The script measures range position, nearby obstruction rails, ATR-normalized risk distance, target room, trend support, and volatility fit. These inputs are combined into a 0-100 Location Quality Score with a clear state such as Clean Location, Watch Location, Obstructed, Danger Close, Risk Wide, or Poor Location.
It produces a forward location window, target/risk rails, compact event labels, alert conditions, and a premium AGPro panel. It does not predict price direction, automate execution, or print direct buy/sell commands.
🎯 Purpose & Design Philosophy
This script was built to solve a common planning problem: a setup may look interesting, but the trade location may still be weak because price is too stretched, too close to the next obstacle, or too close to invalidation.
The goal is to help traders think in terms of location quality before reacting to a setup. It supports a planning mindset: check context, evaluate room, review risk, then decide whether the area deserves attention.
It is designed for traders who want a clean decision layer rather than another generic signal marker.
⚡ Why This Script Is Different
Most tools focus on detecting a level, zone, breakout, or signal.
This script does NOT build a premium/discount map, OTE model, generic support/resistance scanner, order-block map, or prediction engine.
Instead, it asks a narrower planning question: is the current location clean enough to evaluate, or is the chart already blocked by risk, obstruction, or poor range position?
⚙️ Methodology
1. Context Detection
The script identifies the active evaluation side using either Auto Context, Long Context, or Short Context. Auto Context follows the trend-support basis.
2. Reference Mapping
It maps the recent range, nearest obstruction rails, opposite-side risk rail, estimated invalidation reference, and ATR-normalized room.
3. Reaction Evaluation
It scores location quality using range position, target room, risk distance, trend support, and volatility fit.
4. Visual Output
It displays a forward location window, target/risk rails, state labels, alerts, and a compact AGPro panel.
🗺️ How to Read the Chart
Location Window = the current area where price location is being evaluated.
Target Obstruction Rail = the nearest meaningful obstacle in the evaluation direction.
Risk Rail = the opposite-side reference used to estimate invalidation distance.
Labels = compact state markers showing the current planner condition and score.
Colors = teal and indigo suggest stronger quality, amber suggests caution, and pink/red suggests weak or risky location.
Panel = summarizes score, state, range position, obstruction distance, risk state, and next action.
🚦 Signals & States
• Clean Location → location score is strong, room is sufficient, and risk distance is balanced.
• Watch Location → context is acceptable but not strong enough for the clean-location state.
• Obstructed → price is too close to the next target-side obstruction rail.
• Danger Close → invalidation is too close for a balanced location read.
• Risk Wide → invalidation is too far away, making the location less efficient.
• Poor Location → score and context are not strong enough for planning attention.
🔔 Alerts Logic
• Clean Location → triggers when the script enters the Clean Location state.
• Obstructed Location → triggers when price becomes too close to the next obstruction rail.
• Risk Location Warning → triggers when risk distance becomes too tight or too wide.
• Watch Location → triggers when a watchable location context appears without reaching Clean Location.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
Location quality improves when range position, target room, balanced risk distance, trend support, and stable volatility align.
The strongest read appears when the score is high and the panel also shows enough obstruction distance with a balanced risk state.
📊 When to Use
• During setup planning before reacting to a signal.
• Around pullbacks where risk and target room matter.
• During trend continuation review when price may be clean or already stretched.
• Before breakout or reversal evaluation when nearby obstruction can change the quality of the idea.
• On liquid markets where ATR and pivot references are meaningful.
⚠️ When NOT to Use
• Extremely low-liquidity markets with unreliable candles.
• Highly noisy periods where rails change too frequently.
• Extreme volatility spikes where ATR-based distance can expand rapidly.
• Charts where the user has no broader context for directional evaluation.
• As a standalone reason to enter or exit a trade.
🎛️ Key Inputs
• Evaluation Context → selects Auto, Long, or Short planning context.
• Location Lookback → defines the recent structure window.
• Obstruction Pivot Length → controls how strict obstruction rails are.
• Minimum Clean Score → sets the quality threshold for Clean Location.
• Minimum Target Room ATR → controls how much room must exist before the next obstruction.
• Risk Buffer Inputs → define what counts as too close or too wide.
• Visual Settings → control compact or detailed labels, rails, location window, panel visibility, theme, location, and font sizes.
🖥️ Interface & Visual Design
The interface is intentionally chart-first.
The location window shows the active evaluation area without filling the chart with many competing zones. The obstruction rails provide practical reference points. The default labels use compact state tags, while hover tooltips retain the deeper score, room, risk, and action context. Cooldown and maximum-visible settings keep the chart active but not crowded.
The panel follows the AGPro publication layout with a single merged blue title row, adjustable location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Read the panel score and state.
2. Check whether target-side room is open or obstructed.
3. Review whether risk distance is balanced, too close, or too wide.
4. Compare the location window with broader market context.
5. Treat alerts and labels as attention markers, not decisions.
🔍 Interpretation Guidelines
A high score means the location is cleaner relative to the script's rule set. It does not mean price must move in the evaluated direction.
An obstructed state means room is limited before the next nearby reference. It does not mean price cannot break through that area.
A risk warning means the current location is less balanced for planning. It should be interpreted with timeframe, volatility, and broader structure.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a buy/sell signal service.
• Not a premium/discount or OTE zone engine.
• Not a generic support/resistance zone scanner.
⚠️ Limitations & Transparency
Location quality depends on the selected lookback, pivot length, volatility profile, and timeframe.
Different markets can produce different rail behavior. High volatility may widen risk distance. Low volatility may compress target room. Small timeframes may produce more frequent state changes.
The script is rule-based and should be read as a planning tool inside broader analysis.
🧠 Market Context Notes
Trade location is not only about where price is. It is also about what sits nearby.
A location can look attractive but still be weak if there is not enough clean room before the next obstruction. A location can also be risky if invalidation is too close or too far for the current volatility environment.
This script organizes those conditions into a single readable decision layer.
🧾 Use Case Examples
When price pulls back inside a trend and the score improves while risk remains balanced, the chart may deserve closer review.
When price is near a target-side rail and the panel shows Obstructed, the user can recognize that nearby room is limited.
When volatility expands and risk distance becomes too wide, the script can mark the location as less efficient for planning.
🧱 System Philosophy
Trade Location Quality follows the AGPro decision-engine approach: the script should help the user evaluate context, quality, risk, room, and next action without promising an outcome.
The goal is not to add another signal. The goal is to improve the quality of the planning process.
🔐 Non-Promise Statement
No script can guarantee direction, continuation, reversal, or outcome.
This tool provides structured chart context only.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own analysis, risk controls, position sizing, and trading decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use the script to study how trade location changes as price moves closer to risk, target, obstruction, and range edges. The most useful reading comes from comparing the panel state with the visible chart context.
Indicator

Risk Runway Planner [AGPro Series]Risk Runway Planner
🧠 Core Idea
Is the current setup offering a clean risk runway, or is risk too wide, too blocked, or still too early?
📌 Overview / What it does
Risk Runway Planner is a chart-first risk planning and execution readiness tool designed to evaluate whether a setup has enough structure to deserve active attention.
Instead of printing generic buy or sell signals, the script studies stop-distance quality, invalidation clarity, expansion room, volatility state, trend support, and price location. It then converts those factors into a 0-100 quality score and a clear next-action state.
The script produces an active risk runway box, invalidation and target-edge guides, compact chart labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that a setup will follow through.
🎯 Purpose & Design Philosophy
This script was built for traders who want to evaluate setup quality before execution, not after the chart has already moved.
Many tools show signals, volatility compression, or target levels in isolation. Risk Runway Planner is designed to connect the practical planning questions: Where is invalidation? Is stop distance reasonable? Is there enough room before obstruction? Is volatility supportive or unstable? What should the trader pay attention to now?
The design mindset is simple: a cleaner decision framework is more useful than another crowded signal layer.
⚡ Why This Script Is Different
Most tools focus on entries, squeeze conditions, support/resistance zones, or target projections as separate ideas.
This script does NOT try to become a generic compression map, a take-profit ladder, a position-sizing calculator, or a signal generator.
Instead, it evaluates the quality of the risk runway between invalidation and the next target edge. The core output is not a trade command. It is a planning state that helps the user decide whether a setup is READY, still on WATCH, BLOCKED by poor room, or exposed to WIDE RISK.
⚙️ Methodology
1. Context Detection
The script detects the active planning side using trend structure and price location, or allows the user to force long-context or short-context evaluation.
2. Reference Mapping
It maps the current planning range, recent invalidation shelf, nearby obstacle, ATR-normalized stop distance, and projected expansion room.
3. Reaction Evaluation
The model scores stop quality, expansion room, trend support, volatility state, and range location. These components are blended into a 0-100 quality score.
4. Visual Output
The output is shown through a risk runway box, invalidation guide, target-edge guide, compact labels, deterministic alerts, and a premium planning panel.
🗺️ How to Read the Chart
Zones = the active risk runway between invalidation and target edge.
Labels = compact state markers showing READY, WATCH, DOWNGRADE, INVALIDATED, or TARGET EDGE context.
Colors = bullish and bearish context use AGPro state colors, while neutral and warning conditions use controlled accent tones.
Panel = the panel summarizes Risk Compression, Expansion Room, Volatility State, Quality Score, Risk Edge, and Action.
🚦 Signals & States
• READY → the current risk runway has enough quality to justify active attention.
• WATCH → the setup is improving but does not yet meet the stricter readiness threshold.
• WIDE RISK → stop distance or invalidation quality is too weak for clean planning context.
• BLOCKED → expansion room is limited or the nearest obstacle is too close.
• WAIT → the planner does not detect a strong enough structure yet.
• INVALIDATED → a prior active invalidation shelf has been crossed.
• TARGET EDGE → a prior target edge has been reached.
🔔 Alerts Logic
Alerts trigger when the planner enters READY state, enters WATCH state, downgrades from READY, crosses a prior invalidation shelf, or reaches a prior target edge.
These alerts are attention markers. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The strongest planning state appears when multiple components align:
Stop-distance quality + expansion room + trend support + controlled volatility + favorable price location.
When these factors align, the script can move from WATCH to READY. If risk widens or room becomes blocked, the state can downgrade.
📊 When to Use
• Before evaluating a discretionary setup
• During trend pauses where invalidation is becoming clearer
• Before breakout or continuation attempts when risk needs structure
• Around pullbacks where stop distance and target room need review
• When comparing whether one setup has cleaner risk than another
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro-timeframes with unstable wicks
• News-driven volatility spikes
• Markets where recent structure is too distorted to define a useful invalidation shelf
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Planning Side → controls Auto, Long Context, or Short Context evaluation.
• ATR Length → normalizes stop distance, room, labels, and volatility state.
• Planning Range → defines the broader structure used for price location and range context.
• Invalidation Lookback → controls how the invalidation shelf is mapped.
• Obstacle Lookback → controls how nearby target-edge obstruction is estimated.
• READY / WATCH Thresholds → adjust how selective the planner is.
• Visual settings → control runway boxes, guide lines, memory boxes, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around a clean planning panel and one primary chart object: the risk runway box.
The panel uses a single merged AGPro header row and keeps the key planning information readable without turning the chart into a dashboard-heavy layout.
Labels are intentionally compact, offset away from candles, and controlled with cooldown and maximum-visible settings.
🧪 Practical Usage Workflow
1. Read the panel action state.
2. Check whether the risk runway box has enough room between invalidation and target edge.
3. Review whether the Risk Edge is reasonable in ATR terms.
4. Confirm whether the chart context supports the selected planning side.
5. Treat alerts as attention markers and review the broader market context before making any decision.
🔍 Interpretation Guidelines
A higher score means the planner sees better alignment between risk, room, volatility, trend support, and location.
READY does not mean a trade must be taken. It means the setup has enough planning quality to deserve attention.
WATCH means the structure may be developing, but at least one component still needs improvement.
WIDE RISK and BLOCKED are caution states. They help identify when the chart may be less efficient for planning.
🚫 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 invalidation shelves and obstacles are detected.
Volatility changes can alter ATR-normalized risk and room conditions.
Market structure can shift quickly after news, low-liquidity movement, or aggressive momentum expansion.
The script is rule-based and should be interpreted as an analytical planning layer, not as certainty.
🧠 Market Context Notes
Risk quality is not only about stop distance. It also depends on whether price has enough clean room to move, whether volatility is controlled, and whether structure supports the active side.
The planner is most useful when it helps the user avoid low-quality setups before they become emotional decisions.
🧾 Use Case Examples
When price is near a constructive invalidation shelf and still has clean room toward the next target edge, the planner may move toward WATCH or READY.
When price is too close to the nearest obstacle, the planner may show BLOCKED even if trend direction looks attractive.
When stop distance becomes too wide relative to ATR, the planner can show WIDE RISK even if the setup still looks visually interesting.
🧱 System Philosophy
Risk Runway Planner follows the AGPro Series decision-engine approach:
Context first.
Risk before reward.
Structure before signal.
Attention markers instead of promises.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No state, score, label, alert, or visual box 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
The script is designed to help users think more clearly about setup quality, invalidation, volatility, and available room before reacting to price movement.
Indicator

Entry Execution Readiness [AGPro Series]Entry Execution Readiness
🧠 Core Idea
Is this setup ready for execution attention now, or should it remain on watch?
📌 Overview / What it does
Entry Execution Readiness is a chart-first decision engine built to evaluate whether an active setup has enough structure, risk quality, and target room to deserve execution attention.
The script produces a 0-100 Readiness Score, a clear entry state, an entry pocket, an invalidation rail, a target-room band, premium state labels, and a compact AGPro panel. It is designed to organize setup quality, not to predict price or automate execution.
It does not publish buy or sell commands. It does not replace a trader's own execution model. Its purpose is to turn observable setup conditions into a cleaner readiness map.
🎯 Purpose & Design Philosophy
This script was built for traders who already see a potential setup but need a disciplined way to decide whether the setup is clean enough to keep under execution review.
The gap it fills is practical: many tools identify signals, levels, or zones, but they do not answer whether the setup has acceptable risk distance, enough target room, suitable volatility, and directional confirmation at the same time.
The design philosophy is simple: execution should be reviewed through readiness, not excitement.
⚡ Why This Script Is Different
Most tools focus on printing a signal or highlighting a level.
This script does NOT act as a full Position Planner, position sizing model, signal service, or trade automation system.
Instead, it evaluates execution readiness through a compact decision layer: trend alignment, candle efficiency, distance to invalidation, target-room quality, and volatility fit are compressed into one transparent score and one clear next-action state.
⚙️ Methodology
1. Context Detection
The script detects the active setup side automatically, or lets the user force a long-bias or short-bias readiness view.
2. Reference Mapping
It maps an entry pocket around the active trend reference, builds an invalidation rail from recent structure, and projects target room from nearby structure or ATR-adjusted continuation space.
3. Reaction Evaluation
It scores trend alignment, candle efficiency, risk distance, reward room, and volatility fit from 0 to 100.
4. Visual Output
The chart displays the readiness state through zones, labels, alerts, and a premium AGPro panel with the key decision fields.
🗺️ How to Read the Chart
Zones = the active entry pocket and target-room band.
Invalidation rail = the structural level that would weaken or reset the current setup context.
Labels = the current readiness state, score tier, and risk context.
Colors = teal for stronger long-readiness contexts, pink for bearish or invalidation contexts, amber for waiting states, and indigo for monitoring/transition states.
Panel = the fastest summary of score, state, risk distance, target room, and next action.
🚦 Signals & States
• READY → the setup meets the score threshold and confirmation filter.
• MONITOR → the setup is improving but still needs cleaner confirmation or score strength.
• WAIT → the setup exists, but risk, target room, or confirmation is not yet strong enough.
• BLOCKED → the current context does not offer a clean execution-readiness profile.
• INVALIDATED → price closed beyond the active invalidation rail.
🔔 Alerts Logic
READY alerts trigger when the state upgrades into READY.
Downgrade alerts trigger when the active setup weakens from a stronger state.
Invalidation alerts trigger when price closes beyond the current invalidation rail.
Confirmation alerts trigger when score and confirmation improve together near the READY threshold.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The setup becomes stronger when directional trend alignment, candle quality, controlled invalidation distance, acceptable volatility, and clean target room improve at the same time.
The score is intentionally multi-factor so a single strong candle or a single clean level cannot dominate the full readiness view.
📊 When to Use
• Trend continuation setups
• Pullback-to-reference execution reviews
• Breakout continuation contexts with enough target room
• Active trade-planning workflows where the trader already has a directional thesis
• Intraday or swing charts where risk and target room need to be evaluated quickly
• 4-hour swing/execution review charts where the active pocket, invalidation rail, and target room can be read without excessive label compression
⚠️ When NOT to Use
• Very low liquidity markets
• Extremely noisy sideways conditions
• News-driven volatility spikes
• Charts where the user has no independent setup thesis
• Markets with poor execution conditions, wide spreads, or unreliable fills
🎛️ Key Inputs
• Setup Direction → Auto, Long Bias, or Short Bias readiness mode.
• Sensitivity → controls how selective the model is.
• Structure Lookback → affects structure, risk rail, target room, and volatility context.
• Minimum READY Score → defines the threshold required for READY state.
• Confirmation Mode → controls how much candle and trend confirmation is required.
• Label Cooldown / Max Visible Labels → controls label density.
• Panel Location / Panel Theme / Font Sizes → controls visual presentation.
🖥️ Interface & Visual Design
The interface is built around a clean premium overlay.
The panel uses the AGPro standard single merged blue header row and summarizes only the most decision-relevant fields.
The chart visuals are deliberately limited to the current entry pocket, invalidation rail, target room, and moderate state labels so the script remains readable in publication screenshots.
🧪 Practical Usage Workflow
1. Read the panel state and Readiness Score.
2. Check whether price is interacting cleanly with the entry pocket.
3. Review the invalidation rail and risk distance.
4. Compare the target-room band against the current risk.
5. Treat READY as a review state, not as an automatic execution command.
🔍 Interpretation Guidelines
Think of the output as a readiness filter.
A high score means the modeled conditions are aligned more cleanly than usual. It does not mean the setup will work.
A WAIT or MONITOR state can still be useful because it shows what part of the setup is not yet ready.
An INVALIDATED state means the current setup context should be reset or reviewed again from a fresh structure.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not auto trading
• Not guaranteed signals
• Not a full position-sizing planner
• Not a buy/sell command system
⚠️ Limitations & Transparency
Timeframe differences can change how structure, volatility, and target room appear.
Volatility expansion or contraction can make the readiness state change quickly.
Market conditions can shift faster than any rule-based chart tool can summarize.
The model is transparent and deterministic, but it cannot know future price behavior.
🧠 Market Context Notes
Entry readiness is most useful when it is read together with liquidity, structure, session context, and broader volatility conditions.
The script is strongest when the trader already has a setup thesis and needs a cleaner way to review whether execution conditions are improving or weakening.
🧾 Use Case Examples
When price pulls back toward the entry pocket, trend alignment remains intact, risk distance stays controlled, and target room remains clean, the setup may upgrade into MONITOR or READY.
When price stretches too far from the pocket or target room becomes too thin relative to invalidation distance, the score can weaken even if direction still looks attractive.
When price closes beyond the invalidation rail, the active setup context is marked as INVALIDATED.
🧱 System Philosophy
AGPro tools are designed to support structured chart reading, decision clarity, and rule-based interpretation.
This script follows that philosophy by focusing on execution readiness instead of generic signals.
🔐 Non-Promise Statement
No script can provide certainty.
No score can guarantee a future outcome.
This tool organizes visible chart conditions so the user can make a more structured review.
📉 Risk Disclosure
Trading involves risk. Market movement can be unpredictable, and any setup can fail.
Users are responsible for their own analysis, execution, risk management, and decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use the script as a structured decision-support layer. The strongest benefit comes from reviewing why the state is READY, WAIT, MONITOR, BLOCKED, or INVALIDATED rather than treating any single label as a standalone answer.
Indicator

Parabolic SAR Flip Quality [AGPro Series]Parabolic SAR Flip Quality
🧠 Core Idea
Is this Parabolic SAR flip strong enough to plan around, or is it just another noisy stop-and-reverse signal?
📌 Overview / What it does
Parabolic SAR Flip Quality is a planner-style Parabolic SAR overlay built to evaluate PSAR flip conditions as trade-decision context, not as simple directional signals.
The script keeps the classic Parabolic SAR dot trail visible, then adds a professional quality model that measures flip strength, trend alignment, SAR distance, candle efficiency, volatility expansion, and prior-leg maturity. The result is a clear 0-100 readiness score that helps traders judge whether the current PSAR flip environment is valid, weak, developing, or blocked.
It produces qualified flip labels, SAR dots, a SAR-native protection band, and a compact AGPro panel showing Flip Side, SAR Distance, Trend Filter, and Quality Score. It does not automate trades, predict future price, or tell users what to buy or sell. It organizes PSAR flip context into a cleaner decision framework.
🎯 Purpose & Design Philosophy
Most Parabolic SAR tools show where the SAR dots are and where the stop-and-reverse event happened. That is useful, but it often leaves the trader with the harder question: is this flip actually good enough to act on, monitor, or ignore?
This script was built to fill that gap. It turns a classic indicator into a structured decision engine by asking whether the flip has enough distance, trend support, expansion, and maturity behind it.
The design supports traders who want cleaner execution readiness, not more noise. It is built for chart readers who want to evaluate setup quality, risk area, invalidation context, and next-action state before making their own decision.
⚡ Why This Script Is Different
Most tools focus on printing every Parabolic SAR flip as if all flips have similar meaning.
This script does NOT treat a dot-side change as a complete setup. It also does not turn PSAR into a generic signal board or a generic support/resistance zone map.
Instead, it evaluates the flip as a planning event. The script scores the quality of the transition, checks whether trend conditions support the new side, measures how far price is from the SAR reference, and projects a SAR Protection Band that represents the stop-defense area created by the qualified flip.
The difference is the decision layer:
• Is the flip valid?
• How strong is it?
• Where is the SAR-based invalidation area?
• Is the trend filter helping or blocking the setup?
• What is the current read now?
⚙️ Methodology
1. Context Detection
The script detects whether price is currently operating on the bullish or bearish side of the Parabolic SAR. It also tracks raw SAR flips and measures how mature the prior SAR leg was before the transition.
2. Reference Mapping
The active SAR value becomes the primary reference point. Distance from SAR is normalized by ATR so the read adapts across symbols and timeframes.
3. Reaction Evaluation
Each flip is evaluated through a multi-factor quality model:
• SAR distance versus ATR
• EMA trend alignment
• EMA slope direction
• DMI directional agreement
• ADX trend strength
• Candle body efficiency
• Range expansion
• Prior-leg maturity
These conditions are combined into a 0-100 Quality Score.
4. Visual Output
When a flip passes the quality threshold, trend filter, SAR distance requirement, confirmation setting, and cooldown control, the script promotes it into a qualified chart label. It can also draw a SAR Protection Band around the flip's SAR reference for forward context.
🗺️ How to Read the Chart
SAR dots show the classic Parabolic SAR trail. Bullish dots appear below price, and bearish dots appear above price.
Qualified flip labels mark PSAR flips that passed the quality and trend conditions. The label includes the flip side and the quality score, allowing quick comparison between stronger and weaker transitions.
The SAR Protection Band represents the PSAR-based stop-defense area created after a qualified flip. It is not a generic support/resistance zone. It is a SAR-native invalidation and planning reference.
Colors follow the AGPro visual language:
• Teal = bullish side or bullish qualified flip
• Pink = bearish side or bearish qualified flip
• Gold = neutral, blocked, or caution state
• Indigo = trend backbone reference
The panel summarizes the active read:
• Flip Side
• SAR Distance
• Trend Filter
• Quality Score
🚦 Signals & States
• Bullish Flip → A qualified PSAR transition to the bullish side.
• Bearish Flip → A qualified PSAR transition to the bearish side.
• Trend Filter PASS → The broader trend filter agrees with the current SAR side.
• Trend Filter BLOCKED → The SAR side is active, but the broader trend filter does not fully support it.
• High Quality Score → The flip has stronger alignment across distance, trend, expansion, efficiency, and maturity.
• WAIT Grade → The current condition does not meet the preferred readiness profile.
These are analytical states, not trade instructions.
🔔 Alerts Logic
Alerts trigger only when a qualified bullish or bearish PSAR flip is confirmed by the script's quality rules.
• Qualified Bullish PSAR Flip → A bullish SAR flip passed the trend filter, quality threshold, SAR distance threshold, cooldown rule, and confirmation setting.
• Qualified Bearish PSAR Flip → A bearish SAR flip passed the trend filter, quality threshold, SAR distance threshold, cooldown rule, and confirmation setting.
Alerts are attention markers. They are not automated trading instructions and do not guarantee future movement.
🧩 Confluence Logic
The strongest context appears when several conditions align at the same time:
• PSAR flips to a new side
• Price has enough ATR-normalized distance from SAR
• EMA trend direction supports the flip
• DMI confirms directional pressure
• ADX shows enough trend strength
• Candle structure shows real expansion
• The previous SAR leg was mature enough
When these elements align, the flip becomes more useful as a planning reference.
📊 When to Use
This script is best suited for:
• Trending markets where SAR transitions can develop into continuation phases
• Swing-trading review on higher timeframes
• Crypto, forex, stocks, indices, and commodities with enough liquidity
• PSAR users who want a readiness score instead of raw dot flips
• Traders who want a cleaner invalidation reference around qualified SAR flips
• Multi-timeframe analysis where the user wants to compare flip quality across chart periods
⚠️ When NOT to Use
This script is less useful in:
• Very low-liquidity markets
• Extremely noisy sideways chop
• News-driven spikes where ATR and structure can distort quickly
• Ultra-low timeframes with unstable spread or poor execution quality
• Markets where price repeatedly flips around the SAR without trend expansion
In these conditions, raw PSAR flips and quality labels can become less reliable as planning references.
🎛️ Key Inputs
• SAR Start → Controls the initial Parabolic SAR acceleration factor.
• SAR Increment → Controls how quickly the SAR acceleration increases as the trend develops.
• SAR Maximum → Controls the maximum SAR acceleration level.
• Trend EMA Length → Defines the trend backbone used by the filter.
• DMI Length and ADX Smoothing → Control directional pressure and trend-strength measurement.
• Minimum ADX → Sets the required trend-strength floor.
• Minimum Quality Score → Defines how selective qualified flip labels should be.
• Minimum SAR Distance ATR → Blocks cramped flips that occur too close to the SAR reference.
• Prior Leg Maturity Bars → Requires the prior SAR leg to have enough development before a flip receives full maturity credit.
• Flip Cooldown Bars → Controls label density and keeps the chart readable.
• SAR Protection Band settings → Control the width, forward projection, and maximum active bands.
• Panel and Label Font Size → Adjust visual readability, with Normal as the default.
• Panel Location and Theme → Control the AGPro panel placement and appearance.
🖥️ Interface & Visual Design
The interface is designed to be premium, compact, and decision-focused.
The chart keeps the classic PSAR dots as the main visual anchor. Qualified labels appear only when the flip passes the selected filters. The SAR Protection Band is transparent and restrained so it adds planning context without overwhelming candles.
The AGPro panel uses a single merged blue header row with the script name, followed by a clean four-row readout. Its purpose is to summarize the current decision state without turning the chart into a dashboard-heavy layout.
🧪 Practical Usage Workflow
1. Read the panel.
Check the active Flip Side, SAR Distance, Trend Filter, and Quality Score.
2. Check the latest qualified label.
Compare the quality score with the minimum threshold and with prior labels on the chart.
3. Review the SAR Protection Band.
Use the band as a SAR-native planning reference for where the qualified flip should remain structurally defended.
4. Confirm broader context.
Compare the flip with trend direction, volatility, market structure, and timeframe behavior.
5. Decide independently.
Use the output as structured context, not as an automatic trade command.
🔍 Interpretation Guidelines
A strong read usually has a qualified flip label, a passing trend filter, enough SAR distance, and a higher quality grade.
A weaker read may show an active SAR side but a blocked trend filter or a low score. This means the SAR state exists, but the planning context is not strong enough under the script's model.
The SAR Protection Band should be interpreted as a stop-defense and invalidation reference. If price respects it, the flip context remains cleaner. If price violates it, the qualified flip has lost part of its structural value.
The best use of the script is comparison: compare current flip quality against previous flips, across timeframes, and across market conditions.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not guarantee profitable signals.
It does not replace independent analysis, position sizing, risk management, or broader market context.
⚠️ Limitations & Transparency
Parabolic SAR is a trend-following concept, so it can struggle in choppy or directionless markets.
Quality scoring improves structure, but it cannot remove all false transitions. Timeframe selection, volatility regime, liquidity, and market session can affect how signals appear and how useful the SAR Protection Band becomes.
The script is rule-based and transparent. It reads current and historical chart data according to the selected inputs. It does not know future price behavior.
🧠 Market Context Notes
PSAR flips tend to become more meaningful when they occur with volatility expansion, directional pressure, and enough distance from the SAR reference.
In compressed markets, the dots may switch sides more frequently and the score may change quickly. In stronger trends, the SAR dots often create cleaner trailing structure, and qualified flips can become more useful as planning events.
The best interpretation comes from combining the panel state, SAR distance, label quality, protection band behavior, and the broader market environment.
🧾 Use Case Examples
When price flips bullish, the trend filter passes, SAR distance expands above the minimum threshold, and the quality score is high, the user can treat that area as a cleaner bullish planning context.
When price flips bearish but the trend filter is blocked, the script communicates caution. The SAR side changed, but the broader read is not aligned.
When price returns to the SAR Protection Band after a qualified flip, the user can monitor whether the band is respected or violated as part of the invalidation read.
🧱 System Philosophy
The purpose of this script is not to add another signal to the chart.
The purpose is to turn a classic indicator into a decision-support framework:
• Setup validity
• Quality strength
• Trend agreement
• Risk reference
• Invalidation context
• Current action state
This is the AGPro direction: tools that help traders make better decisions, not tools that simply decorate the chart with more signals.
🔐 Non-Promise Statement
No indicator can provide certainty.
This script does not promise future outcomes, guaranteed performance, or risk-free execution.
Its role is to organize Parabolic SAR flip context into a clearer analytical structure.
📉 Risk Disclosure
Trading involves risk, and market conditions can change quickly.
This script is provided for educational and analytical purposes only. It does not provide financial advice, investment advice, or guaranteed trading outcomes.
Users are responsible for their own analysis, decisions, risk management, and trading results.
📚 Educational Note
Parabolic SAR is one of the most recognized stop-and-reverse indicators because it makes trend state visually simple. This script keeps that visual simplicity while adding a quality and planning layer so users can study which flips deserve more attention and which ones should remain secondary context. Indicator

Choppiness Setup Planner [AGPro Series]Choppiness Setup Planner
🧠 Core Idea
Is this choppy market still a no-trade environment, or has it matured into a valid setup with defined risk, invalidation, and targets?
📌 Overview / What it does
Choppiness Setup Planner is a planner-style overlay built for one of the most common decision problems in technical analysis: what should a trader do when price is trapped inside a choppy range, but pressure starts building near the edge?
The script detects no-trade chop conditions, builds a decision range around the active structure, scores setup quality from 0 to 100, and turns a mature range release into a clear planning map with invalidation and target levels. Instead of only saying "the market is choppy," it answers whether the setup is still avoidable, preparing, weak, valid, active, or invalidated.
The cleanest visual use case is higher-timeframe planning. Weekly and daily charts allow the full range-to-plan lifecycle to breathe: no-trade structure, preparation, release, target, and invalidation can all be read without the chart feeling crowded.
It does not automate execution, predict future price, or replace personal trade selection. It is an analytical planner designed to organize context, risk, and next-action state directly on the chart.
🎯 Purpose & Design Philosophy
This script was built because many market-state tools show information without helping the user make a decision. A Choppiness Index value, ADX filter, or range box can be useful, but those outputs often stop before the practical question: what now?
Choppiness Setup Planner fills that gap by connecting chop detection with a structured planning workflow. It is intended for discretionary traders, breakout traders, and range-to-expansion traders who want to avoid low-quality noise while preparing for stronger releases from mature ranges.
The design philosophy is simple: first protect attention, then qualify the setup, then map risk only when the structure deserves it.
⚡ Why This Script Is Different
Most tools focus on detecting chop, drawing a box, or marking a breakout.
This script does NOT act like a generic signal indicator, generic support/resistance tool, or simple Choppiness Index panel.
Instead, it turns a choppy market into a decision sequence:
1. Detect the no-trade environment.
2. Track range age and pressure.
3. Grade setup validity with a 0-100 score.
4. Define the next action state.
5. Map invalidation and targets only after a valid release.
That makes the script closer to a decision engine than a visual marker. It is also intentionally separated from manual position planners: users do not enter their own position parameters. The script derives its planning levels from the detected chop range and the release quality model.
⚙️ Methodology
1. Context Detection
The engine blends Choppiness Index, directional weakness, path efficiency, range tightness, wick noise, and volatility behavior to determine whether the market is inefficient enough to qualify as a no-trade chop environment.
2. Reference Mapping
When chop persists long enough, the script builds a decision range around the active structure. This range is not a generic support/resistance zone; it is a planning container for the current no-trade condition.
3. Reaction Evaluation
The script evaluates whether pressure is improving through range age, chop release, ADX lift, path-efficiency improvement, ATR lift, edge pressure, candle body quality, close quality, and optional volume participation.
4. Visual Output
The chart displays the no-trade ribbon, decision range box, centered zone label, preparation markers, valid plan markers, weak-release markers, invalidation level, target levels, and a compact AGPro planner panel.
🗺️ How to Read the Chart
Zones represent the active no-trade decision range. A centered label inside the box shows whether the structure is still a no-trade zone or has moved into preparation mode.
Labels represent state changes. PREP marks a mature range with improving setup quality. PLAN UP and PLAN DN mark valid releases. SKIP marks a release that happened but failed the minimum plan-quality threshold. T1, T2, and INVALID track the active plan lifecycle.
Colors follow the AGPro state palette. Teal is used for stronger upside planning states, pink for downside or invalidation states, amber for caution and no-trade states, and indigo for preparation/readiness.
The panel shows Setup Quality, Next Action, Chop / Ready, Range Age, Invalidation, and Targets.
🚦 Signals & States
• Avoid: Chop → the market is inefficient and still belongs in no-trade mode.
• Prepare: Edge Watch → the range has matured and internal readiness is improving.
• Skip: Low Quality → price released from the range, but the quality score was not strong enough.
• Track Upside Plan → upside release met the minimum valid plan score.
• Track Downside Plan → downside release met the minimum valid plan score.
• Manage: T1 Reached → the active plan reached its first target level.
• Review: T2 Reached → the active plan reached its second target level.
• Reset: Invalidated → the active plan crossed its invalidation level.
🔔 Alerts Logic
Alerts are available for preparation state, valid upside plan, valid downside plan, weak release, Target 1 reached, Target 2 reached, and invalidation.
Each alert is an attention marker. Alerts are not trade instructions, not automation rules, and not execution commands.
🧩 Confluence Logic
The setup becomes stronger when a mature chop range aligns with improving readiness, edge pressure, candle body participation, release distance, and optional volume participation.
When these components align, the script can convert the release into a valid plan. When price releases without enough score, the script marks the event as SKIP instead of treating every breakout as useful.
📊 When to Use
• Choppy markets where the user needs a no-trade filter.
• Weekly, daily, and 4H planning where range structure matters more than micro-noise.
• Mature ranges that may be preparing for expansion.
• Breakout-preparation workflows.
• Range-to-trend transition monitoring.
• Symbols where invalidation and target structure should be visible before acting.
⚠️ When NOT to Use
• Extremely illiquid markets with unreliable candles.
• Symbols where volume data is misleading, unless volume participation is disabled.
• News-driven spikes where a single candle can distort range logic.
• Very low timeframes with excessive spread noise.
• Scalping workflows that require rapid-fire signals instead of structural planning.
• Markets where the user has no broader context for trend, liquidity, or session behavior.
🎛️ Key Inputs
• Choppiness Length → controls the chop-detection backbone.
• Decision Range Length → controls how the active no-trade range is framed.
• Minimum Range Age → controls how long chop must persist before planning begins.
• Preparation Threshold → controls when the range moves from avoid mode to preparation mode.
• Minimum Valid Plan Score → controls how selective valid plan labels should be.
• Release Buffer ATR → controls how far price must move beyond the range boundary.
• Invalidation Buffer ATR → controls the distance behind the released boundary used for invalidation.
• Target 1 / Target 2 R Multiples → control target projection from the plan risk.
• Panel Location / Theme / Font Size → control the AGPro panel interface.
• Label Font Size / Cooldown / Maximum Visible Labels → control chart readability.
🖥️ Interface & Visual Design
The interface is designed around fast decision reading. The chart carries the range box, no-trade ribbon, centered zone label, event labels, and active risk/target levels. The panel summarizes the same workflow without becoming a large dashboard.
The first panel row follows the AGPro standard: one merged blue header row containing only the script name.
Visual density is intentionally moderate. The chart should not look empty, but it should also avoid crowded signal spam.
🧪 Practical Usage Workflow
1. Read the panel.
Check Setup Quality and Next Action first.
2. Check the decision range.
If the box says NO-TRADE, the structure is still inefficient. If it says PREP, the range is maturing.
3. Evaluate the release.
A valid PLAN label means the release met the quality threshold. A SKIP label means the release was not strong enough.
4. Review invalidation and targets.
When a plan is active, use the plotted levels to understand structure, not as automatic orders.
5. Confirm broader context.
Combine the planner output with trend, liquidity, timeframe, session, and personal execution rules.
For publication screenshots, higher-timeframe examples are usually the cleanest because they show the complete planning sequence without compressing labels and boxes into a noisy layout.
🔍 Interpretation Guidelines
Think in states, not isolated signals.
NO-TRADE protects attention.
PREP means the market is becoming more interesting.
PLAN means the release has enough structure to track.
SKIP means the release happened but did not earn quality.
INVALID means the plan lost its structural premise.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not auto trading.
It is not guaranteed signals.
It is not a strategy tester.
It is not a replacement for independent analysis.
⚠️ Limitations & Transparency
The script is rule-based and depends on selected inputs, timeframe, volatility, and available market data.
Different symbols and sessions can produce different behavior. Low liquidity, sudden volatility shocks, and abnormal gaps can reduce the usefulness of range-based planning.
Volume participation is optional because volume quality differs across markets and feeds.
🧠 Market Context Notes
Chop is not always weakness. Sometimes it is absorption, sometimes indecision, and sometimes simple noise. The script does not claim to know the cause. It organizes the observable structure so the user can decide whether the environment is worth attention.
🧾 Use Case Examples
When price spends several bars inside a tight inefficient range and the panel says Avoid: Chop, the script is acting as a no-trade filter.
When the range matures and the centered label changes to PREP, the script is showing that pressure has improved enough to monitor the edge.
When price releases and receives PLAN UP or PLAN DN, the script maps invalidation and targets from the structure.
When price releases but receives SKIP, the script is saying the event did not meet the model's quality threshold.
On weekly charts, a single valid plan can show the entire decision chain: range maturity, preparation, release, target reaction, and invalidation. This is the strongest showcase environment for the script.
🧱 System Philosophy
AGPro tools are built around structured decision support: define the condition, score the quality, map the relevant structure, and keep the chart readable.
Choppiness Setup Planner follows that philosophy by turning a noisy no-trade environment into a cleaner decision workflow.
🔐 Non-Promise Statement
No script can provide certainty.
No score guarantees follow-through.
No label guarantees an outcome.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, planned setups can fail, and losses can occur. This script is provided for educational and analytical use only. It does not provide financial advice or guaranteed trading outcomes. Users remain responsible for their own analysis, decisions, risk management, and execution.
📚 Educational Note
Use this script to study how choppy markets mature, how range releases differ in quality, and how invalidation and target logic can be organized visually before a decision is made. Indicator

Gap Fill Reaction Planner [AGPro Series]Gap Fill Reaction Planner
🧠 Core Idea
Is this gap reaction actually ready for planning, or is it just another rectangle on the chart?
📌 Overview / What it does
Gap Fill Reaction Planner is a planner-style price action tool built around gap fill behavior, reaction quality, and execution readiness. Instead of simply drawing gap zones, it evaluates whether the active gap reaction has enough structure to become a measurable plan.
The script detects gap support and gap resistance zones, tracks fill progress, classifies reaction state, and converts the active setup into a 0-100 readiness score. It also maps a live entry reference, invalidation level, target projection, and estimated R multiple so the user can review the structure as a plan rather than as an isolated signal.
It does not automate trades, predict future price, or replace independent analysis. Its purpose is to organize gap reaction context into a cleaner decision framework.
🎯 Purpose & Design Philosophy
This script was built to move beyond passive gap marking. A normal gap indicator can show where a gap exists, but it does not answer the questions that matter before a trade idea is considered:
Is the reaction valid?
How strong is the setup?
Where is the invalidation?
Where is the target?
What should the trader watch next?
Gap Fill Reaction Planner was designed for traders who want a structured workflow around opening gaps, continuous-market reaction bands, partial fills, full fills, rejection behavior, and acceptance risk. The mindset is not "take every gap." The mindset is "measure the reaction first."
⚡ Why This Script Is Different
Most gap tools focus on detection. They draw every gap, imbalance, or separation zone and leave the decision process to the user.
This script does NOT act as a generic gap highlighter, generic support/resistance map, or broad imbalance catalog.
Instead, it treats each gap as a planning object. Every active zone is evaluated through fill depth, reaction state, volatility context, participation, age, and structural validity. The panel then translates that context into readiness, next action, invalidation, target, and risk/reward information.
That planner layer is the difference. The script helps the user decide whether a gap reaction deserves attention, not merely whether a gap exists.
⚙️ Methodology
1. Context Detection
The script first searches for gap reaction zones. It prioritizes classic open-to-previous-close gaps, then supports adaptive reaction bands for continuous markets where clean opening gaps may be rare.
2. Reference Mapping
Each detected zone receives a fixed-length rectangular band. The zone is not dragged forward forever; it remains anchored to its origin so old structures do not distort the current chart. Thin zones are displayed with a minimum visual height so the chart keeps a cleaner, more professional planning layer.
3. Reaction Evaluation
The engine tracks fill percentage, partial fill, full fill, rejection, and acceptance. Rejection behavior is treated differently from simple fill behavior because a filled gap and a rejected gap communicate different planning context.
4. Planner Scoring
The readiness score combines gap size, fill quality, reaction behavior, volatility participation, and recency. The score is normalized from 0 to 100.
5. Risk / Target Projection
For the active planner zone, the script calculates an invalidation reference beyond the far side of the gap and projects a target using the selected R multiple.
6. Visual Output
The chart shows gap zones, centered zone labels, optional fill progress, planner labels, and active plan levels. The panel summarizes the decision state.
🗺️ How to Read the Chart
Zones
Gap Support zones represent upward gap reactions that may act as support-style planning areas.
Gap Resistance zones represent downward gap reactions that may act as resistance-style planning areas.
Zone Labels
Focused zones can display a centered label showing the zone role, state, and readiness score. This keeps the chart readable without turning every historical zone into a text cluster.
Colors
Bullish planner context uses the AGPro green state color.
Bearish planner context uses the AGPro pink state color.
Neutral or unfinished context uses restrained secondary colors.
Panel
The panel shows readiness, next action, plan side, gap size, fill/state, invalidation, target/R, and bias.
Plan Levels
When an active planner zone exists, the script can display entry reference, invalidation, and target lines.
🚦 Signals & States
• Fresh → A new gap zone exists but has not reached meaningful fill depth.
• Partial Fill → Price has returned into the gap enough to begin reaction monitoring.
• Rejected → Price filled part of the gap and then closed back away from the zone.
• Full Fill → The gap has reached the full-fill threshold and becomes more neutral.
• Accepted → Price closed beyond the far boundary of the gap, meaning the zone has lost its original reaction role.
• Planner Ready → A rejection setup reached the configured readiness threshold.
🔔 Alerts Logic
New Gap Support Zone
Triggers when a bullish gap support planning zone is created.
New Gap Resistance Zone
Triggers when a bearish gap resistance planning zone is created.
Gap Partial Fill
Triggers when a tracked zone reaches the partial-fill threshold.
Gap Full Fill
Triggers when a tracked zone reaches the full-fill threshold.
Gap Planner Ready
Triggers when a rejection setup reaches the readiness score threshold.
Gap Acceptance
Triggers when price accepts beyond the far side of the gap.
Alerts are attention markers and workflow prompts. They are not trade instructions.
🧩 Confluence Logic
The planner score becomes stronger when multiple conditions align:
• The gap has enough ATR-normalized size
• Fill depth is meaningful but not exhausted
• Reaction behavior confirms away from the zone
• Current volatility and participation support the reaction
• The zone is recent enough to remain relevant
When these pieces align, the gap becomes a stronger planning candidate.
📊 When to Use
• After large opening gaps
• During pullbacks into gap support or gap resistance
• Around partial fill and rejection behavior
• In trending markets where gaps create reaction shelves
• In volatile markets where gap fill behavior matters
• On crypto and FX charts where adaptive reaction bands may help continuous-market analysis
⚠️ When NOT to Use
• Extremely low-liquidity symbols
• Very noisy micro timeframes
• Market conditions where spread, slippage, or data quality is poor
• When the chart is moving too fast for structured planning
• When a trader has not defined broader market context
🎛️ Key Inputs
Detection Mode
Controls whether the script uses only classic open gaps or adaptive reaction bands.
Minimum Gap Size
Filters out small gaps using ATR normalization.
Readiness Threshold
Defines the minimum score required for a planner-ready label.
Target Multiple (R)
Projects the target from the current reference price using the invalidation distance.
Invalidation Buffer
Adds ATR-based spacing beyond the far side of the gap zone.
Zone Right Extension
Controls how far each zone projects from its origin.
Panel / Label Settings
Control panel visibility, panel theme, panel location, and font sizes.
🖥️ Interface & Visual Design
The interface is built for quick decision review. The panel provides the planner summary, while the chart emphasizes the most important structural elements: premium-height zones, focused centered labels, action labels, and active plan levels.
The visual hierarchy is intentionally clean. Zones explain context, labels explain state, and the panel explains what to do next from an analytical standpoint.
🧪 Practical Usage Workflow
1. Read the panel readiness score.
2. Check whether the next action is monitor, wait, plan, or stand aside.
3. Review the active gap zone and its centered label.
4. Compare fill percentage with the reaction state.
5. Review invalidation and target levels.
6. Confirm the idea with broader market context before acting.
🔍 Interpretation Guidelines
A high score does not mean certainty. It means the gap reaction has stronger planning structure.
A partial fill means price has started interacting with the gap, but reaction quality still matters.
A rejection state is more meaningful when it occurs with strong score, clean invalidation, and acceptable target distance.
An accepted zone should usually be treated as a failed reaction context rather than an active planning area.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not an automated trading system.
This script is not a financial advice tool.
This script does not provide guaranteed outcomes.
This script does not replace risk management, trade review, or independent confirmation.
⚠️ Limitations & Transparency
Gap behavior can change significantly across symbols and timeframes.
Continuous markets may produce fewer classic opening gaps, which is why the script includes adaptive detection modes.
Volatility expansion can make targets and invalidation levels wider.
Low-liquidity environments may reduce the reliability of reaction labels and score readings.
No rule-based tool can fully account for news events, sudden liquidity shifts, or execution quality.
🧠 Market Context Notes
Gap reactions are often more useful when they are read together with trend structure, volatility, session behavior, and liquidity context. A gap zone is not automatically important because it exists. It becomes more useful when price returns to it, reacts clearly, and produces a measurable planning structure.
🧾 Use Case Examples
When price returns into a Gap Support zone and rejects upward with a high readiness score, the panel can help review whether invalidation and target structure are measurable.
When price fills a Gap Resistance zone and accepts above it, the script marks the context as acceptance rather than treating the zone as a still-valid resistance area.
When the panel shows low readiness, the script is communicating that the structure may exist visually but is not yet a strong planner candidate.
🧱 System Philosophy
AGProLabs tools are built around structured interpretation. The goal is not to add more noise to the chart. The goal is to convert raw market behavior into a cleaner decision framework that traders can review with discipline.
🔐 Non-Promise Statement
No indicator can remove uncertainty.
No score can guarantee a result.
No planner can replace the trader's responsibility to manage risk.
📉 Risk Disclosure
Trading involves risk. This script is provided for educational and analytical use only. It does not provide financial advice, investment advice, or guaranteed trading outcomes. Users remain responsible for their own research, risk management, position sizing, and execution decisions.
📚 Educational Note
The best use of this script is not to chase every gap. The best use is to slow the decision process down, measure the reaction, and decide whether the setup is structured enough to deserve attention.
Indicator

Daily Trade Plan Generator [AGPro Series]Daily Trade Plan Generator
Daily Trade Plan Generator — complete morning briefing tool that generates a structured, rules-based trade plan for every new trading day. Combines key levels, multi-timeframe bias, projected volatility range, and adaptive Plan A/B/C playbooks into one premium dashboard.
🔷 OVERVIEW
Most traders start their day scattered — flipping through charts, trying to remember yesterday's highs and lows, guessing where the market might move. Daily Trade Plan Generator replaces that chaos with a single structured briefing. Every new trading day (either at UTC midnight for crypto or at a configurable exchange session open), the script automatically generates a complete plan: where the key levels are, which direction has the stronger multi-timeframe bias, how wide the day is likely to trade, and what the Plan A, Plan B, and Plan C playbooks look like. It is the first tool to open every morning — and it is self-updating, so you never have to reset it.
This is not a signal generator and not a strategy. It is a briefing tool, designed for traders who want to start every session with the same structured preparation a professional desk would do — without spending 30 minutes on it manually.
🎯 UNIQUE EDGE
What separates this script from generic level indicators and daily-high-low plotters:
• All-in-one daily briefing — levels, bias, volatility, and Plan A/B/C in one dashboard, not four separate indicators cluttering the chart.
• Multi-timeframe bias score (0 to 100) blending 1H, 4H, Daily, and Weekly EMA structure with three configurable weighting modes (Fast, Balanced, Conservative) so the bias matches your trading style.
• Asset-class-aware round numbers — the script auto-detects price magnitude and picks sensible round-number intervals (1000 for BTC-scale assets, 0.01 for forex majors, and so on) without manual setup.
• Projected daily range as a visual zone — ATR-based expected high and low rendered either as a semi-transparent rectangle, dashed lines, or both, giving you an immediate read on where price is likely to operate.
• Plan A / Plan B / Plan C structure (user-configurable 1 to 3) — deliberate "Plan" terminology to avoid confusion with pivot S/R notation. Plan language uses historical-pattern framing with no forecasting claims.
• Two refresh anchors plus a "both visible" option — crypto traders get UTC midnight, equities/futures traders get configurable session open, swing traders can see both markers.
• Timeframe-adaptive behavior — on weekly and higher timeframes, PDH/PDL automatically hide (since "previous day" is not meaningful there), and Plan A/B references shift to PWH/PWL for consistency.
• Smart label collision avoidance — PROJ HI/LO, PDH/PDL, and PWH/PWL labels intelligently reposition when too close together, keeping every chart readable at any scale.
• Volatility regime classification (Low / Normal / High) with a context-aware risk note that adapts to market conditions.
🧩 METHODOLOGY
LEVELS. Previous Day High/Low and Previous Week High/Low are pulled via higher-timeframe requests and rendered as persistent lines extending from today's session open to the right. The nearest round number is drawn as a single dotted line on the chart; the full list of nearby round numbers is shown in the dashboard panel to keep the chart clean.
BIAS SCORE. For each timeframe (1H, 4H, 1D, 1W), three components are evaluated: fast EMA versus slow EMA relationship, close versus fast EMA position, and fast EMA slope direction. Each component contributes plus or minus one, averaged to a per-timeframe score between -1 and +1. The four timeframe scores are then combined using the selected weighting mode and normalized to a 0-100 scale. Scores above 65 are labeled Bull, below 35 Bear, and in between Neutral.
VOLATILITY. Daily ATR over the configurable length (default 14) determines the expected range. The range is centered on today's session open and expanded by the Range Multiplier input. ATR as a percentage of open price classifies the regime: below 1% is Low, above 4% is High, in between is Normal.
PLANS. The script composes Plan A (primary, aligned with bias), optionally Plan B (alternative, opposite-side rejection path), and optionally Plan C (range / mean-reversion, activated when volatility is low or bias is neutral). Plan references adapt automatically to chart timeframe — intraday and daily charts use PDH/PDL, weekly and higher charts use PWH/PWL. The language is deliberately conditional and references historical patterns rather than predicting future prices.
🔔 SIGNALS & ALERTS
The script includes five built-in alert conditions:
• New Daily Plan Generated — fires when the daily refresh anchor triggers.
• Price Broke PDH — crossover above Previous Day High.
• Price Broke PDL — crossunder below Previous Day Low.
• Price Exceeded Projected High — crossover above ATR-projected high (volatility expansion).
• Price Exceeded Projected Low — crossunder below ATR-projected low (volatility expansion).
Each alert includes the ticker and relevant price in the message payload, ready to route into any alert handler.
⚙️ KEY INPUTS
• Daily Refresh Anchor — UTC Midnight, Exchange Session, or Both Visible.
• Exchange Session Open Hour — 0 to 23, used when Exchange or Both is selected.
• Key Levels toggles — PDH/PDL, PWH/PWL, Round Numbers individually toggleable.
• Round Numbers in panel — 1 to 5 levels above and below the current price.
• Bias Calculation Mode — Fast (HTF-weighted), Balanced, or Conservative (MTF-weighted).
• EMA Fast / Slow periods — defaults 20 and 50.
• ATR Length and Range Multiplier — control the width of the projected daily range.
• Expected Range Visualization — Zone (Box), Dashed Lines, or Both.
• Number of Plans — A, A+B, or A+B+C.
• Panel Location — six corner/middle positions.
• Panel and Label font sizes — Tiny through Huge, default Normal.
• Panel Theme — Dark or Light, adapts to chart background.
🛠️ HOW TO USE
1. Add the script to your chart at the start of each trading day (or leave it on permanently — it refreshes automatically).
2. Read the dashboard panel top to bottom: LEVELS tell you where the battle lines are, BIAS tells you the dominant direction, VOLATILITY tells you how much room the market has, PLANS give you conditional playbooks for the day.
3. Check the "Risk Note" line — it adapts to the volatility regime and bias. Low volatility suggests patience, high volatility suggests reducing size, neutral bias suggests waiting for a clean break.
4. Use the plotted levels as structural references for your own entries and exits. The projected range box highlights where mean-reversion trades are statistically more likely to work.
5. Set alerts on PDH/PDL breaks and projected-range expansion events to get notified when your Plan A or Plan B is being tested.
6. Adjust the bias mode to match your style: intraday scalpers benefit from Fast (HTF-weighted), position traders often prefer Conservative (MTF-weighted).
⚠️ LIMITATIONS & TRANSPARENCY
• This is a briefing tool, not a strategy or signal generator. It does not open, close, or manage trades.
• All levels and plans are derived from historical data (previous day/week highs and lows, ATR, EMA structure). Past structure does not guarantee future behavior.
• Projected ranges are statistical estimates based on ATR — actual daily ranges can and do exceed them, especially during news events or regime shifts.
• The multi-timeframe bias score is a momentum/trend structure measurement, not a prediction. Markets can reverse at any time regardless of bias.
• Plan language uses historical-pattern framing deliberately. No plan is a forecast; it is a conditional reference for discretionary decision-making.
• On weekly and higher timeframes, PDH/PDL are hidden by design because "previous day" is not a meaningful unit for weekly-horizon decisions. Plan A and Plan B use PWH/PWL as reference in those cases.
• The script does not repaint on closed higher-timeframe bars. The daily open, PDH, PDL, PWH, PWL are locked once the respective higher-timeframe bar closes.
• Round-number auto-detection uses price magnitude; for unusual instruments (very high or very low priced), review the levels manually.
🛡️ RISK DISCLOSURE
Trading involves substantial risk of loss. This script is a technical analysis tool provided for informational and educational purposes only. It does not constitute financial advice, investment recommendations, or a solicitation to trade any instrument. Past performance of any pattern, level, or methodology shown is not indicative of future results. Always conduct your own analysis, manage your position size according to your risk tolerance, and consider consulting a qualified financial professional before making trading decisions. The author and AGProLabs assume no liability for any trading outcomes resulting from the use of this tool.
Indicator

Take Profit Planner [AGPro Series]Take Profit Planner
🎯 **Overview**
**Take Profit Planner ** is a precision exit-planning tool that transforms trade management from guesswork into a structured process. It builds a disciplined profit ladder around any trade idea — whether you are a scalper managing rapid exits or a swing trader stepping out of positions over days — and keeps the entire plan on one chart with live progress tracking.
Most traders agonize over entries and leave exits to improvisation. This tool flips that habit: define your anchor, choose your calculation style, and the script projects a complete multi-tier exit map with stop loss, position-sizing allocation, confluence scoring, and real-time hit tracking.
🪜 **What Makes It Different**
Unlike conventional take-profit indicators that plot a single ATR-based target or fixed R:R pair, this tool offers a **multi-layer exit architecture**:
▫️ **Three Calculation Modes** — Fibonacci Extensions, R-Multiples, or Hybrid Confluence in a single tool
▫️ **Three Anchor Sources** — Manual price inputs, auto pivot detection, or recent S/R zone anchoring
▫️ **Confluence Scoring** — In Hybrid mode, every target receives a ★ / ★★ / ★★★ rating based on how many independent level types (Fib, round number, pivot S/R) cluster at that price
▫️ **Position-Sizing Layer** — Allocate a custom percentage of your position to close at each tier, with automatic weighted P&L calculation
▫️ **Live Progress Tracking** — Visual hit confirmation (✓), realized vs expected profit, and a six-state status ladder: ACTIVE → PROGRESSING → IN PROFIT → NEAR COMPLETE → ALL TPs HIT → STOPPED OUT
🧠 **Methodology**
▫️ **Anchor Detection** — The script identifies a trade's origin (Swing) and entry point using one of three methods. Auto Pivot uses a confirmable `pivothigh`/`pivotlow` with configurable length. Auto S/R uses the most recent swing extremes as structural anchor points. Manual lets you input exact prices.
▫️ **Direction Inference** — LONG or SHORT is determined automatically from the geometry: Entry above Swing → LONG, Entry below Swing → SHORT. No manual flag needed.
▫️ **Stop-Loss Logic** — Three modes: ATR Multiple (volatility-adaptive), Swing Point (structural), or Fixed Percent (disciplined). In Manual anchor mode, you set the stop directly.
▫️ **Target Projection** — Fibonacci mode projects targets from the Anchor→Swing leg using standard extensions (1.272, 1.414, 1.618, 2.000, 2.618). R-Multiple mode multiplies the stop distance by risk factors (1R, 2R, 3R, 5R, 8R). Hybrid uses Fibonacci as base and scores confluence.
▫️ **Confluence Algorithm** — For each Fibonacci target, the script checks proximity to: (1) the nearest psychological round number within 0.15 ATR, (2) the most recent pivot high within 0.2 ATR, (3) the most recent pivot low within 0.2 ATR. Each alignment adds one point to the base Fibonacci score.
▫️ **Hit Detection** — On every confirmed bar, the script checks whether price crossed each un-hit target. Hits are persistent until the anchor changes by more than 1 ATR, at which point the plan resets.
🔔 **Signals & Alerts**
▫️ **TP Hit** — Fires once per bar when price touches a specific target. Alert message includes tier number, price, and direction.
▫️ **SL Hit** — Fires once when stop-loss is breached.
▫️ **All TPs Reached** — Fires once when the full ladder is completed.
All alerts are non-repainting and trigger only on confirmed bars.
🎛️ **Key Inputs**
▫️ **Calculation Mode** — Fibonacci Extensions, R-Multiples, or Hybrid Confluence
▫️ **Anchor Source** — Manual Price, Auto Pivot High/Low, or Auto Recent S/R
▫️ **Pivot Length** — Bars of confirmation for automatic pivot detection (default 10)
▫️ **Stop-Loss Mode** — ATR Multiple, Swing Point, or Fixed Percent
▫️ **Number of TP Tiers** — 2 to 7 (default 5)
▫️ **Fibonacci / R-Multiple Levels** — Fully customizable per tier
▫️ **Allocation %** — Position-sizing percentage per tier
▫️ **Zone Half-Width (ATR)** — Vertical thickness of target zones in ATR units
▫️ **Panel Location & Theme** — Six positions, Dark or Light theme
▫️ **Label & Panel Font Size** — Tiny, Small, Normal, Large
💡 **How to Use**
▫️ **Scalper Workflow (Fast Exits)** — Set Calculation Mode to R-Multiples, tier count to 3, allocations to 50 / 30 / 20. Use Auto Pivot with pivot length 5–8 on lower timeframes. Exit weighted-partials at each R-level.
▫️ **Swing Trader Workflow (Multi-Day Holds)** — Set Calculation Mode to Hybrid Confluence, tier count to 5, allocations to 20 / 20 / 25 / 20 / 15. Use Auto Pivot with length 10–15 on 4H or daily. Prioritize exits at ★★★ confluence targets.
▫️ **Discretionary Trader Workflow** — Set Anchor Source to Manual Price, enter your own Entry, Swing, and SL values. Choose Fibonacci mode for trend-based projections or Hybrid for confluence-weighted decisions.
▫️ **Position Management** — The Expected line in the panel shows total profit % if all active tiers are filled (weighted by allocation). The Realized line tracks booked profit as tiers fill. Use this to compare planned vs actual performance.
⚠️ **Limitations & Transparency**
▫️ This is a **planning and visualization tool**, not an entry signal generator. It assumes you already have a trade bias; it structures the exit.
▫️ **Auto-anchor modes** rely on confirmed pivots, which means the most recent plan updates a few bars after a fresh pivot forms. This is intentional to prevent repainting.
▫️ **Confluence scoring** is based on the current snapshot of pivot highs/lows and round numbers. As price moves and new pivots form, scores may change.
▫️ **Hit detection** uses bar highs/lows on confirmed candles only.
▫️ The tool does not know your actual fill prices, slippage, or spreads — expected and realized percentages assume exact execution at target prices.
🛡️ **Risk Disclosure**
Trading involves substantial risk of loss and is not suitable for every investor. The information provided by this indicator is for educational and informational purposes only and does not constitute financial advice, a trading recommendation, or a solicitation to buy or sell any asset. Past performance does not guarantee future results. Always perform your own analysis, define risk before entering any trade, and use proper position sizing. The author and AGProLabs accept no liability for trading decisions made using this tool.
🔓 **Open Source**
This script is published open-source under the Mozilla Public License 2.0. You are welcome to study the methodology, build on it, and contribute feedback. Indicator

Stop Loss Optimizer Engine [AGPro Series]Stop Loss Optimizer Engine
🔹 OVERVIEW
Stop Loss Optimizer Engine compares four independent stop-loss methodologies side by side on a single chart, so traders can see at a glance where each approach would place protection and which one has historically held up best on the current symbol and timeframe. Every method is calculated for both LONG and SHORT, giving eight reference levels plus a compact panel with distance-to-price and a historical hold-rate statistic per method. A Risk Zone highlights the area between current price and the method with the strongest historical hold-rate, providing a clean S/R-style visual anchor for position sizing and R-multiple planning.
🔹 UNIQUE EDGE
Most stop-loss indicators on the platform commit to a single philosophy — pure ATR, pure Chandelier, or pure structure. Traders who want to compare approaches end up loading multiple scripts and eyeballing the differences. Stop Loss Optimizer Engine is built around a different premise: volatility, structure, trailing and recent-extreme stops each have environments in which they work well, and the trader should decide based on evidence rather than habit. The indicator renders all four on one chart, adds a per-method hold-rate measured on the active instrument, and flags the highest-hold-rate method with a star marker so the comparison is always a single glance away. The Risk Zone is drawn using the current-best method, which means the visual anchor adapts to whichever approach is statistically holding up best on that symbol and timeframe right now.
🔹 METHODOLOGY
The four engines are independent and each produces a LONG and a SHORT level:
ATR-SL — close minus or plus ATR × multiplier. Volatility-adaptive, widens in turbulent markets, tightens in calm ones.
Pivot-SL — the most recent confirmed pivot low or pivot high. Respects market structure, places the stop beyond the last reversal point rather than at an arithmetic distance.
Chandelier-SL — highest high minus ATR × multiplier for LONG, lowest low plus ATR × multiplier for SHORT. The classic Le Beau / Elder trailing stop, designed to follow strong trends without premature exits.
Swing-SL — the lowest low or highest high over a short lookback. A simple, robust baseline that works well for shorter trades and scalping.
Hold Rate — for every historical bar in the lookback window, the indicator records the SL level that each method would have produced at that bar, then checks whether price breached that level within a fixed forward window. Hold Rate is the percentage of evaluated bars in which the SL was not breached. This is a pure historical observation, not a forward performance projection.
🔹 SIGNALS & ALERTS
Visual — dotted lines for LONG stops (plotted below price), dashed lines for SHORT stops (plotted above price). Each method uses a distinct color. Labels sit at the right edge of each line with the method name and exact price. A dedicated anti-overlap resolver repositions labels vertically whenever two or more methods produce near-identical levels, so the rightmost chart panel stays readable in tight clusters.
Risk Zone — a shaded rectangle between current close and the highest-hold-rate SL on the trend-dominant side, extending forward from the current bar. Color matches the selected best method.
Panel — four-column layout showing method, LONG price (and distance %), SHORT price (and distance %), and Hold Rate, with a star marker beside the method currently holding the highest rate. A trend footer reports Bullish or Bearish based on the EMA50 filter.
Alerts — four pre-configured conditions for price breaching the ATR and Chandelier SL levels on either side.
🔹 KEY INPUTS
Method toggles for each of the four engines. Length and multiplier inputs per method, with balanced defaults (ATR 1.5× / 14, Pivot length 5, Chandelier 2.5× / 22, Swing lookback 7). Hold-rate statistics lookback and forward window, defaulting to 1000 and 10 bars. Visual controls for long-side lines, short-side lines, labels, the Risk Zone and a trend-based dimming of the counter-trend side. Panel location (six positions), panel theme (Dark or Light), and adjustable font sizes for panel and labels, all defaulting to Normal.
🔹 HOW TO USE
Open the indicator on any symbol and any timeframe. Read the panel first — the starred method is the one with the best historical hold-rate on the current chart. Pick a method that matches the trade plan: ATR for volatility-aware scalps, Pivot for structural setups, Chandelier for trend-following swings, Swing for simple quick trades. Use the Hold Rate column as secondary evidence, not as a standalone forecast. Read the SL price and the distance percentage next to it to size position accordingly — a 2% stop and a 6% stop are not the same trade, even on the same entry. The Risk Zone is a convenience visual for the trend-dominant side and should be interpreted together with the other levels, not in isolation.
🔹 LIMITATIONS & TRANSPARENCY
Hold Rate is a backward-looking statistic computed on historical bars of the active chart. It describes what would have happened under a fixed forward-window assumption on past data and does not guarantee any future behavior. The forward-window length, lookback size and method parameters all influence the resulting numbers; changing inputs changes the statistic. The Pivot-SL method depends on the availability of confirmed pivots in the lookback window and will fall back to a conservative ATR-based placeholder when a pivot is not yet confirmed. Risk Zone selection is based on hold-rate ranking, which can switch between methods as markets evolve. This script is a decision-support tool for discretionary risk management, not a trade-entry signal generator. Always combine with independent analysis and sound position sizing. Past performance of any stop-loss method does not guarantee future results.
🔒 RISK DISCLOSURE
This script is provided for educational and informational purposes only. It is not financial, investment or trading advice. Trading involves substantial risk of loss; use at your own discretion and risk. Indicator

JOAT Institutional Convergence [JOAT]JOAT Institutional Convergence
Introduction
The JOAT Institutional Convergence strategy is a systematic, rules-based trading framework that unifies the logic from all five JOAT indicators into a single coherent entry and exit engine. Each indicator contributes a specific filter layer: the Volumetric Structure Engine provides directional market structure bias, the Adaptive Spectral Bands Hann ribbon provides the primary entry trigger, the Institutional Session Profiler contributes optional session timing, the Imbalance Zone Classifier contributes optional FVG proximity filtering, and the Fractal Liquidity Map contributes fractal-anchored stop placement. No layer is redundant — each addresses a different dimension of trade selection.
The core problem this solves: most PulseWire strategies use a single indicator as both entry and exit signal, producing over-fitting to one methodology. This strategy uses five independent measurement systems simultaneously. An entry only fires when multiple independent conditions converge — structure, momentum, regime, and optionally session and imbalance context. The result is a strategy that takes trades for quantifiable, multi-factor reasons, not because a single line crossed.
Core Concepts
1. Entry Logic — Hann Ribbon Crossover Primary
The primary entry trigger is the Hann FIR ribbon crossover — when the fastest layer (h0) crosses above the second layer (h1), a potential long entry is flagged. This is the earliest mathematically-grounded signal that momentum is shifting:
bool cross_bull = ta.crossover(h0, h1)
bool cross_bear = ta.crossunder(h0, h1)
bool long_sig = (cross_bull or (bos_bull_sig and h0 > h2)) and
struct_trend >= 0 and
adx >= i_adx_min and adx <= i_adx_max and
sess_ok and fvg_ok
The crossover fires on the bar where momentum begins to shift — not after full ribbon alignment is confirmed. This is intentional: waiting for full alignment reduces trade count significantly and enters late. The structural trend filter (struct_trend >= 0) ensures the crossover is not taken against a confirmed downtrend.
2. Structure Filter — VSE Swing Classification
Market structure is classified using the same non-repainting swing detection as the Volumetric Structure Engine. Higher highs and higher lows (struct_trend = 1) are bullish; lower highs and lower lows (struct_trend = -1) are bearish; a mixed state (struct_trend = 0) is neutral. The strategy allows longs in bullish or neutral structure (>= 0) and shorts in bearish or neutral structure (<= 0):
bool new_sh = high == ta.highest(high, i_sw_len) and high < ta.highest(high, i_sw_len)
bool new_sl = low == ta.lowest (low, i_sw_len) and low > ta.lowest (low, i_sw_len)
This prevents the ribbon crossover from triggering entries during confirmed counter-trend structure without requiring perfect alignment.
3. Regime Filter — ADX Gating
ADX gates entries in both directions. Below the minimum ADX, the market has no directional momentum — ribbon crossovers in flat, dead markets produce noise. Above the maximum ADX, the market is over-extended and new entries chase moves that are already mature:
float adx_val = ta.rma(math.abs(dmi_p - dmi_m) / (dmi_p + dmi_m + 0.001) * 100, i_adx_len)
bool adx_ok = adx_val >= i_adx_min and adx_val <= i_adx_max
Default range: 8–60. This wide range accommodates crypto and forex markets that trend aggressively for extended periods (ADX 40–60) as well as early-stage trends (ADX 8–15).
4. Position Sizing — Percentage Risk per Trade
Position sizing is calculated dynamically based on the user's equity risk percentage and the distance to the stop-loss level:
float sl_dist = math.abs(close - sl_price)
float qty = sl_dist > 0 ? (strategy.equity * i_risk_pct / 100.0) / sl_dist : 1.0
strategy.entry("Long", strategy.long, qty = qty)
This ensures every trade risks the same percentage of equity regardless of market volatility — a wider stop reduces size, a tighter stop increases size. The default is 1% risk per trade.
5. Stop-Loss Placement — Fractal Extreme + ATR Buffer
The stop-loss is placed beyond the most recent 20-bar fractal extreme in the direction of the trade, plus one ATR buffer. This anchors the stop to genuine structural pivots rather than arbitrary fixed-pip distances:
float sl_long = ta.lowest(low, 20) - atr_14 * i_sl_atr_buf
float sl_short = ta.highest(high, 20) + atr_14 * i_sl_atr_buf
Features
Five-Layer Entry Filter: Structure + Ribbon + Regime + Session (optional) + FVG proximity (optional)
Hann FIR Ribbon Crossover: Primary entry trigger — earliest mathematically-valid momentum signal
BOS-Armed Entries: Break of Structure signals additionally arm entries for up to 30 bars
Percentage Risk Sizing: Dynamic position size calculated from equity risk % and SL distance
Fractal-Anchored Stop Loss: Stop at 20-bar fractal extreme + ATR buffer
Fixed R:R Take Profit: Configurable reward-to-risk ratio for TP placement
Trailing Stop: Built-in trail_offset activates immediately from entry, protecting profits
Session Filter (optional): Trade only during Asia, London, and/or New York sessions. Off by default for 24h markets.
FVG Proximity Filter (optional): Require entry to be near an active imbalance zone. Off by default for maximum trade count.
Performance Dashboard: Displays trade count, win rate, average R, last trade result, and active filter states
Realistic Simulation: 2-tick slippage + 0.05% commission built into all backtests
Input Parameters
Structure (VSE):
Swing Length: Lookback for swing high/low detection (default: 20)
Ribbon Filter (ASB):
Hann Base Length: Core FIR filter period (default: 20)
Ribbon Spacing: Gap between ribbon layers (default: 3)
Regime Filter:
ADX Length: Period for ADX calculation (default: 14)
Min ADX for Entry: Minimum ADX to allow entries (default: 8). Lower = more trades. Raise to filter ranging markets.
Max ADX for Entry: Maximum ADX to allow entries (default: 60). Lower = skip over-extended moves.
Session Filter (ISP):
Enable Session Filter: Gate entries by session time (default: off — recommended for crypto and indices)
Trade Asia / London / NY: Toggle per-session entry permission
Imbalance Filter (IZC):
Require Near FVG Zone: Entry must be within ATR proximity of an active imbalance (default: off)
FVG Proximity (x ATR): Distance threshold for FVG proximity check (default: 1.5)
Risk Management:
Risk Per Trade (%): Equity percentage risked per trade (default: 1.0)
Reward:Risk Ratio: Take profit as a multiple of the SL distance (default: 2.0)
SL ATR Buffer: ATR multiple added beyond fractal extreme for stop (default: 0.5)
Trail Offset (ATR): Trail stop distance from price (default: 1.5)
BOS Armed Bars: How many bars a BOS signal remains active for entry (default: 30)
How to Use This Strategy
Step 1: Select Your Market and Timeframe
Start on the 1-hour chart. The strategy is calibrated for 1H on crypto, forex majors, and equity indices with default settings. Shorter timeframes (15m) can increase trade count further but require tighter ADX filtering to avoid noise.
Step 2: Run the Backtest with Defaults
With all optional filters off (session and FVG disabled), the strategy trades every valid ribbon crossover that passes structure and regime. This produces the highest trade count. Review the equity curve for smoothness — you want consistent growth, not reliance on a few large winners.
Step 3: Add Filters Progressively
Enable the session filter to restrict to London and NY on forex pairs. Enable the FVG proximity filter to require imbalance context on entries. Each filter reduces trade count but should improve win rate if the underlying edge is present on your instrument.
Step 4: Interpret the Dashboard
The dashboard shows the current state of every filter layer — which ones are active and whether each condition is currently met. This is the diagnostic view: if no trades are firing, the dashboard tells you exactly which filter is blocking entries.
Originality Statement
This strategy is original as a unified multi-indicator convergence framework where each component is an independently published, standalone indicator. Its publication is justified because:
The five-layer filter architecture uses genuinely independent measurement dimensions — market structure (price action), momentum (FIR frequency domain), trend strength (ADX), session timing, and price inefficiency (FVG) — reducing the risk of correlated signals that appear to confirm each other but measure the same thing
Hann FIR crossover as the primary trigger provides a mathematically grounded entry timing signal with lower lag than EMA crossovers of equivalent period — a meaningful improvement to the timing of systematic entries
Dynamic position sizing calculated from SL distance anchored to fractal extremes creates risk-normalized sizing that adapts to each trade's structural context rather than using fixed lot sizes
The modular filter design allows each filter to be toggled independently, making the strategy adaptable to different asset classes (crypto, forex, equities) without code changes — session filter off for 24h markets, FVG filter off for maximum trade generation
Limitations
Backtesting results depend critically on the instrument, timeframe, and parameter settings. Past performance in strategy tester does not guarantee future live trading results.
The 2-tick slippage and 0.05% commission defaults are approximations. Actual execution costs vary by broker, instrument, and session liquidity. High-slippage instruments (illiquid crypto, micro-cap) will perform worse than the backtest indicates.
The FVG proximity filter references FVG logic computed internally. It does not import live data from the separately published Imbalance Zone Classifier indicator — it recomputes the same logic in isolation.
The strategy does not incorporate news filters or earnings event exclusions. Entering positions around major economic releases (FOMC, NFP) during high-volatility events will produce results inconsistent with normal market behavior.
Trailing stop and take profit interact. If price reaches the TP level before the trail stop triggers, the TP closes the trade. Users should verify via strategy properties which exit is dominant in their use case.
Disclaimer
This strategy is provided for educational and informational purposes only. It does not constitute financial advice or a recommendation to buy or sell any instrument. All trading involves risk of loss. Backtested strategy results are hypothetical and do not account for the psychological challenges of live trading. Past results do not guarantee future performance. Always use proper risk management and never risk more than you can afford to lose.
-Made with passion by jackofalltrades
Strategy

Risk Reward Visualizer [AGPro Series]Risk Reward Visualizer
🔹 Overview
Risk Reward Visualizer is a professional trade-planning indicator that transforms every setup into a clean visual framework: entry, stop-loss, and up to three take-profit targets displayed as long rectangular R-multiple zones. Beyond basic visualization, it adds three features rarely found together in one tool — a breakeven probability calculator, live MFE/MAE excursion tracking, and an automatic trail-to-breakeven workflow.
The indicator is built for traders who think in R-multiples: swing traders, prop-firm candidates, day traders, and anyone who wants to answer the question "does this setup actually make mathematical sense?" before committing capital.
🔹 What Makes It Different
Most risk/reward scripts stop at drawing levels and a position-size table. This one goes further:
• Breakeven Probability Math — For every R target, the panel displays the minimum win rate required to break even, adjusted for round-trip fees. A 3R target needs only 25% wins; a 1R target needs 50%. Seeing this side-by-side reframes how you evaluate setups.
• Live MFE / MAE Tracking — Maximum Favorable Excursion and Maximum Adverse Excursion are tracked in real time from the moment the setup becomes valid. Labels mark the exact bar of each peak in R-multiples, with leader lines connecting the label to the wick, so you can grade trade quality after the fact.
• Trail-to-Breakeven Visualization — When TP1 is hit, the original stop fades and a new breakeven line is drawn at entry, making the risk management discipline visible on the chart.
• Hybrid Auto-Detect — Leave Entry and Stop at zero and the script fills them using the current close and the most recent swing pivot plus an ATR buffer. Provide one manually and the other auto-completes. Everything can be overridden.
🔹 Methodology
Levels are calculated from the standard R-multiple framework:
• Risk per unit = |Entry − Stop|
• Take-profit N = Entry ± (N × Risk per unit), signed by trade direction
• Breakeven win rate = (1 + fees_R) / (1 + R target)
Direction is auto-inferred from the relationship between Entry and Stop (Long when Stop is below Entry, Short otherwise), and can be forced. Auto-detect uses a pivot lookback to locate the most recent swing high or low, then offsets the stop by a user-defined ATR multiple to reduce wick-out risk.
MFE and MAE reset whenever Entry or Stop changes, so editing inputs restarts tracking cleanly. Hit detection uses bar high or low against each level and fires alerts only on the rising edge of each event.
🔹 Visuals & Signals
• Risk zone rendered as a pink rectangle between Entry and Stop
• TP1, TP2 and TP3 zones rendered as stacked teal rectangles with graded opacity
• Entry line in indigo, stop in pink, take-profits in teal
• Labels anchor to the right edge of the zone so they never hide candles
• MFE label on the favorable excursion peak, MAE on the adverse peak, each offset 1.5 ATR with a dotted leader line
• Alerts: TP1 hit, TP2 hit, TP3 hit, Stop Loss hit, Breakeven reached
🔹 Key Inputs
• Setup Mode — Manual, Auto-Detect, or Hybrid
• Trade Side — Auto, Long, or Short
• Entry and Stop — leave at zero to auto-detect
• Swing Lookback and ATR Buffer — for auto-detected stops
• TP1, TP2, TP3 multipliers with individual show/hide toggles
• Trail Stop to Breakeven After TP1 — toggle
• Round-Trip Fees (%) — folded into breakeven math
• Enable Position Size Calculator — optional; account size and risk percentage
• Panel location, panel font size, label font size, zone length, zone transparency
🔹 How To Use
Step 1 — Add the script to any symbol and timeframe. By default, Hybrid mode uses the current close as entry and the most recent swing plus an ATR buffer as stop.
Step 2 — Override Entry or Stop with your planned levels if you have a specific setup in mind.
Step 3 — Check the Breakeven Analysis section of the panel. Confirm the minimum win rate required for your chosen R target is realistic for your strategy.
Step 4 — Set alerts for the targets you want to be notified on. If Trail-to-Breakeven is enabled, you will also receive a notification when TP1 hits so you can move your stop in your broker.
Step 5 — After the trade, review MFE and MAE to grade execution. Did price reach favorable excursion that you missed? Did it dip deep into risk before resolving?
🔹 Limitations & Transparency
• This is a planning and visualization tool. It does not place orders and does not produce buy or sell signals.
• The breakeven calculation treats fees as a percentage of entry price converted into R-units. It is a useful approximation, not a tax or slippage model.
• Auto-detected stops depend on recent swing structure. On very low-liquidity symbols or during strong trends without pullbacks, recent swings may be stale. Verify visually before using.
• MFE and MAE tracking uses bar high or low and resets when inputs change.
• Position sizing assumes a linear contract value and does not account for margin, leverage, or instrument-specific tick rules. Always cross-check with your broker.
🔹 Risk Disclosure
Trading carries risk of loss. This indicator is provided for educational and analytical purposes only and is not financial advice. Past behavior of any tool does not guarantee future performance. Use proper position sizing and never risk more than you can afford to lose. Indicator

Indicator

Blanco V1-(Custom TF + Super Signals)**Blanco V1 Trading System (Multi-Timeframe Confirmation)**
Blanco V1 is a high-probability trading indicator designed to identify strong market opportunities using a combination of Zero Lag EMA, trend strength, momentum, and multi-timeframe confirmation.
At its core, Blanco V1 uses a Zero Lag Exponential Moving Average (ZLEMA) to reduce delay and provide faster, more accurate trend signals compared to traditional moving averages.
The system includes three trading modes:
* **Aggressive Mode**: More signals with faster entries, ideal for lower timeframes and active trading.
* **Balanced Mode**: A mix of accuracy and frequency, recommended for most traders.
* **Conservative Mode**: Fewer but higher-quality signals, focused on strong trends and confirmation.
Blanco V1 provides two types of trade signals:
* **Entry Signals (Arrows)**: Small green and red arrows show potential entries based on pullbacks, momentum (RSI), and strong trend conditions (ADX).
* **Trend Signals (BUY/SELL Labels)**: Larger labels appear when the overall trend shifts, signaling potential swing trades.
A key feature of Blanco V1 is the **Multi-Timeframe Dashboard**, which displays trend direction across:
* 5-minute
* 15-minute
* 30-minute
* 1-hour
* 2-hour
* 4-hour
Each timeframe is color-coded:
* 🟢 Green = Bullish
* 🔴 Red = Bearish
The most powerful feature is the **Super Signal (❗)**:
* A green ❗ appears when all timeframes are bullish and a valid buy setup is present.
* A red ❗ appears when all timeframes are bearish and a valid sell setup is present.
These signals represent the highest-probability trades, combining trend alignment, momentum, and full multi-timeframe confirmation.
Blanco V1 performs best on higher timeframes such as 1H and 4H and in trending markets. For best results, combine with proper risk management and price action confirmation.
---
**Quick Guide:**
* 🔺 Arrows = entry timing
* 🟢 BUY / 🔴 SELL = trend shifts
* ❗ = strongest trades (full alignment)
Indicator

AG Pro Position Planner [AGPro Series]AG Pro Position Planner
OVERVIEW
AG Pro Position Planner is a structured trade-planning and risk-organization tool designed for traders who want to map a position before execution. It focuses on four core elements of trade preparation: entry location, stop placement, target mapping, and position sizing. Instead of trying to predict direction or generate automated entries, the script helps organize a plan around levels that the user defines manually.
The purpose of this tool is not to tell the user what to buy or sell. Its purpose is to turn a discretionary plan into a visible, measurable framework on the chart. By combining entry, stop, risk budget, capital usage, and target structure in one view, the script helps reduce planning ambiguity and makes the trade idea easier to review before any order is placed.
The script supports both long and short planning. It can also operate in two different target modes. In R-Based mode, targets are derived from the distance between entry and stop. In Manual mode, the user can input exact target prices directly and the script will convert those targets into their implied R-multiples. This allows the same tool to support both systematic planning and discretionary scenario mapping without changing the underlying workflow.
The visual design is intentionally restrained. The chart shows entry, stop, and target levels, along with optional reward and risk zones. A compact panel summarizes the key planning information, including direction, mode, risk per unit, risk budget, sizing, exposure, and target statistics. The result is a planning layout that remains readable on both light and dark themes while keeping the focus on structure rather than decoration.
WHAT THIS SCRIPT DOES
This script helps the user:
• define a planned entry price
• define a planned stop price
• convert account risk into a position size estimate
• map one to three targets on the chart
• compare manual targets to the initial risk distance
• review exposure before execution
• validate whether a manual target structure is logically ordered
• visualize the reward zone above entry and the risk zone below entry for long scenarios, or the inverse logic for short scenarios
The script is designed as a planning layer. It does not attempt to replace the user’s analysis process. It assumes the user already has a trade idea and needs a cleaner way to structure and review that idea.
UNIQUE EDGE
The distinguishing feature of this script is not signal generation. Its edge is organizational clarity.
Many tools focus on entries, signals, or directional interpretation. This one focuses on plan construction. The user chooses the key prices, and the script translates them into a coherent risk model. That distinction matters. The script does not present itself as a forecasting engine, a market-timing system, or an automated decision model. It is a position-planning framework.
A second differentiator is the dual target workflow. Some users think in fixed R-multiples. Others think in exact price objectives. AG Pro Position Planner supports both approaches in the same interface. In Manual mode, the script still reports the effective R-value of each target, which helps the user compare discretionary targets against the initial stop distance without losing consistency.
A third differentiator is the built-in validation behavior. The script checks whether the trade structure is logically valid for the chosen direction. In Manual mode, it also checks whether the targets are placed in the correct direction and in the correct order. This helps the user detect plan errors before execution rather than after the fact.
METHODOLOGY
The planning model is straightforward by design.
1) Entry and stop define the base risk distance.
The script measures the absolute distance between entry and stop. That distance becomes the reference risk per unit.
2) Account risk defines the risk budget.
The user enters an account size and a percentage risk per trade. The script converts this into a monetary risk budget.
3) Position size is estimated from the risk budget.
The script divides the risk budget by effective risk per unit and rounds the resulting quantity down to the selected quantity step.
4) Optional fee adjustment can be included.
An estimated fee percentage can be added to the per-unit risk as a conservative sizing buffer.
5) Targets are then mapped in one of two ways.
In R-Based mode, each target is calculated from the entry-to-stop distance using the selected R-multipliers.
In Manual mode, the user provides exact target prices and the script calculates the implied R-value of each target relative to the original stop distance.
6) Exposure statistics are summarized in the panel.
The panel shows stop distance, capital usage, risk budget, and sizing information so the trade can be evaluated as a complete plan rather than as isolated levels.
This methodology is intentionally transparent. The script is not using hidden directional filters, prediction logic, or undisclosed entry models. The calculations are derived from the user’s own inputs.
TARGET MODES
R-Based Mode
R-Based mode is intended for users who want a consistent structure around initial risk. The user defines entry and stop, then sets target multipliers such as 1R, 2R, or 3R. The script projects those levels automatically from the base risk distance. This is useful when the user wants standardized scenario planning and fast comparison between multiple setups.
Manual Mode
Manual mode is intended for users who work with exact price objectives. In this mode, the user enters target prices directly. The script then converts those levels into implied R-values. This allows discretionary targets to be measured against the same initial risk model.
To reduce planning mistakes, the script validates whether manual targets are placed in the correct direction and in the correct order for the chosen trade direction. Invalid target structures are flagged in the panel instead of being silently accepted.
PANEL AND VISUAL STRUCTURE
The chart can display:
• entry line
• stop line
• target lines
• reward zone
• risk zone
• right-side labels for entry, stop, and targets
• a compact summary panel
The panel is designed to keep the most useful information visible without taking over the chart. Its goal is to support review, not to dominate the screen.
The compact panel includes:
• plan summary
• validation badge
• entry and stop
• risk per unit
• risk budget
• sizing
• exposure
• target statistics
This structure is meant to help the user answer practical questions quickly:
How much is being risked?
How large is the position?
How much capital is being used?
How far is the stop?
What does each target represent in both price and R terms?
KEY INPUTS
Trade Setup
• Trade Direction
• Target Mode
• Entry Price
• Stop Price
• R-based targets
• Manual targets
Risk Model
• Account Size
• Risk Per Trade (%)
• Estimated Fees (%)
• Quantity Step
Visual Settings
• Panel visibility
• Panel position
• Panel theme
• Panel text size
• Level label size
• Label offset
• Risk/reward zone visibility
• Zone transparency
• Individual target visibility
These inputs are separated by function so the planning workflow stays readable and predictable.
VALIDATION AND SAFETY LOGIC
The script validates several conditions before presenting a plan as valid.
For direction:
• Long plans require stop below entry
• Short plans require stop above entry
For base structure:
• Entry must be positive
• Stop must be positive
• Account size must be positive
• Risk percentage must be positive
• Quantity step must be positive
• Entry and stop must not be identical
For manual targets:
• Targets must be in the correct direction relative to entry
• Targets must be logically ordered for the selected direction
If the structure is invalid, the panel reflects that status instead of presenting the setup as a clean plan. This behavior is intentional. The script is designed to help organize decisions, but also to prevent simple construction errors from being overlooked.
WHO THIS SCRIPT IS FOR
This script is intended for users who already make their own directional decisions and want a cleaner way to structure position plans on the chart.
It may be useful for:
• discretionary traders
• swing traders
• intraday traders
• users who plan entries and stops manually
• users who prefer fixed-R target mapping
• users who want manual targets translated into risk terms
• users who want better visual discipline before execution
It is less relevant for users who are looking for:
• automated entries
• hidden directional logic
• predictive signals
• scanner behavior
• portfolio automation
• strategy backtests
SIGNALS AND ALERTS
This script does not generate buy signals or sell signals.
This script does not publish automated trade calls.
This script does not attempt to identify market direction.
This script does not include alert logic for execution decisions.
Its purpose is planning, visualization, and risk organization.
LIMITATIONS AND TRANSPARENCY
This script is a planning tool, not an execution engine.
It does not know whether the selected entry will be filled.
It does not know whether slippage will occur.
It does not know whether the market will reach the defined targets.
It does not account for instrument-specific margin rules, liquidation mechanics, funding costs, or exchange-specific order behavior unless the user adjusts inputs manually.
The sizing output is an estimate based on the values entered into the script. Real-world execution may differ due to slippage, fees, order type, spread, partial fills, and instrument-specific trading conditions.
In Manual mode, the script evaluates the price structure entered by the user, but it does not claim that those targets are likely to be reached. It only expresses them relative to the initial risk distance.
The chart zones are visual planning aids. They are not probability forecasts and should not be interpreted as predictive boundaries.
WHAT THIS SCRIPT IS NOT
This script is not:
• a strategy tester
• a signal service
• an automated trade system
• a forecasting model
• a promise of profitability
• a replacement for independent analysis
• a substitute for execution judgment
• a guarantee of risk control in live market conditions
It is a structured chart tool for planning and reviewing position scenarios.
RISK DISCLOSURE
Trading and investing involve risk. Any planned setup can fail, and losses can exceed expectations due to slippage, volatility, or execution conditions. This script is provided as an organizational and visualization tool only. Users remain fully responsible for their own analysis, trade selection, order placement, and risk management decisions.
No indicator can remove market risk. A visually clean plan is still only a plan. Position sizing, stop placement, and target mapping should always be reviewed in the context of the instrument, timeframe, liquidity conditions, and the user’s own trading process.
FINAL NOTE
AG Pro Position Planner is built around a simple idea: a trade plan should be measurable before it is actionable. By turning entry, stop, risk budget, sizing, and targets into a single visible structure, the script aims to make discretionary planning more disciplined, more transparent, and easier to review.
The script does not attempt to decide for the user. It helps the user define the plan clearly enough to evaluate it. Indicator

MTF Bias Dashboard (TOTAL STRENGTH)📊 Multi-Timeframe Bias Dashboard (Total Strength)
This indicator gives a clear, no-noise view of market direction by analyzing multiple timeframes and combining them into a single actionable bias.
It tracks the relationship between price and the 200 EMA across key timeframes (15M, 30M, 1H, 4H) to determine whether the market is bullish or bearish, while also measuring the strength of each trend.
🔍 What It Shows
Directional Bias (Bullish / Bearish) for each timeframe
Trend Strength (0–100) based on distance from the 200 EMA
A Total Strength Score that combines all timeframes into one number
This gives you both:
The bigger picture trend
The immediate trading environment
⚡ How It Works
Each timeframe contributes to an overall score:
Bullish trends add positive strength
Bearish trends add negative strength
These values are combined into a Net Strength reading, which tells you who’s in control of the market.
🧠 How to Read It
Strong Positive Total → Market is bullish → Focus on longs
Strong Negative Total → Market is bearish → Focus on shorts
Near Zero → Market is choppy → Avoid trading
Higher timeframe alignment (1H + 4H) defines the main bias, while lower timeframes (15M + 30M) help time entries.
🎯 Why This Is Useful
Eliminates guesswork and conflicting signals
Keeps you trading with trend, not against it
Helps avoid low-quality trades in choppy markets
Perfect for day traders and prop firm traders
🚀 Best Use Case
Use this as a trend filter + bias confirmation tool, then pair it with your entry model (price action, MACD, liquidity, etc.) for precision entries. Indicator

Institutional Footprint Divergence Engine🔹 Introduction
This indicator, the Institutional Footprint Divergence Engine, attempts to identify moments where price action and genuine order flow diverge — a condition that historically precedes reversals driven by smart money absorption and distribution. The core idea is this: if price makes a new swing high but the underlying buy-sell delta is contracting, the market is printing a higher high on less aggressive buying pressure, suggesting the move is being distributed into rather than genuinely accumulated. The inverse is equally meaningful at lows.
Unlike traditional divergence indicators that use derivative oscillators like RSI or MACD as the proxy for momentum, this script uses volume delta — the direct arithmetic difference between buying and selling volume at the bar level — sourced natively from PulseWire's newly released request.footprint() function where a Premium or Ultimate subscription is active. On standard charts, the indicator falls back to a tick-estimated delta approximation. The distinction matters, and I'll cover precisely why throughout this description.
Every detected divergence is assigned a composite quality score from 0 to 100, computed across five weighted dimensions that assess the structural strength, volume context, cumulative delta alignment, and volatility regime at the moment of detection. Only divergences that clear a user-defined score threshold are displayed — filtering the noise that plagues most divergence tools.
🔹 The Premise — Why Delta Divergence Reveals Institutional Behavior
🔸 What volume delta actually measures
Every transaction in a liquid market has a buyer and a seller. Volume delta measures the net directional aggression of those transactions: it is the sum of volume that traded at the ask (aggressive buying) minus the volume that traded at the bid (aggressive selling) within a single bar. A positive delta bar means buyers were more aggressive. A negative delta bar means sellers were more aggressive.
This is categorically different from price direction. A bar can close higher while posting a negative delta — meaning price moved up, but sellers were the more aggressive counterparty throughout the move. This is the fingerprint of absorption: a large participant or group of participants quietly selling into rising price, absorbing aggressive buy orders without allowing the market to fall. They want retail to push price higher. They're using that momentum as liquidity to distribute their position.
Delta divergence is the systematic detection of this condition across swing structures.
🔸 The mechanics of absorption at swing highs
Assume price has been in an uptrend and just made a swing high at $4,200 with a delta of +850 contracts — strong buyer aggression confirming the high. Price retraces, then pushes up again to $4,215, printing a higher high. But this time, the delta is only +210. Price went higher. The aggressive buying volume did not.
What does this tell you? The move to $4,215 required proportionally far less buyer aggression than the move to $4,200. Two possibilities explain this: either sellers are absorbing the buying (distribution), or organic buying interest is fading and the move is increasingly resting on passive limit sell orders being consumed by declining buy-side momentum. Either way, the structural message is identical — the higher high is not supported by the order flow that created it, and the probability of continuation has deteriorated meaningfully.
This is the ICT and Smart Money Concepts concept of distribution rendered in order flow terms rather than price structure terms alone.
🔸 The symmetric argument at swing lows
At swing lows, the bullish divergence condition is: price makes a lower low, but the negative delta at that low is less negative than the prior swing low. Less aggressive selling at a lower price. This is absorption at the demand side — large buyers accumulating into weakness, absorbing retail sell orders without allowing price to collapse further. The lower low prints because they let it — they need the price to be there to fill their orders. But the delta tells you that sellers were unable to drive the same aggression they managed at the prior low.
Harris (2003), in his foundational text on market microstructure, describes this phenomenon as informed traders systematically positioning against the uninformed flow — using the uninformed participants' aggression as liquidity.
Cont, Stoikov & Talreja (2010), in their research on limit order book dynamics, demonstrate empirically that large passive participants consistently exploit periods of high aggressive flow imbalance to establish positions at favorable prices.
Delta divergence is not a leading indicator in the traditional sense. It is a coincident indicator of order flow context that becomes meaningful when paired with a confirmed swing structure.
🔸 Why native footprint data changes the calculus
Prior to January 2026, Pine Script had no access to true intrabar volume distribution. Every "delta" calculation in PulseWire scripts was an estimate — typically assigning the bar's total volume directionally based on close position within the bar's range, or using up/down tick counting approximations. These methods are reasonable proxies but they introduce systematic errors: a bar that closes at its midpoint with heavy two-way activity looks identical to a quiet, directionless bar.
PulseWire's request.footprint() function changes this entirely. It exposes the actual buy and sell volume recorded at each price level (row) within the bar — the genuine transaction-level data that footprint chart platforms like Sierra Chart and Bookmap have historically required separate subscriptions and data feeds to access. The delta returned by fp.delta() is not an estimate. It is the arithmetic difference between actual ask-side and bid-side transactions aggregated across the bar.
This is the first time this data has been natively programmable in Pine Script, and IFDE is built specifically around it.
🔹 How It Works
🔸 Footprint Data and the Delta Fallback
On a Premium or Ultimate PulseWire account with a compatible symbol, request.footprint() returns a footprint object for each bar. IFDE calls fp.buy_volume() and fp.sell_volume() to get true directional volume, and fp.delta() for the bar's net delta. It also iterates every price row via fp.rows() and evaluates row.has_buy_imbalance() and row.has_sell_imbalance() — flagging bars where a disproportionate volume cluster exists at a specific price level, which often marks the precise price where institutional absorption occurred.
When footprint data is unavailable (standard account or non-supported symbol), the indicator falls back to a tick-estimated delta: up-close bars assign 100% of volume to the buy side; down-close bars assign 100% to the sell side; inside bars distribute proportionally based on close position within the range. This fallback is clearly flagged in the status label as ⚠️ ESTIMATED. The divergence logic functions identically in both modes — only the precision of the underlying delta changes.
The Ticks Per Footprint Row input controls the price granularity of the footprint: smaller values create more rows with finer resolution, larger values consolidate into fewer, broader rows. For index futures like ES and NQ, 4–10 ticks per row is typically appropriate. For crypto, you may need to experiment depending on the instrument's tick size.
🔸 Swing Pivot Detection
The indicator uses Pine's native ta.pivothigh() and ta.pivotlow() functions to identify confirmed swing highs and lows. The Swing Pivot Length input defines the lookback and lookahead symmetry of the pivot — a value of 10 means a bar must be the highest high within 10 bars on both sides to qualify as a pivot. Higher values find more significant structural swings but introduce more lag. Lower values are more responsive but noisier.
Critically, delta is sampled at the confirmed pivot bar using ta.valuewhen() — not at the current bar. This eliminates the most common repainting failure mode in divergence indicators: using the current bar's momentum reading to classify a past pivot. The delta value associated with each pivot is locked in the moment the pivot is confirmed.
🔸 Divergence Logic
Each time a new pivot high is confirmed, IFDE compares it against the previous confirmed pivot high. If the current price is higher but the current delta is lower, a bearish divergence is registered. The same comparison runs at pivot lows for bullish divergence, where current price lower and current delta less negative triggers the signal.
The Divergence Lookback setting controls the maximum bar distance between the two pivots being compared. Setting this too wide increases the chance of detecting structurally irrelevant comparisons — swings separated by 150 bars on a 5-minute chart may have no meaningful relationship. Setting it too tight misses legitimate multi-leg divergences. 40–60 bars is a reasonable starting point for most timeframes.
🔸 The ML Quality Score (0–100)
This is the engine's core differentiating feature. Every detected divergence is not displayed by default — it must first pass a composite quality score threshold. The score is calculated across five weighted dimensions:
Delta Magnitude is the most heavily weighted dimension by default (30%). It measures how extreme the opposing delta pressure is, normalised against the rolling maximum delta magnitude over the lookback window. A divergence where the delta is merely slightly less positive scores lower than one where the delta has completely reversed sign.
Volume Confirmation (25%) assesses whether total bar volume at the divergence pivot is above the 14-bar average. Low-volume divergences are structurally weaker — the absorption signal requires meaningful participation to be credible.
CVD Alignment (20%) checks whether the Cumulative Volume Delta — the running sum of all bar-level deltas, mean-reverted against its own moving average — is trending in the direction that supports the divergence. A bullish divergence at a price low carries far more weight when CVD has been quietly rising even as price made new lows.
Price Structure (15%) scores the magnitude of the price swing itself, relative to the current ATR. A divergence across a 0.5 ATR swing scores lower than one across a 2.5 ATR swing. Trivially small swings produce trivially meaningful divergence signals.
Regime Bonus (10%) applies a bonus or penalty based on the current volatility regime, described in detail below.
The weights are fully user-configurable in the 🤖 ML Score Weights input group. Shifting weight toward CVD Alignment, for example, will make the score more conservative and context-dependent. Shifting weight toward Delta Magnitude makes it more responsive to extreme single-bar order flow events. The scores are normalised internally so they always sum to 100 regardless of how you distribute the weights.
Only divergences scoring above the Min Quality Score threshold are displayed. The default of 55 is intentionally permissive to begin with. As you develop familiarity with the indicator on your instrument and timeframe, raising this to 65 or 70 will progressively filter toward only the highest-conviction setups.
🔸 Adaptive Regime Detection
The indicator compares the current 14-period ATR against its own simple moving average over the Regime Detection Period to classify the current volatility environment into three states: HIGH VOLATILITY, NORMAL, and LOW VOLATILITY.
In high volatility regimes, the score threshold is automatically scaled up by 20% — making it harder for a divergence to pass. This is because high-volatility environments produce frequent large delta swings that generate divergence signals with greater frequency but lower predictive value. The regime is tightening the filter precisely when noise is highest.
In low volatility regimes, the threshold is scaled down by 15%. Quiet, low-volatility markets are where institutional accumulation and distribution most commonly occurs under the radar — smaller delta contrasts carry more informational weight when total market activity is compressed.
The current regime and adjusted score floor are displayed in the status label in the top-left corner of the pane. A subtle background colour (green tint for low vol, red tint for high vol) is painted on the price chart to give continuous regime context at a glance.
🔸 The Pane Display
The indicator runs in its own pane below the price chart, containing three visual elements:
The delta histogram plots the smoothed EMA of bar-level delta as coloured columns — cyan for positive (net buying) and red for negative (net selling). The colour intensity scales with the magnitude of the delta relative to the recent maximum, so visually dominant bars correspond to the highest-conviction order flow readings.
The CVD deviation line in yellow shows the cumulative volume delta minus its moving average baseline. This is more useful than raw CVD for divergence context because it removes the secular trend in cumulative flow and focuses on relative shifts — making it easy to spot when CVD is rising or falling against price.
The zero line serves as the delta neutrality reference. Bars crossing from negative to positive delta, or vice versa, in the context of a divergence signal are particularly significant.
On the price chart, divergence lines connect the two pivot points being compared, with opacity scaling to score strength — higher-scoring divergences are rendered more vividly. Labels mark each divergence with its star rating (★ for score 55–69, ★★ for 70–84, ★★★ for 85–100) and the actual score value, along with whether live footprint data or tick estimation is in use.
🔹 Settings Reference
Swing Pivot Length — Controls pivot sensitivity. Lower = more signals, higher = more structural significance. Recommended: 8–15.
Divergence Lookback — Maximum bars between the two pivots being compared. Recommended: 30–75.
Min Quality Score — Score threshold below which divergences are hidden. Start at 55, tune upward as you calibrate to your instrument.
Ticks Per Footprint Row — Footprint granularity. Only relevant with live FP data. Tighter rows = more precision, more computation.
Delta Smoothing Period — EMA period applied to raw delta before divergence comparison. Smoothing reduces false triggers from single noisy bars. Recommended: 2–5.
CVD Baseline Length — Period of the SMA used to mean-revert the cumulative delta. Shorter = more responsive CVD; longer = smoother trend.
Alert Min Score — Score threshold for alert conditions. Set higher than the display threshold if you want alerts only for the strongest signals.
🔹 Closing Remarks
Delta divergence is one of the few conditions in technical analysis that has a genuinely defensible mechanical explanation rooted in market microstructure — it is not a pattern-matching heuristic but a direct observation of the imbalance between aggressive buying and selling pressure across a swing structure. The availability of native footprint data in Pine Script for the first time makes it possible to build this kind of tool without the estimations and approximations that have historically compromised order flow analysis within PulseWire.
That said, this indicator is a probabilistic model, not a signal generator. A score of 90 does not mean the trade works. It means the order flow context at that divergence was unusually well-structured relative to the five dimensions measured. Markets can and do continue trending through well-formed divergences, particularly in strongly trending regimes where institutional participants are not distributing but rather re-accumulating on every pullback.
The most effective use of IFDE is as a confluence filter — a condition that must be present alongside your existing structural, session, or macro framework before you engage a level. A bearish divergence at a weekly resistance level, in a high-volatility regime, scoring 82, with live footprint data showing 7 sell imbalance clusters, is a meaningfully different proposition than a 56-scoring divergence on estimated delta at a randomly selected intraday high.
Use the score. Respect the regime. Verify the data source. The rest is your edge.
🔹 References
Market Microstructure & Order Flow
Harris, L. (2003). Trading and Exchanges: Market Microstructure for Practitioners. Oxford University Press.
Cont, R., Stoikov, S., & Talreja, R. (2010). A stochastic model for order book dynamics. Operations Research, 58(3), 549–563.
Volume and Delta Analysis
Easley, D., & O'Hara, M. (1992). Time and the process of security price adjustment. Journal of Finance, 47(2), 577–605.
Easley, D., Hvidkjaer, S., & O'Hara, M. (2002). Is information risk a determinant of asset returns? Journal of Finance, 57(5), 2185–2221.
Institutional Order Flow & Smart Money
Chordia, T., Roll, R., & Subrahmanyam, A. (2002). Order imbalance, liquidity, and market returns. Journal of Financial Economics, 65(1), 111–130.
Grinblatt, M., & Keloharju, M. (2000). The investment behavior and performance of various investor types. Journal of Financial Economics, 55(1), 43–67. Indicator

Candle DNA Strand█ CANDLE DNA STRAND
A unique lower-panel indicator that visualizes candle structure as a stylized double-helix pattern. One strand represents body dominance (open-close range) while the other represents wick proportion (shadow-to-body ratio). The strands twist around a center axis with color encoding for bullish/bearish bias, revealing candle character patterns over time in an intuitive DNA-inspired format.
█ CONCEPT
Traditional candlestick analysis focuses on individual candle patterns. The Candle DNA Strand takes a different approach by decomposing every candle into two core metrics and plotting them as intertwined waves:
• Body Strand — Measures how much of each candle is "body" (the filled portion between open and close). High body ratios indicate conviction and directional commitment.
• Wick Strand — Measures how much of each candle is "shadow" (upper and lower wicks combined). High wick ratios indicate rejection, indecision, or failed attempts at direction.
These two strands are phase-offset by 180° to create the classic double-helix DNA appearance. As you scroll through the chart, you can visually identify periods of conviction (body-dominant) versus indecision (wick-dominant), and how candle character evolves over time.
█ HOW IT WORKS
The indicator calculates two normalized ratios for each candle:
Body Ratio = |Close - Open| / (High - Low)
Wick Ratio = (Upper Wick + Lower Wick) / (High - Low)
These ratios are smoothed and then modulated onto sine waves that twist around a center axis at the 50 level. The amplitude of each strand reflects the strength of that metric — larger bodies push the body strand further from center, and larger wicks push the wick strand further out.
The strands are color-coded by the current candle's bias:
• Bullish candles (close ≥ open) → Neon green tones
• Bearish candles (close < open) → Neon red tones
█ TRADE ZONES
The indicator includes an optional Trade Zone detection system based on candle character analysis:
◉ LONG ZONE (Green Background)
Triggers when:
• Average body ratio exceeds the Body Dominance Threshold (default 65%)
• Bullish momentum score > 40% (more bulls than bears in lookback period)
• Average wick ratio below the Wick Rejection Threshold (default 55%)
This identifies periods where price is moving up with conviction — strong bullish bodies with minimal rejection wicks.
◉ SHORT ZONE (Red Background)
Triggers when:
• Average body ratio exceeds the Body Dominance Threshold
• Bearish momentum score > 40% (more bears than bulls in lookback period)
• Average wick ratio below the Wick Rejection Threshold
This identifies periods where price is moving down with conviction — strong bearish bodies with minimal rejection wicks.
◉ CHOP/INDECISION
When the average wick ratio exceeds 60%, the market is showing high rejection and indecision. The DNA strands will show wick dominance during these periods.
Triangle markers appear at zone entry points:
• ▲ Green triangle below the helix = Long zone entry
• ▼ Red triangle above the helix = Short zone entry
█ VISUAL ELEMENTS
DNA Strands
Two intertwined lines representing body and wick ratios, twisting around the center axis with a configurable wavelength.
Base Pair Connectors
Vertical lines connecting the two strands at regular intervals, mimicking the "rungs" of a DNA ladder. These help visualize the spread between body and wick metrics.
Nucleotide Nodes
Small circular markers along each strand showing individual data points.
Fill Zone
Subtle gradient fill between the strands for visual depth. The fill color matches whichever strand is currently on top.
Info Label
Displays current values at the right edge of the chart:
• Current bias (BULL/BEAR)
• Body and Wick percentages
• Active trade zone (if any)
█ PATTERN DETECTION
The indicator automatically detects significant candle patterns based on DNA metrics:
DOJI — Body ratio < 15%
Very small body relative to total range. Indicates indecision.
MARUBOZU — Body ratio > 85%
Almost no wicks. Strong conviction candle with price closing near the high (bullish) or low (bearish).
HAMMER — Wick ratio > 60% with lower wick > 2× upper wick
Long lower shadow showing rejection of lower prices.
SHOOTING STAR — Wick ratio > 60% with upper wick > 2× lower wick
Long upper shadow showing rejection of higher prices.
█ SETTINGS
DNA Helix Settings
• Helix Wavelength — Number of bars for one complete DNA twist cycle (default: 20)
• Helix Amplitude — Vertical spread of the strands from center (default: 35)
• Show Base Pair Connectors — Toggle the connecting rungs (default: On)
• Connector Frequency — Draw a connector every N bars (default: 2)
• Data Smoothing — SMA length for smoothing ratios (default: 3)
• Strand Thickness — Line width for the DNA strands (default: 2)
Trade Zone Settings
• Show Trade Zones — Toggle background highlighting and entry signals (default: On)
• Zone Lookback — Bars to analyze for zone detection (default: 5)
• Body Dominance Threshold — Minimum avg body ratio for zone trigger (default: 0.65)
• Wick Rejection Threshold — Maximum avg wick ratio for zone trigger (default: 0.55)
Fluorescent Colors
• Bullish colors — Neon green and electric green variants
• Bearish colors — Neon red and hot pink variants
• Axis, connector, and zone colors are all customizable
Visual Settings
• Show Nucleotide Nodes — Toggle the small circles on strands (default: On)
• Show Info Labels — Toggle the right-side information label (default: On)
• Show DNA Analysis Table — Toggle detailed analysis table (default: Off)
█ ALERTS
Four alert conditions are available:
1. Long Zone Entry
"Entered LONG zone - strong bullish momentum with conviction candles"
2. Short Zone Entry
"Entered SHORT zone - strong bearish momentum with conviction candles"
3. Doji Pattern
"Doji detected - indecision"
4. Marubozu Pattern
"Marubozu detected - strong conviction"
█ INTERPRETATION GUIDE
Reading the DNA:
When body strand dominates (further from center):
• Market is moving with conviction
• Candles have strong bodies, minimal wicks
• Trend is likely to continue
When wick strand dominates (further from center):
• Market is showing rejection/indecision
• Candles have long shadows relative to bodies
• Potential reversal or consolidation
Strand crossovers:
• When strands cross, character is shifting
• Body crossing above wick → increasing conviction
• Wick crossing above body → increasing indecision
Color consistency:
• Long stretches of green → sustained bullish pressure
• Long stretches of red → sustained bearish pressure
• Alternating colors → choppy, mixed market
█ BEST PRACTICES
1. Use with price context — The DNA strand shows candle character, not direction. Combine with price action on the main chart.
2. Adjust wavelength to timeframe — Shorter wavelengths (10-15) for scalping, longer wavelengths (25-40) for swing trading.
3. Trade zones are filters, not signals — Use zone entries as confirmation for your existing strategy, not as standalone signals.
4. Watch for character shifts — When the dominant strand changes, market behavior is changing. This often precedes reversals.
5. Multiple timeframe analysis — Check DNA character on higher timeframes to understand the broader context.
█ CREDITS
Developed by Hash Capital Research
Pine Script™ v6
This indicator is provided for educational and informational purposes. Always conduct your own analysis and manage risk appropriately. Indicator

Indicator

MTF CISD Trade System + Alerts🔹 Introduction
This indicator, MTF CISD Trade System + Alerts, identifies high-probability trade entries by detecting Change in State of Delivery (CISD) events across up to six user-defined timeframes simultaneously, and only triggering an entry signal when every enabled timeframe agrees on directional bias — confirmed by a matching CISD on the chart's own timeframe.
The core idea is this: when the market's delivery mechanism — the way price is being distributed or accumulated by institutional participants — shifts in the same direction across multiple timeframes at once, that convergence is meaningful. A single timeframe CISD is noise. Six timeframes aligning and then confirming on your entry timeframe is a structurally significant event.
No model of institutional order flow or delivery state is perfect. CISD is a proxy — a price-action-based inference about intent, not direct visibility into the order book. I'll address this limitation honestly throughout.
🔹 The Premise
🔸 What is "Delivery"?
Markets don't move randomly. Price is delivered from one level to another by participants with directional intent. When a large participant — a bank, fund, or algorithm with size — wants to accumulate a long position, they need sellers. When they want to distribute, they need buyers. The process of filling that intent leaves observable footprints in price structure.
Delivery state refers to the current directional intent baked into recent price action. Is the market delivering price upward — making higher closes, respecting higher opens, absorbing sell-side resistance? Or is it delivering downward — closing below opens, treating prior bullish structure as supply?
The key insight is that delivery doesn't change instantaneously. It tends to persist. A market that has been delivering bullishly for the past several candles is more likely to continue doing so than to suddenly reverse — until it shows you structural evidence of a state change.
That evidence is what CISD captures.
🔸 The Mechanics of a CISD
Consider a concrete example. Assume price has been in a bearish delivery phase. The most recent non-inside bearish candle closed at $99 with an open of $101. That open — $101 — becomes a bull target: a structural level that, if reclaimed on a close, suggests the market is no longer delivering bearishly.
Now assume price trades sideways for a few candles and then a candle closes at $102. The prior close was at $100, meaning price was below $101 going into this candle and has now closed above it. That crossover — price transitioning through the open of a prior bearish candle — is a Bullish CISD.
Why does the open matter and not, say, the high or the body midpoint? Because the open of a directional candle represents where price started before commitment was expressed. Reclaiming it suggests that commitment is being challenged at the source. It's the most structurally defensible level to use without access to actual order book data.
The inverse applies for Bearish CISD: the open of the last non-inside bullish candle becomes a bear target, and a close below it — crossing from above — signals a shift toward bearish delivery.
Inside candles are excluded. A candle whose high is lower than the prior high and whose low is higher than the prior low is an inside candle — it expresses no directional commitment of its own. Using it to set a target would contaminate the signal with indecision. The indicator skips inside candles entirely when updating targets.
🔸 Why Multiple Timeframes?
A single CISD on a 5-minute chart happens dozens of times per session. Most are meaningless. They represent micro-fluctuations in a market that is, at higher timeframes, still clearly trending in the opposite direction.
The core challenge in intraday trading is timeframe alignment: you want to be trading with the higher timeframe bias, not against it. A bullish 5-minute CISD during a bearish hourly, daily, and weekly structure is a counter-trend scalp at best, a trap at worst.
Lo and MacKinlay (1988) documented that returns at different frequencies are not independent — price structure at higher timeframes significantly conditions the distribution of outcomes at lower timeframes. This is the academic underpinning of what traders know empirically: trade with the higher timeframe, not against it.
When the Weekly, Daily, H4, H1, M15, and M5 have all individually confirmed a bullish CISD — meaning delivery has demonstrably shifted to bullish on every relevant timeframe — the probability that a long entry will find follow-through is structurally higher than any single-timeframe setup could provide.
Six-timeframe alignment is rare. That rarity is the filter.
🔸 The Confirmation Gate — Why Not Enter Immediately on Alignment?
This is a subtle but critical design decision, and one that separates this system from a naive multi-timeframe crossover.
When a higher timeframe — say, the hourly — registers its CISD and becomes the final piece needed for full bearish alignment, the current 5-minute candle might already have a bullish CISD baked into it. That candle existed before the alignment completed. It's not a response to bearish alignment — it's a relic of the prior bullish structure.
Entering short on that candle would be entering against the very confirmation you're requiring. You'd be using a bullish local signal as a short entry trigger simply because the timing happened to coincide with a higher timeframe shift.
The indicator solves this with a pending state. The moment full alignment is achieved, the system arms a directional pending flag and waits. It does not enter. It listens. The entry only fires when the next local CISD — the one that occurs after alignment is confirmed — appears in the correct direction. A bearish pending state requires a new bearish CISD on the chart timeframe. A bullish pending state requires a new bullish CISD.
The entry is always a fresh confirmation, never a recycled one.
🔹 How It Works
🔸 CISD Detection Engine
The indicator runs an identical CISD detection function on every timeframe, including the local chart timeframe and all six user-selected higher timeframes via request.security. For each timeframe, it maintains two levels:
Bull target — the open of the most recent non-inside bearish candle
Bear target — the open of the most recent non-inside bullish candle
A Bullish CISD fires when the prior close was at or below the bull target and the current close is above it. A Bearish CISD fires when the prior close was at or above the bear target and the current close is below it.
State updates — the "Last CISD" label in the table — only occur on confirmed (closed) bars. This prevents the state from flickering during the formation of a live candle. What you see in the table reflects the last completed directional shift, not a mid-bar reading.
Small green triangles below bars mark Bullish CISD events on the chart timeframe. Small red triangles above bars mark Bearish CISD events. These are visual anchors showing you where delivery shifts are occurring locally — independently of whether alignment is achieved.
🔸 Multi-Timeframe Alignment Table
In the top-right corner, a compact table displays the current CISD state for each of the six configured timeframes.
Green (Bullish) — that timeframe's last confirmed CISD was bullish
Red (Bearish) — that timeframe's last confirmed CISD was bearish
Gray (Neutral) — insufficient history or no CISD has fired yet
Full alignment — all enabled timeframes showing the same state — triggers a green or red background on the chart. This background is persistent: it stays active for the entire duration that alignment holds, giving you a continuous visual context for the trade environment.
Individual timeframes can be enabled or disabled. Disabling a timeframe removes it from the alignment calculation entirely — it doesn't count for or against alignment. This lets you configure the system for your specific trading style, whether that's a 3-timeframe approach for faster setups or all 6 for maximum confluence.
🔸 Entry Signals
Larger triangles — green below the bar for longs, red above the bar for shorts — mark actual entry signals. These only appear when:
All enabled timeframes are aligned in the same direction
The CISD confirmation gate is armed (alignment was freshly achieved or is ongoing)
A new local CISD fires in the matching direction
The entry falls within the configured time window and day-of-week filter
Entries are taken at the close of the confirmation candle. This is an important assumption: in practice, you would place a limit order at the close price or enter at the open of the next candle. Bar-close entries are the most common convention for CISD-based strategies because the CISD itself is only confirmed on the close.
🔸 Trade Lines and Risk Management
When an entry fires, the indicator automatically draws three horizontal lines extending forward in time:
Blue (Entry) — the close price at the moment of entry
Red dashed (Stop Loss) — the open of the entry candle by default, or the low of the prior candle for longs / high of the prior candle for shorts if the "Use Previous Candle for SL" option is enabled
Green dashed (Take Profit) — calculated as Entry + (Risk × RR Ratio) for longs, Entry − (Risk × RR Ratio) for shorts
The Risk-Reward Ratio is fully adjustable. The default is 2.0, meaning TP is twice the distance of SL from entry. Increasing this improves the reward per trade but will reduce win rate as price needs to travel further to close the trade as a winner. Decreasing it improves win rate at the cost of expected value per trade — there is a direct tradeoff.
The stop loss placement assumption matters significantly. Using the entry candle's open assumes you're targeting the candle where delivery shifted as your invalidation point — if price returns to that open, the CISD failed. Using the prior candle's extreme gives the trade slightly more room but widens risk. Neither is universally superior — it depends on the volatility of the instrument and the timeframe you're trading.
Lines extend bar-by-bar until alignment breaks, at which point the trade is considered closed.
🔸 Session and Day-of-Week Filters
The entry filter uses America/New_York timezone with automatic DST adjustment. You set a start and end hour/minute in Eastern time, and the indicator computes whether each potential entry candle's close time falls within that window.
This matters because CISD setups during illiquid hours — Asian session for US equities, overnight for forex majors during off-hours — tend to produce false alignment from low-volume price drift rather than genuine institutional delivery shifts. Restricting entries to the primary session for your instrument significantly reduces noise.
Days of the week are individually toggleable. Sunday and Saturday are off by default. Mondays and Fridays around major economic events are worth monitoring carefully — many traders prefer to disable Friday entries to avoid holding through weekend gaps.
🔸 Performance Statistics Table
In the bottom-left, a live stats table tracks:
Total Trades — all entry signals that fired within the allowed session
Wins — trades where price reached the TP level before alignment broke
Losses — trades where price hit the SL level, or alignment broke before either level was reached
Win Rate — wins as a percentage of total trades
There are limitations here worth stating clearly. The stats count a trade as a loss if alignment breaks before either TP or SL is hit — which is the conservative assumption. In live trading, you might hold the trade past alignment if your personal rules allow it. The stats reflect the mechanical rules of the system as coded, not all possible discretionary interpretations.
🔹 Closing Remarks
CISD is one of the more structurally sound price-action concepts available to retail traders because it is anchored to a specific, objectively defined level — the open of a prior directional candle — rather than a subjective pattern or a lagging average. It doesn't predict the future. It identifies where delivery has demonstrably shifted and asks whether the market is confirming that shift across the timeframes that matter to you.
This system is not a black box that prints money. Full six-timeframe alignment is rare by design. When it occurs, you are looking at a market that has, at every relevant structural level, shifted its delivery state in the same direction. That's meaningful context — not a guarantee.
The most important thing this system can do for your trading is force discipline: you cannot enter unless structure agrees. You cannot enter on a stale signal. You cannot override the session filter in the code. The rules are the rules.
Use it as a confluence tool. Study the setups it finds. Understand why some hit TP and others break alignment early. The patterns in that data will teach you more about your instrument than any indicator description can.
🔹 References
Market Microstructure & Timeframe Dependency
Lo, A. W., & MacKinlay, A. C. (1988). Stock market prices do not follow random walks: Evidence from a simple specification test. Review of Financial Studies, 1(1), 41–66.
Easley, D., & O'Hara, M. (1992). Time and the process of security price adjustment. Journal of Finance, 47(2), 577–605.
Order Flow and Directional Delivery
Hasbrouck, J. (1991). Measuring the information content of stock trades. Journal of Finance, 46(1), 179–207.
Glosten, L. R., & Milgrom, P. R. (1985). Bid, ask and transaction prices in a specialist market with heterogeneously informed traders. Journal of Financial Economics, 14(1), 71–100.
Multi-Timeframe Analysis
Müller, U. A., Dacorogna, M. M., Davé, R. D., Pictet, O. V., Olsen, R. B., & Ward, J. R. (1993). Fractals and intrinsic time — a challenge to econometricians. Olsen & Associates Research Group, Zurich. Indicator
