circle

Draws a Circle using a center point and a second point that sets the radius. Great for spotlighting reaction zones around pivots, news candles, or any area you want to keep an eye on. You can softly fill it and optionally show a small label.

Syntax (one line)

circle(centerPoint, edgePoint, styles?)

Parameters

centerPoint (PricedData) · Center of the circle (time & price). edgePoint (PricedData) · Any point on the circumference; distance to centerPoint becomes the radius. styles (CircleLineToolOverrides) · Visual and label options:

• backgroundColor (RGBAColor | BaseColors) · Fill color inside the circle.

• bold (boolean) · Make label text bold.

• color (RGBAColor | BaseColors) · Circle outline color.

• fillBackground (boolean) · Turn the fill on/off.

• fontSize (number) · Label font size.

• italic (boolean) · Make label text italic.

• linewidth (number) · Outline thickness.

• showLabel (boolean) · Show a small label on the circle.

• textColor (RGBAColor | BaseColors) · Label text color.

Return Value

(string) · The drawing ID of the created Circle.

Example

What this does: Every 48 candles, drops a circle around a recent pivot. We keep the fill subtle and display a small label. All styling stays in one const style.

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

onTick = () => {
  if (index % 48 === 0) { // draw occasionally to keep charts clean
    // 1) Pick center (pivot) and an edge point to set the radius
    const center = newPoint(time(60), closeC(60)); // pivot center
    const edge   = newPoint(time(45), high(45));   // defines radius

    // 2) Style (CircleLineToolOverrides)
    const style = {
      color: color.blue,                       // outline
      linewidth: 2,
      fillBackground: true,
      backgroundColor: color.rgba(0, 102, 255, 0.18),
      showLabel: true,
      textColor: color.white,
      fontSize: 12,
      bold: true,
      italic: false
    };

    // 3) Draw the circle
    circle(center, edge, style);
  }
};

Tips

• Use a meaningful pivot for centerPoint so the circle frames real market reactions.

• Keep fills subtle (higher transparency in backgroundColor) so candles remain visible.

• Try different radii by moving edgePoint to nearby highs/lows to fit the local structure.

Warning

• Very small radii can be hard to see; pick an edgePoint that creates a circle large enough to be useful.

Good Practice

• Reuse a few color presets (e.g., blue for watch zones, orange for news areas) so circles are instantly recognizable.

• Keep labels short (1–2 words) to avoid clutter.