獲取歷史倉位信息

{
    "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 
            }
        ]
    }
}

該接口可以查詢倉位歷史信息記錄

HTTP請求

GET /api/v1/history-positions

示例

GET /api/v1/history-positions

API權限

此接口需要通用權限

請求URL

此接口支持合約URL

頻率限制

合约类权重：2

參數

參數	數據類型	是否必須	含義
symbol	String	否	合約名稱
from	long	否	平倉開始時間
to	long	否	平倉結束時間
limit	int	否	每頁請求數量，默認10
pageId	int	否	當前頁數，默認1

返回值

參數	含義
currentPage	當前頁碼
pageSize	每頁條數
totalNum	縂條數
totalPage	縂頁數
closeId	平倉id
positionId	倉位id
uid	uid
userId	user id
symbol	symbol
settleCurrency	結算幣種
leverage	杠桿倍數
type	平倉類型
side	方向
closeSize	平倉數量
pnl	盈虧
realisedGrossCost	累計已實現毛利價值
withdrawPnl	提現盈虧
roe	收益率
tradeFee	纍計的手續費
fundingFee	纍計的資金費用
openTime	開倉時間
closeTime	平倉時間
openPrice	開倉價格
closePrice	平倉價格