Skip to main content

Get Unfilled Order

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/pending-order

Request parameters

Parameter NameRequiredTypeNotes
marketfalsestringMarket name
market_typetruestringMarket type.
Note: In spot related functions, only SPOT or MARGIN can be used.
In futures related functions, only FUTURES can be used.
sidefalsestringOrder side
client_idfalsestringUser-defined ID
pagefalseintNumber of pagination. Default is 1.
limitfalseintNumber in each page. Default is 10.

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

Request example

GET /futures/pending-order?market=CETUSDT&market_type=FUTURES&side=buy&page=1&limit=10

Response example

{
"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
}
],
"pagination": {
"total": 1,
"has_next": false
}
"message": "OK"
}