Get Positions History (UTA)

GET

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

api-channel:Private

api-permission:General

api-rate-limit-pool:Management

sdk-service:UTA

sdk-sub-service:Positions

sdk-method-name:GetPositionsHistory

api-rate-limit-weight:2

Description

This interface allows users to query position history information records.

Data Time Range

The data is retained in the system for up to three months. Queries are permitted within this retention period (i.e., from the current time to three months prior). However, each individual query is limited to a time range of 7 × 24 hours (i.e., up to one week). If the specified time range exceeds this limit, the system will default to retrieving data within the maximum allowable 7 × 24-hour window. To access data spanning beyond 7 × 24 hours, multiple queries are required.

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

🟢200OK

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "items": [
            {
                "symbol": "XBTUSDTM",
                "closeId": "556",
                "marginMode": "CROSS",
                "side": "LONG",
                "entryPrice": "66895.7",
                "closePrice": "62889.8",
                "maxSize": "5",
                "avgClosePrice": "62889.8",
                "leverage": "25",
                "realizedPnL": "-20.27523235",
                "fee": "0.3893565",
                "tax": "0",
                "fundingFee": "0.14362415",
                "closingTime": 1771940011060000000,
                "creationTime": 1771495960604000000
            }
        ],
        "lastId": 502
    }
}

Modified at 2026-04-02 03:38:56

Get Position List (UTA)

Get Account Position Tiers