Place Order

info

Do not use the duplicate orderLinkId in normal order & TP/SL order

HTTP Request

POST /spot/v3/private/order

Request Parameters

Parameter	Required	Type	Comments
symbol	true	string	Name of the trading pair
orderQty	true	string	Order qty. When you place a MARKET BUY order, this param means quote amount. e.g., MARKET BUY BTCUSDT, orderQty should be 200 USDT
side	true	string	Side. BUY, SELL
orderType	true	string	Order type
timeInForce	false	string	Time in force
orderPrice	false	string	Order price. When the type field is MARKET, the price field is optional. When the type field is LIMIT or LIMIT_MAKER, the price field is required
orderLinkId	false	string	User-generated order ID
orderCategory	false	integer	Order category. 0：normal order by default; 1：TP/SL order, Required for TP/SL order.
triggerPrice	false	string	Trigger price. Used for TP/SL order
smpType	false	string	Smp execution type. What is SMP?

Response Parameters

Parameter	Type	Comments
orderId	string	Order ID
orderLinkId	string	User-generated order ID
symbol	string	Name of the trading pair
createTime	string	Order Creation Time
orderPrice	string	Last traded price
orderQty	string	Order quantity
orderType	string	Order type
side	string	Side. BUY, SELL
status	string	Order status
timeInForce	string	Time in force
accountId	string	Account ID
execQty	string	Please ignore
orderCategory	integer	Order category. 0：normal order by default; 1：TP/SL order
triggerPrice	string	Trigger price. TP/SL order has this field
smpType	string	Smp execution type

Request Example

POST /spot/v3/private/order HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1673333450317
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 146

{
    "symbol": "ETHUSDT",
    "orderPrice": "1220",
    "side": "SELL",
    "orderQty": "1",
    "orderType": "LIMIT",
    "timeInForce": "GTC"
}

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "orderId": "1330411843270754304",
        "orderLinkId": "1673333450634810",
        "symbol": "ETHUSDT",
        "createTime": "1673333450646",
        "orderPrice": "1220",
        "orderQty": "1",
        "orderType": "LIMIT",
        "side": "SELL",
        "status": "NEW",
        "timeInForce": "GTC",
        "accountId": "592335",
        "execQty": "0",
        "orderCategory": 0,
        "smpType": "None"
    },
    "retExtInfo": {},
    "time": 1673333450660
}