修改委託單

備註

您只能修改那些未成交或者部分成交的訂單。

HTTP 請求

POST /contract/v3/private/order/replace

請求參數

參數	是否必需	類型	說明
symbol	true	string	合約名稱
orderId	false	string	訂單Id. orderId和orderLinkId必傳其中一個
orderLinkId	false	string	用戶自定義訂單Id. orderId和orderLinkId必傳其中一個
price	false	string	修改後的訂單價格. 若不修改，請不要傳該字段
qty	false	string	修改後的訂單數量. 若不修改，請不要傳該字段
triggerPrice	false	string	觸發價格. 若不修改，請不要傳該字段
takeProfit	false	string	修改後的止盈價格. 若不修改，請不要傳該字段
stopLoss	false	string	修改後的止損價格. 若不修改，請不要傳該字段
tpTriggerBy	false	string	止盈價格觸發類型. 若下單時未設置該值，則調用該接口修改止盈價格時，該字段必傳
slTriggerBy	false	string	止損價格觸發類型. 若下單時未設置該值，則調用該接口修改止損價格時，該字段必傳
triggerBy	false	string	觸發價格的觸發類型. LastPrice, IndexPrice, MarkPrice
tpLimitPrice	false	string	觸發止盈後轉換為限價單的價格. 當且僅當原始訂單下單時創建的是部分止盈止損限價單, 本字段才有效
slLimitPrice	false	string	觸發止損後轉換為限價單的價格. 當且僅當原始訂單下單時創建的是部分止盈止損限價單, 本字段才有效

響應參數

參數	類型	說明
orderId	string	訂單Id
orderLinkId	string	用戶自定義訂單Id

請求示例

POST /contract/v3/private/order/replace HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1670554903846
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
{
    "symbol": "XRPUSDT",
    "orderId": "5ba57394-0ff0-4cb8-8000-59085d2c3aba",
    "orderLinkId": null,
    "price": "14.5"
}

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "orderId": "5ba57394-0ff0-4cb8-8000-59085d2c3aba",
        "orderLinkId": ""
    },
    "retExtInfo": {},
    "time": 1670554904609
}