Get Account Ledgers - Margin_hf - KUCOIN API

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

Official Announcement

SPOT Margin HF Migration Completion Announcement

Notes

Response field: accountType

Current: returns MARGIN_V2, ISOLATED_V2

Next: will gradually migrate to MARGIN, ISOLATED

Parameter Limitation

Preferred: MARGIN, ISOLATED

V2: MARGIN_V2, ISOLATED_V2 -- same meaning as non-V2 parameters; phased out gradually.

Pagination

If lastId is specified, the returned data is earlier than lastId. Otherwise, the system returns the latest data.

Time Range

You can only query data within the last 3 * 24 hours (from 3 * 24 hours ago up to now). If the specified time range exceeds this limit, the system defaults to returning data within the last 3 * 24 hours.

bizType Context

If bizType is MARGIN_EXCHANGE or ISOLATED_EXCHANGE, the context field includes additional transaction details (order ID, transaction ID, trading pair).

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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