Position

[[position]] is a conditional block that evaluates reference and comparison on every candle.

The position key defines the direction of the test:

• position = "above": the condition is true when $\text{reference}>\text{comparison}$.
• position = "below": the condition is true when $\text{reference}<\text{comparison}$.

When the condition is true, execution jumps to the block referenced by next_block_id. This block checks an instantaneous relative position and does not detect crossover events (use [[crossover]] or [[crossunder]] for that).

Block declaration#

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

Example#

[[position]]
id            = "trend_filter"
position      = "above"
reference     = "close_price"
comparison    = "ma_fast"
next_block_id = "next_step"

Block parameters#

This block does not produce any output variable; it only controls execution flow.

Equivalent with [[condition]]#

The [[position]] block is a readable shortcut for a strict comparison between two expressions evaluated on each candle.

Equivalent for position = "above":

[[condition]]
id            = "trend_filter"
condition     = "close_price > ma_fast"
next_block_id = "next_step"

Equivalent for position = "below":

[[condition]]
id            = "trend_filter"
condition     = "close_price < ma_fast"
next_block_id = "next_step"