獲取歷史倉位信息

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

{
    "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	否	每頁請求數量，最大值200，默認10
pageId	int	否	當前頁數，默認1

TIP

您只能獲取3個月時間範圍內的數據。若超出時間範圍，系統會報錯。查詢結果按照平倉時間倒序排序

返回值

參數	含義
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	平倉價格