OPEN-SOURCE SCRIPT
更新済 Liquidity Reclaim Planner [AGPro Series]
Liquidity Reclaim Planner [AGPro Series]
🧠 Core Idea
After a liquidity event, is the reclaim strong enough to matter, or is the move still fragile?
📌 Overview / What it does
Liquidity Reclaim Planner [AGPro Series] is a chart-first liquidity planning tool designed to evaluate what happens after price sweeps a recent swing liquidity reference.
Instead of treating every liquidity sweep as a finished signal, the script starts a structured reclaim workflow. It maps the liquidity event, the reclaim pocket, the failure line, the target-room corridor, a 0-100 reclaim score, failure risk, and a clear next-action state.
The script does not predict price direction, automate execution, or claim that a reclaim will continue. It organizes post-event liquidity context so traders can review whether the reclaim has enough quality, timing, participation, and room to deserve attention.
🎯 Purpose & Design Philosophy
This script was built for traders who want more than another sweep marker.
Many liquidity tools identify where a stop run, wick raid, or sweep happened. That is useful, but the harder question comes after the event: did price reclaim the level cleanly, is the failure point clear, and is there enough structure room for the idea to remain practical?
Liquidity Reclaim Planner supports a decision-engine mindset. It helps users move from raw event detection toward structured review: event, reclaim, failure risk, target room, and next action.
⚡ Why This Script Is Different
Most tools focus on detecting liquidity sweeps, equal highs, equal lows, or stop-hunt style wick events.
This script does NOT try to become a broad liquidity sweep scanner, an EQH/EQL engine, an order block map, a structural breakout reclaim planner, or a generic support/resistance zone tool.
Instead, it focuses on the post-event reclaim decision. It asks whether the sweep was reclaimed with enough depth balance, close strength, timing, volume response, and structural room to become a useful planning context.
⚙️ Methodology
1. Context Detection
The engine tracks confirmed swing highs and swing lows as active buy-side and sell-side liquidity references.
2. Reference Mapping
When price moves through a fresh liquidity reference by an ATR-normalized amount, the script registers a liquidity event and starts a reclaim plan.
3. Reaction Evaluation
The reclaim score evaluates sweep depth, reclaim close strength, time to reclaim, relative volume response, and room to the next structure reference.
4. Visual Output
The script draws the reclaim pocket, failure line, target-room corridor, event labels, sparse context labels, and the AG Pro decision panel.
🗺️ How to Read the Chart
Zones = the reclaim pocket between the swept liquidity level and the event extreme, plus an optional target-room corridor toward the next structural reference.
Labels = liquidity event, reclaim ready, room thin, failure line, and sparse context states.
Colors = bullish reclaim planning uses AGPro teal, bearish reclaim planning uses AGPro pink, neutral review uses gold, and risk/failure context uses red.
Panel = the panel shows Liquidity Event, Reclaim Score, Failure Risk, Room, and Action.
🚦 Signals & States
• Sell-side Event → price swept a recent swing low and a bullish reclaim plan is being evaluated.
• Buy-side Event → price swept a recent swing high and a bearish reclaim plan is being evaluated.
• Reclaim Watch → price has not yet reclaimed strongly enough, but context is active.
• Planner Ready → reclaim score and target room are strong enough for structured review.
• Risk Review → reclaim exists, but the quality profile is not yet clean.
• Room Thin → reclaim exists, but the next structural room is limited.
• Failure Hit → price crossed the active failure line and the reclaim plan needs reassessment.
🔔 Alerts Logic
Alerts trigger when a sell-side or buy-side liquidity event appears, when a reclaim becomes ready, when the planner reaches Planner Ready state, when target room becomes thin, or when the failure line is crossed.
Alerts are attention markers. They are not trade instructions, entry commands, or automated strategy signals.
🧩 Confluence Logic
The strongest context usually appears when sweep depth is balanced, reclaim happens quickly, the reclaim close is decisive, relative volume supports the reaction, and the target-room corridor is not compressed.
When these elements align, the reclaim score improves and the panel action becomes more useful for structured review.
📊 When to Use
• Liquidity-driven markets where swing highs and swing lows are actively swept.
• Intraday or swing charts where reclaim behavior after stop runs matters.
• 4H charts when the trader wants a balanced view between visible liquidity events and readable planning zones.
• Post-sweep review workflows.
• Situations where the trader needs a clear failure line and room assessment.
⚠️ When NOT to Use
• Extremely low-liquidity symbols where swing references are unreliable.
• Highly chaotic news candles where reclaim behavior is distorted by abnormal volatility.
• Very compressed chop where every small swing becomes noise.
• Markets where volume data is missing or not meaningful, unless volume weighting is interpreted carefully.
🎛️ Key Inputs
• Liquidity Pivot Strength → controls how swing liquidity references are confirmed.
• Max Liquidity Level Age → controls how long a swing reference remains eligible.
• Sensitivity → adjusts how selective liquidity event and reclaim thresholds are.
• Timely Reclaim Window → defines how many bars after the event can still count as timely reclaim.
• Planner Ready Score → controls the 0-100 score threshold for the main ready state.
• Minimum Target Room ATR → controls how much structure room is required before room is considered acceptable.
• Visual settings → control reclaim pockets, failure lines, target-room corridors, labels, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around a clean AG Pro panel and compact chart visuals.
The first panel row is a merged blue AGPro header. The remaining rows show the active liquidity event, reclaim score, failure risk, target room, and next action.
The chart uses a limited number of zones and labels so the active plan is visible without turning the chart into a crowded liquidity map.
🧪 Practical Usage Workflow
1. Read the panel to identify whether a liquidity event is active.
2. Check the reclaim pocket to understand the swept level and event extreme.
3. Review the reclaim score and failure risk.
4. Check the target-room corridor before assigning importance to the reclaim.
5. Use the Action row to decide whether the context deserves review, waiting, or rejection.
🔍 Interpretation Guidelines
Think in terms of quality, not certainty.
A reclaim with a high score, clean timing, strong close, and enough room is more useful than a late reclaim into nearby structure.
A low score does not mean price cannot move. It means the script's reclaim-planning conditions are not well aligned.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a complete liquidity or smart-money framework.
• Not an order block, FVG, or generic support/resistance map.
⚠️ Limitations & Transparency
Swing references are confirmed after the selected pivot strength, so the script uses confirmed structure rather than instantly known future pivots.
Different timeframes, symbols, volatility regimes, and liquidity conditions can change how reclaim behavior appears.
Relative volume can add context, but volume response does not guarantee continuation or reversal.
Target-room corridors are structural planning references, not forecasts.
🧠 Market Context Notes
Liquidity events often matter most when they occur around visible swing references that many traders can identify.
The reclaim phase is where the decision quality changes. A fast reclaim can show rejection, while a slow or weak reclaim can indicate fragile context.
The failure line exists so the user can see where the active reclaim idea becomes structurally weaker according to the script's own rules.
🧾 Use Case Examples
When price sweeps a recent swing low, quickly closes back above the level, and the target-room corridor is open, the planner may shift from Reclaim Watch to Planner Ready.
When price reclaims late or reclaims directly into nearby structure, the panel may show Risk Review or Room Thin.
When price crosses the active failure line after reclaim, the script marks Failure Hit so the context can be reassessed.
🧱 System Philosophy
Liquidity Reclaim Planner follows the AGPro Series approach: clear structure, rule-based scoring, readable visuals, and decision support without outcome promises.
The script is designed to help traders review the quality of a setup context, not to replace judgment or risk planning.
🔐 Non-Promise Statement
No script can provide certainty.
No reclaim score guarantees continuation, reversal, or profit.
The output should be interpreted as structured analytical context.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, position sizing, risk controls, and market interpretation.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use this tool to study how liquidity events evolve after the sweep: whether price reclaims, where the failure line sits, how much room remains, and whether the context is strong enough to deserve further review.
🧠 Core Idea
After a liquidity event, is the reclaim strong enough to matter, or is the move still fragile?
📌 Overview / What it does
Liquidity Reclaim Planner [AGPro Series] is a chart-first liquidity planning tool designed to evaluate what happens after price sweeps a recent swing liquidity reference.
Instead of treating every liquidity sweep as a finished signal, the script starts a structured reclaim workflow. It maps the liquidity event, the reclaim pocket, the failure line, the target-room corridor, a 0-100 reclaim score, failure risk, and a clear next-action state.
The script does not predict price direction, automate execution, or claim that a reclaim will continue. It organizes post-event liquidity context so traders can review whether the reclaim has enough quality, timing, participation, and room to deserve attention.
🎯 Purpose & Design Philosophy
This script was built for traders who want more than another sweep marker.
Many liquidity tools identify where a stop run, wick raid, or sweep happened. That is useful, but the harder question comes after the event: did price reclaim the level cleanly, is the failure point clear, and is there enough structure room for the idea to remain practical?
Liquidity Reclaim Planner supports a decision-engine mindset. It helps users move from raw event detection toward structured review: event, reclaim, failure risk, target room, and next action.
⚡ Why This Script Is Different
Most tools focus on detecting liquidity sweeps, equal highs, equal lows, or stop-hunt style wick events.
This script does NOT try to become a broad liquidity sweep scanner, an EQH/EQL engine, an order block map, a structural breakout reclaim planner, or a generic support/resistance zone tool.
Instead, it focuses on the post-event reclaim decision. It asks whether the sweep was reclaimed with enough depth balance, close strength, timing, volume response, and structural room to become a useful planning context.
⚙️ Methodology
1. Context Detection
The engine tracks confirmed swing highs and swing lows as active buy-side and sell-side liquidity references.
2. Reference Mapping
When price moves through a fresh liquidity reference by an ATR-normalized amount, the script registers a liquidity event and starts a reclaim plan.
3. Reaction Evaluation
The reclaim score evaluates sweep depth, reclaim close strength, time to reclaim, relative volume response, and room to the next structure reference.
4. Visual Output
The script draws the reclaim pocket, failure line, target-room corridor, event labels, sparse context labels, and the AG Pro decision panel.
🗺️ How to Read the Chart
Zones = the reclaim pocket between the swept liquidity level and the event extreme, plus an optional target-room corridor toward the next structural reference.
Labels = liquidity event, reclaim ready, room thin, failure line, and sparse context states.
Colors = bullish reclaim planning uses AGPro teal, bearish reclaim planning uses AGPro pink, neutral review uses gold, and risk/failure context uses red.
Panel = the panel shows Liquidity Event, Reclaim Score, Failure Risk, Room, and Action.
🚦 Signals & States
• Sell-side Event → price swept a recent swing low and a bullish reclaim plan is being evaluated.
• Buy-side Event → price swept a recent swing high and a bearish reclaim plan is being evaluated.
• Reclaim Watch → price has not yet reclaimed strongly enough, but context is active.
• Planner Ready → reclaim score and target room are strong enough for structured review.
• Risk Review → reclaim exists, but the quality profile is not yet clean.
• Room Thin → reclaim exists, but the next structural room is limited.
• Failure Hit → price crossed the active failure line and the reclaim plan needs reassessment.
🔔 Alerts Logic
Alerts trigger when a sell-side or buy-side liquidity event appears, when a reclaim becomes ready, when the planner reaches Planner Ready state, when target room becomes thin, or when the failure line is crossed.
Alerts are attention markers. They are not trade instructions, entry commands, or automated strategy signals.
🧩 Confluence Logic
The strongest context usually appears when sweep depth is balanced, reclaim happens quickly, the reclaim close is decisive, relative volume supports the reaction, and the target-room corridor is not compressed.
When these elements align, the reclaim score improves and the panel action becomes more useful for structured review.
📊 When to Use
• Liquidity-driven markets where swing highs and swing lows are actively swept.
• Intraday or swing charts where reclaim behavior after stop runs matters.
• 4H charts when the trader wants a balanced view between visible liquidity events and readable planning zones.
• Post-sweep review workflows.
• Situations where the trader needs a clear failure line and room assessment.
⚠️ When NOT to Use
• Extremely low-liquidity symbols where swing references are unreliable.
• Highly chaotic news candles where reclaim behavior is distorted by abnormal volatility.
• Very compressed chop where every small swing becomes noise.
• Markets where volume data is missing or not meaningful, unless volume weighting is interpreted carefully.
🎛️ Key Inputs
• Liquidity Pivot Strength → controls how swing liquidity references are confirmed.
• Max Liquidity Level Age → controls how long a swing reference remains eligible.
• Sensitivity → adjusts how selective liquidity event and reclaim thresholds are.
• Timely Reclaim Window → defines how many bars after the event can still count as timely reclaim.
• Planner Ready Score → controls the 0-100 score threshold for the main ready state.
• Minimum Target Room ATR → controls how much structure room is required before room is considered acceptable.
• Visual settings → control reclaim pockets, failure lines, target-room corridors, labels, panel theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around a clean AG Pro panel and compact chart visuals.
The first panel row is a merged blue AGPro header. The remaining rows show the active liquidity event, reclaim score, failure risk, target room, and next action.
The chart uses a limited number of zones and labels so the active plan is visible without turning the chart into a crowded liquidity map.
🧪 Practical Usage Workflow
1. Read the panel to identify whether a liquidity event is active.
2. Check the reclaim pocket to understand the swept level and event extreme.
3. Review the reclaim score and failure risk.
4. Check the target-room corridor before assigning importance to the reclaim.
5. Use the Action row to decide whether the context deserves review, waiting, or rejection.
🔍 Interpretation Guidelines
Think in terms of quality, not certainty.
A reclaim with a high score, clean timing, strong close, and enough room is more useful than a late reclaim into nearby structure.
A low score does not mean price cannot move. It means the script's reclaim-planning conditions are not well aligned.
🚫 What This Script Is NOT
• Not a prediction engine.
• Not financial advice.
• Not auto trading.
• Not guaranteed signals.
• Not a complete liquidity or smart-money framework.
• Not an order block, FVG, or generic support/resistance map.
⚠️ Limitations & Transparency
Swing references are confirmed after the selected pivot strength, so the script uses confirmed structure rather than instantly known future pivots.
Different timeframes, symbols, volatility regimes, and liquidity conditions can change how reclaim behavior appears.
Relative volume can add context, but volume response does not guarantee continuation or reversal.
Target-room corridors are structural planning references, not forecasts.
🧠 Market Context Notes
Liquidity events often matter most when they occur around visible swing references that many traders can identify.
The reclaim phase is where the decision quality changes. A fast reclaim can show rejection, while a slow or weak reclaim can indicate fragile context.
The failure line exists so the user can see where the active reclaim idea becomes structurally weaker according to the script's own rules.
🧾 Use Case Examples
When price sweeps a recent swing low, quickly closes back above the level, and the target-room corridor is open, the planner may shift from Reclaim Watch to Planner Ready.
When price reclaims late or reclaims directly into nearby structure, the panel may show Risk Review or Room Thin.
When price crosses the active failure line after reclaim, the script marks Failure Hit so the context can be reassessed.
🧱 System Philosophy
Liquidity Reclaim Planner follows the AGPro Series approach: clear structure, rule-based scoring, readable visuals, and decision support without outcome promises.
The script is designed to help traders review the quality of a setup context, not to replace judgment or risk planning.
🔐 Non-Promise Statement
No script can provide certainty.
No reclaim score guarantees continuation, reversal, or profit.
The output should be interpreted as structured analytical context.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, position sizing, risk controls, and market interpretation.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
Use this tool to study how liquidity events evolve after the sweep: whether price reclaims, where the failure line sits, how much room remains, and whether the context is strong enough to deserve further review.
リリースノート
🔧 UPDATE NOTES - V1.1This update focuses on label readability, cleaner publication density, and single-line liquidity reclaim event labels.
The core purpose of the script remains unchanged.
This release improves how the existing liquidity reclaim workflow is presented 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
------------------------
• Converted event score labels to single-line badges.
Event labels now append score context as Q values instead of using multi-line text.
• Reduced default chart label density.
The default maximum visible labels was reduced for a cleaner public-release chart.
• Increased context label spacing.
Sparse approach and active-state context labels now print less frequently by default.
• Increased event label cooldown.
Repeated liquidity event labels are more controlled during fast markets.
• Preserved the liquidity reclaim model.
Liquidity event detection, reclaim pocket, failure line, target-room corridor, score model, panel, and alerts remain unchanged.
------------------------
Visual Improvements
------------------------
• Improved chart readability by removing multi-line event label text.
• Reduced visual clutter while keeping meaningful liquidity reclaim context visible.
• Preserved contrast-safe colored zone labels for dark and light chart backgrounds.
• Refined visual hierarchy so reclaim pocket, target corridor, failure guide, and panel remain easier to scan.
------------------------
Interface & Usability
------------------------
• Default label settings are now more publication-friendly.
• Existing label score, label font size, panel font size, panel location, and panel theme controls remain available.
• Existing reclaim pocket and target corridor controls remain unchanged.
• Enhanced overall user experience without changing core analytical logic.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The goal is to improve clarity and usability, not to introduce new predictive behavior.
Users should interpret outputs the same way as before, but with improved visual structure.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may affect how signals 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.
リリースノート
🔧 UPDATE NOTES - v1.2This update focuses on completing the reclaim decision read.
The core purpose of the script remains unchanged.
This release adds a target level, an invalidation level, and a stop-aware
follow-through proof rate to the planning panel, and unifies on-chart label
contrast.
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
------------------------
• Target level added to the panel
The structural room reference used for the target-room corridor is now shown as
a concrete price next to the score and room, so the objective sits beside the
quality read rather than only on the chart.
• Invalidation level added to the panel
The failure line beyond the event extreme is now shown as a concrete price, so
the planning invalidation reference reads directly in the panel.
• Stop-aware Proof row added
On each confirmed reclaim, the planner measures from the reclaim bar close
whether price closed to a 1.5 ATR follow-through before closing 1.0 ATR against
it. Both sides are evaluated on confirmed closes so the race stays fair,
unresolved reclaims time out without being counted, and the row reads
"Building (n)" until at least 6 samples exist, e.g. "54% (18)".
• Unified label contrast
The reclaim pocket label, target-room label, approach labels, event labels, and
context labels now derive text color from their fill brightness, so every badge
stays legible on both bright and dark fills.
------------------------
Visual Improvements
------------------------
• Improved label readability by deriving text color from each badge fill
• Refined panel hierarchy so score, target, invalidation, and room read together
• Kept reclaim pocket, failure line, and target corridor visuals unchanged
------------------------
Interface & Usability
------------------------
• Panel now reads: Liquidity Event, Reclaim Score, Failure Risk, Target, Invalidation, Room, Action, Proof
• Grouped objective and invalidation for clearer at-a-glance interpretation
• Enhanced overall user experience without changing the core reclaim logic
------------------------
Behavior Notes
------------------------
This update does not change the core liquidity event, reclaim, or scoring logic.
The Target is a structural reference, the Invalidation is the failure line, and
the Proof row is a historical, descriptive follow-through statistic measured on
confirmed closes. None of these are forecasts, win rates, or trade instructions,
and the proof rate is symbol- and timeframe-dependent.
Users should interpret outputs the same way as before, now with an added target,
invalidation, and follow-through context.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may
affect how reclaims, the target, and the proof rate 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.
リリースノート
Version 1.3 – Owned Liquidity Badge LanesThis update removes the competing label streams that obscured liquidity events while preserving the sweep, reclaim, scoring, risk, proof, and alert engine.
• Event badges now use font-aware, ATR-scaled three-lane staggering with source-candle connectors, keeping price ownership clear when nearby events compete for space.
• Default historical density was reduced to four event badges with a 34-bar cooldown, while approach and periodic context badges are now optional and disabled by default.
• Same-bar context duplication was blocked so a reclaim transition is no longer repeated by a second Planner Ready or Room Thin badge.
• Event language was shortened to compact SELL SWEEP, BUY SWEEP, RECLAIM READY, RECLAIM FAILED, and ROOM THIN identities.
• The centered active pocket badge now includes side, lifecycle, and quality context instead of displaying a generic pocket name.
• The active failure rail received a filled right-edge owner badge with its exact price, eliminating an unlabeled planning line.
オープンソーススクリプト
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が提供または承認する金融、投資、取引、またはその他の種類の助言もしくは推奨であることを意図したものではなく、またこれらに該当するものでもありません。詳細は利用規約をご覧ください。