Get Trade History - Old

It is recommended to use the GET /api/v1/hf/fills endpoint instead of this endpoint

Description

Request recent fills via this endpoint.
The return value is the data after Pagination, sorted in descending order according to time.

Tips

The system allows you to retrieve up to one week’s worth of data (starting from the last day by default). If the time period of the queried data exceeds one week (time range from the start to end time exceeding 7 * 24 hours), the system will prompt to remind you that you have exceeded the time limit. If you only specified the start time, the system will automatically calculate the end time (end time = start time + 7 * 24 hours). Conversely, if you only specified the end time, the system will calculate the start time (start time = end time - 7 * 24 hours) the same way.

The total number of items retrieved cannot exceed 50,000. If it is exceeded, please shorten the query time range.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "currentPage": 1,
        "pageSize": 50,
        "totalNum": 1,
        "totalPage": 1,
        "items": [
            {
                "symbol": "DOGE-USDT",
                "tradeId": "10862827223795713",
                "orderId": "6745698ef4f1200007c561a8",
                "counterOrderId": "6745695ef15b270007ac5076",
                "side": "buy",
                "liquidity": "taker",
                "forceTaker": false,
                "price": "0.40739",
                "size": "10",
                "funds": "4.0739",
                "fee": "0.0040739",
                "feeRate": "0.001",
                "feeCurrency": "USDT",
                "stop": "",
                "tradeType": "TRADE",
                "type": "market",
                "createdAt": 1732602254928
            }
        ]
    }
}