AG Pro Williams %R Exhaustion Map [AGPro Series]

4月5日

AG Pro Williams %R Exhaustion Map [AGPro Series]

Overview / What it does

AG Pro Williams %R Exhaustion Map is a bounded-oscillator reaction map built to study exhaustion behavior around the extreme ends of Williams %R. Instead of treating Williams %R as a simple overbought/oversold trigger, this script maps whether an extreme reading is only being touched briefly, held with persistence, beginning to release, failing to release, or unwinding with more structure. The goal is to organize extreme-zone behavior into readable states rather than reduce the tool to a basic reversal shortcut.

The script is designed for traders who want to understand when an extreme condition is still being sustained and when that same condition may be starting to lose efficiency. In practice, that means the script focuses less on isolated crossings and more on the sequence around them: entry into an extreme zone, time spent there, the first release attempt, the possibility of a failed release, and the confirmation of an exhaustion unwind. This sequence-based framing is what gives the tool its map identity.

Within the AG Pro series, this script is intentionally separate from tools that revolve around trend confirmation, centerline balance, divergence, or generic momentum shifts. It is also intentionally separate from the series' Stochastic-based exhaustion work. Stochastic can be useful for reading swing rhythm and rotational turns, while this Williams %R version is centered more tightly on bounded extreme persistence and release behavior. In other words, this script is not presented as an alternative skin for another oscillator. It is a different framework for reading how price behaves when an oscillator remains pinned near an edge and then attempts to escape that condition.

Unique Edge

The unique edge of this script is not that it plots Williams %R, but that it classifies the life cycle of an extreme reading. The script distinguishes between stretch, locked conditions, release attempts, failed releases, and exhaustion unwinds. That structure helps separate three situations that are often mixed together in standard oscillator use:

1) an extreme reading that is still being sustained,
2) an extreme reading that has started to weaken but may still fail, and
3) an extreme reading that is releasing with enough follow-through to qualify as an exhaustion unwind.

This matters because many standard oscillator workflows treat every exit from an extreme zone as if it carried the same informational value. This script does not. It places more emphasis on persistence, release quality, and post-release follow-through, which can help users avoid treating every early reversal attempt as equivalent.

Methodology

The script begins with Williams %R and user-defined extreme thresholds. From there, it evaluates how long the oscillator remains in the upper or lower extreme zone and how deeply it is embedded in that zone. This forms the basis of the lock-strength logic. A fast touch into an extreme area and an extended embedded condition are therefore not interpreted in the same way.

Once an extreme condition has persisted long enough, the script begins monitoring for a release. A release is not defined as any random movement away from the boundary. It requires the prior extreme condition to have had sufficient persistence and then looks for a buffered move away from the threshold. This helps reduce noise from trivial fluctuations around the extreme lines.

After a release is detected, the script continues to track what happens next. If the oscillator quickly slips back into the same extreme region, the move can be classified as a failed release. If the move continues far enough away from the release anchor within the confirmation window, it can be classified as an exhaustion unwind. This post-release tracking is a central part of the script's design because it helps distinguish between temporary relief and more meaningful exhaustion release.

The panel summarizes this process using state, side, lock strength, and release quality. Lock strength is intended to reflect how established the prior extreme condition was. Release quality is intended to reflect the quality of the release sequence, not forecast what price must do next. These metrics are descriptive and contextual. They are not guarantees.

Signals & Alerts

This script provides event-style labels and alert conditions for the main transitions in the exhaustion sequence. The alerts are deterministic and tied to explicit script conditions rather than discretionary interpretation.

Main event types:
- Bullish release detected
- Bearish release detected
- Bullish release failed
- Bearish release failed
- Bull exhaustion unwind confirmed
- Bear exhaustion unwind confirmed

How to interpret them:
- A release event marks the first qualified move away from a persistent extreme condition.
- A failed release marks a release attempt that reverted back into the prior extreme condition too quickly.
- An exhaustion unwind confirmation marks a release that traveled far enough from its anchor within the configured window to qualify as a more established unwind sequence.

These events are intended to help structure chart reading. They are not standalone trade instructions, and they are not framed as guaranteed reversal signals.

Key Inputs

Williams %R Length
Controls the oscillator lookback period.

Upper Extreme / Lower Extreme
Define the zones used to classify upper and lower exhaustion behavior.

Lock Bars
Controls how much persistence is required before an extreme condition is treated as locked rather than only stretched.

Release Buffer
Adds distance beyond the raw threshold so the script does not treat every minor edge fluctuation as a release.

Confirm Distance / Confirm Window
Control how far and how quickly a release must extend to qualify as an exhaustion unwind.

Fail Window
Controls how quickly a release can revert back into the extreme zone and still be classified as a failed release.

Event Memory Bars
Controls how long the release state is remembered on the chart.

Visual Settings
Allow users to control event labels, minimum spacing between labels, background tint, and optional price-bar coloring.

Panel Settings
Allow users to control panel visibility, placement, font size, and theme.

How this differs from related AG Pro scripts

This script should not be confused with the series' other momentum or exhaustion tools.

Compared with Stochastic-based exhaustion work in the AG Pro series, this script is less about oscillator rhythm and more about the persistence and release structure of a bounded extreme condition. The emphasis here is on whether Williams %R remains pinned, whether the first escape attempt fails, and whether the unwind becomes established.

Compared with RSI-, CCI-, or MFI-oriented workflows, this script is not a centerline trend model, not a divergence engine, and not a money-flow proxy. Its purpose is narrower and more specific: to map the state transition of extreme Williams %R conditions.

Compared with broader trend or regime tools in the AG Pro series, this script is not trying to classify the full market environment by itself. It is better understood as a focused reaction map that can be used alongside a user's own structure, trend, or risk framework.

Limitations & Transparency

This is an indicator, not a strategy. It does not place orders, it does not calculate performance statistics, and it does not claim to predict future price direction. It visualizes oscillator-state transitions derived from Williams %R and user-defined thresholds.

Like all bounded oscillators, Williams %R can remain in extreme territory for extended periods during strong directional conditions. For that reason, an extreme reading should not automatically be interpreted as a reversal condition. This script attempts to improve that interpretation by separating stretch, lock, release, failed release, and unwind behavior, but it does not eliminate false positives.

Results can vary meaningfully with symbol, timeframe, volatility regime, and input configuration. Traders should expect the script to behave differently on very quiet markets, strongly trending markets, and highly reactive instruments. Label frequency and state persistence can also change materially when thresholds and confirmation settings are adjusted.

This tool is intended to support chart organization and decision framing. It should be used with the user's own market structure analysis, execution model, and risk management process.

Risk Disclosure

This script is provided for educational and analytical purposes only. It is not financial advice, not a solicitation, and not a promise of results. Trading and investing involve risk, including the risk of loss. No indicator can remove uncertainty from markets, and no exhaustion signal guarantees reversal, continuation, or trade success.

Users should validate any workflow with their own testing, judgment, and risk controls before using it in live decision-making.

4月13日

發行說明

Update Notes - V2.0

This update refines the script’s visual structure and improves the readability of its exhaustion-release workflow.

What changed in this update:

- Reworked the panel layout to match the current AG Pro standard.
- Converted the top panel row into a single merged header with a clean blue background.
- Improved panel hierarchy and readability for state, bias, lock strength, release quality, and current Williams %R value.
- Set the default panel font size to Small for a cleaner and more compact presentation.
- Kept label sizing at a balanced default for better visibility without unnecessary clutter.
- Refined the release workflow with an additional impulse filter to make release events more selective.
- Improved event marker handling and corrected plotting behavior for more stable on-chart rendering.
- Maintained the core Williams %R exhaustion framework while improving clarity in release, failure, and unwind transitions.
- Preserved alert coverage for release, failed release, and confirmed exhaustion unwind events.

Notes:
- This script is designed for analytical and informational use only.
- It highlights exhaustion behavior, release behavior, and follow-through structure within the Williams %R framework.
- It does not predict outcomes and should be used together with broader market context, price structure, and risk management.

Risk Disclosure:
This script does not provide financial advice, trading advice, or guaranteed outcomes. All trading and investment decisions remain the sole responsibility of the user.

4月23日

發行說明

Update Notes - V2.1

- Removed the leading `AG Pro` prefix from the public script title and kept the AG Pro branding inside the panel header only.
- Reworked the source header and public naming so the script now aligns with the current AGPro Series publication standard.
- Added professional English tooltips across every input for a cleaner public-release experience.
- Introduced `Release Corridors`, a new Williams %R-native visual layer that projects the active unwind objective directly inside the oscillator pane.
- Reframed the workflow terminology around `Upper` and `Lower` exhaustion states to make the sequence easier to read and less directional by default.
- Tightened label handling with spacing control and a retained-label cap so the chart stays premium instead of crowded.
- Added a live right-edge state tag to surface the current regime and quality score without forcing more panel weight.
- Rebuilt the panel around the current AG Pro standard with a single merged blue header row and cleaner metric hierarchy.
- Set both panel font size and label size defaults to `Normal` for stronger readability out of the box.
- Preserved the core Williams %R exhaustion engine while improving visual hierarchy, release tracking clarity, and publish-facing polish.

What this update is meant to improve

This release is built to make the script more visually memorable and more immediately readable without drifting into another AG Pro concept family.
It stays focused on Williams %R exhaustion persistence, release behavior, failed release behavior, and confirmed unwind development.
It is not being reframed into a stochastic model, a generic momentum oscillator, a support and resistance tool, or a volume-pressure map.

Why the new corridor layer matters

The new corridor boxes give each qualified release a visible objective window.
Instead of only seeing that a release occurred, the user can now read how far the oscillator needs to travel, how long the window remains active, and whether that sequence resolves cleanly or fails early.
That makes the script feel less like a raw threshold trigger and more like a structured exhaustion workflow.

前天

發行說明

UPDATE NOTES - v2.2

This update focuses on decision clarity and panel usability.

The core purpose of the script remains unchanged.
This release improves how the existing exhaustion, release, failure, and unwind
logic 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
------------------------

- Next Action readout
The summary panel now leads with a plain-language Next Action line that
translates the current exhaustion state and side into a single suggested
response (for example Watch Short - Upper Locked, Follow Long - Lower Release,
Hold Short - Unwind Confirmed, Avoid Longs - Release Failed, or Stand Aside -
No Extreme). It turns the existing state, lock, and release-quality readings
into one clear at-a-glance read instead of leaving the reader to combine the
rows manually.

- Mean-reversion decision ladder
The action wording follows the exhaustion workflow: a persisting extreme reads
as Watch, a fresh release reads as Follow, a confirmed unwind reads as Hold,
and a failed release reads as Avoid the faded direction. This keeps the
guidance honest about whether the reversion is only setting up, actually
working, or has already failed.

- Adaptive panel contrast
The Next Action cell uses a luminance-aware text color so it stays crisp and
readable across all panel themes.


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

- Improved first-glance interpretation by surfacing the most actionable
information at the very top of the panel.

- Refined visual hierarchy so the suggested response stands out clearly above
the supporting exhaustion diagnostics.

- Kept the release corridors, state tag, markers, and event labels at their
existing balanced settings to preserve a premium, uncluttered pane.


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

- Optimized panel layout for clearer information flow from action to context.

- Improved label readability inside the panel across all themes.

- Enhanced overall user experience without changing core logic.


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

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

The Williams %R engine, extreme locking, release detection, failure and unwind
confirmation, and release corridors behave exactly as before. The Next Action
line is a readability layer built directly on top of those existing outputs.

Users should interpret outputs the same way as before, now with a clearer
summary of the current exhaustion context.


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

The script remains a rule-based analytical tool.

Market conditions such as volatility, liquidity, and timeframe differences may
affect how extremes, releases, and unwinds 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.