createIcebergStrategy
Splits a large order into multiple smaller child orders, displaying only one at a time to hide total size and reduce market impact.
Instructions
Creates an Iceberg strategy that splits a large order into multiple smaller child orders, displaying only one at a time to hide trading intent.
When to use:
You have a large order and want to hide total size from the market
You want to prevent price manipulation based on your order size
You need to reduce market impact while maintaining consistent pricing
You want to earn maker rebates by using post-only orders
Execution behavior:
Calculate child order size:
If subSize provided: orderCount = size / subSize
If orderCount provided: subSize = size / orderCount
Create first child order (limit or chase pricing)
Wait for child order to fill completely
Once filled, create next child order
Repeat until all size is executed
Each child order is independent - can have different prices if chasing
Important notes:
Recommended subSize: 5%-20% of total size
Enable postOnly=1 to get maker fee rebates
Set chaseDistance="-1" for aggressive taker execution (hit best bid/ask)
Always set maxChasePrice for price protection
Strategy executes sequentially - slower than Chase but more stealthy
If a child order is partially filled and canceled, strategy continues with remaining amount
Agent hint: Use this endpoint when user wants to hide large order size from the market. Best for "buy 100 BTC without showing the full size" type requests. Do not use for time-sensitive execution - use Chase Order instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | Yes | ||
| symbol | Yes | ||
| side | Yes | ||
| size | Yes | ||
| strategyType | No | iceberg | |
| subSize | No | ||
| orderCount | No | ||
| limitPrice | No | ||
| chaseDistance | No | ||
| chasePercentE4 | No | ||
| maxChasePrice | No | ||
| postOnly | No | 0 | |
| reduceOnly | No | ||
| positionIdx | No | 0 | |
| leverageType | No | 0 |