Skip to main content

Batch Query Order Status

Info
  • This endpoint requires signature. For specific signature rules, please refer to Authentication
  • This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.
Dangerous
  • After an order without any transactions is canceled, the server will not save the order, nor can the data of this order be queried via any endpoint.

HTTP request

GET /futures/batch-order-status

Request parameters

Parameter NameRequiredTypeNotes
markettruestringMarket name
order_idstruestringBatch order IDs, separated by ","

Return parameters

Parameter NameTypeNotes
order_idintOrder ID
marketstringMarket name
market_typestringMarket Type
sidestringOrder side
typestringOrder type
amountstringOrder amount
pricestringOrder price
unfilled_amountstringThe remaining unfilled amount
filled_amountstringFilled amount
filled_valuestringFilled value
client_idstringClient ID
feestringTrading fee charged
fee_ccystringTrading fee currency
maker_fee_ratestringMaker fee rate
taker_fee_ratestringTaker fee rate
last_filled_amountstringFilled amount of the last transaction
last_filled_pricestringFilled price of the last transaction
realized_pnlstringRealized PNL
created_atintOrder creation time
updated_atintOrder update time
statusstringOrder status

Request example

GET /futures/batch-order-status?market=CETUSDT&order_ids=13400,13401

Response example

{
"code": 0,
"data": [
{
"code": 0,
"data": {
"order_id": "13400",
"market": " CETUSDT",
"market_type": "FUTURES",
"side": "buy",
"type": "limit",
"amount": "10000",
"price": "1",
"unfilled_amount": "50241.7185224371",
"filled_amount": "27564.87468358",
"filled_value": "27564.87468358",
"client_id": "client_id_1",
"fee": "11.6582326221",
"fee_ccy": "USDT",
"maker_fee_rate": "0",
"taker_fee_rate": "0.0003",
"last_filled_amount": "27564.87468358",
"last_filled_price": "1",
"realized_pnl": "-22.142539215",
"created_at": 1691482451000,
"updated_at": 1691482451000,
"status": "part_deal"
},
"message": "OK"
}
],
"message": "OK"
}