Get Closed PnL

Query user's closed profit and loss records. The results are sorted by updatedTime in descending order.

info

Support USDT Perpetual, Inverse Perpetual and Inverse Future

Query time range:

• Specify startTime and endTime, you can query up to 2 years records
• Without startTime and endTime, it returns past 6 months records by default

HTTP Request

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

Request Parameters

Parameter	Required	Type	Comments
symbol	true	true	Symbol name
startTime	false	integer	The start timestamp (ms) startTime and endTime are not passed, return 7 days by default Only startTime is passed, return range between startTime and startTime+7 days Only endTime is passed, return range between endTime-7 days and endTime If both are passed,the rule is endTime - startTime <= 7 days
endTime	false	integer	The end timestamp (ms)
limit	false	integer	Limit for data size per page. [1, 200]. Default: 50
cursor	false	string	Cursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

Parameter	Type	Comments
list	array	Object
> symbol	string	Symbol name
> orderId	string	Order Id
> side	string	Buy, Side
> qty	string	Order qty
> leverage	string	leverage
> orderPrice	string	Order price
> orderType	string	Order type. Market,Limit
> execType	string	Exec type
> closedSize	string	Closed size
> cumEntryValue	string	Cumulated entry position value
> avgEntryPrice	string	Average entry price
> cumExitValue	string	Cumulated exit position value
> avgExitPrice	string	Average exit price
> closedPnl	string	Closed PnL
> fillCount	string	The number of fills in a single order
> createdAt	string	The created time (ms), same as createdTime
> createdTime	string	The created time (ms), same as createdAt
> updatedTime	string	The updated time (ms)
nextPageCursor	string	Cursor. Used to pagination

Request Example

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

Response Example

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