取得流水記錄 - 合約

GET

https://api-futures.kucoin.com/api/v1/transaction-history

api-channel:Private

api-permission:General

api-rate-limit-pool:Futures

api-rate-limit-weight:2

sdk-service:Account

sdk-method-name:getFuturesLedger

sdk-sub-service:Account

說明

此界面可查詢合約業務線的分類帳記錄。

提示

如果有未平倉合約，返回的第一頁的狀態將是 Pending，顯示當前 8 小時結算期內的已實現盈虧。請在偏移量欄位中指定目前頁面的最小偏移量號碼，以便移至下一頁。

提示

startAt 和 endAt 的補充說明： startAt 必須小於 endAt；且間隔不能超過 1 天；只允許傳送一個欄位，如果只傳送一個欄位，系統會自動增加或減少另一個欄位 1 天完成

Request

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api-futures.kucoin.com/api/v1/transaction-history?currency=XBT&type=Transferin&offset=254062248624417&forward=false&maxCount=50&startAt=1728663338000&endAt=1728692138000'

Responses

🟢200確認

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "dataList": [
            {
                "time": 1728665747000,
                "type": "TransferIn",
                "amount": 0.01,
                "fee": 0.0,
                "accountEquity": 14.02924938,
                "status": "Completed",
                "remark": "Transferred from High-Frequency Trading Account",
                "offset": 51360793,
                "currency": "USDT"
            },
            {
                "time": 1728648000000,
                "type": "RealisedPNL",
                "amount": 0.00630042,
                "fee": 0.0,
                "accountEquity": 20.0,
                "status": "Completed",
                "remark": "XBTUSDTM",
                "offset": 51352430,
                "currency": "USDT"
            }
        ],
        "hasMore": false
    }
}

Modified at 2026-01-15 07:50:25

取得流水記錄 - 槓桿高頻

新增子帳戶