Batch Place Orders

Batch Place Orders

Submit up to 5 orders in a single request. Each order is executed independently, and a failure in one item does not affect the others.

Request frequency limit: 1/1s

Request URL

POST /deepcoin/trade/batch-orders

Request Parameters

Request body:

Field Name	Required	Type	Description
orders	true	array	Order list, maximum 5 items per request

Order item fields:

Field Name	Required	Type	Description
instId	true	string	Product ID
tdMode	true	string	Trading mode Isolated: isolated Cross: cross Cash: cash
ccy	false	string	Margin currency, only applicable to cross margin orders in single-currency margin mode
clOrdId	false	string	Custom order ID, combination of letters and numbers, length between 1-32. Currently not supported by downstream order placement
tag	false	string	Order tag, combination of letters and numbers, length between 1-16. Currently not supported by downstream order placement
side	true	string	Order side Buy: buy Sell: sell
posSide	false	string	Position side Required when product type is SWAP Long: long Short: short
mrgPosition	false	string	Position mode Required when product type is SWAP Merged: merge Split: split
closePosId	false	string	Position ID to close, required in split mode
ordType	true	string	Order type Market: market Limit: limit Post only: post_only IOC: ioc
sz	true	string	Order size, get minimum order size (minSz) through Get Product Info API
px	false	string	Order price, only applicable to limit and post_only orders
reduceOnly	false	boolean	Reduce-only flag
tgtCcy	false	string	Market order quantity type for spot orders base_ccy / quote_ccy
tpTriggerPx	false	string	Take profit trigger price
slTriggerPx	false	string	Stop loss trigger price

Request Example

{
  "orders": [
    {
      "instId": "BTC-USDT-SWAP",
      "tdMode": "cross",
      "side": "buy",
      "ordType": "limit",
      "sz": "1",
      "px": "65000",
      "posSide": "long",
      "mrgPosition": "merge"
    },
    {
      "instId": "ETH-USDT-SWAP",
      "tdMode": "cross",
      "side": "sell",
      "ordType": "market",
      "sz": "2",
      "posSide": "short",
      "mrgPosition": "merge"
    }
  ]
}

Response Parameters

The data field is an array, and each item corresponds to the same index in the request orders.

Field Name	Type	Description
ordId	string	Order ID. Empty string when placement fails
clOrdId	string	Custom order ID. Currently returned as empty string
tag	string	Order tag. Currently returned as empty string
sCode	string	Per-order execution result code, 0 means success
sMsg	string	Per-order error message

Response Example

{
  "code": "0",
  "msg": "",
  "data": [
    {
      "ordId": "1000587866646229",
      "clOrdId": "",
      "tag": "",
      "sCode": "0",
      "sMsg": ""
    },
    {
      "ordId": "",
      "clOrdId": "",
      "tag": "",
      "sCode": "36",
      "sMsg": "InsufficientMoney"
    }
  ]
}