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
andendTime
, you can query up to 2 years records - Without
startTime
andendTime
, 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)
|
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
}