Get Account Ledgers - Margin_hf

Description

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

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.

If bizType is MARGIN_EXCHANGE or ISOLATED_EXCHANGE, the context field will contain additional information about the transaction (order ID, transaction ID, transaction pair).

Request

Query Params

currency

string

optional

Currency optional; more than one can be selected; separate using commas; select no more than 10 currencies; the default will be to query for all currencies if left empty

Example:

BTC

direction

enum<string>

optional

direction: in, out

Allowed values:

inout

Example:

bizType

string

optional

Transaction type: TRANSFER- transfer funds, MARGIN_EXCHANGE-cross margin trade, ISOLATED_EXCHANGE-isolated margin trade, LIQUIDATION-liquidation, ASSERT_RETURN-forced liquidation asset return

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)

Example:

1728663338000

endAt

integer <int64>

optional

End time (milliseconds)

Example:

1728692138000

Responses

🟢200OK

application/json

Body

code

string

required

data

array [object {11}]

required

integer <int64>

optional

currency

string

optional

currency

amount

string

optional

Change in funds balance

fee

string

optional

Transaction, Deposit or withdrawal fee

balance

string

optional

Total balance of funds after change

accountType

string

optional

Master account type TRADE_HF

bizType

string

optional

Trnasaction type, such as TRANSFER, TRADE_EXCHANGE, etc.

direction

string

optional

Direction of transfer (out or in)

createdAt

integer <int64>

optional

Ledger creation time

context

string

optional

Core transaction parameter

tax

string

optional

Example

{
  "code": "200000",
  "data": [
    {
      "id": 1949641706720,
      "currency": "USDT",
      "amount": "0.01000000",
      "fee": "0.00000000",
      "balance": "0.01000000",
      "accountType": "MARGIN_V2",
      "bizType": "TRANSFER",
      "direction": "in",
      "createdAt": 1728664091208,
      "context": "{}",
      "tax": "0.00000000"
    }
  ]
}

Get Account Ledgers - Margin_hf

Request

Request samples

Responses