查詢平倉盈虧

獲取當前用戶的所有平倉盈虧數據，返回結果按照updatedTime降序排列.

信息

支持 USDT永續, 反向永續和反向交割

查詢時間範圍:

• 指定的了startTime 和 endTime, 您可以查詢過去2年的數據
• 若不指定startTime 和 endTime, 默認返回近6個月的數據

HTTP 請求

GET /contract/v3/private/position/closed-pnl

請求參數

參數	是否必需	類型	說明
symbol	true	string	產品類型
startTime	false	integer	開始時間戳 (毫秒) startTime 和 endTime都不傳入, 則默認返回最近7天的數據 startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天 若不傳startTime，則查詢startTime和startTime+7天的數據 若不傳endTime，則查詢endTime-7天和endTime的數據
endTime	false	integer	結束時間戳 (毫秒)
limit	false	integer	每頁數量限制. [1, 200]. default: 50
cursor	false	string	游標，用於翻頁

響應參數

參數	類型	說明
list	array	Object
> symbol	string	合約名稱
> orderId	string	訂單Id
> side	string	買賣方向. Buy, Side
> qty	string	訂單數量
> leverage	string	持倉槓桿
> orderPrice	string	訂單價格
> orderType	string	訂單類型. Market,Limit
> execType	string	執行類型
> closedSize	string	平倉數量
> cumEntryValue	string	被平倉位的累計入場價值
> avgEntryPrice	string	平均入場價格
> cumExitValue	string	被平倉位的累計出場價值
> avgExitPrice	string	平均出場價格
> closedPnl	string	被平倉位的盈虧
> fillCount	string	單筆訂單的成交筆數
> createdAt	string	訂單創建時間, 同createdTime
> createdTime	string	訂單創建時間, 同createdAt
> updatedTime	string	訂單更新時間
nextPageCursor	string	游標，用於翻頁

請求示例

GET /contract/v3/private/position/closed-pnl?symbol=ETHUSDT&limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1670855140626
X-BAPI-RECV-WINDOW: 5000

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "list": [
        {
            "symbol": "ETHUSDT",
            "orderId": "ee650123-74bf-4094-aadb-efa139d99c50",
            "side": "Buy",
            "qty": "0.30",
            "orderPrice": "1314.75",
            "orderType": "Market",
            "execType": "Trade",
            "closedSize": "0.30",
            "cumEntryValue": "373.71078947",
            "avgEntryPrice": "1245.7026",
            "cumExitValue": "375.532",
            "avgExitPrice": "1251.7734",
            "closedPnl": "-2.27050237",
            "fillCount": "2",
            "leverage": "50",
            "createdAt": "1670838034412",
            "createdTime": "1670838034412",
            "updatedTime": "1670838034450"
        }
    ],
    "nextPageCursor": "eyJza2lwX2xvY2FsX3N5bWJvbCI6ZmFsc2UsInBhZ2VfdG9rZW4iOiJleUpOSWpwN0lsOTFjM2N4WHlJNmV5SkNJam9pUVRnMlZFcEJSVWRCVVVVOUluMHNJbkJySWpwN0lrSWlPaUpLUjFac1RtcFZkMDFVU1hwTVZHTXdXVzFaZEU1RVFUVk9RekZvV1ZkU2FVeFhWbTFaVkVWNlQxZFJOVTlYVFRGTlFUMDlJbjBzSWw5emExOGlPbnNpUWlJNklrWjZRVU5XZGpWcVkyTXlSblJoTTJSQlp6MDlJbjE5ZlE9PSJ9"
},
    "retExtInfo": {},
    "time": 1670855140831
}