Skip to main content

Position List

Position List

HTTP Request

GET /contract/v3/private/copytrading/position/list

Request Parameters

ParameterRequiredTypeComments
symbolfalsestringSymbol

Response Parameters

ParameterTypeComments
listarrayObject
> symbolstringSymbol
> sidestringSide
> sizestringPosition qty
> positionValuestringPosition value
> entryPricestringAverage entry price
> liqPricestringLiquidation price
> bustPricestringBankruptcy price
> markPricestringMark price
> leveragestringIn Isolated Margin mode, the value is set by the user. In Cross Margin mode, the value is the max leverage at current risk level
> isIsolatedbooleantrue means isolated margin mode; false means cross margin mode
> positionMarginstringPosition margin
> occClosingFeestringPosition closing fee occupied (your opening fee + expected maximum closing fee)
> occFundingFeestringPre-occupied funding fee: calculated from position qty and current funding fee
> cumRealisedPnlstringAccumulated realised pnl (all-time total)
> freeQtystringQty which can be closed. (If you have a long position, free_qty is negative. vice versa)
> unrealisedPnlstringunrealised pnl
> positionIdxstringPosition 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
> createdTimestringCreation time (when the order_status was Created)
> updatedTimestringUpdate 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
}