查詢平倉盈虧

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

統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約
經典帳戶覆蓋範圍: USDT永續 / 反向合約

信息

• 經典帳戶: 返回結果按照updatedTime降序排列.
• 統一帳戶 (反向合約除外): 結果依createdTime降序排列，之後與經典帳戶一致
• 統一帳戶 (linear, spot, option) 支持查詢過去730天的平倉盈虧紀錄

HTTP 請求

GET /v5/position/closed-pnl

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型 統一帳戶: linear, inverse 經典帳戶: linear, inverse. 這裡category字段不參與業務邏輯，僅做路由使用
symbol	false	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, 100]. 默認: 50
cursor	false	string	游標，用於翻頁

響應參數

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

---

請求示例

HTTP

GET /v5/position/closed-pnl?category=linear&limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672284128523
X-BAPI-RECV-WINDOW: 5000

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.get_closed_pnl(
    category="linear",
    limit=1,
))

Java

import com.bybit.api.client.domain.*;
import com.bybit.api.client.domain.position.*;
import com.bybit.api.client.domain.position.request.*;
import com.bybit.api.client.service.BybitApiClientFactory;
var client = BybitApiClientFactory.newInstance().newAsyncPositionRestClient();
var closPnlRequest = PositionDataRequest.builder().category(CategoryType.LINEAR).build();
client.getClosePnlList(closPnlRequest, System.out::println);

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
    testnet: true,
    key: 'apikey',
    secret: 'apisecret',
});

client
    .getClosedPnL({
        category: 'linear',
        limit: 1,
    })
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "nextPageCursor": "5a373bfe-188d-4913-9c81-d57ab5be8068%3A1672214887231423699%2C5a373bfe-188d-4913-9c81-d57ab5be8068%3A1672214887231423699",
        "category": "linear",
        "list": [
            {
                "symbol": "ETHPERP",
                "orderType": "Market",
                "leverage": "3",
                "updatedTime": "1672214887236",
                "side": "Sell",
                "orderId": "5a373bfe-188d-4913-9c81-d57ab5be8068",
                "closedPnl": "-47.4065323",
                "avgEntryPrice": "1194.97516667",
                "qty": "3",
                "cumEntryValue": "3584.9255",
                "createdTime": "1672214887231423699",
                "orderPrice": "1122.95",
                "closedSize": "3",
                "avgExitPrice": "1180.59833333",
                "execType": "Trade",
                "fillCount": "4",
                "cumExitValue": "3541.795"
            }
        ]
    },
    "retExtInfo": {},
    "time": 1672284129153
}