Ichimoku

Indicators

• Price
• High
• Low

Ichimoku

9 · 26 · 52 · 26

• Conversion line
• Base line
• Span A
• Span B
• above cloud
• below cloud

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

Shows with a cloud where the trend goes. Sums up the trend in lines made from the high and low of the last candles. The conversion line shows the short-term trend, the base line the medium-term one. Span A and span B form the cloud: when the price is above it, the trend points up, below it down, inside the cloud it is undecided. Charts draw the cloud shifted forward; this node gives it at the current candle, the way it sits above that candle on the chart. Example: “Conversion line crosses above base line” together with “above the cloud” reports the classic signal for an uptrend. The lagging line is not an output, because it is drawn shifted into the past. Its rule “price above the price 25 candles ago” (the chart shifts it that far with displacement 26) is built with the Change % node: 25 candles back, above 0.

What it looks like

• Price (close of each candle)
• cloud between span A and span B
• conversion line (9)
• base line (26)
• true as long as

BTC/USDT with Ichimoku 9 · 26 · 52 · 26. The cloud sits at each candle the way the chart draws it shifted forward above that candle; the node does not look into the future for that. The strips show when the price closes above and when below the cloud, in between it is inside.

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.

Conversion line

Default: 9 · from 1 to 500, whole number

How many candles the conversion line takes the high and low from. Usually 9.

Base line

Default: 26 · from 1 to 500, whole number

How many candles the base line takes the high and low from. Usually 26.

Span B

Default: 52 · from 1 to 500, whole number

How many candles span B covers, the slow edge of the cloud. Usually 52.

Displacement

Default: 26 · from 1 to 500, whole number

How many candles the cloud is shifted forward, usually 26. The count starts at the current candle, so with 26 the cloud at a candle comes from the values 25 candles earlier. Almost everyone uses the defaults 9, 26, 52 and 26; you rarely need to change them.

Example

The classic signal: the conversion line crosses above the base line while the price is above the cloud.

How to connect the nodes:

1. Candle (Price) → Ichimoku (Price)
2. Candle (High) → Ichimoku (High)
3. Candle (Low) → Ichimoku (Low)
4. Ichimoku (Conversion line) → Compare A/B (A)
5. Ichimoku (Base line) → Compare A/B (B)
6. Compare A/B (true/false) → AND (Signal 1)
7. Ichimoku (above cloud) → AND (Signal 2)
8. AND (all true) → Push (Trigger)

On the board it reads: 9 · 26 · 52 · 26

Chain as JSON

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

ichimoku.json

{
  "name": "Example: Ichimoku",
  "version": 1,
  "nodes": [
    { "id": "c1", "type": "core.candle", "position": { "x": 40, "y": 40 }, "settings": { "pair": "BTC/USDT", "timeframe": "1h" } },
    { "id": "i1", "type": "core.ichimoku", "position": { "x": 260, "y": 40 }, "settings": {} },
    { "id": "k1", "type": "core.compare-ab", "position": { "x": 480, "y": 40 }, "settings": { "operator": "crossesAbove" } },
    { "id": "a1", "type": "core.and", "position": { "x": 700, "y": 40 }, "settings": {} },
    { "id": "p1", "type": "core.push", "position": { "x": 920, "y": 40 }, "settings": {} }
  ],
  "edges": [
    { "from": "c1.close", "to": "i1.close" },
    { "from": "c1.high", "to": "i1.high" },
    { "from": "c1.low", "to": "i1.low" },
    { "from": "i1.conversion", "to": "k1.a" },
    { "from": "i1.base", "to": "k1.b" },
    { "from": "k1.out", "to": "a1.in0" },
    { "from": "i1.above", "to": "a1.in1" },
    { "from": "a1.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	Conversion line	Number series	appears in messages as a price, e.g. “$81,616”
Output	Base line	Number series	appears in messages as a price, e.g. “$81,616”
Output	Span A	Number series	appears in messages as a price, e.g. “$81,616”
Output	Span B	Number series	appears in messages as a price, e.g. “$81,616”
Output	above cloud	Signal (true/false)	–
Output	below cloud	Signal (true/false)	–

Good to know

• In messages the values are called “conversion line”, “base line”, “cloud span A”, “cloud span B”.
• Warm-up with the default settings: 77 candles (this many extra candles are loaded by the replay before the value is reliable).
• Search also finds it under: ichimoku, cloud, kumo, tenkan, kijun, trend.

Technical details

Conversion and base line as the midpoint of the highest high and lowest low over 9 and 26 candles, span A as the mean of both, span B as the midpoint over 52 candles, both delayed by displacement − 1 candles so they sit at the current candle; the same values as TradingView’s built-in Ichimoku Cloud indicator, which draws the cloud that many candles ahead.

• Type in the chain: core.ichimoku · Version 1.0.0 · Category key ind
• Settings in the chain: conversion (Conversion line), base (Base line), spanB (Span B), displacement (Displacement)
• Pins in the chain: Input close, high, low · Output conversion, base, spanA, spanB, above, below
• Reference tests in the manifest: 1 (with fixed price data: 500 candles of 1h)
• How a node is built