設置止盈止損模式

提示

某種程度上來說，該接口已經廢棄, 原因在於新版的止盈止損機制是基於訂單維度. 這個接口當初主要是用於倉位維度的止盈止損

但是, 您仍然可以使用該接口, 為某個合約設置一個隱式的止盈止損模式, 因為當您在下單接口或者設置止盈止損接口時, 不傳入字段"tpslMode"時, 系統將會獲取一個默認值, 該 默認值實際上是源於是否調用過該接口做過修改, 不曾修改過的symbol, 都是默認Full

可以將止盈止損模式設置為部分止盈止損或者全部止盈止損

信息

在部分止盈止損下，您可以設置小於倉位大小的止盈止損數量

HTTP 請求

POST /v5/position/set-tpsl-mode

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型 統一帳戶: linear, inverse 經典帳戶: linear, inverse. 這裡category字段不參與業務邏輯，僅做路由使用
symbol	true	string	合約名稱
tpSlMode	true	string	TP/SL模式. Full,Partial

響應參數

參數	類型	說明
tpSlMode	string	Full,Partial

---

請求示例

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);
    });

響應示例

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