跳至主要内容

設置止盈止損

該接口可以設置止盈、止損和追蹤止損.

提示
  • 在提交請求後，系統內部將會自動創建對應類型的條件單
  • 若倉位被平，系統將會調整相關條件訂單數量或者取消這些條件單。
  • 支持USDT永續，USDC永續，反向永續和反向交割.
信息

新版止盈止損, 支持既持有全部止盈止損單, 也可以持有部分止盈止損單

  • 全部倉位止盈止損單: 該接口可用於修改該類型的止盈止損單的參數
  • 部分倉位止盈止損單: 該接口僅能新增部分倉位止盈止損單
備註

新版止盈止損下, 調用該接口對持倉上的已有的止盈止損進行單邊止盈或者止損修改時, 會導致成對的tp/sl訂單失去綁定關係, 這意味著當通過tp/sl訂單ID調用 取消接口時, 只會取消對應訂單ID的單邊止盈或止損.

HTTP 請求​

POST /contract/v3/private/position/trading-stop

請求參數​

參數是否必需類型說明
symboltruestring合約名稱
takeProfitfalsestring不能小於0. 設置為0時，則表示取消止盈. 部分止盈止損無法通過設置0來取消
stopLossfalsestring不能小於0. 設置為0時，則表示取消止損. 部分止盈止損無法通過設置0來取消
tpSizefalsestring止盈倉位數量. 僅部分止盈止損時有效. 注意: tpSize和slSize的數值必須相等
slSizefalsestring止盈倉位數量. 僅部分止盈止損時有效. 注意: tpSize和slSize的數值必須相等
tpTriggerByfalsestring止盈價格類型
slTriggerByfalsestring止損價格類型
trailingStopfalsestring不能小於0. 設置為0時，則表示取消追蹤止損. 注意: 僅對USDT永續有效
activePricefalsestring追蹤止損激活價格. 追蹤止損會在到達該價格時觸發
tpslModefalsestring止盈止損模式. Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損. 由於每個合約都有初始的止盈止損模式(Full), 若曾經修改過, 那麼可能是Partial, 因此若不傳入, 則系統會自動獲取該合約當前的止盈止損模式配置
tpLimitPricefalsestring觸發止盈後轉換為限價單的價格. 僅tpslMode=Partial且tpOrderType=Limit時有效
slLimitPricefalsestring觸發止損後轉換為限價單的價格. 僅tpslMode=Partial且slOrderType=Limit時有效
tpOrderTypefalsestring止盈觸發後的訂單類型. Market(默認), Limit. 對於tpslMode=Full時, 僅支持tpOrderType=Market
slOrderTypefalsestring止損觸發後的訂單類型. Market(默認), Limit. 對於tpslMode=Full時, 僅支持slOrderType=Market
positionIdxtrueinteger倉位標識，用於識別倉位.
  • 0: 單向持倉
  • 1: 買側雙向持倉
  • 2: 賣側雙向持倉

響應參數​

無

請求示例​

POST /contract/v3/private/position/trading-stop HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1670852788387
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
{
    "symbol": "SOLPERP",
    "takeProfit": "19",
    "stopLoss": "10",
    "activePrice": null,
    "trailingStop": null,
    "tpTriggerBy": null,
    "slTriggerBy": null,
    "tpslMode": "Partial",
    "tpOrderType": "Limit"
    "slOrderType": "Limit"
    "tpSize": "50",
    "slSize": "50",
    "tpLimitPrice": "18",
    "slLimitPrice": "11",
    "positionIdx": 0
}

響應示例​

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