跳转到主要内容
通过 WebSocket 撤销订单。
  • 接口:wss://trade.qfex.com?api_key=YOUR_API_KEY。
  • 连接后必须在 1 分钟内完成身份认证。

1. 身份认证

连接后立即发送:

2. 取消订单

可以按 order_id、client_order_id、twap_id 或 client_twap_id 取消。将标识符填入 order_id 字段,并用 cancel_order_id_type 指定如何解释该值。
  • order_id:始终是唯一的 UUID v4,只取消一笔订单。
  • client_order_id:不保证唯一,会取消该品种中具有相同客户端订单 ID 的全部订单。
  • twap_id:服务器生成的 TWAP ID,取消匹配的 TWAP。
  • client_twap_id:客户端提供的 TWAP ID,取消该品种中匹配的 TWAP。

按订单 ID 取消单笔订单

按客户端订单 ID 取消,可能影响多笔订单

按 TWAP ID 取消

按客户端 TWAP ID 取消

参数

注意:
  • 四种模式均将标识符放入 order_id。引擎根据 cancel_order_id_type 判断其属于订单 ID、客户端订单 ID、TWAP ID 还是客户端 TWAP ID。
  • 订单 ID 始终唯一,格式为 UUID v4。
  • 客户端订单 ID 不保证唯一,可能取消同一品种的多笔订单。
  • twap_id 和 client_twap_id 用于取消 TWAP。
  • 响应包含 OrderStatus 状态码,例如 CANCELLED、NO_SUCH_ORDER 或 REJECTED。

示例代码

响应示例

下单返回 ACK;撤单返回相同结构,但状态为 CANCELLED。