Get Positions History

{
    "success": true,
    "code": "200",
    "msg": "success",
    "retry": false,
    "data": {
        "currentPage": 1,
        "pageSize": 10, 
        "totalNum": 25, 
        "totalPage": 3, 
        "items": [
            {
                "closeId": "300000000000000030", 
                "positionId": "300000000000000009", 
                "uid": 99996908309485, 
                "userId": "6527d4fc8c7f3d0001f40f5f",
                "symbol": "XBTUSDM",
                "settleCurrency": "XBT", 
                "leverage": "0.0", 
                "type": "LIQUID_LONG", 
                "side": null, 
                "closeSize": null, 
                "pnl": "-1.0000003793999999", 
                "realisedGrossCost": "0.9993849748999999", 
                "withdrawPnl": "0.0", 
                "roe": null, 
                "tradeFee": "0.0006154045", 
                "fundingFee": "0.0", 
                "openTime": 1713785751181, 
                "closeTime": 1713785752784, 
                "openPrice": null, 
                "closePrice": null 
            }
        ]
    }
}

This interface can query position history information records

HTTP REQUEST

GET /api/v1/history-positions

Example

GET /api/v1/history-positions

API KEY PERMISSIONS

This endpoint requires the General permission.

REQUEST URL

This endpoint support Futures URL

REQUEST RATE LIMIT

Futures weight：2

PARAMETERS

Param	Type	Mandatory	Description
symbol	String	No	symbol
from	long	No	Closing start time
to	long	No	Closing end time
limit	int	No	Number of requests per page, default 10
pageId	int	No	Current page number, default 1

RESPONSES

Param	Description
currentPage	Current page number
pageSize	Number of results per page
totalNum	Total number of results
totalPage	TotalPage
closeId	Closeid
positionId	Positionid
uid	uid
userId	user id
symbol	symbol
settleCurrency	Currency used to clear and settle the trades
leverage	Leverage to the order
type	Type of closure
side	Direction of the trade (buy or sell)
closeSize	Quantity of the position closed
pnl	profit and loss
realisedGrossCost	Accumulated realised gross profit value
withdrawPnl	Rate of return on investment
roe	Rate of return on investment
tradeFee	Accumulated trading fees
fundingFee	Accumulated funding fees
openTime	Time when the position was opened
closeTime	Time when the position was closed
openPrice	Opening price of the position
closePrice	Closing price of the position