Exit

[[exit]] manages exits for an open position by creating price-based orders. It can place a take profit, a stop loss, and a trailing stop. Orders remain pending until they are filled or cancelled.

For the overall sizing logic and the difference between absolute quantity, equity percentage, and position percentage, see Position sizing, margin, and leverage. This page only describes the [[exit]] block semantics.

When the block is evaluated again with the same order_id, Whale‑E updates the existing orders. When a parameter is no longer set, the corresponding order is cancelled.

If no exit level is defined (profit, limit, loss, stop, trail_price, trail_points), the block does not place any new order and cancels existing exit orders associated with order_id.

By default, after placing, updating or cancelling orders, the block validates on the current candle and control moves to the next block immediately. The wait_candles key only delays this transition; it does not change how orders are executed.

Block declaration#

A strategy can contain multiple [[exit]] blocks. The order_id field identifies the exit orders managed by the block.

Examples#

Take profit and stop loss#

This example places a take profit and a stop loss using tick distances from the entry price.

[[exit]]
id       = "exit_main"
order_id = "exit_main"
profit   = 120
loss     = 80

Partial exit#

This example closes 25% of the current position when the profit target is reached.

[[exit]]
id          = "take_partial"
order_id    = "take_partial"
qty_percent = 25
profit      = 100

Trailing stop#

This example creates a trailing stop with activation and trailing distances defined in ticks.

[[exit]]
id           = "trail"
order_id     = "trail"
trail_points = 200
trail_offset = 100

Targeting a specific entry#

This example applies the stop loss only to the entry whose order_id is add.

[[exit]]
id         = "exit_add"
order_id   = "exit_add"
from_entry = "add"
loss       = 60

Exit armed before a pending entry fills#

This example arms a bracket on the same candle as an already submitted limit entry. If the main entry fills later, Whale-E then creates the exit orders using the levels evaluated when the arm_exit block ran.

[[entry]]
id            = "place_limit_entry"
order_id      = "main"
direction     = "long"
limit         = "close * 0.995"
wait_candles  = 0
next_block_id = "arm_exit"

[[exit]]
id            = "arm_exit"
order_id      = "main_exit"
from_entry    = "main"
profit        = 250
loss          = 150
wait_candles  = 0
next_block_id = "next_step"

Cancelling exit orders#

This example cancels existing exit orders for exit_main by omitting all exit levels.

[[exit]]
id       = "cancel_exit"
order_id = "exit_main"

No delay#

This example keeps the same exit levels but chains to the next block immediately.

[[exit]]
id           = "instant_exit"
order_id     = "instant_exit"
profit       = 50
loss         = 50
wait_candles = 0

Block parameters#