取得交易歷史

GET

https://api.kucoin.com/api/v3/hf/margin/fills

api-channel:Private

api-permission:General

api-rate-limit-pool:Spot

api-rate-limit-weight:5

sdk-service:Margin

sdk-method-name:getTradeHistory

sdk-sub-service:Order

說明

此端點可用於取得最新的保證金交易詳細資訊清單。
傳回的資料會根據順序的最新更新時間以降序排序。

提示

若訂單非有效狀態，僅可查詢最近 7×24 小時（即從當前時間起往前推 7 天）內的數據。若超出此時間範圍，系統將默認查詢 7×24 小時內的數據。

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/v3/hf/margin/fills?symbol=BTC-USDT&tradeType=MARGIN_TRADE&orderId&side&type&lastId=254062248624417&limit=100&startAt=1728663338000&endAt=1728692138000'

Responses

🟢200確認

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "items": [
            {
                "id": 137891621991,
                "symbol": "BTC-USDT",
                "tradeId": 11040911994273793,
                "orderId": "671868085584bc0007d85f46",
                "counterOrderId": "67186805b7cbdf00071621f9",
                "side": "buy",
                "liquidity": "taker",
                "forceTaker": false,
                "price": "67141.6",
                "size": "0.00001",
                "funds": "0.671416",
                "fee": "0.000671416",
                "feeRate": "0.001",
                "feeCurrency": "USDT",
                "stop": "",
                "tradeType": "MARGIN_TRADE",
                "tax": "0",
                "taxRate": "0",
                "type": "limit",
                "createdAt": 1729652744998
            }
        ],
        "lastId": 137891621991
    }
}

Modified at 2026-01-16 07:41:20

取得已結束訂單

按 OrderId 取得訂單