Create Order

Place a spread combination order. Up to 50 open orders per account.

HTTP Request

POST/v5/spread/order/create

Request Parameters

Parameter	Required	Type	Comments
symbol	true	string	Spread combination symbol name
side	true	string	Order side. Buy, Sell
orderType	true	string	Limit, Market
qty	true	string	Order qty
price	false	string	Order price
orderLinkId	false	string	User customised order ID, a max of 45 characters. Combinations of numbers, letters (upper and lower cases), dashes, and underscores are supported.
timeInForce	false	string	Time in force. IOC, FOK, GTC, PostOnly

info

The acknowledgement of an place order request indicates that the request was sucessfully accepted. This request is asynchronous so please use the websocket to confirm the order status.

Response Parameters

Parameter	Type	Comments
orderId	string	Spread combination order ID
orderLinkId	string	User customised order ID

Request Example

HTTP

POST /v5/spread/order/create HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1744079410023
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 191

{
    "symbol": "SOLUSDT_SOL/USDT",
    "side": "Buy",
    "orderType": "Limit",
    "qty": "0.1",
    "price": "21",
    "orderLinkId": "1744072052193428479",
    "timeInForce": "PostOnly"
}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.spread_place_order(
    symbol="SOLUSDT_SOL/USDT",
    side="Buy",
    orderType="Limit",
    qty="0.1",
    price="21",
    orderLinkId="1744072052193428479",
    timeInForce="PostOnly"
))

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "orderId": "1b00b997-d825-465e-ad1d-80b0eb1955af",
        "orderLinkId": "1744072052193428479"
    },
    "retExtInfo": {},
    "time": 1744075839332
}