Set Leverage

info

According to the risk limit, leverage affects the maximum position value that can be opened, that is, the greater the leverage, the smaller the maximum position value that can be opened, and vice versa. Learn more

HTTP Request

POST /v5/position/set-leverage

Request Parameters

Parameter	Required	Type	Comments
category	true	string	Product type UTA2.0, UTA1.0: linear, inverse Classic account: linear, inverse
symbol	true	string	Symbol name, like BTCUSDT, uppercase only
buyLeverage	true	string	[1, max leverage] one-way mode: buyLeverage must be the same as sellLeverage Hedge mode: Classic account & UTA (isolated margin): buyLeverage and sellLeverage can be different; UTA (cross margin): buyLeverage must be the same as sellLeverage
sellLeverage	true	string	[1, max leverage]

---

Response Parameters

None

Request Example

HTTP

POST /v5/position/set-leverage HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672281605082
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "category": "linear",
    "symbol": "BTCUSDT",
    "buyLeverage": "6",
    "sellLeverage": "6"

}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.set_leverage(
    category="linear",
    symbol="BTCUSDT",
    buyLeverage="6",
    sellLeverage="6",
))

Java

import com.bybit.api.client.domain.*;
import com.bybit.api.client.domain.position.*;
import com.bybit.api.client.domain.position.request.*;
import com.bybit.api.client.service.BybitApiClientFactory;
var client = BybitApiClientFactory.newInstance().newAsyncPositionRestClient();
var setLeverageRequest = PositionDataRequest.builder().category(CategoryType.LINEAR).symbol("BTCUSDT").buyLeverage("5").sellLeverage("5").build();
client.setPositionLeverage(setLeverageRequest, System.out::println);

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
    testnet: true,
    key: 'apikey',
    secret: 'apisecret',
});

client
    .setLeverage({
        category: 'linear',
        symbol: 'BTCUSDT',
        buyLeverage: '6',
        sellLeverage: '6',
    })
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {},
    "retExtInfo": {},
    "time": 1672281607343
}