Supertrend

Indicators

• Price
• High
• Low

Supertrend

10 candles · factor 3

• Supertrend
• up
• down

This is how the node looks on the board: inputs on the left, outputs on the right.

Trend line that flips when the trend turns. Trails a line behind the price at the distance of its usual swings: below it in an uptrend, above it in a downtrend. The line only moves in the direction of the trend. When the price closes on its other side, the trend turns and the line jumps to the other side. Many use it as a trailing stop. Example: “Price crosses above Supertrend 10 · 3” fires when the trend turns up. The “up” and “down” signals are true as long as the trend points that way.

What it looks like

• Price (close of each candle)
• line in an uptrend
• line in a downtrend
• price crosses above

BTC/USDT on 1-hour candles with Supertrend 10 · 3. The line only follows the price in the direction of the trend; when the price closes on its other side, it flips. At the dots the price crosses above it, as “Price crosses above Supertrend” would report. The strip shows when the “up” signal is true.

Settings

The settings appear on the right under “Properties” once you click the node on the board. Below each field you find the same explanation as here.

ATR candles

Default: 10 · from 1 to 500, whole number

How many candles the usual range (ATR) is measured over, which sets the distance of the line. 10 is the usual value.

Factor

Default: 3 · from 0.1 to 20

How far the line sits from the price, as a multiple of the ATR. With 3 the trend only turns on a clear counter move. Smaller values like 2 report turns earlier, but also more often wrongly.

Example

Notifies you when the price crosses above the Supertrend, so the trend turns up.

How to connect the nodes:

1. Candle (Price) → Supertrend (Price)
2. Candle (High) → Supertrend (High)
3. Candle (Low) → Supertrend (Low)
4. Candle (Price) → Compare A/B (A)
5. Supertrend (Supertrend) → Compare A/B (B)
6. Compare A/B (true/false) → Push (Trigger)

On the board it reads: 10 candles · factor 3

Chain as JSON

To try it, copy it and paste it in the editor under “Import”. Importing creates a new chain.

supertrend.json

{
  "name": "Example: Supertrend",
  "version": 1,
  "nodes": [
    { "id": "c1", "type": "core.candle", "position": { "x": 40, "y": 40 }, "settings": { "pair": "BTC/USDT", "timeframe": "1h" } },
    { "id": "s1", "type": "core.supertrend", "position": { "x": 260, "y": 40 }, "settings": {} },
    { "id": "k1", "type": "core.compare-ab", "position": { "x": 480, "y": 40 }, "settings": { "operator": "crossesAbove" } },
    { "id": "p1", "type": "core.push", "position": { "x": 700, "y": 40 }, "settings": {} }
  ],
  "edges": [
    { "from": "c1.close", "to": "s1.close" },
    { "from": "c1.high", "to": "s1.high" },
    { "from": "c1.low", "to": "s1.low" },
    { "from": "c1.close", "to": "k1.a" },
    { "from": "s1.line", "to": "k1.b" },
    { "from": "k1.out", "to": "p1.in" }
  ]
}

Inputs and outputs

Only matching types connect: number series to number series (round pin), signal to signal (square), message to message (diamond).

Direction	Pin	Type	Note
Input	Price	Number series	required
Input	High	Number series	required
Input	Low	Number series	required
Output	Supertrend	Number series	appears in messages as a price, e.g. “$81,616”
Output	up	Signal (true/false)	–
Output	down	Signal (true/false)	–

Good to know

• In messages the value is called “Supertrend 10 · 3”.
• Warm-up with the default settings: 200 candles (this many extra candles are loaded by the replay before the value is reliable).
• Search also finds it under: trend, stop, trailing stop, atr, reversal, trend change.

Technical details

Bands (high + low) / 2 ± factor × ATR that only trail in the direction of the trend until the previous close breaks them; the direction turns when the close crosses the active band; the same formula as ta.supertrend in TradingView.

• Type in the chain: core.supertrend · Version 1.0.0 · Category key ind
• Settings in the chain: length (ATR candles), factor (Factor)
• Pins in the chain: Input close, high, low · Output line, up, down
• Reference tests in the manifest: 1 (with fixed price data: 500 candles of 1h)
• How a node is built