Get Account Ledgers - Margin_hf

GET

https://api.kucoin.com/api/v3/hf/margin/account/ledgers

api-channel:Private

api-permission:General

api-rate-limit-pool:Spot

sdk-service:Account

sdk-sub-service:Account

sdk-method-name:getMarginHFLedger

api-rate-limit-weight:2

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Responses

🟢200OK

application/json

Body

Examples

SuccessMargin Liquidation

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

Modified at 2025-11-18 03:37:27

Get Account Ledgers - Trade_hf

Get Account Ledgers - Futures