Place a margin or futures limit order that rests in the order book until it is matched or canceled. This is the counterpart of order_limit_place, and like its spot twin it is the only method in the collateral_* family that accepts rpi.
Rate limits
Place margin limit order
Request parameters
Two parameters set this family apart from the spot methods. The reduce_only flag restricts the order to shrinking an existing position, and position_side selects the position leg in hedge mode. Both are described in Margin & Futures orders.
Across the whole collateral_* family amount is stock on both sides. Leverage and margin come from the account collateral configuration and are not order parameters — see Margin Trading and Futures.
Response
The result object is the standard order object plus reduce_only and position_side — see the order object reference. A margin limit order reports type 7.
Hedge mode governs position_side. The field is optional at the request layer but functionally required once hedge mode is enabled — omitting it, or sending BOTH, returns error 114, same as sending a value other than BOTH without hedge mode enabled. A switch in progress returns error 113. On a non-futures margin market any value other than BOTH is rejected with error 1.
Error codes
Standard transport errors and the shared account, rate-limit, and region codes are listed in Order Management.