OPEN-SOURCE SCRIPT
Williams %R Ribbon

Williams %R Ribbon
Most traders know Williams %R as a classic overbought/oversold oscillator. Unfortunately, many stop there.
The Williams %R Ribbon reimagines this well-known indicator into a modern visualization designed to make momentum, trend transitions, and market extension easier to read at a glance. Instead of focusing solely on fixed overbought and oversold levels, this indicator emphasizes the relationship between Williams %R and its signal line, transforming that relationship into an intuitive gradient ribbon that helps reveal changes in market structure before they become obvious.
Features
Momentum Ribbon
The traditional Williams %R line is transformed into a dynamic ribbon that expands, contracts, and changes color based on the relationship between Williams %R and its signal line.
- Bullish momentum is displayed with a green ribbon.
- Bearish momentum is displayed with a red ribbon.
- Neutral conditions automatically fade to gray when momentum becomes indecisive.
The ribbon allows traders to recognize momentum shifts without constantly watching for line crossovers.
Multi-Timeframe Analysis
Analyze higher timeframe Williams %R values directly on lower timeframe charts.
Choose from:
- Chart Timeframe
- 2× Chart Timeframe
- 4× Chart Timeframe
- Manual Timeframe Selection
This makes it possible to monitor higher-timeframe momentum while executing trades on lower timeframes without adding multiple indicators to the chart.
Optional Display Smoothing
The ribbon includes display-only smoothing designed to reduce visual stair-stepping that naturally occurs when displaying higher timeframe calculations on lower timeframe charts.
Importantly:
- Indicator calculations remain unchanged.
- Signal generation remains unchanged.
- Alerts continue using the original data.
Only the visual appearance of the ribbon is smoothed.
Extension Grade
Instead of simply identifying whether Williams %R is overbought or oversold, the indicator continuously classifies the current level into extension categories such as:
- Moderately Extended
- Extended
- Very Extended
- Extremely Extended
This provides additional context regarding how far price has stretched relative to its recent trading range.
Flexible Display Modes
Choose the visualization that best fits your trading style.
Available display modes include:
- Ribbon
- Signal Line Only
- Solid Signal Line Only
- Ribbon + Signal Line
Whether you prefer a clean minimalist chart or a full ribbon visualization, the indicator adapts to your workflow.
Dynamic Coloring
The ribbon automatically adjusts its colors based on current market conditions.
Strong bullish momentum receives brighter bullish colors.
Strong bearish momentum receives brighter bearish colors.
Neutral conditions fade naturally, helping reduce visual noise during consolidation.
Built-In Alerts
Alerts are included for:
- Bullish ribbon crosses
- Bearish ribbon crosses
- Oversold exits
- Overbought exits
- All Extension Grade thresholds
Because alerts use the original unsmoothed Williams %R values, visual smoothing never delays signal generation.
Designed for Clarity
Many oscillators overwhelm traders with unnecessary visual clutter.
The goal of this indicator is the opposite.
Every design decision was made with one objective:
Help traders understand what the oscillator is communicating as quickly as possible.
The gradient ribbon allows momentum, trend direction, and market extension to be interpreted almost instantly while maintaining the familiar foundation of the classic Williams %R.
Best Used For
- Trend confirmation
- Multi-timeframe analysis
- Momentum analysis
- Mean reversion strategies
- Swing trading
- Identifying overextended markets
- Building rule-based trading systems
Disclaimer
This indicator is provided for educational and informational purposes only. It does not constitute financial, investment, legal, or tax advice and should not be considered a recommendation to buy or sell any financial instrument.
No indicator can predict future market movements or guarantee profitable results. Market conditions change continuously, and all trading involves risk, including the potential loss of all invested capital.
Past performance does not guarantee future results. Always perform your own analysis, practice sound risk management, and consult a qualified financial professional if you require investment advice.
Open-source script
In true PulseWire spirit, the creator of this script has made it open-source, so that traders can review and verify its functionality. Kudos to the author! While you can use it for free, remember that republishing the code is subject to our House Rules.
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by PulseWire. Read more in the Terms of Use.
Open-source script
In true PulseWire spirit, the creator of this script has made it open-source, so that traders can review and verify its functionality. Kudos to the author! While you can use it for free, remember that republishing the code is subject to our House Rules.
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by PulseWire. Read more in the Terms of Use.
