跳至主要内容

設置止盈止損

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

普通帳戶覆蓋範圍: USDT永續 / 反向合約

提示

在提交請求後，系統內部將會自動創建對應類型的條件單。若倉位被平，系統將會調整相關條件訂單數量或者取消這些條件單。

信息

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

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

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

HTTP 請求​

POST /cloud/trade/v3/position/trading-stop

請求參數​

參數是否必需類型說明
categorytruestring產品類型
  • 交易帳戶: linear, inverse.
  • 普通帳戶: linear, inverse. 這裡category字段不參與業務邏輯，僅做路由使用
symboltruestring合約名稱
takeProfitfalsestring止盈價格. 等於0表示取消止盈，若不修改，則不要傳遞該參數
stopLossfalsestring止損價格. 等於0表示取消止損，若不修改，則不要傳遞該參數
trailingStopfalsestring追蹤止損, 僅支持按價差設置. 等於0表示取消追蹤止損，若不修改，則不要傳遞該參數
tpTriggerByfalsestring止盈價格類型
slTriggerByfalsestring止損價格類型
activePricefalsestring追蹤止損激活價格. 追蹤止損會在到達該價格時觸發
tpslModefalsestring止盈止損模式. Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損. 由於每個合約都有初始的止盈止損模式(Full), 若曾經修改過, 那麼可能是Partial, 因此若不傳入, 則系統會自動獲取該合約當前的止盈止損模式配置
tpSizefalsestring止盈倉位數量. 僅部分止盈止損時有效. 注意: tpSize和slSize的數值必須相等
slSizefalsestring止損倉位數量. 僅部分止盈止損時有效. 注意: tpSize和slSize的數值必須相等
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 /cloud/trade/v3/position/trading-stop HTTP/1.1
Host: openapi-testnet.zoomex.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672283124270
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "category":"linear",
    "symbol": "XRPUSDT",
    "takeProfit": "0.5",
    "stopLoss": "0.2",
    "tpTriggerBy": "MarkPrice",
    "slTriggerBy": "IndexPrice",
    "tpslMode": "Partial",
    "tpOrderType": "Limit"
    "slOrderType": "Limit"
    "tpSize": "50",
    "tpLimitPrice": "0.49",
    "slLimitPrice": "0.21",
    "positionIdx": 0
}

響應示例​

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