Set Leverage

Set the leverage

Unified account covers: USDT perpetual / USDC contract / Inverse contract
Classic account covers: USDT perpetual / Inverse contract

HTTP Request

POST /v5/position/set-leverage

Request Parameters

Parameter	Required	Type	Comments
category	true	string	Product type Unified account: linear, inverse Classic account: linear, inverse. Please note that category is not involved with business logic
symbol	true	string	Symbol name
buyLeverage	true	string	[1, max leverage of corresponding risk limit] 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 of corresponding risk limit]

---

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
}