取得倉位歷史（UTA）

GET

https://api.kucoin.com/api/ua/v1/position/history

api-channel:Private

api-permission:General

api-rate-limit-pool:Management

api-rate-limit-weight:2

sdk-service:UTA

sdk-method-name:GetPositionsHistory

sdk-sub-service:Positions

Description

此介面允許使用者查詢持倉歷史資訊記錄。

Data Time Range

資料在系統中最多保留三個月。查詢僅允許在此保留期間內進行（即從現在起往前三個月）。但每次單筆查詢的時間範圍限制為 7 × 24 小時（即最多一週）。若指定的時間範圍超過此限制，系統將預設僅回傳最大允許的 7 × 24 小時視窗內的資料。若要取得超過 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/ua/v1/position/history?symbol=XBTUSDTM&startAt&endAt&lastId&pageSize'

Responses

🟢200成功

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "items": [
            {
                "symbol": "XBTUSDTM",
                "closeId": "10000000000000155",
                "marginMode": "CROSS",
                "side": "SHORT",
                "entryPrice": "87544.8",
                "closePrice": "87559.9",
                "maxSize": "-1",
                "avgClosePrice": "87559.9",
                "leverage": "48",
                "realizedPnL": "-0.12016282",
                "fee": "0.10506282",
                "tax": "0",
                "fundingFee": "0",
                "closingTime": 1766476104013000000,
                "creationTime": 1766476047678000000
            }
        ],
        "lastId": 10000000000000069
    }
}

Modified at 2026-01-06 10:31:18

取得倉位列表（UTA）

取得帳戶倉位風險限額