通過orderId撤單
此端點可以取消單筆訂單。
TIP
此接口只提交取消請求。實際取消結果需要通過查詢訂單狀態或訂閱websocket獲取訂單消息。建議您在收到Open消息後再進行撤單,否則會導致訂單取消不成功。
HTTP請求
DELETE /api/v1/orders/{orderId}
請求示例
DELETE /api/v1/orders/5bd6e9286d99522a52e458de
{
"cancelledOrderIds":[
"5bd6e9286d99522a52e458de"
]
}
API權限
此接口需要幣幣交易權限或槓桿交易權限。
請求URL
此接口支持現貨URL
頻率限制
現貨類權重
:3
請求參數
請求參數 | 類型 | 是否必須 | 含義 |
---|---|---|---|
orderId | String | 是 | 路徑參數,訂單Id 唯一標識 |
返回值
字段 | 含義 |
---|---|
cancelledOrderIds | 取消的訂單id |
TIP
The orderId 是服務器生成的訂單唯一標識,不是客戶端生成的clientOId
撤單被拒
如果訂單不能撤銷(已經成交或已經取消),會返回錯誤信息,可根據返回的msg獲取原因。