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.

HTTP REQUEST

GET /api/v1/hf/accounts/ledgers

Example

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

API KEY PERMISSIONS

This endpoint requires the General permission.

REQUEST URL

This endpoint support Spot URL

REQUEST RATE LIMIT

Spot weight：2

PARAMETERS

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

TIP

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.

RESPONSES

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