Skip to main content
Version: Next

Create Order

Create a futures opening or closing order, supporting market and limit orders.

API Information

  • Method: POST
  • Path: /api/v1/futures/open-api/order/create

Request Parameters

ParameterTypeRequiredDescription
symbolstringYesFutures trading pair, e.g. BTCUSDT
coTypeintYesContract type: 1=US stocks, 2=Hong Kong stocks, 3=Cryptocurrency
orderTypeintYesOrder type: 1=Limit, 2=Market
openTypeintYesOpen/Close: 1=Open, 2=Close
sideintYesDirection: 1=Long (Buy), 2=Short (Sell)
pricestringConditionalOrder price (required for limit orders)
volstringConditionalQuantity (choose vol or amt)
amtstringConditionalAmount in USD (choose vol or amt, recommended for opening)
leveragestringRequired for openLeverage, e.g. "10"
marginModeintNoMargin mode: 1=Cross, 2=Isolated, default 1
posIdint64Required for closePosition ID
stopProfitPricestringNoTake profit price
stopLossPricestringNoStop loss price
triggerTypeintNoTrigger type: 1=Normal, 2=Take profit, 3=Stop loss, 4=Liquidation

Request Example

Opening Example:

{
"symbol": "BTCUSDT",
"coType": 3,
"orderType": 2,
"openType": 1,
"side": 1,
"amt": "10000",
"leverage": "10",
"marginMode": 1,
"triggerType": 1
}

Closing Example:

{
"symbol": "BTCUSDT",
"coType": 3,
"orderType": 2,
"openType": 2,
"side": 1,
"posId": 123456,
"vol": "0.5",
"triggerType": 1
}

Response Fields

FieldTypeDescription
codeintStatus code, 200 indicates success
msgstringResponse message
data.orderIdint64Order ID
data.orderNostringOrder number

Response Example

{
"code": 200,
"msg": "success",
"data": {
"orderId": 123456789,
"orderNo": "ORD20240120001"
}
}