Range Oscillator (Zeiierman)

█ Overview
Range Oscillator (Zeiierman) is a dynamic market oscillator designed to visualize how far the price is trading relative to its equilibrium range. Instead of relying on traditional overbought/oversold thresholds, it uses adaptive range detection and heatmap coloring to reveal where price is trading within a volatility-adjusted band.

The oscillator maps market movement as a heat zone, highlighting when the price approaches the upper or lower range boundaries and signaling potential breakout or mean-reversion conditions.

Highlights

• Adaptive range detection based on ATR and weighted price movement.
  
• Heatmap-driven coloring that visualizes volatility pressure and directional bias.
  
• Clear transition zones for detecting trend shifts and equilibrium points.
  

█ How It Works

⚪ Range Detection
The indicator identifies a dynamic price range using two main parameters:

• Minimum Range Length: The number of bars required to confirm that a valid range exists.
  
• Range Width Multiplier: Expands or contracts the detected range proportionally to the ATR (Average True Range).
  

This approach ensures that the oscillator automatically adapts to both trending and ranging markets without manual recalibration.

⚪ Weighted Mean Calculation
Instead of a simple moving average, the script calculates a weighted equilibrium mean based on the size of consecutive candle movements:

• Larger price changes are given greater weight, emphasizing recent volatility.
  

⚪ Oscillator Formula
Once the range and equilibrium mean are defined, the oscillator computes:

Osc = 100 * (Close - Mean) / RangeATR

This normalizes price distance relative to the dynamic range size — producing consistent readings across volatile and quiet periods.

█ Heatmap Logic

The Range Oscillator includes a built-in heatmap engine that color-codes each oscillator value based on recent price interaction intensity:

• Strong Bullish Zones: Bright green — price faces little resistance upward.
  
• Weak Bullish Zones: Muted green — uptrend continuation but with minor hesitation.
  
• Transition Zones: Blue — areas of uncertainty or trend shift.
  
• Weak Bearish Zones: Maroon — downtrend pressure but soft momentum.
  
• Strong Bearish Zones: Bright red — strong downside continuation with low resistance.
  

Each color band adapts dynamically using:

• Number of Heat Levels: Controls granularity of the heatmap.
  
• Minimum Touches per Level: Defines how reactive or “sensitive” each color zone is.
  

█ How to Use

⚪ Trend & Momentum Confirmation
When the oscillator stays above +0 with green coloring, it suggests sustained bullish pressure.

Similarly, readings below –0 with red coloring, it suggests sustained bearish pressure.

⚪ Range Breakouts
When the oscillator line breaks above +100 or below –100, the price is exceeding its normal volatility range, often signaling breakout potential or exhaustion extremes.

⚪ Mean Reversion Trades
Look for the oscillator to cross back toward zero after reaching an extreme. These transitions (often marked by blue tones) can identify early reversals or range resets.

⚪ Divergence
Use oscillator peaks and troughs relative to price action to spot hidden strength or weakness before the next move.


█ Settings

• Minimum Range Length: Number of bars needed to confirm a valid range.
  
• Range Width Multiplier: Expands or contracts range width based on ATR.
  
• Number of Heat Levels: Number of gradient bands used in the oscillator.
  
• Minimum Touches per Level: Sensitivity threshold for when a zone becomes “hot.”
  

-----------------
Disclaimer

The content provided in my scripts, indicators, ideas, algorithms, and systems is for educational and informational purposes only. It does not constitute financial advice, investment recommendations, or a solicitation to buy or sell any financial instruments. I will not accept liability for any loss or damage, including without limitation any loss of profit, which may arise directly or indirectly from the use of or reliance on such information.

All investments involve risk, and the past performance of a security, industry, sector, market, financial product, trading strategy, backtest, or individual's trading does not guarantee future results or returns. Investors are fully responsible for any investment decisions they make. Such decisions should be based solely on an evaluation of their financial circumstances, investment objectives, risk tolerance, and liquidity needs.