Skip to main content

Place Order

Description

Place an order in futures trading.

HTTP Request

POST /v3/trade/order

Request Parameters

ParameterRequiredTypeDescription
symbolYesStringA trading pair, consisting of two currencies: base currency and quote currency
sideYesStringEnumerate: BUY and SELL
typeYesStringOrder type; enumerate MARKET, LIMIT, and LIMIT_MAKER
clOrdIdNoStringOrder ID as assigned by the user
pxNoStringPrice, applicable for limit orders only. No price input is required for market orders.
szYesStringOrder size, specifically in Cont
reduceOnlyNoBooleanReduce only
timeInForceNoStringEnumerate FOK, IOC, and GTC. It is an optional field with GTC by default.
stpModeNoStringEnumerate
- EXPIRE_TAKER
- EXPIRE_MAKER
- EXPIRE_BOTH
Default is NONE

Response Parameters

ParameterTypeDescription
ordIdStringOrder ID
clOrdIdStringClient Order ID as assigned by the client

Request Example

{
"clOrdId": "939a9d51-8f32-443a-9fb8-ff0852010487",
"symbol": "BTC_USDT_PERP",
"side": "buy",
"type": "limit_maker",
"px": "46050",
"sz": "10",
"timeInForce": "GTC",
"stpMode": "EXPIRE_TAKER",
"reduceOnly": false
}

Response Example

{
"code":200,
"data":{
"clOrdId":"939a9d51-8f32-443a-9fb8-ff0852010487",
"ordId":"331375826421678080"
},
"msg":"Success"
}