Get Account Ledgers - Spot/Margin - KUCOIN API

Description

This interface is for transaction records from all your account types, supporting various currency inquiries. Items are paginated and sorted to show the latest first. See the Pagination section for retrieving additional entries after the first page.

Tips

Time Range
The start and end time range cannot exceed 24 hours. An error will occur if the specified time window exceeds this range. If only the end time is specified, the system will automatically calculate the start time as end time - 24 hours; if only the start time is specified, the system will automatically calculate the end time as start time + 24 hours.

Historical Data
Supports up to 1 year of historical data. If you need longer historical data, please submit a ticket: https://kucoin.zendesk.com/hc/en-us/requests/new

Record Count Limit
For each 24 hours query window, the maximum number of returned records is 10,000. If this limit is exceeded, please narrow the start time and end time range and query again.

Notes

If the returned value of bizType is trade exchange, additional trade information (such as order ID, trade ID, and trading pair) will be returned in the context field.

BizType Description

Field	Description
Assets Transferred in After Upgrading	Assets transferred in after V1 to V2 upgrading
Deposit	Deposit
Withdrawal	Withdrawal
Transfer	Transfer
Trade_Exchange	Trade
Vote for Coin	Vote for Coin
KuCoin Bonus	Bonus
Referral Bonus	Referral Bonus
Rewards	Activities Rewards
Distribution	Distribution, such as get GAS by holding NEO
Airdrop/Fork	Airdrop/Fork
Other rewards	Other rewards, except Vote, Airdrop, Fork
Fee Rebate	Fee Rebate
Buy Crypto	Use credit card to buy crypto
Sell Crypto	Use credit card to sell crypto
Public Offering Purchase	Public Offering Purchase for Spotlight
Send red envelope	Send red envelope
Open red envelope	Open red envelope
Staking	Staking
LockDrop Vesting	LockDrop Vesting
Staking Profits	Staking Profits
Redemption	Redemption
Refunded Fees	Refunded Fees
KCS Pay Fees	KCS Pay Fees
Margin Trade	Margin Trade
Loans	Loans
Borrowings	Borrowings
Debt Repayment	Debt Repayment
Loans Repaid	Loans Repaid
Lendings	Lendings
Pool transactions	Pool-X transactions
Instant Exchange	Instant Exchange
Sub Account Transfer	Sub-account transfer
Liquidation Fees	Liquidation Fees
Soft Staking Profits	Soft Staking Profits
Voting Earnings	Voting Earnings on Pool-X
Redemption of Voting	Redemption of Voting on Pool-X
Convert to KCS	Convert to KCS
BROKER_TRANSFER	Broker transfer record

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": {
        "currentPage": 1,
        "pageSize": 50,
        "totalNum": 1,
        "totalPage": 1,
        "items": [
            {
                "id": "265329987780896",
                "currency": "USDT",
                "amount": "0.01",
                "fee": "0",
                "balance": "0",
                "accountType": "TRADE",
                "bizType": "SUB_TRANSFER",
                "direction": "out",
                "createdAt": 1728658481484,
                "context": ""
            }
        ]
    }
}