Get Account Ledgers - Trade_hf

GET

https://api.kucoin.eu/api/v1/hf/accounts/ledgers

api-channel:Private

api-permission:General

api-rate-limit-pool:Spot

sdk-service:Account

sdk-sub-service:Account

sdk-method-name:getSpotHFLedger

api-rate-limit-weight:2

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.

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 7 * 24 hour time range (i.e., from 7 * 24 hours ago up to now). If you specify a time range that exceeds this limit, the system will default to data from within 7 * 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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.kucoin.eu/api/v1/hf/accounts/ledgers?currency=BTC&direction=in&bizType=TRANSFER&lastId=254062248624417&limit=100&startAt=1728663338000&endAt=1728692138000'

Responses

🟢200OK

application/json

Body

Examples

SuccessKCS DEDUCTION FEES

{
    "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\"}"
        }
    ]
}

Modified at 2026-01-28 12:46:39

Get Account Ledgers - Spot/Margin

Get Account Ledgers - Margin_hf