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
}