Skip to main content

Order Status Query

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 /spot/order-status

Request parameters

Parameter NameRequiredTypeNotes
markettruestringMarket name
order_idtrueintOrder ID

Return parameters

Parameter NameTypeNotes
order_idintOrder ID
marketstringMarket name
market_typestringMarket Type
ccystringCurrency name
sidestringOrder side
typestringOrder type
amountstringOrder amount
pricestringOrder price
unfilled_amountstringThe remaining unfilled amount
filled_amountstringFilled amount
filled_valuestringFilled value
client_idstringClient ID
base_feestringTrading fee charged in base currency
quote_feestringTrading fee charged in quote currency
discount_feestringTrading fee charged in deduction currency
maker_fee_ratestringMaker fee rate
taker_fee_ratestringTaker fee rate
last_filled_amountstringFilled amount of the last transaction
order_status Null if the order is filled
last_filled_pricestringFilled price of the last transaction
order_status Null if the order is filled
created_atintOrder creation time
updated_atintOrder update time
statusstringOrder status

Request example

GET /spot/order-status?market=CETUSDT&order_id=13400

Response example

{
"code": 0,
"data": {
"order_id": 13400,
"market": " CETUSDT",
"market_type": "MARGIN",
"ccy": "CET",
"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",
"base_fee": "11.6582326221",
"quote_fee": "0",
"discount_fee": "0",
"maker_fee_rate": "0",
"taker_fee_rate": "0.0003",
"last_fill_amount": "27564.87468358",
"last_fill_price": "1",
"created_at": 1691482451000,
"updated_at": 1691482451000,
"status": "part_deal"
},
"message": "OK"
}