Skip to main content

Take Profit Stop Loss

The Take Profit Stop Loss (TPSL) module enables conditional orders that automatically execute when certain price conditions are met. This allows traders to set up automated trading strategies that protect against losses (stop loss) or lock in profits (take profit) without requiring constant monitoring.

How TPSL works​

  1. Create a condition: Define whether the order should trigger when the price goes above or below a specified trigger price.
  2. Create a pending order: Specify the order details (limit or market order) that the system places when the condition is met.
  3. Add conditional order: Combine the condition and pending order, and add them to your margin manager.
  4. Execution: Anyone can call the permissionless execute_conditional_orders function to execute orders whose conditions are met. This is typically handled by keepers or bots monitoring the market.

Conditional orders are stored in sorted vectors for efficient execution:

  • trigger_below: Orders that trigger when the price falls below the trigger price (sorted from high to low)
  • trigger_above: Orders that trigger when the price rises above the trigger price (sorted from low to high)

API​

Helper functions​

Use these functions to create conditions and pending orders for conditional orders.

Click to open
Create a condition

Create a new condition that specifies when the order should trigger.

Click to open
Create a pending limit order

Create a pending limit order that the system places when the condition is met. Order type must be no_restriction or immediate_or_cancel.

Click to open
Create a pending market order

Create a pending market order that the system places when the condition is met.

Manage conditional orders​

These functions are exposed on the MarginManager to manage conditional orders.

Click to open
Add conditional order

Add a conditional order to the margin manager. The system places the order when the condition is met. Validates that the trigger condition is valid relative to the current price.

Click to open
Cancel conditional order

Cancel a specific conditional order by ID.

Click to open
Cancel all conditional orders

Cancel all conditional orders for the margin manager.

Click to open
Execute conditional orders

Execute conditional orders whose conditions are met. This is a permissionless function that can be called by anyone (typically keepers or bots).

Click to open
Read endpoints

Events​

Click to open
ConditionalOrderAdded

The system emits this event when you add a conditional order to a margin manager.

Click to open
ConditionalOrderCancelled

The system emits this event when you cancel a conditional order.

Click to open
ConditionalOrderExecuted

The system emits this event when a conditional order executes.

Click to open
ConditionalOrderInsufficientFunds

The system emits this event when a conditional order fails to execute due to insufficient funds.