Perpetuals: advanced orders

Advanced orders are execution algorithms and trigger structures that the exchange runs for you: you submit the intent, a server-side executor slices, watches or arms it, and child orders hit the book on your behalf. They survive client disconnects.

Every type follows the same shape:

POST   /api/v1/perp/orders/{type}        create
GET    /api/v1/perp/orders/{type}        list
DELETE /api/v1/perp/orders/{type}/{id}   cancel
GET    /api/v1/perp/orders/advanced      list every type in one call

{type} is one of twap, vwap, pov, scale, iceberg, oco, bracket, pegged, sniper, conditional, trailing-stop. Each create call costs weight 2 against your rate budget (Rate limits). All of them accept clientOrderId, leverage, positionSide and (where it makes sense) reduceOnly.

Scheduled execution

TWAP — spread a size evenly over a window.

VWAP — same idea, weighted toward expected volume.

POV — participate at a share of market volume.

maxDurationSeconds is what stops a POV order from running forever in a market that stops trading — it is required for that reason.

Passive placement

Scale — a ladder of resting orders.

Iceberg — show a slice, hide the rest.

Pegged — track the book instead of a fixed price.

Always set minPrice / maxPrice on a pegged order. Without them the peg follows the book wherever it goes.

Triggers and exits

Conditional — fire an order when a trigger price prints.

OCO — two exits, either one cancels the other.

Bracket — entry plus both exits, submitted as one structure.

Trailing stop — a stop that follows the favourable side.

Sniper — wait for a condition, then take aggressively.

Interaction with TP/SL

Bracket exits and OCO legs are protection on a position, the same slot that POST /perp/positions/{market}/tpsl writes to. Setting position TP/SL while a bracket or OCO is live is refused with POS_TPSL_EXISTS (14005), listing the order ids that hold that protection — send replace: true to cancel them and take over. The protection array on the position shows what is currently armed and which engine owns it.

Failure codes