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

Query Params

symbol

string

required

symbol

Example:

BTC-USDT

orderId

string

optional

The unique order ID generated by the trading system. (If orderId is specified, please ignore the other query parameters.)

side

enum<string>

optional

Specify if the order is to 'buy' or 'sell'.

Allowed values:

buysell

type

enum<string>

optional

limit, market, limit_stop or market_stop

Allowed values:

limitmarketlimit_stopmarket_stop

tradeType

enum<string>

optional

The type of trading: TRADE - Spot Trading (TRADE as default), MARGIN_TRADE - Cross Margin Trading, MARGIN_ISOLATED_TRADE - Isolated Margin Trading.

Allowed values:

TRADEMARGIN_TRADEMARGIN_ISOLATED_TRADE

Default:

TRADE

startAt

integer <int64>

optional

Start time (milliseconds)

Example:

1728663338000

endAt

integer <int64>

optional

End time (milliseconds)

Example:

1728692138000

currentPage

integer

optional

Current request page.

Default:

pageSize

integer

optional

Number of results per request. Minimum is 10, maximum is 500.

>= 10<= 500

Example:

Responses

🟢200OK

application/json

Body

code

string

required

data

object

required

currentPage

integer

required

pageSize

integer

required

totalNum

integer

required

totalPage

integer

required

items

array [object {17}]

required

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
      }
    ]
  }
}

Get Trade History - Old

Request

Request samples

Responses