This indicator calculates the distribution of close-to-close percentage changes using rate of change on closing prices. It bins percentage changes into intervals of 0.25 percent increments from negative to positive values and plots a normalized cumulative hist
Indicator · Pine Script v5 · Own pane
ATR Percentile Rank
This indicator measures how extreme current Average True Range is versus recent history.
GitHub stars43on the repository
Pine versionv5runs as is
Lines of code28
Settings6inputs
LicenceNone statedfile: MPL-2.0
Last update1 year ago23 Sep 2025
Add It to Your TradingView Chart
- 1Copy the scriptPress Copy script above, or the copy button on the code below.
- 2Open the Pine EditorOpen a TradingView chart and choose Pine Editor at the bottom of the screen.
- 3Paste over the templateCreate a new indicator, select all of the template text and paste. Press Save and give it a name.
- 4Add it to the chartPress Add to chart, then adjust the settings with the gear icon next to its name.
Source Code
28 lines of Pine Script v5 from ATR Percentile.pine, published under MPL-2.0 (file header). Keep the author's credit and licence lines when you reuse it.
// This source code is subject to the terms of the Mozilla Public License 2.0 at https://mozilla.org/MPL/2.0/
// © Zettt
// 2023-12-05 - Initial release
//@version=5
indicator("ATR Percentile Rank")
atrLength = input.int(defval = 10, title = "ATR Length", minval = 1, group = "ATR Percentile")
lookback = input.int(defval = 50, title = "Percentile Lookback", minval = 1, group = "ATR Percentile")
emaLength = input.int(defval = 20, title = "EMA Length", minval = 1, group = "ATR Percentile")
percentileRankExtreme = input.int(defval = 10, title = "Percentile Extreme", minval = 1, step = 1, group = "ATR Percentile")
// Color gradient
bottomColor = input.color(defval = color.rgb(255, 235, 59, 0), title = "Bottom Color", group = "Gradient")
topColor = input.color(defval = color.rgb(242, 54, 69, 0), title = "Bottom Color", group = "Gradient")
// bottomColorCutoff = input.float(defval = 0, title = "Bottom Color Cutoff", minval = 0, step = 0.1, group = "Gradient", tooltip = "Below this value, the gradient will not take effect, i.e. the color will stay constant.")
// topColorCutoff = input.float(defval = 100, title = "Top Color Cutoff", minval = 0, step = 0.1, group = "Gradient", tooltip = "Above this value…")
// Calculations and plots
atr = ta.atr(atrLength)
percentileRank = ta.percentrank(atr, lookback)
percentileEMA = ta.ema(percentileRank, emaLength)
plot(percentileRank, title = "ATR Percentile", color = color.from_gradient(percentileRank, 0, 100, bottomColor, topColor))
plot(percentileEMA, title = "Percentile EMA", color = color.new(#64b5f6, 20))
// plot volatility at extremes
plot(percentileRank < percentileRankExtreme ? percentileRank : na, title="Lowest Volatility", color=color.rgb(255, 235, 59, 80), style=plot.style_columns, histbase=100)
plot(percentileRank > 100-percentileRankExtreme ? percentileRank : na, title="Highest Volatility", color=color.rgb(242, 54, 69, 80), style=plot.style_columns, histbase=0)
Overview
ATR Percentile Rank calculates ATR, converts it to a percentile rank over a lookback window, and smooths that rank with an EMA. Both series plot in a separate pane, with a color gradient from low to high rank. Columns highlight the lowest and highest volatility when the rank falls inside user-set extremes. Lengths, lookback, extreme threshold, and gradient colors are adjustable. No trade signals or orders are generated.
- ATR percentile rank
- EMA of the percentile
- Gradient color on the rank
- Column highlights at volatility extremes
- Adjustable extreme threshold
Details
Published by
Zettt on GitHub
Type
Indicator, Pine Script v5
Draws
Separate pane below the chart
Category
Volatility & bands
Markets
Any symbol
Timeframes
Any timeframe
Risk Notes
No repainting, lookahead or stacked entries were found in its code or README. That says nothing about how well it works: test it first.
Settings
The inputs you can change from the gear icon on the chart. Defaults are the author's.
| Setting | Type | Default | Variable |
|---|---|---|---|
| ATR Length | int | 10 | atrLength |
| Percentile Lookback | int | 50 | lookback |
| EMA Length | int | 20 | emaLength |
| Percentile Extreme | int | 10 | percentileRankExtreme |
| Bottom Color | color | color.rgb(255, 235, 59, 0) | bottomColor |
| Bottom Color | color | color.rgb(242, 54, 69, 0) | topColor |
Third-party code. ForexR did not write, test or endorse this script, and the summary above was generated automatically from its code and README. Indicators describe the past, and a strategy's backtest can look better than live trading, especially when a script repaints. Check it in the Strategy Tester and on a demo account before you rely on it.
Similar Pine Scripts
This indicator plots a Supertrend-based trend-following setup in a separate pane and skips conditions it treats as a sideways market. A volatility range is built from an ATR value, with RMA, SMA, EMA, or WMA smoothing, or from a fixed point distance. Optional
This indicator plots candle range and open-to-close movement as percentages in a separate pane. Range is the high-low difference divided by the low, and change is the close-open difference divided by the open. Both series draw as columns. Teal columns show ran
The Mojito v3 Strategy indicator evaluates volatility term structure by calculating the ratio between front-month and second-month VIX futures contracts. It smooths this ratio using a configurable median filter and compares the result against user-defined uppe
Calculates dynamic modeling values by applying a mathematical logistic differential equation to price change over a specified lookback length. It measures price momentum relative to the recent high-low price range. The script plots positive and negative logist
MACD-V is a volatility-normalized momentum indicator based on research by Alex Spiroglou. It calculates the standard MACD histogram and normalizes it by dividing by the Average True Range (ATR). Plotted in a separate pane as a colored histogram, it includes us
Trade Your Charts With a Regulated Broker
Compare brokers that connect to TradingView, with spreads, minimum deposits and leverage side by side.
Compare brokers