My Position
Get real-time position data
HTTP Request
GET /contract/v3/private/position/list
Request Parameters
Parameter | Required | Type | Comments |
---|---|---|---|
symbol | false | string | Symbol name |
settleCoin | false | string | Settle coin. Either symbol or settleCoin is required. symbol has a higher priority |
Response Parameters
Parameter | Type | Comments |
---|---|---|
category | string | Product type |
nextPageCursor | string | Cursor. Used to pagination |
list | array | Object |
> symbol | string | Symbol name |
> side | string | Side. Buy , Sell . Return None when zero position of one-way mode |
> size | string | Position size |
> entryPrice | string | Entry price |
> leverage | string | leverage |
> positionValue | string | Position value |
> positionIdx | integer | Position index |
> riskId | integer | Risk limit id |
> riskLimitValue | string | Position limit value corresponding to the risk id |
> tradeMode | integer | 0 : cross margin mode. 1 : isolated margin mode |
> autoAddMargin | integer | 0 : false. 1 : true |
> positionBalance | string | Position margin |
> liqPrice | string | Estimated liquidation price. It returns value only when minPrice < liqPrice < maxPrice |
> bustPrice | string | Estimated bankruptcy price |
> tpSlMode | string | Depreciated, meaningless here, always "Full" |
> takeProfit | string | Take profit price |
> stopLoss | string | Stop loss price |
> createdTime | string | Position created timestamp (ms) |
> updatedTime | string | Position data updated timestamp (ms) |
> trailingStop | string | Trailing stop |
> activePrice | string | Activate price of trailing stop |
> markPrice | string | Real-time mark price |
> unrealisedPnl | string | unrealised PNL |
> cumRealisedPnl | string | cumulative realised PNL |
> positionMM | string | Position maintenance margin |
> positionIM | string | Position initial margin |
> positionStatus | string | Position status |
> sessionAvgPrice | string | Settlement price |
> occClosingFee | string | Pre-occupancy closing fee |
> adlRankIndicator | integer | Auto-deleverage rank indicator. What is Auto-Deleveraging? |
> isReduceOnly | boolean | Useful when Bybit lower the risk limit
|
> mmrSysUpdatedTime | string | Useful when Bybit lower the risk limit
false : the timestamp when the MMR had been adjusted by system |
> leverageSysUpdatedTime | string | Useful when Bybit lower the risk limit
false : the timestamp when the leverage had been adjusted by system |
Request Example
GET /contract/v3/private/position/list?symbol=ETCUSDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1673421074950
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Response Example
{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"positionIdx": 0,
"riskId": 236,
"symbol": "ETCUSDT",
"side": "None",
"size": "0.0",
"positionValue": "0",
"entryPrice": "0",
"tradeMode": 0,
"autoAddMargin": 0,
"leverage": "10",
"positionBalance": "0",
"liqPrice": "",
"bustPrice": "0.000",
"takeProfit": "0.000",
"stopLoss": "0.000",
"trailingStop": "0.000",
"unrealisedPnl": "0",
"createdTime": "1672986751942",
"updatedTime": "1675382400091",
"tpSlMode": "Full",
"riskLimitValue": "200000",
"activePrice": "0.000",
"markPrice": "15.126",
"cumRealisedPnl": "-10.69094915",
"positionMM": "0",
"positionIM": "0",
"positionStatus": "Normal",
"sessionAvgPrice": "0.000",
"occClosingFee": "0",
"avgPrice": "0",
"adlRankIndicator": 0,
"isReduceOnly": false,
"mmrSysUpdatedTime": "",
"leverageSysUpdatedTime": ""
}
],
"category": "",
"nextPageCursor": ""
},
"retExtInfo": {},
"time": 1697685149803
}