Skip to main content

Get Futures Leverage

Query isolated leverage setting for futures symbols. Unlike Get Position Info, this endpoint does not require an open position to retrieve the leverage setting.

HTTP Request

GET/v5/position/symbol-info

Request Parameters

ParameterRequiredTypeComments
categorytruestringProduct type linear(USDT Contract, USDC Contract), inverse
symbolfalsestringSymbol name, like BTCUSDT, uppercase only

Response Parameters

ParameterTypeComments
categorystringProduct type
listarrayObject
> symbolstringSymbol name
> leveragestringLeverage
> sidestringMeaningless field, pls ignore. Buy, Sell, ""
> positionIdxintegerPosition mode. 0: one-way; 1: two-way Buy; 2: two-way Sell
info

Under Portfolio Margin mode, this endpoint returns an error.

Request Example

GET /v5/position/symbol-info?category=linear&symbol=BTCUSDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672284128523
X-BAPI-RECV-WINDOW: 5000

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {
"category": "linear",
"list": [
{
"symbol": "MNTUSDT",
"leverage": "10",
"side": "Sell",
"positionIdx": 2
},
{
"symbol": "MNTUSDT",
"leverage": "10",
"side": "Sell",
"positionIdx": 1
}
]
},
"retExtInfo": {},
"time": 1781518340920
}