Batch Get Order Info

Batch Get Order Info

Query up to 5 orders in a single request. Each item is queried independently and returned in request order.

Request frequency limit: 1/1s

Request URL

POST /deepcoin/trade/batch-order-query

Request Parameters

Request body:

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

Query item fields:

Field Name	Required	Type	Description
instId	true	string	Product ID
ordId	false	string	Order ID. One of ordId or clOrdId must be provided
clOrdId	false	string	Client order ID. One of ordId or clOrdId must be provided

Request Example

{
  "orders": [
    {
      "instId": "BTC-USDT-SWAP",
      "ordId": "1000597586292096"
    },
    {
      "instId": "ETH-USDT-SWAP",
      "ordId": "1000597586292104"
    }
  ]
}

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
clOrdId	string	Client order ID
sCode	string	Per-item query status code, 0 means success
sMsg	string	Per-item query status message
data	object	Order detail. null when query fails

The data object uses the same fields as the single-order query response.

Response Example

{
  "code": "0",
  "msg": "",
  "data": [
    {
      "ordId": "1000597586292096",
      "clOrdId": "",
      "sCode": "0",
      "sMsg": "",
      "data": {
        "instType": "SWAP",
        "instId": "BTC-USDT-SWAP",
        "tgtCcy": "",
        "ccy": "",
        "ordId": "1000597586292096",
        "clOrdId": "",
        "tag": "",
        "px": "65000",
        "sz": "1",
        "pnl": "0",
        "ordType": "limit",
        "side": "buy",
        "posSide": "long",
        "tdMode": "cross",
        "accFillSz": "0",
        "fillPx": "",
        "tradeId": "",
        "fillSz": "",
        "fillTime": "",
        "avgPx": "",
        "state": "live",
        "lever": "10",
        "tpTriggerPx": "",
        "tpTriggerPxType": "",
        "tpOrdPx": "",
        "slTriggerPx": "",
        "slTriggerPxType": "",
        "slOrdPx": "",
        "feeCcy": "USDT",
        "fee": "0",
        "rebateCcy": "",
        "source": "",
        "rebate": "",
        "category": "normal",
        "uTime": "1773913896000",
        "cTime": "1773913896000"
      }
    }
  ]
}