Skip to main content

Get Stock Positions

Query all underlying stock position snapshots under the current MM account, including total holdings, available holdings, pending shares.

info

This endpoint is only available for Market Maker.

HTTP Request

GET/v5/rwa/stocks/positions

Request Parameters

ParameterRequiredTypeComments
symbolfalsestringStock symbol, e.g. AAPL-US. Filter by symbol; returns all positions if omitted
showZerofalsebooleanWhether to return zero-quantity positions. Default: false

Response Parameters

ParameterTypeComments
dataarray<object>Position list
> symbolstringStock symbol
> qtystringTotal position quantity (shares)
> availableQtystringAvailable position (sellable / transferable)
> pendingQtystringPending position (locked by pending settlements or orders)
> updatedAtintegerSnapshot update timestamp in milliseconds

Request Example

GET /v5/rwa/stocks/positions?showZero=false HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1787657753833
X-BAPI-RECV-WINDOW: 5000
X-BAPI-SIGN: XXXXX

Response Example

{
"retCode": 0,
"retMsg": "ok",
"result": {
"data": [
{
"symbol": "AAPL",
"qty": "100",
"availableQty": "80",
"pendingQty": "20",
"updatedAt": 1724534400000
}
]
},
"time": 1724534400123
}