取得帳戶流水記錄

GET

https://api.kucoin.com/api/ua/v1/account/ledger

api-channel:Private

api-permission:General

api-rate-limit-pool:Management

api-rate-limit-weight:2

sdk-service:UTA

sdk-method-name:getAccountLedger

sdk-sub-service:Account

Description

此 API 端點會回傳所有劃轉（轉入與轉出）記錄，並支援多幣種查詢。查詢結果會依 createdAt 與 ID 以降冪排序。

Tips

若設定 lastId，則取得的資料會 < lastId；否則將回傳最新資料。

單次查詢最大支持範圍：1天，總可查詢範圍 7 * 24 小時（即從 7 * 24 小時前至現在）。若您指定的時間範圍超出此限制，系統將預設回傳 7 * 24 小時內的資料。

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.kucoin.com/api/ua/v1/account/ledger?accountType=FUTURES&currency=BTC&direction=in&businessType=TRANSFER&lastId=254062248624417&startAt=1728663338000&endAt=1728692138000&pageSize=100'

Response Example

200 - UNIFIED - UNIFIED

{
    "code": "200000",
    "data": {
        "lastId": 10000000001485678,
        "items": [
            {
                "accountType": "UNIFIED",
                "id": "10000000002286107",
                "currency": "USDT",
                "direction": "IN",
                "businessType": "FUNDING_FEE",
                "amount": "0.00262242",
                "balance": "378.12022481286",
                "fee": "0",
                "tax": "0",
                "remark": "",
                "ts": 1768780806739000000
            },
            {
                "accountType": "UNIFIED",
                "id": "10000000002203239",
                "currency": "USDT",
                "direction": "IN",
                "businessType": "FUNDING_FEE",
                "amount": "0.00504281",
                "balance": "378.12577652286",
                "fee": "0",
                "tax": "0",
                "remark": "",
                "ts": 1768694412367000000
            }
        ]
    }
}

Request

Query Params

Responses

🟢200UNIFIED

application/json

Body

🟢200FUNDING

🟢200SPOT

🟢200ISOLATED

🟢200CROSS

🟢200FUTURES

Modified at 2026-04-03 08:57:34

取得實際費率

取得利息歷史（UTA）