Place a new multi-leg order
Submits a new multi-leg order asynchronously for the specified account. Note: Order placement is asynchronous. This response confirms submission only. To verify the order status or execution details, use the GET /{orderId} endpoint after placement.
LIMIT orders are accepted.limitPrice is positive for a net debit and negative for a net credit. Option legs need an openCloseIndicator.ratioQuantity is its ratio within the strategy: typically 1 for an option leg and 100 for an equity leg.You are using your live production account. These commands will execute real orders in your real account, proceed with caution.
Buy the 240 call and sell the 250 call for a net debit of $4.50 or less. Debit limit prices are positive. The code samples and the playground use this request.
| Name | Type | Required | Description |
|---|---|---|---|
| accountId | string | Yes | - |
The OrderId, a UUID conforming to RFC 4122 (8-4-4-4-12 format, e.g., 0d2abd8d-3625-4c83-a806-98abf35567cc), globally unique over time. Serves as the deduplication key; if reused on the same account, the operation is idempotent.
The order quantity
The order type. Only LIMIT order are allowed
MARKET,LIMIT,STOP,STOP_LIMIT,MARKET_ON_CLOSE,LIMIT_ON_CLOSEThe limit price for the order. For debit spreads the limit price must be positive, for create spreads the limit price is negative
From 2-6 legs. There can be at most 1 equity leg
Optional field to indicate whether to use margin buying power. Defaults to true if not specified.
The id of a locate requested ahead of this order with the locate endpoint. Only for orders whose equity leg sells to open a hard-to-borrow equity. The locate must belong to the account, be for the symbol of the equity leg, not have expired, not have been used by another order, and cover the shares of the equity leg. If omitted, the shares are located as part of placing the order.
Order validation failed.
No response body defined
{
"orderId": "167a5bbe-7dae-400e-a424-d94c311e2d58"
}