OPEN-SOURCE SCRIPT
ที่อัปเดต: Smart Money Displacement Ladder [AGPro Series]
Smart Money Displacement Ladder [AGPro Series]
🧠 Core Idea
Is displacement strong, clean, and sustained enough to shift market context?
📌 Overview / What it does
Smart Money Displacement Ladder is a rule-based market-structure and price-action visualization tool designed to study strong directional displacement candles.
The script identifies clean bullish or bearish displacement, maps the imbalance shelf created by the candle, tracks ladder-style follow-through, and highlights whether the displacement is being sustained or failing.
It does not predict price direction, automate trades, or guarantee that displacement will continue. It is a structured decision-support map for displacement quality, imbalance shelf behavior, ladder continuation, and failure context.
🎯 Purpose & Design Philosophy
Many smart-money or imbalance tools mark a gap, a candle, or a generic continuation zone.
This script was built to answer a more complete question:
Did displacement actually change context, and is the market defending that displacement?
The design goal is to help traders read displacement as a progression: clean candle, shelf defense, ladder step, sustained pressure, or failure.
⚡ Why This Script Is Different
Most tools focus on single displacement candles, fair value gaps, or basic momentum signals.
This script does NOT treat every large candle as meaningful displacement.
Instead, it checks candle body, range, close location, optional volume participation, shelf defense, and ladder continuation. The focus is displacement quality and progression rather than simple candle marking.
⚙️ Methodology
1. Candle Quality Detection
The script evaluates candle body size, full range, and close strength relative to ATR.
2. Displacement Validation
A candle must satisfy directional and quality thresholds before it becomes the active displacement anchor.
3. Imbalance Shelf Mapping
After displacement forms, the script projects an imbalance shelf from the displacement candle.
4. Ladder Evaluation
Price extension beyond the active ladder level increases the ladder step count and strengthens the continuation context.
5. Visual Output
The chart displays the displacement box, imbalance shelf, ladder rails, centered shelf label, event labels, right-side tags, alerts, and a compact AG Pro decision panel.
🗺️ How to Read the Chart
Displacement Box = the active candle range that created the displacement anchor.
Imbalance Shelf = the projected shelf that should ideally remain defended after displacement.
Ladder Rail = the active extension level used to track follow-through.
Centered Shelf Label = the main visual anchor inside the active imbalance shelf.
Right-Side Tags = current displacement state, quality score, and shelf reference.
Event Labels = clean displacement, ladder continuation, or displacement failure labels.
Panel = summarizes displacement state, direction, quality score, ladder steps, shelf range, next context, and timeframe.
🚦 Signals & States
• CLEAN DISPLACEMENT → a directional candle meets displacement quality rules.
• FOLLOW-THROUGH → price extends beyond the active ladder level after displacement.
• LADDER STEP → a new continuation step is formed.
• SUSTAINED DISPLACEMENT → multiple ladder steps are active after the displacement anchor.
• DISPLACEMENT FAIL → price loses the imbalance shelf during the failure window.
• WAIT DISPLACEMENT → no valid displacement anchor is active yet.
🔔 Alerts Logic
Alerts trigger when a major displacement state appears.
• Clean Displacement → a clean directional displacement candle has formed.
• Displacement Ladder Continuation → price extended the active displacement ladder.
• Displacement Failure → price lost the active imbalance shelf after displacement.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• Candle body is large relative to ATR
• Candle range expands cleanly
• Close location is strong in the displacement direction
• Relative volume supports participation
• The imbalance shelf remains defended
• Price forms additional ladder steps
• The panel state agrees with chart labels
If these elements do not align, the script avoids forcing a displacement continuation interpretation.
📊 When to Use
• Smart-money displacement studies
• Market-structure shift review
• Momentum expansion analysis
• Imbalance shelf tracking
• Trend continuation context
• Crypto, forex, stocks, and index markets
• 1H, 4H, and daily charts
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy markets with unreliable candle structure
• News spikes where displacement quality may be distorted
• Ultra-low timeframes with excessive wick noise
• Markets where large candles repeatedly fail without structure
• Situations where displacement should not be interpreted without broader context
🎛️ Key Inputs
• ATR Length → normalizes displacement size, shelf depth, and label spacing.
• Minimum Body ATR → controls how large the candle body must be before displacement qualifies.
• Minimum Range ATR → controls how much total candle expansion is required.
• Close Strength Threshold → controls how strong the candle close must be inside the range.
• Use Volume Confirmation → adds relative volume to quality scoring.
• Shelf Failure Window → controls how long shelf failure remains relevant after displacement.
• Imbalance Shelf ATR → controls shelf thickness.
• Projection Bars → controls how far shelves, rails, and tags project.
• Label Font Size → controls chart label and tag text size.
• Panel Font Size → controls panel text size.
🖥️ Interface & Visual Design
The visual hierarchy is built around the displacement progression.
The displacement box marks the anchor candle.
The shelf shows where displacement should ideally remain defended.
The ladder rail shows whether price is extending.
The centered badge keeps the active shelf readable at first glance.
The AG Pro panel summarizes the current displacement state without requiring the user to inspect every candle manually.
🧪 Practical Usage Workflow
1. Wait for a clean displacement candle.
2. Check the imbalance shelf created by that candle.
3. Watch whether price defends or loses the shelf.
4. Look for ladder steps after shelf defense.
5. Use the panel to confirm direction, quality, ladder count, and next context.
6. Interpret the output inside broader trend, liquidity, volatility, and structure context.
🔍 Interpretation Guidelines
Clean displacement does not guarantee continuation. It means the candle met the script's displacement quality rules.
A defended shelf does not guarantee trend expansion. It means price has not invalidated the displacement shelf during the active window.
A ladder step does not guarantee follow-through. It means price extended the active ladder reference.
A displacement failure is a structural warning, not a trading command.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed entry or exit signals.
It is not a simple fair value gap marker.
It is not a full smart-money concept trading system.
⚠️ Limitations & Transparency
Displacement quality depends on ATR and candle structure.
Timeframe differences can change displacement visibility.
High volatility can create large candles that fail quickly.
Low-liquidity markets may create misleading candle expansion.
Shelf behavior should be interpreted within broader market structure.
The script is designed for structured interpretation, not certainty.
🧠 Market Context Notes
Displacement often matters most when it appears near important structure, after liquidity events, or during momentum expansion.
The same displacement candle can mean different things in a strong trend, a range, a liquidity sweep, or a news shock.
The script should be read together with volume, volatility, liquidity, and higher-timeframe context.
🧾 Use Case Examples
• If a bullish displacement candle forms and the shelf remains defended, the ladder may show follow-through context.
• If a bearish displacement candle forms and price quickly reclaims the shelf, the map may show displacement failure.
• If multiple ladder steps form after displacement, the script may classify the move as sustained displacement.
🧱 System Philosophy
Smart Money Displacement Ladder is part of the AGPro Series approach to decision-support tools:
clear structure, premium chart readability, honest interpretation, and no promise of certainty.
The goal is to help traders see whether displacement is being defended and extended, without turning every strong candle into a forced signal.
🔐 Non-Promise Statement
No script can know the future.
No displacement candle guarantees continuation.
No signal should be interpreted without broader market context.
📉 Risk Disclosure
Trading involves risk.
Markets can move unpredictably.
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
📚 Educational Note
Use this script to study how displacement develops after a strong candle.
The value is not only in the displacement label. The value is in learning whether the market defends the shelf, extends through ladder steps, or rejects the displacement context.
🧠 Core Idea
Is displacement strong, clean, and sustained enough to shift market context?
📌 Overview / What it does
Smart Money Displacement Ladder is a rule-based market-structure and price-action visualization tool designed to study strong directional displacement candles.
The script identifies clean bullish or bearish displacement, maps the imbalance shelf created by the candle, tracks ladder-style follow-through, and highlights whether the displacement is being sustained or failing.
It does not predict price direction, automate trades, or guarantee that displacement will continue. It is a structured decision-support map for displacement quality, imbalance shelf behavior, ladder continuation, and failure context.
🎯 Purpose & Design Philosophy
Many smart-money or imbalance tools mark a gap, a candle, or a generic continuation zone.
This script was built to answer a more complete question:
Did displacement actually change context, and is the market defending that displacement?
The design goal is to help traders read displacement as a progression: clean candle, shelf defense, ladder step, sustained pressure, or failure.
⚡ Why This Script Is Different
Most tools focus on single displacement candles, fair value gaps, or basic momentum signals.
This script does NOT treat every large candle as meaningful displacement.
Instead, it checks candle body, range, close location, optional volume participation, shelf defense, and ladder continuation. The focus is displacement quality and progression rather than simple candle marking.
⚙️ Methodology
1. Candle Quality Detection
The script evaluates candle body size, full range, and close strength relative to ATR.
2. Displacement Validation
A candle must satisfy directional and quality thresholds before it becomes the active displacement anchor.
3. Imbalance Shelf Mapping
After displacement forms, the script projects an imbalance shelf from the displacement candle.
4. Ladder Evaluation
Price extension beyond the active ladder level increases the ladder step count and strengthens the continuation context.
5. Visual Output
The chart displays the displacement box, imbalance shelf, ladder rails, centered shelf label, event labels, right-side tags, alerts, and a compact AG Pro decision panel.
🗺️ How to Read the Chart
Displacement Box = the active candle range that created the displacement anchor.
Imbalance Shelf = the projected shelf that should ideally remain defended after displacement.
Ladder Rail = the active extension level used to track follow-through.
Centered Shelf Label = the main visual anchor inside the active imbalance shelf.
Right-Side Tags = current displacement state, quality score, and shelf reference.
Event Labels = clean displacement, ladder continuation, or displacement failure labels.
Panel = summarizes displacement state, direction, quality score, ladder steps, shelf range, next context, and timeframe.
🚦 Signals & States
• CLEAN DISPLACEMENT → a directional candle meets displacement quality rules.
• FOLLOW-THROUGH → price extends beyond the active ladder level after displacement.
• LADDER STEP → a new continuation step is formed.
• SUSTAINED DISPLACEMENT → multiple ladder steps are active after the displacement anchor.
• DISPLACEMENT FAIL → price loses the imbalance shelf during the failure window.
• WAIT DISPLACEMENT → no valid displacement anchor is active yet.
🔔 Alerts Logic
Alerts trigger when a major displacement state appears.
• Clean Displacement → a clean directional displacement candle has formed.
• Displacement Ladder Continuation → price extended the active displacement ladder.
• Displacement Failure → price lost the active imbalance shelf after displacement.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• Candle body is large relative to ATR
• Candle range expands cleanly
• Close location is strong in the displacement direction
• Relative volume supports participation
• The imbalance shelf remains defended
• Price forms additional ladder steps
• The panel state agrees with chart labels
If these elements do not align, the script avoids forcing a displacement continuation interpretation.
📊 When to Use
• Smart-money displacement studies
• Market-structure shift review
• Momentum expansion analysis
• Imbalance shelf tracking
• Trend continuation context
• Crypto, forex, stocks, and index markets
• 1H, 4H, and daily charts
⚠️ When NOT to Use
• Very low-liquidity symbols
• Extremely noisy markets with unreliable candle structure
• News spikes where displacement quality may be distorted
• Ultra-low timeframes with excessive wick noise
• Markets where large candles repeatedly fail without structure
• Situations where displacement should not be interpreted without broader context
🎛️ Key Inputs
• ATR Length → normalizes displacement size, shelf depth, and label spacing.
• Minimum Body ATR → controls how large the candle body must be before displacement qualifies.
• Minimum Range ATR → controls how much total candle expansion is required.
• Close Strength Threshold → controls how strong the candle close must be inside the range.
• Use Volume Confirmation → adds relative volume to quality scoring.
• Shelf Failure Window → controls how long shelf failure remains relevant after displacement.
• Imbalance Shelf ATR → controls shelf thickness.
• Projection Bars → controls how far shelves, rails, and tags project.
• Label Font Size → controls chart label and tag text size.
• Panel Font Size → controls panel text size.
🖥️ Interface & Visual Design
The visual hierarchy is built around the displacement progression.
The displacement box marks the anchor candle.
The shelf shows where displacement should ideally remain defended.
The ladder rail shows whether price is extending.
The centered badge keeps the active shelf readable at first glance.
The AG Pro panel summarizes the current displacement state without requiring the user to inspect every candle manually.
🧪 Practical Usage Workflow
1. Wait for a clean displacement candle.
2. Check the imbalance shelf created by that candle.
3. Watch whether price defends or loses the shelf.
4. Look for ladder steps after shelf defense.
5. Use the panel to confirm direction, quality, ladder count, and next context.
6. Interpret the output inside broader trend, liquidity, volatility, and structure context.
🔍 Interpretation Guidelines
Clean displacement does not guarantee continuation. It means the candle met the script's displacement quality rules.
A defended shelf does not guarantee trend expansion. It means price has not invalidated the displacement shelf during the active window.
A ladder step does not guarantee follow-through. It means price extended the active ladder reference.
A displacement failure is a structural warning, not a trading command.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed entry or exit signals.
It is not a simple fair value gap marker.
It is not a full smart-money concept trading system.
⚠️ Limitations & Transparency
Displacement quality depends on ATR and candle structure.
Timeframe differences can change displacement visibility.
High volatility can create large candles that fail quickly.
Low-liquidity markets may create misleading candle expansion.
Shelf behavior should be interpreted within broader market structure.
The script is designed for structured interpretation, not certainty.
🧠 Market Context Notes
Displacement often matters most when it appears near important structure, after liquidity events, or during momentum expansion.
The same displacement candle can mean different things in a strong trend, a range, a liquidity sweep, or a news shock.
The script should be read together with volume, volatility, liquidity, and higher-timeframe context.
🧾 Use Case Examples
• If a bullish displacement candle forms and the shelf remains defended, the ladder may show follow-through context.
• If a bearish displacement candle forms and price quickly reclaims the shelf, the map may show displacement failure.
• If multiple ladder steps form after displacement, the script may classify the move as sustained displacement.
🧱 System Philosophy
Smart Money Displacement Ladder is part of the AGPro Series approach to decision-support tools:
clear structure, premium chart readability, honest interpretation, and no promise of certainty.
The goal is to help traders see whether displacement is being defended and extended, without turning every strong candle into a forced signal.
🔐 Non-Promise Statement
No script can know the future.
No displacement candle guarantees continuation.
No signal should be interpreted without broader market context.
📉 Risk Disclosure
Trading involves risk.
Markets can move unpredictably.
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
📚 Educational Note
Use this script to study how displacement develops after a strong candle.
The value is not only in the displacement label. The value is in learning whether the market defends the shelf, extends through ladder steps, or rejects the displacement context.
Release Note
UPDATE NOTES - VERSION 1.1This update focuses on readability, presentation control, and higher-timeframe chart balance.
The core purpose of the script remains unchanged.
This release improves how the existing displacement ladder, imbalance shelf, quality score, and panel context are presented 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
------------------------
* Added Adaptive HTF Projection
Shelf, ladder rail, and right-side tag projection now adapt on daily, weekly, and monthly charts for cleaner screenshots.
* Added Shelf Badge Anchor
The centered shelf badge can now be shifted horizontally inside the active shelf without changing displacement logic.
* Expanded panel controls
The panel now supports Top Center, Middle Center, Bottom Center, Elite Dark, Slate, and Clean Light presentation choices.
* Added Huge font option
Chart labels, shelf badges, right-side tags, and panel text now include a Huge size option.
* Improved live panel positioning
Changing the panel location now updates the existing panel position during the latest chart render.
* Reduced label object churn
The active shelf badge is now updated in place instead of being recreated on every latest-bar render.
------------------------
Visual Improvements
------------------------
* Improved chart readability by making shelf projection more balanced on wider timeframes.
* Preserved the centered shelf badge and compact right-side tag structure.
* Refined visual hierarchy between displacement box, shelf, ladder rail, quality tag, and panel.
* Kept the original public-release identity while giving users more presentation flexibility.
------------------------
Interface & Usability
------------------------
* Optimized panel placement options for crowded charts.
* Added an additional Slate theme for layouts where Elite Dark is heavy and Clean Light is too bright.
* Improved label sizing flexibility for high-resolution screenshots.
* Enhanced overall user experience without changing the core displacement ladder model.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
Displacement detection, shelf construction, ladder step tracking, failure logic, quality scoring, labels, panel rows, and alerts remain conceptually unchanged.
The goal is to improve clarity and usability, not to introduce new predictive behavior.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, timeframe differences, and volume quality may affect how displacement ladders 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 - 1.2This update adds a hold-rate proof layer, contrast-safe label text, and a more
focused panel to the Smart Money Displacement Ladder. The core displacement
engine, ladder logic and scoring remain unchanged. This script continues to
function as an analytical visualization tool. It does not predict price direction
or provide guaranteed outcomes.
------------------------
What Changed
------------------------
- Hold-Rate Proof Layer
The panel now tracks how often a fresh displacement held its imbalance shelf
through a defined window before losing it, with sample size shown.
- Thesis-Aligned Statistic
The proof reflects the script's core idea - displacement strong enough to hold
its shelf versus one that fails - by measuring the imbalance shelf directly.
- Honest, Non-Repaint Statistics
Each displacement is counted once. Samples are confirmed-bar gated, losing the
shelf inside the window counts as a non-hold, and the rate is built from completed
windows only so it is not inflated.
- Contrast-Safe Label Text
A luminance helper now sets tag, badge and event-label text color automatically,
so amber, pink and indigo elements stay clearly readable.
- Cleaner Panel
Replaced the static timeframe row with the Hold Rate proof row for a more
decision-first panel.
- New Proof Input
A dedicated proof group adds Proof Hold Window Bars so the hold test can be tuned
per market and timeframe.
------------------------
Visual Improvements
------------------------
- Improved tag, shelf-badge and event-label readability through automatic contrast
- Kept the premium displacement box, imbalance shelf, ladder rails and centered
badge intact
- Preserved moderate, non-overlapping label density
- No added chart clutter from the proof layer
------------------------
Interface & Usability
------------------------
- Added a Hold Rate proof row to the panel
- Improved first-glance trust with a visible track-record context
- Kept all existing settings and defaults backward compatible
- Enhanced overall experience without changing the core engine
------------------------
Behavior Notes
------------------------
This update does not change how displacement, the imbalance shelf, ladder steps,
failure or the quality score are computed. The goal is added proof context and
cleaner text contrast. Outputs should be interpreted the same way as before.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool. Volatility, liquidity and
timeframe differences can affect how displacement and statistics appear. Always
interpret outputs 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
Version 1.3 – Quality Persistence and Ladder ReadabilityThis update strengthens proof integrity and visual interpretation by preserving each active displacement's original quality basis while refining how ladder direction, shelf context, and current quality are presented. The displacement thresholds, shelf rules, hold-rate proof window, alerts, and overall workflow remain unchanged.
• Locked the base quality score at the confirmed displacement candle, preventing unrelated later candles from rewriting the active displacement's original body, range, close-strength, and relative-volume evidence.
• Limited subsequent score changes to verified ladder progression and shelf-failure penalties, keeping the displayed quality aligned with the active displacement lifecycle.
• Centered the default shelf badge horizontally and vertically inside the projected imbalance shelf while retaining the existing anchor control for optional customization.
• Replaced generic historical LADDER labels with directional BULL STEP and BEAR STEP labels, and clarified clean-displacement and failure events with matching directional text.
• Separated the right-side QUALITY badge from directional state color by using the AGPro accent color, and added score-aware panel coloring for faster quality interpretation.
• Preserved the existing event-density limits, panel structure, premium palette, alert conditions, and hold-rate proof methodology.
สคริปต์แบบโอเพนซอร์ส
ด้วยเจตนารมณ์หลักของ TradingView ผู้สร้างสคริปต์นี้ได้ทำให้เป็นโอเพนซอร์ส เพื่อให้เทรดเดอร์สามารถตรวจสอบและยืนยันฟังก์ชันการทำงานของมันได้ ขอชื่นชมผู้เขียน! แม้ว่าคุณจะใช้งานได้ฟรี แต่โปรดจำไว้ว่าการเผยแพร่โค้ดซ้ำจะต้องเป็นไปตาม กฎระเบียบการใช้งาน ของเรา
🧠 Trading Suite - Flagship Workflow
tradingview.com/script/XJmX3p98-Trading-Suite-AGPro-Series/
🔷 Crypto Setup Planner - Multi-Symbol Planner
tradingview.com/script/LgVRo7Ql-Crypto-Setup-Planner-AGPro-Series/
tradingview.com/script/XJmX3p98-Trading-Suite-AGPro-Series/
🔷 Crypto Setup Planner - Multi-Symbol Planner
tradingview.com/script/LgVRo7Ql-Crypto-Setup-Planner-AGPro-Series/
คำจำกัดสิทธิ์ความรับผิดชอบ
ข้อมูลและบทความไม่ได้มีวัตถุประสงค์เพื่อก่อให้เกิดกิจกรรมทางการเงิน, การลงทุน, การซื้อขาย, ข้อเสนอแนะ หรือคำแนะนำประเภทอื่น ๆ ที่ให้หรือรับรองโดย TradingView อ่านเพิ่มเติมใน ข้อกำหนดการใช้งาน
สคริปต์แบบโอเพนซอร์ส
ด้วยเจตนารมณ์หลักของ TradingView ผู้สร้างสคริปต์นี้ได้ทำให้เป็นโอเพนซอร์ส เพื่อให้เทรดเดอร์สามารถตรวจสอบและยืนยันฟังก์ชันการทำงานของมันได้ ขอชื่นชมผู้เขียน! แม้ว่าคุณจะใช้งานได้ฟรี แต่โปรดจำไว้ว่าการเผยแพร่โค้ดซ้ำจะต้องเป็นไปตาม กฎระเบียบการใช้งาน ของเรา
🧠 Trading Suite - Flagship Workflow
tradingview.com/script/XJmX3p98-Trading-Suite-AGPro-Series/
🔷 Crypto Setup Planner - Multi-Symbol Planner
tradingview.com/script/LgVRo7Ql-Crypto-Setup-Planner-AGPro-Series/
tradingview.com/script/XJmX3p98-Trading-Suite-AGPro-Series/
🔷 Crypto Setup Planner - Multi-Symbol Planner
tradingview.com/script/LgVRo7Ql-Crypto-Setup-Planner-AGPro-Series/
คำจำกัดสิทธิ์ความรับผิดชอบ
ข้อมูลและบทความไม่ได้มีวัตถุประสงค์เพื่อก่อให้เกิดกิจกรรมทางการเงิน, การลงทุน, การซื้อขาย, ข้อเสนอแนะ หรือคำแนะนำประเภทอื่น ๆ ที่ให้หรือรับรองโดย TradingView อ่านเพิ่มเติมใน ข้อกำหนดการใช้งาน