Skip to main content

Get Filled 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 /spot/finished-order

Request parameters

Parameter NameRequiredTypeNotes
marketfalsestringMarket name. Pass to return orders in all markets
Note: market_type MARGIN cannot be null or passed
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, null to return orders of both sides
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
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
created_atintOrder creation time
updated_atintOrder update time

Request example

GET /spot/finished-order?market=CETUSDT&market_type=MARGIN&order_side=buy&page=1&limit=10

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