OPEN-SOURCE SCRIPT
Diupdate

Wick Absorption Reversal Planner [AGPro Series]

1 481
Wick Absorption Reversal Planner [AGPro Series]

🧠 Core Idea

Is an extended wick showing absorption, and did the candle body reclaim enough structure to treat the reversal context seriously?


📌 Overview / What it does

Wick Absorption Reversal Planner [AGPro Series] maps extended wick reactions as absorption pockets and evaluates whether price can reclaim the body rail after that reaction.

The script displays a wick absorption pocket, body reclaim rail, failure shelf, room reference, event labels, right-side tags, optional bar coloring, and a compact AG Pro dashboard with a 0-100 reversal score.

It does not predict reversals. It helps organize wick absorption, body reclaim quality, pressure, room, invalidation, and action state.


🎯 Purpose & Design Philosophy

Many candle tools label rejection candles, engulfing candles, or generic wick events.

This script was built for the next layer: whether the wick reaction is being absorbed and whether the candle body can reclaim the important zone afterward.

It helps traders separate random wick noise from a structured absorption pocket with a body reclaim rail and failure logic.


⚡ Why This Script Is Different

Most wick indicators focus on the wick itself.

This script does NOT treat every long wick as a reversal signal.

Instead, it maps the wick pocket, checks body reclaim, measures pressure and room, and gives a clear action state. The goal is interpretation, not prediction.


⚙️ Methodology

1. Wick Absorption Detection

The script checks upper and lower wick size relative to ATR and total candle range.

2. Context Mapping

The wick is compared with recent structure to avoid treating every isolated candle as meaningful.

3. Body Reclaim Evaluation

After a wick absorption pocket is detected, the body reclaim rail becomes the key threshold for reversal planning.

4. Visual Output

The chart receives the wick pocket, body reclaim rail, failure shelf, room rail, labels, right-side tags, optional bar coloring, and dashboard panel.


🗺️ How to Read the Chart

The wick absorption pocket marks the area created by the extended wick reaction.

The body reclaim rail shows the level price needs to recover for the reversal context to improve.

The failure shelf marks where the absorption context fails.

The room rail marks the nearest structure reference in the reversal direction.

Labels highlight wick absorption, body reclaim, pocket pressure, room tests, and absorption failure.

Colors represent context:

• Teal → bullish wick absorption

• Pink → bearish wick absorption or failure

• Gold → room reference or waiting context

• Indigo → pocket pressure or monitoring context

The panel summarizes:

• Pocket

• Reversal Score

• Pressure

• Room

• Action


🚦 Signals & States

• Bull Wick Absorption → lower wick absorption pocket detected

• Bear Wick Absorption → upper wick absorption pocket detected

• Body Reclaim → price reclaimed the body rail after absorption

• Pocket Pressure → price is testing the wick pocket without clean reclaim

• Room Test → price reached the active room reference

• Absorption Failed → price crossed the failure shelf

• READY → body reclaim and score quality are strong enough to monitor

• MONITOR → pocket or reclaim context is active but not fully ready

• WAIT → no strong active context exists

• INVALIDATED → the wick absorption context failed

• EXPIRED → the pocket is too old to remain active


🔔 Alerts Logic

Alerts can trigger when a bullish or bearish wick absorption pocket appears, when body reclaim appears, when READY state appears, when pocket pressure appears, when the room rail is reached, or when absorption fails.

Alerts are attention markers only. They are not trade instructions.


🧩 Confluence Logic

The context becomes stronger when wick size, wick-to-range ratio, structural location, participation, body reclaim, and room align.

For example, a lower wick into recent structure followed by body reclaim and available room is more useful than a random wick in the middle of noisy price action.


📊 When to Use

• Reversal watch areas after extended wicks

• Support/resistance reactions with visible rejection

• Pullbacks where wick absorption may matter

• Failed breakdown or failed breakout reactions

• Liquid symbols with readable candles and stable spreads

• 1h, 4h, and 1D charts where wick structure is visible


⚠️ When NOT to Use

• Very low-liquidity markets

• Symbols with unreliable candle structure

• Random spike candles from illiquid prints

• News candles with unstable spreads

• Extremely noisy ranges where every candle has exaggerated wicks


🎛️ Key Inputs

• ATR Length → controls normalization for wick size and visual spacing

• Wick Context Lookback → controls structural comparison

• Minimum Wick ATR → controls required wick size

• Minimum Wick / Range → controls required wick dominance inside the candle

• Minimum Relative Volume → filters very thin wick reactions

• Body Reclaim Buffer ATR → controls the reclaim rail threshold

• Failure Buffer ATR → controls where absorption fails

• Room Lookback → controls the room reference

• Visual settings → control pocket, rails, labels, tags, panel, and bar colors


🖥️ Interface & Visual Design

The visual hierarchy is designed around the wick pocket first, then the reclaim rail.

The pocket defines the reaction, the body reclaim rail defines improvement, the failure shelf defines risk, and the panel gives a quick state read.

The goal is a premium wick absorption map without turning the chart into a generic candle-label board.


🧪 Practical Usage Workflow

1. Check whether a wick absorption pocket is active

2. Read the reversal score and action state

3. Inspect the body reclaim rail

4. Compare pocket pressure with room

5. Watch the failure shelf

6. Confirm the context with broader structure and timeframe alignment


🔍 Interpretation Guidelines

A wick absorption pocket means the candle showed a meaningful wick reaction in context.

Body reclaim means price recovered the reclaim rail after the wick reaction.

READY means the rule-based context has enough quality to monitor.

Room is a reference for structure, not a promised target.


🚫 What This Script Is NOT

This script is not a prediction engine.

It is not a guaranteed reversal system.

It is not a generic candle pattern detector.

It is not a volume absorption zone engine.

It is not an automated trading tool.

It does not provide financial advice.

It does not guarantee reversal, continuation, profit, or a specific target.


⚠️ Limitations & Transparency

Wick behavior depends on market structure, liquidity, volatility, session conditions, and timeframe.

Some long wicks are random noise.

Some absorption pockets may fail quickly.

The score is a rule-based context score, not a certainty model.


🧠 Market Context Notes

Wicks can show rejection, absorption, stop activity, or simply noise.

The key question is whether price can reclaim the body rail after the wick event.

Use the pocket as context, not as confirmation by itself.


🧾 Use Case Examples

When price prints a long lower wick into recent structure, the script can map a bullish wick absorption pocket.

If price later reclaims the body rail, the script marks body reclaim and updates the panel state.

If price loses the failure shelf, the script marks absorption failure.


🧱 System Philosophy

This script follows the AGPro Series approach: turn a familiar chart behavior into a structured decision-support map.

The focus is not prediction. The focus is wick context, body reclaim, pressure, room, invalidation awareness, and visual clarity.


🔐 Non-Promise Statement

No script can remove uncertainty from markets.

This tool does not promise accuracy, profitability, or future price movement.

Its purpose is to organize wick absorption context so the user can interpret the chart more clearly.


📉 Risk Disclosure

Trading involves risk.

Market conditions can change quickly, and any analytical output can fail.

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

Do not read a wick by itself.

The strongest reads usually come when wick absorption, body reclaim, structure, participation, and room align.
Catatan Rilis
UPDATE NOTES - V1.1

This update focuses on light-chart readability, compact labels, pocket-label structure, and publication-ready visual consistency.

The core purpose of the script remains unchanged.
This release improves how wick absorption pockets, body reclaim events, room references, and invalidation 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
------------------------

• Replaced pocket box text with a centered colored badge.
The wick absorption pocket now uses a contrast-safe badge label instead of transparent box text, improving readability on both dark and light chart themes.

• Converted event labels to single-line premium labels.
Absorption, body reclaim, pressure, room test, and invalidation labels now use compact one-line wording.

• Improved light panel compatibility.
The panel theme option now uses a true Light mode with light backgrounds and dark readable text.

• Reduced default label clutter.
Invalidation labels are now disabled by default, maximum retained labels were reduced, and cooldown was slightly increased.

• Moved labels farther from candles.
The default label offset was increased to reduce overlap with candle bodies and wicks.


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

• Improved light-chart readability by removing naked pocket text from transparent box fill.

• Added a colored centered badge for active wick absorption pockets.

• Reduced vertical label footprint with single-line labels.

• Preserved premium colored event-label boxes.


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

• Label Font Size continues to control chart labels, right-side tags, and the pocket badge.

• Users can still enable invalidation labels manually.

• Existing right-side tag controls remain available.

• 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, wick size, 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.
Catatan Rilis
🔧 UPDATE NOTES - v1.2

This update focuses on readability and decision transparency.

The core purpose of the script remains unchanged.
This release hardens label contrast, separates clustered labels, and adds an
honest follow-through statistic so the strength of body reclaims is easier to
judge at a glance.

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
------------------------

• Stop-Aware Room-Reach Rate
A new "Room Rate" panel row reports how often a body reclaim went on to reach
the room rail before the failure shelf was crossed. A win means the room rail
was reached first and a loss means the failure shelf was crossed first, which
reuses the planner's own room and failure levels, now measured across history.
Reclaims that resolve neither way inside the pocket window are left uncounted,
and the row shows the sample size and reads "Building" until enough reclaims
have completed. This adds context to the live reversal score without changing
how the score or any state is calculated.

• Hardened Label Contrast
Every absorption, reclaim, pressure, room, and invalidation label, the centered
pocket badge, the right-side tags, and the panel score and action cells now
select their text color from the brightness of their own background, so
bullish, bearish, neutral, and accent elements stay legible. This corrects light
text that previously sat on light bearish and neutral fills.

• Overlap-Free Event Labels
Absorption, reclaim, pressure, room, and invalidation labels are now separated
by a vertical anti-collision pass, so clustered events no longer stack their
labels on top of one another.


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

• Improved chart readability by hardening label, badge, and tag contrast

• Reduced visual clutter by separating clustered event labels

• Refined visual hierarchy so absorption and reclaim events stand out clearly

• Preserved the existing pocket, rail, shelf, room, and tag layout


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

• Optimized panel layout with a new room follow-through row

• Improved label readability for better chart interaction

• Adjusted default visual presentation for a more balanced appearance

• Enhanced overall user experience without changing core logic


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

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

The wick absorption detection, pocket, reclaim, scoring, room, and failure logic
behave the same as before. The Room Rate is an observational statistic only.

Users should interpret outputs the same way as before, but with improved visual
structure and added 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 absorption pockets, reclaims, and the room rate appear.

The room rate is a historical observation on the current chart and does not
predict future reclaims. 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.

Pernyataan Penyangkalan

Informasi dan publikasi ini tidak dimaksudkan, dan bukan merupakan, saran atau rekomendasi keuangan, investasi, trading, atau jenis lainnya yang diberikan atau didukung oleh TradingView. Baca selengkapnya di Ketentuan Penggunaan.