OPEN-SOURCE SCRIPT
ที่อัปเดต:

Asian Range Liquidity Map [AGPro Series]

1 355
Asian Range Liquidity Map [AGPro Series]

🔹 OVERVIEW

Asian Range Liquidity Map is a precision tool for ICT and smart-money traders who focus on the London Open liquidity sweep. The indicator maps the Asian session high/low liquidity pool, tracks which side gets taken on the London kill-zone, and keeps a rolling 60-session record of post-sweep reactions. The engine calculates live Reversal / Continuation / Mixed probabilities for both bull and bear sweeps and displays everything in a compact info panel without cluttering the chart.

Whether you trade Turtle Soup setups, session-based liquidity grabs, or simply want clean Asian range context, this indicator gives you the structural read most traders spend months building manually.


🔹 UNIQUE EDGE

This is not another session-box plotter. Three design choices separate it from generic Asian range indicators:

1. ATR-Normalized Quality Filter — the range width is measured against the Daily ATR, not the chart timeframe. Sessions that are abnormally narrow (illiquid) or abnormally wide (news-driven noise) are filtered out of the statistics engine automatically. Only clean, tradable ranges count.

2. Live Historical Statistics Engine — every past sweep in the 60-session rolling window is classified as Reversal, Continuation, or Mixed using close-based validation. When a new sweep fires, a state label immediately shows the historical bias: "Bull Sweep -> Historical Reversal 73% (n=26)". You see the context the moment price reacts.

3. Three-Tier Classification — most tools treat sweep reactions as a binary outcome. This engine separates clean reversals, clean continuations, and indecisive mixed responses, giving a more honest statistical picture. The Mixed bucket is visible in the panel so the trader always knows how confident the signal actually is.


🔹 METHODOLOGY

1. Session Tracking — the Asian window is tracked using pure UTC hour/minute math (default 00:00-08:00 UTC), fully independent of chart timezone. Start and end hours are configurable.

2. Range Validity — on session close, the range width is compared to the Daily ATR. If the ratio falls outside the user-defined band (default 0.3-2.0 x dATR), the session is marked Filtered Out and excluded from statistics.

3. Sweep Detection — after the session closes, the engine watches a configurable post-open window (default 6 hours) for the first break of the Asian High or Low. Only the first sweep per session is recorded, which keeps the sample clean.

4. Reaction Classification — after the reaction window (default 10 bars), the engine evaluates post-sweep closes:
- Reversal: price closed through the opposite side by at least Reversal Threshold x Range
- Continuation: price sustained past the sweep level with pullback under Continuation Threshold x Range
- Mixed: neither condition was met

5. Rolling Sample — the most recent 60 classified sweeps feed the Bull and Bear statistics independently. Default is 60, configurable from 20 to 100.


🔹 SIGNALS AND ON-CHART ELEMENTS

- Asian Range Box: dotted amber rectangle during the session, solidifies on close if the range passes the ATR filter. Filtered sessions fade to near-invisible.
- High and Low Dotted Extensions: projected right from each validated session, showing the liquidity levels the market will target.
- Sweep State Label: appears on the bar that first breaks the range. Color-coded green for bull sweeps, pink for bear sweeps, with the historical bias and sample size baked in.
- Sweep Line: thick horizontal line at the taken level, drawn forward across the projection zone.
- Projection Zone: rectangular post-sweep forecast box where follow-through (or rejection) typically plays out.
- Multi-Day Overlay: up to the last 5 validated Asian ranges rendered with fade hierarchy (oldest most faded, newest most visible).
- Three alerts are included: Bull Sweep Detected, Bear Sweep Detected, and London Open with Valid Asian Range.


🔹 KEY INPUTS

Session Settings:
- Asian Session Start/End Hour (UTC)
- Sweep Detection Window (hours after London Open)

Quality Filter:
- Use ATR filter (on/off)
- Min and Max Range Width (x Daily ATR)
- ATR Length

Historical Stats Engine:
- Sample Size (20-100 sessions)
- Reaction Window (bars after sweep)
- Reversal Threshold (x Range)
- Continuation Threshold (x Range)

Multi-Day Overlay:
- Show historical sessions (on/off)
- Days to show and fade intensity

Post-Sweep Projection:
- Show projection zone (on/off)
- Projection length in bars

Visual Style:
- Label Font Size (independent from panel)
- Show sweep state label (on/off)

Info Panel:
- Show panel, location, theme (Dark/Light)
- Panel Font Size (independent from labels)


🔹 HOW TO USE

Best fit: intraday timeframes from 1m to 60m. The 15m chart is the intended sweet spot and what the defaults are tuned around. The script auto-disables on 4H and higher with a clear on-chart notice.

Typical workflow:

1. Confirm Range Status shows Valid after the Asian session closes. If Filtered Out, stand aside that day.
2. Wait for the London Sweep Window state and watch the Asian High/Low levels.
3. When a sweep fires, read the state label. A high Reversal probability near a major higher-timeframe level often flags a Turtle Soup opportunity. A high Continuation probability suggests fading is risky and trend-aligned entries are preferred.
4. Use the projection zone as a post-sweep attention area, not a target in itself.
5. Cross-check with your own higher-timeframe bias, volume, and structure before committing.


🔹 LIMITATIONS AND TRANSPARENCY

- This is a context tool, not a strategy. No buy/sell signals are generated and no backtest or performance claim is made.
- The historical percentages shown are descriptive statistics of recent price behavior in the sample window. They describe what has happened, not what will happen. A reading like 80% Reversal means four out of five prior sweeps in the sample reversed; the fifth did not.
- On strongly trending or low-volatility instruments, distributions can skew heavily to one category. For example, on a tight range-bound market a liquidity sweep almost always reverts, producing very high Reversal readings. This is a feature of the data, not a bug. If a distribution looks extreme, tighten the Reversal Threshold and shorten the Reaction Window for a stricter definition, or widen them for a looser one.
- Request.security is used to pull Daily ATR and is evaluated without lookahead; no future data is used.
- First-run sample size will be small until the chart has enough history to fill 60 sessions. Expect the panel to show progress like 18 / 60 until the buffer fills.


🔹 RISK DISCLOSURE

This indicator is a research and analysis tool for educational purposes. It does not constitute financial advice, a recommendation, or a solicitation to buy or sell any asset. Past behavior of liquidity sweeps does not guarantee future outcomes. Trading carries substantial risk of loss. Always perform your own analysis, apply risk management that suits your account, and consult a qualified professional before making financial decisions.
Release Note
🔧 UPDATE NOTES - V1.6

This update focuses on readability, visual balance, panel structure, and sweep-context clarity.

The core purpose of the script remains unchanged.
This release improves how the existing Asian range and London sweep logic is presented, organized, and interpreted on the chart.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

• Rebuilt the visual structure around a cleaner Asian range workflow.
The script still maps the Asian session high and low, then tracks the first valid high-side or low-side sweep during the London sweep window.

• Improved sweep label management.
Sweep labels are now kept in a controlled buffer so the chart can show useful historical context without becoming overcrowded.

• Added a cleaner historical range hierarchy.
Recent Asian range boxes are shown with a softer fade structure and a lower default history count for a more premium chart view.

• Refined post-sweep projection zones.
Projection zones now use a compact ATR-scaled height and include centered text inside the zone for immediate context.

• Updated naming and panel standards.
The public script title no longer starts with AG Pro, while the panel title keeps the AG Pro branding. The panel header remains a single merged blue row.


------------------------
Visual Improvements
------------------------

• Improved chart readability by adjusting range boxes, sweep labels, projection zones, and right-edge range context.

• Reduced visual clutter to enhance first-glance interpretation.

• Refined visual hierarchy so the active Asian range, swept side, and historical sweep bias stand out more clearly.

• Adjusted label placement to avoid burying labels inside candles.

• Added centered projection labels inside sweep projection zones.


------------------------
Interface & Usability
------------------------

• Optimized panel layout for clearer information flow.

• Improved label readability for better chart interaction.

• Adjusted default visual settings for a more balanced appearance.

• Added configurable label font size and panel font size with Normal as the default.

• Added panel location and theme controls while keeping the panel visible by default.

• Reduced the panel to the most important live context: state, range, sweep side, high-sweep stats, low-sweep stats, and sample depth.


------------------------
Behavior Notes
------------------------

This update does not change the core analytical purpose of the script.

The goal is to improve clarity and usability, not to introduce predictive behavior.

Users should interpret outputs the same way as before, but with improved visual structure, cleaner session rendering, and better sweep-context presentation.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, timeframe differences, and session timezone selection may affect how sweeps appear.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.
Release Note
UPDATE NOTES - v1.7

This update focuses on readability and presentation.

The core purpose of the script remains unchanged. This release improves how the
existing Asian range, sweep labels, projection zones, and panel read on both
light and dark chart backgrounds.

This script continues to function as an analytical and visualization tool. It
does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

- Projection badge moved off the candles
The sweep projection label now sits at the right edge of the projection zone
and stays vertically centered, instead of floating in the middle of the zone
where it could overlap recent candles.

- Theme-aware text everywhere
Sweep labels, the projection badge, the range tag, and every colored panel
value now choose a text color that reads clearly on both light and dark
backgrounds.

- Panel readability on both themes
Panel value colors were tuned so the state, sweep, high-sweep, low-sweep, and
sample rows stay readable on the light theme as well as the dark theme.


------------------------
Visual Improvements
------------------------

- Projection badge sits at the right edge of its zone, away from the candles.

- Contrast-safe sweep, projection, range-tag, and panel text on both themes.

- Reduced overlap between the projection label and price action.

- Preserved the familiar Asian range, sweep line, and projection-zone layout.


------------------------
Interface & Usability
------------------------

- Cleaner, more readable projection and sweep labeling.

- Improved panel contrast across all rows on both themes.

- Adjusted default visual presentation for a more balanced, premium appearance.

- Enhanced overall user experience without changing core logic.


------------------------
Behavior Notes
------------------------

This update does not change the core analytical logic of the script.

The Asian range tracking, the sweep detection and reaction classification, the
historical high-sweep and low-sweep statistics, and the panel all behave exactly
as before.

Users should interpret outputs the same way as before, but with a cleaner and
more readable presentation.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, session timing, and timeframe
differences may affect how the range and sweeps appear. Outputs should always be
interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes. Users
remain responsible for their own decisions.
Release Note
🔧 UPDATE NOTES - v1.8

This update focuses on turning context into a clear next step.

The core purpose of the script remains unchanged.
This release adds a decision-language Bias read on top of the existing high-sweep and low-sweep
reaction statistics, so the active context resolves into a single clear line.

This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.


------------------------
What Changed
------------------------

• Added a Bias row to the panel
The panel already reported, for each side, how often a swept Asian range high or low led to a
reversal or a continuation, with a sample size. This release adds a single Bias row that reads
the active sweep and turns those native statistics into a clear next-step line:
- Reversal lean XX% : the active side has historically reversed more often
- Continuation lean XX% : the active side has historically continued more often
- Mixed reaction : neither outcome dominates the sample
- Building range / Awaiting sweep / Off session : current session context when no sweep is active
The Bias color reflects the resulting directional lean (a reversal after a high sweep reads
bearish; a continuation after a high sweep reads bullish, and the inverse for low sweeps).

• Added hidden data outputs
The high-sweep and low-sweep reversal and continuation rates are now added to the hidden plot
outputs alongside the existing sweep-side, historical-sample, and range-width values, so they
can be referenced by alerts, screeners, or other tools without changing the chart visuals.


------------------------
Visual Improvements
------------------------

• Placed the new Bias row directly below the Sweep row so the active context and its historical
lean read together, above the per-side statistics block.

• Preserved the live and historical Asian range boxes, high and low liquidity lines, sweep
labels and lines, post-sweep projection zones, and the right-edge range tag.

• Kept the merged blue header row and alternating-row dashboard styling across the dark and
light themes.


------------------------
Interface & Usability
------------------------

• Optimized panel layout so the active sweep resolves into a single, readable Bias line rather
than requiring the reader to compare the two statistics rows manually.

• Improved at-a-glance interpretation while keeping the full reversal, continuation, and sample
context visible underneath.

• Adjusted default visual settings for a more balanced appearance without changing the core
session, sweep, or statistics logic.


------------------------
Behavior Notes
------------------------

This update does not change the core analytical logic of the script.

The Bias line is a direct, rule-based reading of the existing reaction statistics for the
active sweep. It is descriptive context, not a prediction, and it does not change how the Asian
range, sweep detection, reaction classification, or sample statistics are produced.

Users should interpret outputs the same way as before, now with a clearer summary line.


------------------------
Limitations Reminder
------------------------

The script remains a rule-based analytical tool.

The Bias read and the reversal/continuation rates depend on the available history and on how
many sweeps occurred on the current symbol and timeframe; a small sample should be treated with
caution. The tool is intended for intraday timeframes at or below the configured maximum.
Market conditions such as volatility, liquidity, and timeframe differences may affect how
sweeps and rates appear.

Outputs should always be interpreted within broader market context.


------------------------
Risk Reminder
------------------------

This script is for educational and analytical purposes only.

It does not provide financial advice or guaranteed trading outcomes.

Users remain responsible for their own decisions.

คำจำกัดสิทธิ์ความรับผิดชอบ

ข้อมูลและบทความไม่ได้มีวัตถุประสงค์เพื่อก่อให้เกิดกิจกรรมทางการเงิน, การลงทุน, การซื้อขาย, ข้อเสนอแนะ หรือคำแนะนำประเภทอื่น ๆ ที่ให้หรือรับรองโดย TradingView อ่านเพิ่มเติมใน ข้อกำหนดการใช้งาน