Switch Position Mode

It supports to switch the position mode for USDT perpetual and Inverse futures. If you are in one-way Mode, you can only open one position on Buy or Sell side. If you are in hedge mode, you can open both Buy and Sell side positions simultaneously.

Unified account covers: USDT perpetual / Inverse Futures
Classic account covers: USDT perpetual / Inverse Futures

tip

• Priority for configuration to take effect: symbol > coin > system default
• System default: one-way mode
• If the request is by coin (settleCoin), then all symbols based on this setteCoin that do not have position and open order will be batch switched, and new listed symbol based on this settleCoin will be the same mode you set.

Example

	System default	coin	symbol
Initial setting	one-way	never configured	never configured
Result	All USDT perpetual trading pairs are one-way mode
Change 1	-	-	Set BTCUSDT to hedge-mode
Result	BTCUSDT becomes hedge-mode, and all other symbols keep one-way mode
list new symbol ETHUSDT	ETHUSDT is one-way mode （inherit default rules）
Change 2	-	Set USDT to hedge-mode	-
Result	All current trading pairs with no positions or orders are hedge-mode, and no adjustments will be made for trading pairs with positions and orders
list new symbol SOLUSDT	SOLUSDT is hedge-mode (Inherit coin rule)
Change 3	-	-	Set ASXUSDT to one-mode
Take effect result	AXSUSDT is one-way mode, other trading pairs have no change
list new symbol BITUSDT	BITUSDT is hedge-mode (Inherit coin rule)

The position-switch ability for each contract

	Classic account	Unified account
USDT perpetual	Support one-way & hedge-mode	Support one-way & hedge-mode
USDC perpetual	Support one-way only	Support one-way only
Inverse perpetual	Support one-way only	Support one-way only
Inverse future	Support one-way & hedge-mode	Support one-way & hedge-mode

HTTP Request

POST /v5/position/switch-mode

Request Parameters

Parameter	Required	Type	Comments
category	true	string	Product type Unified account: linear, USDT Perp; inverse, Inverse Futures Classic account: linear, USDT Perp; inverse, Inverse Futures. Please note that category is not involved with business logic
symbol	false	string	Symbol name. Either symbol or coin is required. symbol has a higher priority
coin	false	string	Coin
mode	true	integer	Position mode. 0: Merged Single. 3: Both Sides

---

Response Parameters

None

Request Example

HTTP

POST /v5/position/switch-mode HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1675249072041
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 87

{
    "category":"inverse",
    "symbol":"BTCUSDH23",
    "coin": null,
    "mode": 0
}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.switch_position_mode(
    category="inverse",
    symbol="BTCUSDH23",
    mode=0,
))

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().newPositionRestClient();
var switchPositionMode = PositionDataRequest.builder().category(CategoryType.LINEAR).symbol("BTCUSDT").positionMode(PositionMode.BOTH_SIDES).build();
System.out.println(client.switchPositionMode(switchPositionMode));

Node.js

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

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

client
    .switchPositionMode({
        category: 'inverse',
        symbol: 'BTCUSDH23',
        mode: 0,
    })
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

Response Example

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