Set TP/SL Mode

tip

To some extent, this endpoint is depreciated because now tpsl is based on order level. This API was used for position level change before.

However, you still can use it to set an implicit tpsl mode for a certain symbol because when you don't pass "tpslMode" in the place order or trading stop request, system will get the tpslMode by the default setting.

Set TP/SL mode to Full or Partial

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

info

For partial TP/SL mode, you can set the TP/SL size smaller than position size.

HTTP Request

POST /v5/position/set-tpsl-mode

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
tpSlMode	true	string	TP/SL mode. Full,Partial

Response Parameters

Parameter	Type	Comments
tpSlMode	string	Full,Partial

---

Request Example

HTTP

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

{
    "symbol": "XRPUSDT",
    "category": "linear",
    "tpSlMode": "Full"
}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.set_tp_sl_mode(
    symbol="XRPUSDT",
    category="linear",
    tpSlMode="Full",
))

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 setTpSlRequest = PositionDataRequest.builder().category(CategoryType.LINEAR).symbol("BTCUSDT").tpslMode(TpslMode.PARTIAL).build();
client.swithMarginRequest(setTpSlRequest, System.out::println);

Node.js

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

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

client
    .setTPSLMode({
        symbol: 'XRPUSDT',
        category: 'linear',
        tpSlMode: 'Full',
    })
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "tpSlMode": "Full"
    },
    "retExtInfo": {},
    "time": 1672279322666
}