取得流水記錄 - 現貨高頻

GET

https://api.kucoin.com/api/v1/hf/accounts/ledgers

api-channel:Private

api-permission:General

api-rate-limit-pool:Spot

api-rate-limit-weight:2

sdk-service:Account

sdk-method-name:getSpotHFLedger

sdk-sub-service:Account

說明

此 API 端點會回傳高頻交易帳戶中的所有轉帳（入帳和出帳）記錄，並支援多幣查詢。查詢結果依 createdAt 和 ID 降序排序。

提示

如果設定了 lastId，取得的資訊 < lastId。否則，它會還原為最新資訊。

您只能從 3* 24 小時時間範圍內取得資料（即從 3* 24 小時前到現在）。如果您指定的時間範圍超過此限制，系統會預設為 3* 24 小時內的資料。

內容

如果 bizType 是 TRADE_EXCHANGE，上下文欄位會包含額外的交易資訊 (訂單 ID、交易 ID 和交易對)。

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/v1/hf/accounts/ledgers?currency=BTC&direction=in&bizType=TRANSFER&lastId=254062248624417&limit=100&startAt=1728663338000&endAt=1728692138000'

Responses

🟢200確認

application/json

Body

Examples

成功KCS 扣款費用

{
    "code": "200000",
    "data": [
        {
            "id": "254062248624417",
            "currency": "USDT",
            "amount": "1.59760080",
            "fee": "0.00159920",
            "tax": "0",
            "balance": "26.73759503",
            "accountType": "TRADE_HF",
            "bizType": "TRADE_EXCHANGE",
            "direction": "in",
            "createdAt": "1728443957539",
            "context": "{\"symbol\":\"KCS-USDT\",\"orderId\":\"6705f6350dc7210007d6a36d\",\"tradeId\":\"10046097631627265\"}"
        }
    ]
}

Modified at 2026-01-14 07:52:14

取得流水記錄 - 幣幣/保證金

取得流水記錄 - 槓桿高頻