> For the complete documentation index, see [llms.txt](https://docs.pearprotocol.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pearprotocol.io/api-integration/executing-trade/order-type/ladder-order.md).

# 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`:

```json
{
  "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.
