priceNote

Attaches a text note to a price point and draws a small pointer/leader toward another point. Great for tagging levels with a quick comment (e.g., “liquidity grab”) while keeping the note readable with background, border, and word-wrap.

Syntax (one line)

priceNote(originPoint, commentPoint, styles?, text?)

Parameters

originPoint (PricedData) · First anchor (time & price) where the note is attached. commentPoint (PricedData) · Second anchor (time & price) the note points toward. styles (TextLineToolOverrides) · Visual and layout options:

• backgroundColor (RGBAColor | BaseColors) · Box fill color.

• backgroundTransparency (number) · 0–100 background opacity (higher = lighter).

• bold (boolean) · Make the note text bold.

• borderColor (RGBAColor | BaseColors) · Box border color.

• color (RGBAColor | BaseColors) · Text color.

• drawBorder (boolean) · Show a border around the box.

• fillBackground (boolean) · Fill the box background.

• fixedSize (boolean) · Keep the on-screen size constant when zooming.

• fontsize (number) · Text size.

• italic (boolean) · Italicize the text.

• wordWrap (boolean) · Wrap text onto multiple lines.

• wordWrapWidth (number) · Pixel width used when wrapping. text (string) · The message shown in the note.

Return Value

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

Example

What this does: Every 45 candles, adds a note at the current close that points toward a nearby candle, using soft background and a thin border. All visuals live in one const style.

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

onTick = () => {
  if (index % 45 === 0) { // draw occasionally to keep charts clean
    // 1) Choose the two anchors (attach here, point there)
    const origin  = newPoint(time(0),  closeC(0));   // attach at current bar
    const target  = newPoint(time(6),  closeC(6));   // point toward a nearby bar

    // 2) Style (TextLineToolOverrides)
    const style = {
      fillBackground: true,
      backgroundColor: color.rgba(255, 193, 7, 0.18), // amber tint
      backgroundTransparency: 82,
      drawBorder: true,
      borderColor: color.rgba(255, 193, 7, 0.85),
      color: color.black,
      fontsize: 12,
      bold: true,
      italic: false,
      wordWrap: true,
      wordWrapWidth: 160,
      fixedSize: false
    };

    // 3) Draw the price note
    priceNote(origin, target, style, "Liquidity grab\nPossible retest");
  }
};

Tips

• Use wordWrap + wordWrapWidth to keep multi-line notes tidy and readable.

• Pick high-contrast color vs backgroundColor so text stays visible over candles.

• fixedSize: true keeps font size consistent while zooming.

Warning

• Very long notes can cover price action; keep messages short and bump up backgroundTransparency if needed.

Good Practice

• Create color presets (info/warning/confirm) and reuse the same const style across scripts.

• Point the note toward the nearest relevant bar so the context is obvious at a glance.