Get Account Ledger - KUCOIN API

Description

This API endpoint returns all transfer (in and out) records 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

accountType

enum<string>

required

Account Type

Allowed values:

FUNDINGTRADINGFUTURESCROSSISOLATED

Example:

FUTURES

currency

string

optional

Currency (you can choose more than one currency). You can specify a max. of 10 currencies in one go. If not specified, all currencies will be queried by default.

Example:

BTC

direction

enum<string>

optional

direction: in, out

Allowed values:

inout

Example:

businessType

enum<string>

optional

Transaction type

Allowed values:

TRADE_EXCHANGETRANSFERSUB_TRANSFERRETURNED_FEESDEDUCTION_FEESOTHER

Example:

TRANSFER

lastId

integer <int64>

optional

The ID of the last set of data from the previous data batch. By default, the latest information is given.

Example:

254062248624417

startAt

integer <int64>

optional

Start time (milliseconds)

>= 0<= 9999999999999

Example:

1728663338000

endAt

integer <int64>

optional

End time (milliseconds)

>= 0<= 9999999999999

Example:

1728692138000

pageSize

integer

optional

Page Size

>= 1<= 200

Default:

100

Example:

100

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

code

string

required

Response code

data

array [object {11}]

required

accountType

string

required

Master account type, e.g., TRADING

string

required

Unique ID

currency

string

required

Currency

amount

string

required

Change in funds balance

tax

string

required

Tax applied to the transaction

fee

string

required

Transaction, deposit, or withdrawal fee

balance

string

required

Total balance of funds after change

businessType

string

required

Transaction type, such as TRANSFER, TRADE_EXCHANGE, etc.

direction

enum<string>

required

Direction of transfer

Allowed values:

inout

string

required

Timestamp of the event

remark

string

required

Business-related information, such as order ID or serial number, as a JSON string

Examples

SuccessKCS DEDUCTION FEES

{
  "code": "200000",
  "data": [
    {
      "id": "685cbb3d6123427a71ca5",
      "currency": "USDT",
      "amount": "0.01",
      "fee": "0",
      "accountType": "FUNDING",
      "businessType": "资金划转",
      "direction": "out",
      "ts": 1750907709080,
      "remark": ""
    }
  ]
}