Get Recent Closed Orders

Description

Get a list of recent 1000 closed orders in the last 24 hours.

If you need to get your recent traded order history with low latency, you may query this endpoint.

Any limit order on the exchange order book is in active status. Orders removed from the order book will be marked with done status. After an order becomes done, there may be a few milliseconds latency before it’s fully settled.

You can check the orders in any status. If the status parameter is not specified, orders of done status will be returned by default.

When you query orders in active status, there is no time limit. However, when you query orders in done status, the start and end time range cannot exceed 24*7 hours. An error will occur if the specified time window exceeds the range. If you specify the end time only, the system will automatically calculate the start time as end time minus 24 hours, and vice versa.

POLLING
For high-volume trading, it is highly recommended that you maintain your own list of open orders and use one of the streaming market data feeds to keep it updated. You should poll the open orders endpoint to obtain the current state of any open order.

If you need to get your recent trade history with low latency, you may query the endpoint Get List of Orders Completed in 24h.

API KEY PERMISSIONS
This endpoint requires the General permission.

REQUEST URL
This endpoint support Futures URL

REQUEST RATE LIMIT
Futures weight：2

Responses

🟢200OK

application/json

Body

code

string

required

data

array [object {38}]

required

string

required

Order ID

symbol

string

required

Symbol of the contract, Please refer to Get Symbol endpoint: symbol

type

string

required

Order type, market order or limit order

side

string

required

Transaction side

price

string

required

Order price

size

integer

required

Order quantity

value

string

required

Order value

dealValue

string

required

Executed size of funds

dealSize

integer

required

Executed quantity

stp

string

required

self trade prevention

stop

string

required

Stop order type (stop limit or stop market)

stopPriceType

string

required

Trigger price type of stop orders

stopTriggered

boolean

required

Mark to show whether the stop order is triggered

stopPrice

integer

required

Trigger price of stop orders

timeInForce

string

required

Time in force policy type

postOnly

boolean

required

Mark of post only

hidden

boolean

required

Mark of the hidden order

iceberg

boolean

required

Mark of the iceberg order

leverage

string

required

Leverage of the order

forceHold

boolean

required

A mark to forcely hold the funds for an order

closeOrder

boolean

required

A mark to close the position

visibleSize

integer

required

Visible size of the iceberg order

clientOid

string

required

Unique order id created by users to identify their orders

remark

string

required

Remark of the order

tags

string

required

tag order source

isActive

boolean

required

Mark of the active orders

cancelExist

boolean

required

Mark of the canceled orders

createdAt

integer <int64>

required

Time the order created

updatedAt

integer <int64>

required

last update time

endAt

integer <int64>

required

End time

orderTime

integer <int64>

required

Order create time in nanosecond

settleCurrency

string

required

settlement currency

marginMode

string

required

Margin mode: ISOLATED (isolated), CROSS (cross margin).

avgDealPrice

string

required

Average transaction price, forward contract average transaction price = sum (transaction value) / sum (transaction quantity), reverse contract average transaction price = sum (transaction quantity) / sum (transaction value). Transaction quantity = lots * multiplier

filledSize

integer

required

Value of the executed orders

filledValue

string

required

Executed order quantity

status

string

required

order status: “open” or “done”

reduceOnly

boolean

required

A mark to reduce the position size only

Example

{
  "code": "200000",
  "data": [
    {
      "id": "236387137732231168",
      "symbol": "XRPUSDTM",
      "type": "market",
      "side": "buy",
      "price": "0",
      "size": 1,
      "value": "5.51",
      "dealValue": "5.511",
      "dealSize": 1,
      "stp": "",
      "stop": "",
      "stopPriceType": "",
      "stopTriggered": false,
      "stopPrice": null,
      "timeInForce": "GTC",
      "postOnly": false,
      "hidden": false,
      "iceberg": false,
      "leverage": "10.0",
      "forceHold": false,
      "closeOrder": false,
      "visibleSize": 0,
      "clientOid": "16698fe6-2746-4aeb-a7fa-61f633ab6090",
      "remark": null,
      "tags": "",
      "isActive": false,
      "cancelExist": false,
      "createdAt": 1729172287496,
      "updatedAt": 1729172287568,
      "endAt": 1729172287568,
      "orderTime": 1729172287496950800,
      "settleCurrency": "USDT",
      "marginMode": "ISOLATED",
      "avgDealPrice": "0.5511",
      "filledSize": 1,
      "filledValue": "5.511",
      "status": "done",
      "reduceOnly": false
    },
    {
      "id": "236317213710184449",
      "symbol": "XBTUSDTM",
      "type": "market",
      "side": "buy",
      "price": "0",
      "size": 1,
      "value": "67.4309",
      "dealValue": "67.4309",
      "dealSize": 1,
      "stp": "",
      "stop": "",
      "stopPriceType": "",
      "stopTriggered": false,
      "stopPrice": null,
      "timeInForce": "GTC",
      "postOnly": false,
      "hidden": false,
      "iceberg": false,
      "leverage": "3",
      "forceHold": false,
      "closeOrder": false,
      "visibleSize": 0,
      "clientOid": "5c52e11203aa677f33e493fb",
      "remark": null,
      "tags": "",
      "isActive": false,
      "cancelExist": false,
      "createdAt": 1729155616310,
      "updatedAt": 1729155616324,
      "endAt": 1729155616324,
      "orderTime": 1729155616310180400,
      "settleCurrency": "USDT",
      "marginMode": "ISOLATED",
      "avgDealPrice": "67430.9",
      "filledSize": 1,
      "filledValue": "67.4309",
      "status": "done",
      "reduceOnly": false
    },
    {
      "id": "236317094436728832",
      "symbol": "XBTUSDTM",
      "type": "market",
      "side": "buy",
      "price": "0",
      "size": 1,
      "value": "67.445",
      "dealValue": "67.445",
      "dealSize": 1,
      "stp": "",
      "stop": "",
      "stopPriceType": "",
      "stopTriggered": false,
      "stopPrice": null,
      "timeInForce": "GTC",
      "postOnly": false,
      "hidden": false,
      "iceberg": false,
      "leverage": "3",
      "forceHold": false,
      "closeOrder": false,
      "visibleSize": 0,
      "clientOid": "5c52e11203aa677f33e493fb",
      "remark": null,
      "tags": "",
      "isActive": false,
      "cancelExist": false,
      "createdAt": 1729155587873,
      "updatedAt": 1729155587946,
      "endAt": 1729155587946,
      "orderTime": 1729155587873332000,
      "settleCurrency": "USDT",
      "marginMode": "ISOLATED",
      "avgDealPrice": "67445.0",
      "filledSize": 1,
      "filledValue": "67.445",
      "status": "done",
      "reduceOnly": false
    }
  ]
}

Get Recent Closed Orders

Request

Request samples

Responses