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.

Responses

🟢200OK

application/json

Body

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",
            "positionSide": "BOTH",
            "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",
            "positionSide": "BOTH",
            "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",
            "positionSide": "BOTH",
            "avgDealPrice": "67445.0",
            "filledSize": 1,
            "filledValue": "67.445",
            "status": "done",
            "reduceOnly": false
        }
    ]
}

Get Recent Closed Orders

Request

Request Code Samples

Responses