Trend

[[trend]] is a conditional block that compares the numeric value of reference on the current candle with its value on the previous candle.

The direction key defines the comparison:

• direction = "bullish": the condition is true when ${\text{reference}}_t>{\text{reference}}_{t-1}$
• direction = "bearish": the condition is true when ${\text{reference}}_t<{\text{reference}}_{t-1}$

As long as the trend of reference does not match the requested direction, the block stays pending and evaluation continues on the next candle. The block is validated as soon as that trend matches the requested direction. Execution then continues with the block identified by next_block_id.

Block declaration#

A strategy can contain multiple [[trend]] blocks.

Examples#

Direct use#

This example shows a [[trend]] block used directly in the strategy flow. The strategy moves to next_block only when ema_fast - ema_slow moves upward from one candle to the next.

[[trend]]
id            = "my_trend"
direction     = "bullish"
reference     = "ema_fast - ema_slow"
next_block_id = "next_block"

Use inside [[and]]#

This example shows a [[trend]] block evaluated by a parent [[and]] block. The [[trend]] block does not define next_block_id; flow is controlled by the parent [[and]].

[[and]]
id            = "entry_filters"
condition_ids = ["trend_ok", "volatility_ok"]
next_block_id = "open_long"

[[trend]]
id        = "trend_ok"
direction = "bullish"
reference = "ema_fast - ema_slow"

Block parameters#

The [[trend]] block does not produce any output variable. It is only used to move execution forward when the monitored expression changes in the requested direction between the current candle and the previous one.