Get Account Ledgers - trade_hf

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


GET /api/v1/hf/accounts/ledgers


GET /api/v1/hf/accounts/ledgers?bizType=TRADE_EXCHANGE&currency=YOP,DAI&startAt=1601395200000

// response
  "code": "200000",
  "data": [
      "id": "42852417537",
      "currency": "CSP",
      "amount": "1.00000000",
      "fee": "0.00000000",
      "balance": "99999986.99999999",
      "accountType": "TRADE_HF",
      "bizType": "TRADE_EXCHANGE",
      "direction": "in",
      "createdAt": "1661347205743",
      "context": "{'symbol':'CSP-USDT','orderId':'6306257dd9180300014c8d47','tradeId':'609522034689'}"
      "id": "42852401152",
      "currency": "CSP",
      "amount": "1.00000000",
      "fee": "0.00000000",
      "balance": "99999985.99999999",
      "accountType": "TRADE_HF",
      "bizType": "TRADE_EXCHANGE",
      "direction": "out",
      "createdAt": "1661347205743",
      "context": "{'symbol':'CSP-USDT','orderId':'63062585d9180300014c8d50','tradeId':'609522034689'}"

This endpoint requires the General permission.


This endpoint support Spot URL


Spot weight:2

Param Type Mandatory Description
currency String No currency, optional,can select more than one,separate with commas,select no more than 10 currencys,the default will be to query for all currencys if left empty
direction String No Direction of transaction (in or out): in-transfer in, out-transfer out
bizType String No Transaction type: TRANSFER-transfer funds,TRADE_EXCHANGE-Trade
lastId long No The id of the last set of data from the previous batch of data. By default, the latest information is given.
limit int No Default100,Max200
startAt long No Start time (milisecond), the conditional limit createdAt
endAt long No End time (milisecond), the conditional limit createdAt


If lastId is configured, the information obtained < lastId. Otherwise, it will go back 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.

Param Description
id Unique key
currency currency
amount Change in funds balance
fee Deposit or withdrawal fee
balance Total balance of funds after change
accountType Master account type TRADE_HF
bizType Trnasaction type,such as TRANSFER, TRADE_EXCHANGE, etc.
direction Direction of transfer( out or in)
createdAt Created
context Core transaction parameter
  • context description
    • If the bizType is TRADE_EXCHANGE, the context field will include additional transaction information (order id, transaction id, and trading pair).