Get Account Ledgers - Trade_hf

GET/api/v1/hf/accounts/ledgers

:::info[Description]
This API endpoint returns all transfer (in and out) records in high-frequency trading accounts and supports multi-coin queries. The query results are sorted in descending order by createdAt and ID.
:::

:::tip[Tips]
If lastId is configured, the information obtained < lastId. Otherwise, it will revert to the latest information.

You can only obtain data from within a 3 * 24 hour time range (i.e., from 3 * 24 hours ago up to now). If you specify a time range that exceeds this limit, the system will default to data from within 3 * 24 hours.
:::

context

If the bizType is TRADE_EXCHANGE, the context field will include additional transaction information (order ID, transaction ID, and trading pair).

Request

Query Params

currency

string

optional

Currency (you can choose more than one currency). You can specify a max. of 10 currencies in one go. If not specified, all currencies will be queried by default.

Example:

BTC

direction

enum<string>

optional

direction: in, out

Allowed values:

inout

Example:

bizType

enum<string>

optional

Transaction type

Allowed values:

TRADE_EXCHANGETRANSFERRETURNED_FEESDEDUCTION_FEESOTHER

Example:

TRANSFER

lastId

integer <int64>

optional

The ID of the last set of data from the previous data batch. By default, the latest information is given.

Example:

254062248624417

limit

integer

optional

Default100, Max200

>= 1<= 200

Default:

100

Example:

100

startAt

integer <int64>

optional

Start time (milliseconds)

>= 0<= 9999999999999

Example:

1728663338000

endAt

integer <int64>

optional

End time (milliseconds)

>= 0<= 9999999999999

Example:

1728692138000

Request samples

Responses

OK(200)

HTTP Code: 200

Content Type : JSONapplication/json

code

string

required

data

array [object {11}]

required

string

required

Unique ID

currency

string

required

currency

amount

string

required

Change in funds balance

fee

string

required

Transaction, Deposit or withdrawal fee

tax

string

required

balance

string

required

Total balance of funds after change

accountType

string

required

Master account type TRADE_HF

bizType

string

required

Trnasaction type, such as TRANSFER, TRADE_EXCHANGE, etc.

direction

enum<string>

required

Direction of transfer (out or in)

Allowed values:

inout

createdAt

string

required

Created time

context

string

required

Core transaction parameter

{
  "code": "200000",
  "data": [
    {
      "id": "254062248624417",
      "currency": "USDT",
      "amount": "1.59760080",
      "fee": "0.00159920",
      "tax": "0",
      "balance": "26.73759503",
      "accountType": "TRADE_HF",
      "bizType": "TRADE_EXCHANGE",
      "direction": "in",
      "createdAt": "1728443957539",
      "context": "{\"symbol\":\"KCS-USDT\",\"orderId\":\"6705f6350dc7210007d6a36d\",\"tradeId\":\"10046097631627265\"}"
    }
  ]
}

Last modified: 17 days ago