Position List
Position List
HTTP Request
GET /contract/v3/private/copytrading/position/list
Request Parameters
| Parameter | Required | Type | Comments |
|---|---|---|---|
| symbol | false | string | Symbol |
Response Parameters
| Parameter | Type | Comments |
|---|---|---|
| list | array | Object |
| > symbol | string | Symbol |
| > side | string | Side |
| > size | string | Position qty |
| > positionValue | string | Position value |
| > entryPrice | string | Average entry price |
| > liqPrice | string | Liquidation price |
| > bustPrice | string | Bankruptcy price |
| > markPrice | string | Mark price |
| > leverage | string | In Isolated Margin mode, the value is set by the user. In Cross Margin mode, the value is the max leverage at current risk level |
| > isIsolated | boolean | true means isolated margin mode; false means cross margin mode |
| > positionMargin | string | Position margin |
| > occClosingFee | string | Position closing fee occupied (your opening fee + expected maximum closing fee) |
| > occFundingFee | string | Pre-occupied funding fee: calculated from position qty and current funding fee |
| > cumRealisedPnl | string | Accumulated realised pnl (all-time total) |
| > freeQty | string | Qty which can be closed. (If you have a long position, free_qty is negative. vice versa) |
| > unrealisedPnl | string | unrealised pnl |
| > positionIdx | string | Position idx, used to identify positions in different position modes:0-Single side; 1-Buy side of both side mode; 2-Sell side of both side mode |
| > createdTime | string | Creation time (when the order_status was Created) |
| > updatedTime | string | Update time |
Request Example
curl --location --request GET 'https://api-testnet.bybit.com/contract/v3/private/copytrading/position/list' \
--header 'X-BAPI-SIGN-TYPE: 2' \
--header 'X-BAPI-SIGN: XXXXX' \
--header 'X-BAPI-API-KEY: XXXXX' \
--header 'X-BAPI-TIMESTAMP: 1670831398044' \
--header 'X-BAPI-RECV-WINDOW: 5000' \
Response Example
{
"retCode": 0,
"retMsg": "success",
"result": {
"list": [
{
"symbol": "ETHUSDT",
"side": "Sell",
"size": "0.02",
"positionValue": "25.2665",
"entryPrice": "1263.325",
"liqPrice": "1383.30",
"bustPrice": "1389.65",
"markPrice": "1254.60",
"leverage": "10",
"isIsolated": true,
"positionMargin": "2.52665009",
"occClosingFee": "0.0166758",
"occFundingFee": "0",
"cumRealisedPnl": "132.46751301",
"freeQty": "0.02",
"unrealisedPnl": "0.1745",
"positionIdx": "2",
"createdTime": "1652324549816",
"updatedTime": "1670841190027"
}
]
},
"retExtInfo": {},
"time": 1670841190031
}