priceRange

The Price Range tool measures the vertical distance (price change) between two points. It’s perfect to quickly see how much a move gained/lost (in price units), and you can add a label so it’s readable at a glance.

Syntax (one line)

priceRange(fromPoint, toPoint, styles?)

Parameters

fromPoint (PricedData) · First anchor (time & price) where the measurement starts. toPoint (PricedData) · Second anchor (time & price) where the measurement ends. styles (PriceRangeLineToolOverrides) · Visual and label options:

• backgroundColor (RGBAColor | BaseColors) · Fill color behind the range.

• bold (boolean) · Make label text bold.

• color (RGBAColor | BaseColors) · Line/outline color of the range.

• extendLeft (boolean) · Extend the range box/line to the left.

• extendRight (boolean) · Extend the range box/line to the right.

• fillBackground (boolean) · Fill the background of the range area.

• fillLabelBackground (boolean) · Fill the label’s background box.

• fontSize (number) · Base font size for text.

• italic (boolean) · Italicize label text.

• labelBackgroundColor (RGBAColor | BaseColors) · Color for the label’s background.

• labelFontSize (number) · Font size for the label.

• labelTextColor (RGBAColor | BaseColors) · Text color inside the label.

• linewidth (number) · Thickness of the range outline.

• showLabel (boolean) · Show/hide the label that displays the measured value.

• textcolor (RGBAColor | BaseColors) · Text color (general, if supported by your theme).

• transparency (number) · Transparency for fills (0=opaque, 100=fully transparent).

Return Value

(string) · The drawing ID of the created Price Range.

Example

What this does: Every 48 candles, it measures the price move from a past swing low to a recent swing high, fills the box softly, and shows a clear label.

//@version=1
init = () => {
  indicator({ onMainPanel: true, format: 'inherit' });
};

onTick = () => {
  // Keep charts tidy: draw occasionally
  if (index % 48 === 0) { // ← adjust frequency as you like
    // 1) Choose two anchors (time & price)
    const from = newPoint(time(60), low(60));   // start at swing low
    const to   = newPoint(time(20), high(20));  // end at swing high

    // 2) Style (PriceRangeLineToolOverrides)
    const style = {
      color: color.blue,                 // outline color
      linewidth: 2,                      // thicker outline
      fillBackground: true,              // fill the range box
      backgroundColor: color.rgba(0, 0, 255, 0.12),
      transparency: 85,                  // soft fill
      showLabel: true,                   // display value label
      labelBackgroundColor: color.rgba(0, 0, 255, 0.18),
      labelTextColor: color.white,
      labelFontSize: 12,
      bold: true,
      extendRight: false,                // don’t extend; measure only between points
      extendLeft: false
    };

    // 3) Build the measurement
    priceRange(from, to, style);
  }
};

Tips

• Use swing lows/highs for fromPoint and toPoint so the range reflects a meaningful move.

• If the label overlaps candles, lower labelFontSize or raise transparency for a lighter fill.

• Turn on extendRight to keep the box visible as new bars print.

Warning

• Don’t pass raw time() or price numbers directly—always wrap anchors using newPoint(time(offset), priceValue) or nothing will draw.

Good Practice

• Keep a small set of presets (e.g., blue for bullish legs, red for bearish legs) to recognize ranges quickly.

• Pair Price Range with dateRange or dateAndPriceRange to see both the duration and the size of a move.