Trade

Submit Multi-leg Order

POSThttps://openapi.longbridge.com/v1/trade/order/multileg

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=.

This API is used to submit a multi-leg option combination order (such as vertical spreads, straddles, strangles, collars, etc.). All legs are submitted together as a single strategy order.

Request

Request body

NameTypeRequiredDescription
sidestringRequiredOrder Side. **Enum Value:**, `Buy`, `Sell`
order_typestringRequiredOrder Type. One of: `LO`, `ELO`, `MO`, `AO`, `ALO`, `ODD`, `LIT`, `MIT`, `TSLPAMT`, `TSLPPCT`, `SLO`.
submitted_pricestringOptionalSubmitted price, example: `1.5`. Required for limit order types such as `LO`
submitted_quantitystringRequiredSubmitted quantity (number of combinations), example: `1`
strategystringRequiredMulti-leg strategy. **Enum Value:**, `CoveredCall` - Covered stock, `CoveredPut` - Covered stock, `VerticalCallSpread` - Vertical spread, `VerticalPutSpread` - Vertical spread, `Collar` - Collar, `Straddle` - Straddle, `Strangle` - Strangle
legsarrayRequiredLegs of the combination order
∟ symbolstringRequiredOption symbol, use `ticker.region` format, example: `QQQ260731C764000.US`
∟ ratio_quantitystringRequiredLeg ratio quantity, example: `1`
remarkstringOptionalRemark (Maximum 255 characters)
client_request_idstringOptionalClient request ID, used for idempotency (Maximum 64 characters)

Response

Response JSON example

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": "683615454870679600"
  }
}

Error code

See the Error Codes page for the full list of error codes.