Position

Subscribe to the position stream to see changes to your position size, position setting changes, etc.

Covers: USDT Perpetual, Inverse Perpetual, Inverse Future

Topic: user.position.contractAccount

Response Parameters

Parameter	Type	Comments
topic	string	Topic name
data	array	Object
> symbol	string	Symbol name
> riskId	integer	Risk limit id
> riskLimitValue	string	Risk limit value
> side	string	Side. Buy,Sell
> size	string	Position size
> entryPrice	string	Average entry price
> positionValue	string	Entry position value
> positionIdx	integer	Position idx, used to identify positions in different position modes 0: One-Way Mode 1: Buy side of both side mode 2: Sell side of both side mode
> tradeMode	integer	Trade mode. 0: cross margin, 1: isolated margin
> autoAddMargin	integer	Auto add margin. 0: false, 1: true
> leverage	string	Position leverage
> positionBalance	string	Position margin
> markPrice	string	Mark price
> liqPrice	string	Liquidation price. It returns value only when minPrice < liqPrice < maxPrice
> bustPrice	string	Bankruptcy price
> tpSlMode	string	Depreciated, meaningless here, always "Full"
> takeProfit	string	Take profit price
> stopLoss	string	Stop loss price
> trailingStop	string	Trailing stop
> activePrice	string	Trailing stop trigger price
> unrealisedPnl	string	Unrealised PnL
> cumRealisedPnl	string	Cumulative realized P&L
> occClosingFee	string	Position closing fee occupied
> sessionAvgPrice	string	Settlement price
> positionStatus	string	Position status
> positionMM	string	Position Initial margin
> positionIM	string	Position Maintenance margin
> createdTime	string	Position created timestamp (ms)
> updatedTime	string	Position data updated timestamp (ms)
> 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

Stream Example

{
    "topic": "user.position.contractAccount",
    "data": [
        {
            "positionIdx": 0,
            "riskId": 1,
            "symbol": "ARBUSDT",
            "side": "None",
            "size": "0",
            "positionValue": "0",
            "entryPrice": "0",
            "tradeMode": 0,
            "autoAddMargin": 0,
            "leverage": "10",
            "positionBalance": "0",
            "liqPrice": "",
            "bustPrice": "0.0000",
            "takeProfit": "0.0000",
            "stopLoss": "0.0000",
            "trailingStop": "0.0000",
            "unrealisedPnl": "0",
            "createdTime": "1695115891722",
            "updatedTime": "1697686565866",
            "tpSlMode": "Full",
            "sessionAvgPrice": "0.0000",
            "positionStatus": "Normal",
            "occClosingFee": "0",
            "markPrice": "0.7747",
            "cumRealisedPnl": "21.84890946",
            "activePrice": "0.0000",
            "riskLimitValue": "200000",
            "positionMM": "0",
            "positionIM": "0",
            "adlRankIndicator": 0,
            "isReduceOnly": false,
            "mmrSysUpdateTime": "",
            "leverageSysUpdatedTime": ""
        }
    ]
}