trendAngle

Draws a line between two points and shows the angle of that line relative to the chart. Traders often use this to measure the steepness of price trends (for example, “Is this move at a 30° angle or more?”).

Syntax

trendAngle(fromPoint, toPoint, styles?)

Parameters

• fromPoint: The starting point of the line (newPoint(time, price)).

• toPoint: The ending point of the line (newPoint(time, price)).

• styles (optional) Style options for the angle line:

  • linecolor: line color (e.g. color.blue)

  • linewidth: thickness

  • linestyle: solid/dashed/dotted

  • textcolor: the color of the angle text

⚠️ Note: Unlike trendLine or extendedLine, this one doesn’t use a separate text label — the angle itself is automatically shown.

Return Value

• string — The id of the angle drawing.

Example

//@version=1
init = () => {
    // Place this drawing on the main chart
    indicator({ onMainPanel: true, format: 'inherit' });
};

onTick = () => {
    // Every 40 candles, draw a new angle line
    if (index % 40 === 0) {
        // Create the starting point: 20 candles ago, at its low
        const p1 = newPoint(time(20), low(20));

        // Create the ending point: the current candle, at its high
        const p2 = newPoint(time(0), high(0));

        // Draw a blue angle line from p1 to p2
        // - The angle between these points will be displayed automatically
        // - Styles: blue color, thickness of 2
        trendAngle(
            p1,
            p2,
            { linecolor: color.blue, linewidth: 2 }
        );
    }
};

Result

Tips

• Use trendAngle to compare how steep current moves are versus past moves.

• A gentle angle often means consolidation; a steep angle often means acceleration.

Warning

• If you give invalid points (like missing time or price), the angle won’t be drawn.

• Because the angle depends on chart scaling (time vs. price), different zoom levels can make angles look steeper or flatter.

Good Practice

• Combine trendAngle with other tools (like trendLine) to see both the slope and the projected path.

• Keep your chart zoom consistent when comparing multiple angles.