OPEN-SOURCE SCRIPT
已更新 Fair Value Gap Reclaim Planner [AGPro Series]
Fair Value Gap Reclaim Planner [AGPro Series]
🧠 Core Idea
Has price returned into a fair value gap and reclaimed the imbalance midpoint with enough quality?
📌 Overview / What it does
Fair Value Gap Reclaim Planner is an imbalance-focused price action tool built around three-candle fair value gap structure.
The script detects bullish and bearish FVG zones, tracks fill progress, maps the midpoint, evaluates reclaim quality, and displays a structured 0-100 readiness score. It also projects an active reclaim corridor, invalidation shelf, target rails, labels, and a clean AG Pro dashboard.
It does not predict future price movement, automate entries, or provide guaranteed signals. It is a visual framework for reading fair value gap reclaim behavior.
🎯 Purpose & Design Philosophy
This script was built for traders who study imbalance zones but want a cleaner way to separate meaningful reclaim behavior from ordinary gap interaction.
Fair value gaps can attract attention, but not every touch matters. The planner focuses on whether price fills, reacts, and reclaims a meaningful reference level inside the imbalance.
The design supports patient analysis: identify the zone, measure the fill, wait for reclaim, then evaluate context.
⚡ Why This Script Is Different
Most FVG tools highlight many imbalance zones and leave the user to interpret the rest manually.
This script does NOT flood the chart with every historical imbalance.
Instead, it focuses on the active FVG context, tracks fill progress, evaluates midpoint or full-edge reclaim, and converts the reaction into a clear score and action state.
⚙️ Methodology
1. Context Detection
The script detects bullish and bearish three-candle fair value gaps using a minimum ATR-based size filter.
2. Reference Mapping
It maps the FVG top, bottom, midpoint, fill area, and invalidation boundary.
3. Reaction Evaluation
When price interacts with the active FVG, the script evaluates fill progress, reclaim distance, wick response, body quality, relative volume, gap quality, and freshness.
4. Visual Output
Qualified reclaim events are shown with labels, projected zones, target rails, right-side level tags, and a compact panel.
🗺️ How to Read the Chart
FVG Zone shows the active imbalance area.
Midline marks the primary reclaim reference when Midline mode is selected.
Fill Progress shows how deeply price has returned into the imbalance.
READY FVG RECLAIM labels mark reclaim events that meet the selected score threshold.
Invalidation Shelf marks the area where the reclaim context weakens or fails.
The AG Pro panel summarizes Gap State, Reclaim Score, Fill Progress, Risk, and Action.
🚦 Signals & States
• BULL FVG → bullish fair value gap detected and locked.
• BEAR FVG → bearish fair value gap detected and locked.
• READY FVG RECLAIM → price reclaimed the selected FVG reference with enough quality.
• FVG TOUCH → price interacted with the active FVG zone.
• INVALIDATED → the active reclaim context lost the opposite FVG edge.
• READY → a qualified reclaim event is active.
• MONITOR → the active FVG is being tested or a reclaim context remains open.
• WAIT → no qualified reclaim event is active.
🔔 Alerts Logic
Bullish FVG Reclaim Ready triggers when price reclaims the selected FVG reference upward with enough score quality.
Bearish FVG Reclaim Ready triggers when price reclaims the selected FVG reference downward with enough score quality.
FVG Touch triggers when price interacts with the active imbalance zone.
FVG Reclaim Invalidated triggers when the active reclaim context loses the opposite FVG edge.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest reclaim contexts appear when fill progress, wick response, close quality, relative volume, gap size, and freshness align.
When price returns into the imbalance, respects the zone, and reclaims the midpoint or edge with clean reaction quality, the score improves.
📊 When to Use
• Markets with visible imbalance behavior
• Breakout pullbacks into fair value gaps
• Trend continuation reviews
• Reclaim attempts after partial FVG fills
• Intraday or swing contexts where FVG zones remain meaningful
⚠️ When NOT to Use
• Very low liquidity markets
• Extremely noisy or illiquid symbols
• Markets with unreliable candles or volume
• Wide-spread conditions where small gaps are misleading
• News spikes where imbalance zones can be invalidated quickly
🎛️ Key Inputs
• Minimum FVG Size ATR → filters out tiny imbalance zones.
• Maximum FVG Age Bars → controls how long an FVG can remain active.
• Reclaim Reference → chooses midpoint reclaim or full-edge reclaim.
• Touch Lookback Bars → controls how recent the FVG interaction must be.
• Invalidation Buffer ATR → controls the risk shelf beyond the FVG edge.
• Minimum Ready Score → sets how strict READY events should be.
• Target Rails → control projected T1 and T2 levels.
• Label Settings → control label density, size, and spacing.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is designed to show the active imbalance context without filling the chart with excessive historical zones.
The FVG zone, midline, fill meter, invalidation shelf, target rails, and panel are visually separated so the chart remains readable.
The goal is a premium first-glance layout: zone first, reclaim second, action state third.
🧪 Practical Usage Workflow
1. Check the panel for active Gap State.
2. Locate the FVG zone and midpoint.
3. Watch how deeply price fills the imbalance.
4. Evaluate READY FVG RECLAIM labels and score quality.
5. Compare price with the invalidation shelf and target rails.
6. Confirm broader structure before making decisions.
🔍 Interpretation Guidelines
A high reclaim score means the reaction is cleaner according to the script's rules.
A lower score means the reclaim may be weaker, late, noisy, or incomplete.
Fill progress is not a signal by itself. It becomes more meaningful when combined with reclaim quality and broader market context.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an automated trading system.
It does not guarantee entries, exits, profits, or outcomes.
⚠️ Limitations & Transparency
Fair value gap interpretation can vary across markets, sessions, and timeframes.
Some markets create many small gaps that may not carry meaningful context.
Volatility changes can make an active FVG less relevant over time.
No rule-based script can fully account for news, liquidity shocks, or sudden market structure shifts.
🧠 Market Context Notes
Fair value gaps often represent fast price displacement and temporary imbalance.
The reclaim of a midpoint or edge can help traders study whether the market is accepting or rejecting the imbalance area.
The script works best when combined with structure, liquidity, volatility, and trend context.
🧾 Use Case Examples
When a bullish FVG forms after displacement, price returns into the zone, partially fills it, and then reclaims the midpoint, the script may mark a bullish reclaim context.
When a bearish FVG forms after downside displacement, price retraces into the imbalance and then rejects back below the midpoint, the script may mark a bearish reclaim context.
🧱 System Philosophy
Fair Value Gap Reclaim Planner follows the AG Pro Series approach: turn a popular market concept into a structured decision map with context, score, risk reference, and clean visuals.
It is designed to support judgment, not replace it.
🔐 Non-Promise Statement
No script can provide certainty.
No signal should be treated as guaranteed.
Outputs should always be interpreted with independent analysis and responsible risk control.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly.
Users are responsible for their own decisions, risk management, and trade execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
This script is designed to help traders study how fair value gap fills, midpoint reclaims, and imbalance reactions behave across different market conditions.
🧠 Core Idea
Has price returned into a fair value gap and reclaimed the imbalance midpoint with enough quality?
📌 Overview / What it does
Fair Value Gap Reclaim Planner is an imbalance-focused price action tool built around three-candle fair value gap structure.
The script detects bullish and bearish FVG zones, tracks fill progress, maps the midpoint, evaluates reclaim quality, and displays a structured 0-100 readiness score. It also projects an active reclaim corridor, invalidation shelf, target rails, labels, and a clean AG Pro dashboard.
It does not predict future price movement, automate entries, or provide guaranteed signals. It is a visual framework for reading fair value gap reclaim behavior.
🎯 Purpose & Design Philosophy
This script was built for traders who study imbalance zones but want a cleaner way to separate meaningful reclaim behavior from ordinary gap interaction.
Fair value gaps can attract attention, but not every touch matters. The planner focuses on whether price fills, reacts, and reclaims a meaningful reference level inside the imbalance.
The design supports patient analysis: identify the zone, measure the fill, wait for reclaim, then evaluate context.
⚡ Why This Script Is Different
Most FVG tools highlight many imbalance zones and leave the user to interpret the rest manually.
This script does NOT flood the chart with every historical imbalance.
Instead, it focuses on the active FVG context, tracks fill progress, evaluates midpoint or full-edge reclaim, and converts the reaction into a clear score and action state.
⚙️ Methodology
1. Context Detection
The script detects bullish and bearish three-candle fair value gaps using a minimum ATR-based size filter.
2. Reference Mapping
It maps the FVG top, bottom, midpoint, fill area, and invalidation boundary.
3. Reaction Evaluation
When price interacts with the active FVG, the script evaluates fill progress, reclaim distance, wick response, body quality, relative volume, gap quality, and freshness.
4. Visual Output
Qualified reclaim events are shown with labels, projected zones, target rails, right-side level tags, and a compact panel.
🗺️ How to Read the Chart
FVG Zone shows the active imbalance area.
Midline marks the primary reclaim reference when Midline mode is selected.
Fill Progress shows how deeply price has returned into the imbalance.
READY FVG RECLAIM labels mark reclaim events that meet the selected score threshold.
Invalidation Shelf marks the area where the reclaim context weakens or fails.
The AG Pro panel summarizes Gap State, Reclaim Score, Fill Progress, Risk, and Action.
🚦 Signals & States
• BULL FVG → bullish fair value gap detected and locked.
• BEAR FVG → bearish fair value gap detected and locked.
• READY FVG RECLAIM → price reclaimed the selected FVG reference with enough quality.
• FVG TOUCH → price interacted with the active FVG zone.
• INVALIDATED → the active reclaim context lost the opposite FVG edge.
• READY → a qualified reclaim event is active.
• MONITOR → the active FVG is being tested or a reclaim context remains open.
• WAIT → no qualified reclaim event is active.
🔔 Alerts Logic
Bullish FVG Reclaim Ready triggers when price reclaims the selected FVG reference upward with enough score quality.
Bearish FVG Reclaim Ready triggers when price reclaims the selected FVG reference downward with enough score quality.
FVG Touch triggers when price interacts with the active imbalance zone.
FVG Reclaim Invalidated triggers when the active reclaim context loses the opposite FVG edge.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest reclaim contexts appear when fill progress, wick response, close quality, relative volume, gap size, and freshness align.
When price returns into the imbalance, respects the zone, and reclaims the midpoint or edge with clean reaction quality, the score improves.
📊 When to Use
• Markets with visible imbalance behavior
• Breakout pullbacks into fair value gaps
• Trend continuation reviews
• Reclaim attempts after partial FVG fills
• Intraday or swing contexts where FVG zones remain meaningful
⚠️ When NOT to Use
• Very low liquidity markets
• Extremely noisy or illiquid symbols
• Markets with unreliable candles or volume
• Wide-spread conditions where small gaps are misleading
• News spikes where imbalance zones can be invalidated quickly
🎛️ Key Inputs
• Minimum FVG Size ATR → filters out tiny imbalance zones.
• Maximum FVG Age Bars → controls how long an FVG can remain active.
• Reclaim Reference → chooses midpoint reclaim or full-edge reclaim.
• Touch Lookback Bars → controls how recent the FVG interaction must be.
• Invalidation Buffer ATR → controls the risk shelf beyond the FVG edge.
• Minimum Ready Score → sets how strict READY events should be.
• Target Rails → control projected T1 and T2 levels.
• Label Settings → control label density, size, and spacing.
• Panel Settings → control panel visibility, location, theme, and font size.
🖥️ Interface & Visual Design
The interface is designed to show the active imbalance context without filling the chart with excessive historical zones.
The FVG zone, midline, fill meter, invalidation shelf, target rails, and panel are visually separated so the chart remains readable.
The goal is a premium first-glance layout: zone first, reclaim second, action state third.
🧪 Practical Usage Workflow
1. Check the panel for active Gap State.
2. Locate the FVG zone and midpoint.
3. Watch how deeply price fills the imbalance.
4. Evaluate READY FVG RECLAIM labels and score quality.
5. Compare price with the invalidation shelf and target rails.
6. Confirm broader structure before making decisions.
🔍 Interpretation Guidelines
A high reclaim score means the reaction is cleaner according to the script's rules.
A lower score means the reclaim may be weaker, late, noisy, or incomplete.
Fill progress is not a signal by itself. It becomes more meaningful when combined with reclaim quality and broader market context.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an automated trading system.
It does not guarantee entries, exits, profits, or outcomes.
⚠️ Limitations & Transparency
Fair value gap interpretation can vary across markets, sessions, and timeframes.
Some markets create many small gaps that may not carry meaningful context.
Volatility changes can make an active FVG less relevant over time.
No rule-based script can fully account for news, liquidity shocks, or sudden market structure shifts.
🧠 Market Context Notes
Fair value gaps often represent fast price displacement and temporary imbalance.
The reclaim of a midpoint or edge can help traders study whether the market is accepting or rejecting the imbalance area.
The script works best when combined with structure, liquidity, volatility, and trend context.
🧾 Use Case Examples
When a bullish FVG forms after displacement, price returns into the zone, partially fills it, and then reclaims the midpoint, the script may mark a bullish reclaim context.
When a bearish FVG forms after downside displacement, price retraces into the imbalance and then rejects back below the midpoint, the script may mark a bearish reclaim context.
🧱 System Philosophy
Fair Value Gap Reclaim Planner follows the AG Pro Series approach: turn a popular market concept into a structured decision map with context, score, risk reference, and clean visuals.
It is designed to support judgment, not replace it.
🔐 Non-Promise Statement
No script can provide certainty.
No signal should be treated as guaranteed.
Outputs should always be interpreted with independent analysis and responsible risk control.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly.
Users are responsible for their own decisions, risk management, and trade execution.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
This script is designed to help traders study how fair value gap fills, midpoint reclaims, and imbalance reactions behave across different market conditions.
發行說明
UPDATE NOTES - V1.3This update focuses on 4H chart presentation, label spacing, and premium screenshot clarity.
The core purpose of the script remains unchanged.
This release improves how the existing FVG reclaim logic is presented on the chart, especially where multiple FVG events appear close together.
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
------------------------
• Shortened event label text.
FVG lock, touch, and ready labels now use more compact wording to reduce horizontal crowding around candles.
• Reduced default historical label count.
The script now keeps fewer historical event labels by default, creating a cleaner 4H and 1D chart presentation.
• Increased default label cooldown.
Repeated FVG event labels are paced more slowly by default to reduce clustering in active price areas.
• Shortened active FVG zone badge text.
The centered zone badge now omits empty score text when no score is available, keeping the active zone cleaner.
• Shortened compact right-side FVG tag text.
Compact zone tags now use a mid-level reference instead of a long top-to-bottom price range.
------------------------
Visual Improvements
------------------------
• Improved 4H chart readability by reducing label crowding.
• Refined active zone labeling for a more balanced premium look.
• Reduced overlap risk in clustered FVG areas.
• Preserved contrast-safe colored label boxes for dark and light chart themes.
------------------------
Interface & Usability
------------------------
• Existing visual controls remain available.
• Users can still increase historical label count manually if they prefer more chart markers.
• Invalidated labels remain optional and disabled by default.
• The AG Pro panel format and merged blue header remain unchanged.
------------------------
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 - 1.4This update adds a live proof statistic, contrast-safe label text, and safer
volatility handling to the Fair Value Gap Reclaim Planner. The FVG detection,
reclaim scoring, risk shelf and target logic remain unchanged. This script
continues to function as an analytical decision tool. It does not predict price
direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
- Reclaim Hit Rate (Proof Layer)
The dashboard now tracks how often a qualified reclaim reaches a balanced
one-risk target before its own invalidation line. Wins and losses are counted
only on confirmed bars, and samples that resolve neither inside the proof window
are left unresolved and uncounted, so the statistic stays honest and does not
repaint.
- Contrast-Safe Label Text
A luminance helper now sets the text color for the zone badge, event labels,
right-side tags and the panel Action cell, so teal, pink, amber and indigo
elements stay clearly readable on dark and light charts.
- Safer Volatility Handling
ATR is now guarded against missing or zero values, and label spacing now uses an
ATR-based floor for more consistent tag placement across instruments.
- New Proof Window Setting
A Reclaim Proof Window input controls how many bars a qualified reclaim has to
resolve before its sample is left uncounted.
------------------------
Visual Improvements
------------------------
- Improved readability of the zone badge, event labels and right-side level tags
- Clearer panel Action cell across all states (Ready, Monitor, Wait, Invalidated)
- Kept the FVG zone, midline, fill meter, invalidation shelf and target rails intact
- No added chart clutter
------------------------
Interface & Usability
------------------------
- Added a Reclaim Hit Rate row to the dashboard panel
- Kept the existing Gap State, Reclaim Score, Fill Progress, Risk and Action rows
- Preserved all existing settings and defaults as backward compatible
- Enhanced overall experience without changing the core engine
------------------------
Behavior Notes
------------------------
This update does not change how FVGs are detected or how the reclaim score is
computed. The Reclaim Hit Rate is a descriptive, backward-looking statistic of
past qualified reclaims, not a forward prediction. 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 reclaims 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.
開源腳本
秉持TradingView一貫精神，這個腳本的創作者將其設為開源，以便交易者檢視並驗證其功能。向作者致敬！您可以免費使用此腳本，但請注意，重新發佈代碼需遵守我們的社群規範。
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
免責聲明
這些資訊和出版物並非旨在提供，也不構成TradingView提供或認可的任何形式的財務、投資、交易或其他類型的建議或推薦。請閱讀使用條款以了解更多資訊。
開源腳本
秉持TradingView一貫精神，這個腳本的創作者將其設為開源，以便交易者檢視並驗證其功能。向作者致敬！您可以免費使用此腳本，但請注意，重新發佈代碼需遵守我們的社群規範。
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
免責聲明
這些資訊和出版物並非旨在提供，也不構成TradingView提供或認可的任何形式的財務、投資、交易或其他類型的建議或推薦。請閱讀使用條款以了解更多資訊。