Get Orders List - Old

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

Description

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

Tips

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 7 * 24 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 7 * 24 hours, and vice versa.

The history for canceled orders is only kept for one month. The history for filled orders is only kept for six months.

Request

Query Params

symbol

string

optional

Symbol

Example:

BTC-USDT

status

enum<string>

optional

Active or done (done as default); only list orders with a specific status.

Allowed values:

activedone

Default:

done

side

enum<string>

optional

Buy or Sell

Allowed values:

buysell

type

enum<string>

optional

Order type

Allowed values:

limitmarketlimit_stopmarket_stopoco_limitoco_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)

endAt

integer <int64>

optional

End time (milliseconds)

currentPage

integer

optional

Current request page.

Default:

pageSize

integer

optional

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

>= 10<= 500

Default:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

required

Example

{
    "code": "200000",
    "data": {
        "currentPage": 1,
        "pageSize": 50,
        "totalNum": 1,
        "totalPage": 1,
        "items": [
            {
                "id": "674a9a872033a50007e2790d",
                "symbol": "BTC-USDT",
                "opType": "DEAL",
                "type": "limit",
                "side": "buy",
                "price": "50000",
                "size": "0.00001",
                "funds": "0",
                "dealFunds": "0",
                "dealSize": "0",
                "fee": "0",
                "feeCurrency": "USDT",
                "stp": "",
                "stop": "",
                "stopTriggered": false,
                "stopPrice": "0",
                "timeInForce": "GTC",
                "postOnly": false,
                "hidden": false,
                "iceberg": false,
                "visibleSize": "0",
                "cancelAfter": 0,
                "channel": "API",
                "clientOid": "5c52e11203aa677f33e4923fb",
                "remark": "order remarks",
                "tags": null,
                "isActive": false,
                "cancelExist": true,
                "createdAt": 1732942471752,
                "tradeType": "TRADE"
            }
        ]
    }
}