All scripts
Pro Β· Invite-only on TradingView
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
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
- 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.
- 02
Add it to your favorites
On the script page, click Add to favorites (the star icon).
- 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.
- 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
- 1Band walk up Green bands and green fill: a trend, price keeps closing near the upper edge.
- 2Band walk down Red bands and red fill: a downtrend along the lower edge.
- 3Neutral band Gray: no band walk. The thin line in the middle is the basis.
- 4Squeeze Gray dots at the bottom of the chart: volatility has contracted.
- 5Squeeze release Triangle: the squeeze ends above (β²) or below (βΌ) the basis.
- 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.
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.
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
- 01
Read the state
One look at the color: green or red = band walk, gray = no band walk. Gray dots at the bottom = squeeze.
- 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.
- 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.
- 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.
- 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.
- 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?
| Market | Timeframe | Fit | Why |
|---|---|---|---|
| S&P 500 (SPY, futures) | Daily, 4h | Clear trend phases and clear sideways phases β both readings occur. Very liquid, tight spreads. | |
| Gold | Daily, 4h | Long trends with pronounced band walks, plus quiet phases before big moves. | |
| Large-cap stocks (e.g. Apple) | Daily | Clean candles, but earnings create gaps and sudden squeeze releases. | |
| Bitcoin | Daily, 4h | Strong band walks, but violent spikes beyond the edge β mean-reversion trades need wide stops. | |
| EUR/USD | 4h, daily | Long quiet phases, good for mean reversion and squeezes. Trends tend to build over weeks. | |
| GBP/NZD | 4h, daily | Lots of sideways movement β suits the mean-reversion reading, but wide spreads and sudden spikes. | |
| Small caps | all | Thin 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
- 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
- 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
- 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
- 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
- 01
Open the alert window
At the top of the chart, click Alert or press
Alt + A. - 02
Choose the condition
Under Condition, select βVB Pro-Read [Indicatr]β and below it the alert you want.
- 03
Trigger
Choose βOnce per bar closeβ β states can still change on the current candle.
- 04
Notification
Choose app, email or webhook and save.
| Alert | When it fires |
|---|---|
| Band walk up started | A green band walk begins. |
| Band walk down started | A red band walk begins. |
| Squeeze fired up | A squeeze ends and price closes above the basis. |
| Squeeze fired down | A squeeze ends and price closes below the basis. |
| Mean-reversion candidate | Without 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
- 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
- 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.
Volatility Bands Pro-Read
Draws Bollinger, Keltner or Donchian and reads the band behaviour: band walk in trends, mean reversion without trend, squeeze.
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.