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 true: Only allowed to reduce the position. You can consider a series of measures, e.g., lower the risk limit, decrease leverage or reduce the position, add margin, or cancel orders, after these operations, you can call confirm new risk limit endpoint to check if your position can be removed the reduceOnly mark false: There is no restriction, and it means your position is under the risk when the risk limit is systematically adjusted Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
> mmrSysUpdatedTime	string	Useful when Bybit lower the risk limit When isReduceOnly=true: the timestamp (ms) when the MMR will be forcibly adjusted by the system When isReduceOnly=false: the timestamp when the MMR had been adjusted by system It returns the timestamp when the system operates, and if you manually operate, there is no timestamp Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others
> leverageSysUpdatedTime	string	Useful when Bybit lower the risk limit When isReduceOnly=true: the timestamp (ms) when the leverage will be forcibly adjusted by the system When isReduceOnly=false: the timestamp when the leverage had been adjusted by system It returns the timestamp when the system operates, and if you manually operate, there is no timestamp Keeps "" by default, if there was a lower risk limit system adjustment previously, it shows that system operation timestamp Only meaningful for isolated margin & cross margin of USDT Perp, USDC Perp, USDC Futures, Inverse Perp and Inverse Futures, meaningless for others

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
}