New high/low

Conditions

• Value

New high/low

Price · 168 candles

• new high
• new low

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

Highest or lowest value in N candles. True on every candle where the value is higher than on all candles before it in the chosen period, or lower than on all of them. That is how you report breakouts to a new high or low, for the price as well as for an indicator. Example: price into “new high” with 168 candles reports the highest close in a week on 1-hour candles.

What it looks like

• Price (close of each candle)
• highest close of the 20 candles before
• lowest close before
• new high or low

BTC/USDT with the highest and lowest close of the 20 candles before. When the price is above, it is a new 20-candle high; when below, a new low. In a rally this is true on several candles in a row; an alert only comes the first time, until the signal has been false again.

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.

Candles

Default: 20 · from 1 to 1,000, whole number

How many candles before the value is compared with. 20 is usual; 168 is one week on 1-hour candles.

Example

Notifies you when BTC reaches its highest close in a week on 1-hour candles.

How to connect the nodes:

1. Candle (Price) → New high/low (Value)
2. New high/low (new high) → Telegram (Trigger)

On the board it reads: Price · 168 candles

Chain as JSON

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

newhighlow.json

{
  "name": "Example: New high/low",
  "version": 1,
  "nodes": [
    { "id": "c1", "type": "core.candle", "position": { "x": 40, "y": 40 }, "settings": { "pair": "BTC/USDT", "timeframe": "1h" } },
    { "id": "n1", "type": "core.newhighlow", "position": { "x": 260, "y": 40 }, "settings": { "length": 168 } },
    { "id": "t1", "type": "core.telegram", "position": { "x": 480, "y": 40 }, "settings": {} }
  ],
  "edges": [
    { "from": "c1.close", "to": "n1.in" },
    { "from": "n1.high", "to": "t1.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	Value	Number series	required
Output	new high	Signal (true/false)	–
Output	new low	Signal (true/false)	–

Good to know

• Warm-up with the default settings: 21 candles (this many extra candles are loaded by the replay before the value is reliable).
• Search also finds it under: new high, new low, breakout, record, highest, lowest, high, low.

Technical details

New high: value > highest value of the N candles before, the current one not counted; new low: value < lowest value before. The same calculation as value > ta.highest(value, N)[1] in TradingView.

• Type in the chain: core.newhighlow · Version 1.0.0 · Category key cond
• Settings in the chain: length (Candles)
• Pins in the chain: Input in · Output high, low
• Reference tests in the manifest: 1 (with fixed price data: 500 candles of 1h)
• How a node is built