Get Positions History

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.

Responses

🟢200成功

application/json

Body

Example

{
    "code": "200000",
    "data": {
        "currentPage": 1,
        "pageSize": 10,
        "totalNum": 1,
        "totalPage": 1,
        "items": [
            {
                "closeId": "500000000036305465",
                "userId": "633559791e1cbc0001f319bc",
                "symbol": "XBTUSDTM",
                "settleCurrency": "USDT",
                "leverage": "1.0",
                "type": "CLOSE_LONG",
                "pnl": "0.51214413",
                "realisedGrossCost": "-0.5837",
                "realisedGrossCostNew": "-0.5837",
                "withdrawPnl": "0.0",
                "tradeFee": "0.03766066",
                "fundingFee": "-0.03389521",
                "openTime": 1735549162120,
                "closeTime": 1735589352069,
                "openPrice": "93859.8",
                "closePrice": "94443.5",
                "marginMode": "CROSS",
                "positionSide": "BOTH",
                "tax": "0.0",
                "roe": null,
                "liquidAmount": null,
                "liquidPrice": null,
                "side": "LONG"
            }
        ]
    }
}

Get Positions History

Request

Request Code Samples

Responses