Ladder Order

A ladder order creates multiple trigger orders spread across a range of weighted ratio levels. Instead of entering a full position at one price, the total USD value is distributed evenly across levels that fire as the weighted ratio moves through the range.

Ladder orders are not limit orders β€” each level is a trigger order that executes a market order when the weighted ratio reaches that level.

Use executionType: "LADDER" with a ladderConfig:

{
  "executionType": "LADDER",
  "leverage": 5,
  "usdValue": 1000,
  "slippage": 0.01,
  "longAssets": [{ "asset": "BTC", "weight": 1 }],
  "shortAssets": [{ "asset": "ETH", "weight": 1 }],
  "ladderConfig": {
    "ratioStart": 40,
    "ratioEnd": 44,
    "numberOfLevels": 5
  }
}

This creates 5 trigger orders at weighted ratios 40, 41, 42, 43, 44, each for $200 (= $1,000 / 5). All triggers use WEIGHTED_RATIO type with LESS_THAN direction.

Level
Trigger Ratio
USD

1

40.0

$200

2

41.0

$200

3

42.0

$200

4

43.0

$200

5

44.0

$200

Config constraints: numberOfLevels must be between 2 and 50.

Last updated