ProIndicatr Pro: 4 Pro indicators
indicator.trading
All scripts

Free Β· Open source

Volatility Bands Pro-Read

Bollinger, Keltner or Donchian – and the answer to whether a touch of the band means trend strength or a likely return.

Type
Volatility bands + band analysis
Replaces
Bollinger Β· Keltner Β· Donchian
Recommended
Daily chart, 4h
Price
Free, open source
Open chart on TradingView
Volatility Bands Pro-Read on the S&P 500 ETF SPY on the daily chart with green and red band walks, gray band, squeeze dots, triangles and mean-reversion crosses
Volatility Bands Pro-Read on the S&P 500 ETF SPY on the daily chart with green and red band walks, gray band, squeeze dots, triangles and mean-reversion crosses

Volatility Bands Pro-Read draws Bollinger Bands, Keltner Channels or Donchian Channels and reads how price behaves at the band for you: is price walking along the band in a trend (band walk), returning into the band without a trend (mean-reversion candidate), or is volatility contracting (squeeze)? The bands change color with the state, and small markers highlight the important moments – for long and short. This page explains every feature – and above all, what you do with it and why.

Overview

At a glance

What does it do?

It colors the bands green or red when price walks along the band in a trend, marks the return into the band when there is no trend, and shows when volatility contracts.

What do I do with it?

You decide which reading applies right now: in a colored band walk you trade with the trend, in the gray band you watch for the return to the middle, in a squeeze you prepare for a move.

Why?

The most common Bollinger mistake is β€œupper band touched = sell”. In a strong trend, though, price often walks along the band for a long time – and anyone trading against it is on the wrong side.

What do I get?

You stop reading the same band by gut feeling and read it by the state of the market instead – and you avoid trades against a running trend.

On your chart in 3 minutes

Quickstart

  1. 01

    Open the script page

    The button at the top of this page takes you to the script page on TradingView. The script is free and open source – you can read the code there too.

  2. 02

    Add it to your favorites

    On the script page, click Add to favorites (the star icon).

  3. 03

    Add it to your chart

    At the top of the chart, click Indicators, choose Favorites on the left and click Volatility Bands Pro-Read. Alternatively, search for β€œIndicatr” in the same window.

  4. 04

    Pick a market and timeframe

    Start with a liquid market such as the S&P 500 (SPY), gold or a large-cap stock on the daily chart or on 4h. The defaults (Bollinger 20, 2) are the classic values – only change something once you understand what it does.

The chart explained

What you see on the chart

S&P 500 (SPY), daily chart, Bollinger Bands (20, 2). The numbers belong to the list below.Open chart on TradingView
All elements of Volatility Bands Pro-Read on the chart, numbered
All elements of Volatility Bands Pro-Read on the chart, numbered
  1. 1Band walk up Green bands and green fill: a trend, price keeps closing near the upper edge.
  2. 2Band walk down Red bands and red fill: a downtrend along the lower edge.
  3. 3Neutral band Gray: no band walk. The thin line in the middle is the basis.
  4. 4Squeeze Gray dots at the bottom of the chart: volatility has contracted.
  5. 5Squeeze release Triangle: the squeeze ends above (β–²) or below (β–Ό) the basis.
  6. 6Mean-reversion candidate Small cross: without a trend, price closes back inside the band.

Elements 1 and 2

Band walk: when the band is not a reversal signal

In a strong trend, price keeps closing near the outer band. That’s exactly when the script colors the bands and fill green (up) or red (down).

What does it do?

It checks whether several of the latest closes sit in the outer part of the band – 3 of the last 5 by default – and whether ADX shows a trend at the same time. Only when both are true does it count as a band walk.

What do I do with it?

During a band walk you read touches of the outer band as strength, not as a reversal. In a green band you look for longs on pullbacks toward the basis, in a red band for shorts on bounces – and you don’t sell β€œbecause the upper band was reached”.

Why?

In a trend the band expands with price. A close at the edge then means buyers (or sellers) are strong enough to hold price there. Trading against that pressure is the classic Bollinger mistake.

What do I get?

You stay on the right side of strong trends for longer and save yourself expensive counter-trades at the edges.

Elements 3 and 6

Without a trend: mean-reversion candidates

When there’s no trend, the band behaves differently: excursions beyond the edge often don’t hold, and price swings back toward the middle.

SPY, daily chart, July to November 2026. After the green band walk in August the band turns gray. The red cross at the top marks a short candidate, the dark crosses at the bottom mark long candidates. The red triangles show squeezes that released to the downside.Open chart on TradingView
S&P 500 on the daily chart, July to November 2026: green band, then gray band with a red cross above a high and dark crosses below lows
S&P 500 on the daily chart, July to November 2026: green band, then gray band with a red cross above a high and dark crosses below lows

What does it do?

If ADX shows no trend and price closes back inside the band after closing outside it, the script places a small cross: above the candle for a short candidate (return from the upper band), below the candle for a long candidate (return from the lower band).

What do I do with it?

You use the cross as a hint that the excursion didn’t hold. An obvious target is the basis in the middle of the band; the stop goes beyond the extreme of the excursion.

Why?

Without a trend, the pressure that would keep price at the edge is missing. A close back inside the band shows that the excursion found no follow-through buying (or selling).

What do I get?

You only fade the edges when the market is really moving sideways – not in the middle of a trend.

Elements 4 and 5

Squeeze: when volatility contracts

Quiet phases don’t last forever. The squeeze shows you when the band has become unusually narrow – and when that tension releases.

SPY, daily chart, December 2025 to April 2026. During this period the Bollinger Bands repeatedly sat inside the Keltner Channel (squeeze dots at the bottom of the chart, see the large image above). Several releases up and down led nowhere – only in March does a red band walk down appear, followed by a green one up in April.Open chart on TradingView
S&P 500 on the daily chart, December 2025 to April 2026: green and red squeeze triangles in the gray band, then a red band walk down and a green band walk up
S&P 500 on the daily chart, December 2025 to April 2026: green and red squeeze triangles in the gray band, then a red band walk down and a green band walk up

What does it do?

When the Bollinger Bands sit inside the Keltner Channel, price swings are unusually small compared with normal candle size. Gray dots then appear at the bottom of the chart. When the squeeze ends, a triangle marks the release: β–² if price closes above the basis, β–Ό if below.

What do I do with it?

You use the squeeze as an early warning: mark levels, set an alert, plan for both directions. The triangle shows you which way the tension released first.

Why?

Volatility alternates between narrow and wide. Quiet phases are often followed by bigger moves. If you spot the narrow phase, you’re prepared instead of chasing the move.

What do I get?

You’re ready before the breakout and quickly see whether it turns into a band walk – or fizzles out.

In practice

How to work with the script

  1. 01

    Read the state

    One look at the color: green or red = band walk, gray = no band walk. Gray dots at the bottom = squeeze.

  2. 02

    Choose the reading

    During a band walk you only trade with the trend, for example pullbacks toward the basis. In the gray band you watch for mean-reversion crosses. In a squeeze you wait for the release.

  3. 03

    Check the context

    Higher timeframe, scheduled events (central banks, jobs data, inflation, earnings), major levels and related markets. If something doesn’t fit, you skip the situation.

  4. 04

    Set stop and target

    In a band walk the stop goes beyond the last pullback; for mean-reversion trades beyond the extreme of the excursion. Target for mean-reversion trades: the basis.

  5. 05

    Calculate position size

    Always the same risk per trade, for example 0.5 to 1% of the account. The size follows from the distance to the stop.

  6. 06

    Manage the trade

    When a band walk turns gray, you protect your profits. If price closes outside the band again during a mean-reversion trade, the idea was wrong.

Before you trade

  • Does the reading match the state? No trade against a colored band walk just because price is at the edge.
  • Are there important events coming up? Central banks, jobs data, inflation, earnings for stocks.
  • Is there a major level in the way – an old high or low, a round number?
  • What are the related markets doing? For gold the dollar and real yields, for stocks bond yields, for Bitcoin risk sentiment.
  • Is the stop clear – and does your position size match it?

Recommendations

Which markets fit – and which don’t

Volatility Bands Pro-Read doesn’t need volume – it works with price and volatility only. That’s why it also runs on forex and on indices without volume data. What matters is something else: does the market switch recognizably between trend and sideways phases, and are the candles clean enough for a close at the band to mean something?

MarketTimeframeFitWhy
S&P 500 (SPY, futures)Daily, 4hClear trend phases and clear sideways phases – both readings occur. Very liquid, tight spreads.
GoldDaily, 4hLong trends with pronounced band walks, plus quiet phases before big moves.
Large-cap stocks (e.g. Apple)DailyClean candles, but earnings create gaps and sudden squeeze releases.
BitcoinDaily, 4hStrong band walks, but violent spikes beyond the edge – mean-reversion trades need wide stops.
EUR/USD4h, dailyLong quiet phases, good for mean reversion and squeezes. Trends tend to build over weeks.
GBP/NZD4h, dailyLots of sideways movement – suits the mean-reversion reading, but wide spreads and sudden spikes.
Small capsallThin trading, gaps, single news items move the price. The band loses its meaning.

Assessment based on market characteristics and behavior on the chart, not a backtest. ●●● good fit, ●●○ with limitations, ●○○ difficult.

Good examples: S&P 500 and gold

S&P 500 (SPY or futures)

Daily chart and 4h

Good fit
  • Both states occur: the index has pronounced trend phases (band walks) and equally clear sideways phases (mean-reversion crosses) – as in the chart above.
  • Huge liquidity and tight spreads: a close at the band is a real market price, not a fluke of a thin order book.
  • Quiet phases are easy to read: between major events the index often goes quiet – the squeeze makes such phases easy to see.

Gold

Daily chart and 4h

Good fit
  • Long trends: gold often moves in one direction for months, driven by the dollar, real yields and central-bank buying. That produces long band walks.
  • High liquidity on every trading day, almost around the clock.
  • Tip: keep an eye on the dollar and US yields – they often explain why a band walk starts or ends.

With limitations and difficult

GBP/NZD and other thin crosses

4h and daily chart

Use with care
  • To be honest, the mean-reversion reading actually fits here: the pair often moves sideways for a long time, which is exactly what the mean-reversion crosses are made for.
  • But: wide spreads eat a large part of the profit on the small targets back to the basis.
  • Sudden spikes: two central banks and a commodity currency pull in different directions. A range quickly turns into a jump that runs over the stop.
  • Band walks are rare and short – the pair is hardly suitable for trend trading.

Small caps and penny stocks

all timeframes

Poor fit
  • Thin trading: few participants, big jumps between candles. A close at the band can be pure chance.
  • Single news items move the price erratically. Neither band walks nor mean reversion follow a pattern then.
  • Overnight gaps jump over the band and the stop.

Which timeframe?

  • Daily chart: the clearest reading. Band walks last days to weeks, squeezes are easy to see, costs hardly matter.
  • 4h: a good compromise for active traders on liquid markets.
  • 1h: possible on very liquid markets. More noise, more short-lived state changes – use the daily chart as context.
  • Below 1h: states change often, spread and fees weigh more. For stocks and indices, the open distorts the first candles of the day.

Both directions

Long and short

All three readings exist as mirror images: band walk up (green) and down (red), mean-reversion candidates from the upper band (short, cross above the candle) and from the lower band (long, cross below the candle), squeeze release up (β–²) and down (β–Ό). In the SPY example you can see a red band walk down in March 2026 – exactly the moment when β€œlower band touched = buy” would have been most expensive.

The part that makes the difference

How to manage the trades

Before the entry

  • State first, then the marker. Mean-reversion crosses only appear without a trend – still, a look at the next higher timeframe pays off: is there a clear trend against you there?
  • Check the calendar. Before central-bank decisions, jobs and inflation data or earnings, you’d rather skip new trades. The move afterwards often has little to do with the band before it.
  • Check intermarket. Gold reacts to the dollar and real yields, tech stocks to bond yields, Bitcoin to risk sentiment in equity markets.
  • Size the position from the stop. Always the same risk per trade.

While the trade is running

  • Band-walk trades: as long as the band stays colored, you have a tailwind. When it turns gray, you trail the stop or take part off.
  • Mean-reversion trades: the target is the basis. If the band turns against you on the way (a new trend starts), you’d rather get out than hope.
  • Squeeze trades: if price flips straight back to the other side of the basis after the release, it was a false start – get out.

After the trade

  • Note the state for every trade: band walk, mean reversion or squeeze. After 30 to 50 trades you’ll see which reading really works on your market.

Don’t miss a thing

Setting up alerts

  1. 01

    Open the alert window

    At the top of the chart, click Alert or press Alt + A.

  2. 02

    Choose the condition

    Under Condition, select β€œVB Pro-Read [Indicatr]” and below it the alert you want.

  3. 03

    Trigger

    Choose β€œOnce per bar close” – states can still change on the current candle.

  4. 04

    Notification

    Choose app, email or webhook and save.

AlertWhen it fires
Band walk up startedA green band walk begins.
Band walk down startedA red band walk begins.
Squeeze fired upA squeeze ends and price closes above the basis.
Squeeze fired downA squeeze ends and price closes below the basis.
Mean-reversion candidateWithout a trend, price closes back inside the band – long and short in one alert.

Reference

All settings

Double-click the name β€œVB Pro-Read” at the top left of the chart to open the settings. They’re split into four groups. The defaults are enough to start with – most traders change the band type at most.

1 Β· Band and band walk vs. mean reversion

Settings groups 1 and 2: Band and Band walk vs. mean reversion
Settings groups 1 and 2: Band and Band walk vs. mean reversion
Band typeDefault: Bollinger
Bollinger: width based on how much closes fluctuate, basis is a simple average. Keltner: width based on average candle size (ATR), basis is an exponential average – calmer, less sensitive to outliers. Donchian: highest high and lowest low of the period, basis is the midpoint.
LengthDefault: 20
Period for band and basis. Shorter = the band reacts faster but is noisier. Longer = calmer, states change less often.
Bollinger multiplierDefault: 2
Width of the Bollinger Bands. Higher = wider band, fewer closes outside it. Also affects squeeze detection – even if you display a different band type.
Keltner ATR multiplierDefault: 1.5
Width of the Keltner Channel. Also affects the squeeze: higher = squeezes are detected more often.
Band walk: lookback barsDefault: 5
How many of the latest candles are checked for a band walk.
Band walk: min. closes in outer zoneDefault: 3
How many of those candles must close in the outer zone. Higher = stricter, band walks appear later and less often.
Outer zone (position in band, 0-1)Default: 0.8
Where the outer zone begins. 0.8 means the top fifth of the band for up, the bottom fifth for down. Higher = only closes right at the edge count.
ADX lengthDefault: 14
Period for trend strength (ADX).
ADX trend thresholdDefault: 20
The ADX level above which the market counts as trending. Above it band walks are possible, below it mean-reversion candidates. Higher = fewer band walks, more mean-reversion candidates.

2 Β· Squeeze and display

Settings groups 3 and 4: Squeeze and Display
Settings groups 3 and 4: Squeeze and Display
Show squeeze (Bollinger inside Keltner)Default: on
Show or hide the squeeze dots and release triangles. The squeeze alerts stay active even when it’s off.
Walk up / bullish Β· Walk down / bearish Β· NeutralDefault: Green / Red / Gray
Colors for the band walk up (also β–² and long crosses), the band walk down (also β–Ό and short crosses) and the neutral band. β€œNeutral” also colors the basis and the squeeze dots.
Mark mean-reversion candidates (no trend)Default: on
Show or hide the mean-reversion crosses. When off, the β€œMean-reversion candidate” alert no longer fires either.

From practice

Common mistakes

  • β€œUpper band = sell”. In a colored band walk the edge is a sign of strength, not a reversal signal.
  • Trading mean-reversion crosses without a stop. If the range turns into a trend, mean-reversion trades quickly run deep into a loss.
  • Reading the squeeze as a direction signal. It shows tension, not direction. The first release can reverse.
  • Trading on the current candle. Color and markers are only fixed when the candle closes.
  • Two band indicators on top of each other. Remove the built-in Bollinger Bands, otherwise you’ll miss the coloring.
  • Constantly tweaking the settings. Adjusting after every loss means optimizing for the past.

FAQ

Does the script repaint?

No. All states and markers are based on closing prices. They can still change on the current candle; once the candle closes, they’re fixed.

Which band type should I use?

To start, Bollinger – the best-known variant, which the defaults also refer to. Keltner is calmer and reacts less to individual outliers. Donchian shows the high-low range and suits breakout traders. Band walk, mean reversion and squeeze work with all three.

Why is the band gray even though price is hugging the upper edge?

A band walk needs two things together: enough closes in the outer zone and a trend according to ADX. Without the trend the band stays gray – and a drop back into the band would be marked as a mean-reversion candidate.

Why do some triangles have no move after them?

The squeeze only shows that volatility is expanding again. It doesn’t say how far or for how long. Wait for confirmation, for example a band walk in the breakout direction.

Does it work without volume, for example on forex?

Yes. The script only uses price and volatility, no volume.

Is the script really free?

Yes. Volatility Bands Pro-Read is free and open source on TradingView. The button on this page takes you to the script page. After Add to favorites you’ll find it on the chart under Indicators β†’ Favorites.

How do you like Volatility Bands Pro-Read?

Your vote tells us what to work on next.

Support

Report a problem or share feedback

Something off with the script, unclear in the docs, or you have an idea? Write to us. We reply by email.

Helps us check access or settings.

Only used to reply to you.

What is it about?

By sending, you agree that we use your details to handle your request. More in our privacy policy.

Volatility Bands Pro-Read

Draws Bollinger, Keltner or Donchian and reads the band behaviour: band walk in trends, mean reversion without trend, squeeze.

Open on TradingView

For educational and analytical purposes only. Not financial advice. Marks and states are not recommendations to buy or sell. Past behavior is no guarantee of future results. Trading involves a risk of loss.

Volatility Bands Pro-Read – Documentation & Guide | indicator.trading