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.