WebSocket API v1 交易 - addOrder 和 cancelOrder

上次更新时间： 2025年4月1日
  • •

    下订单 - addOrder

  • •

    取消订单 - cancelOrder

通过 WebSocket API v1 进行交易（下订单和取消订单）由 addOrder 和 cancelOrder 端点提供。与通过 REST API 交易类似，addOrder 端点用于下新订单，而 cancelOrder 端点用于取消现有（未结）订单。

一旦与 WebSocket API 建立连接，即可通过以下步骤下订单和取消订单：

  1. 1

    获取身份验证令牌，通过 REST API GetWebSocketsToken 端点（一旦获取到有效令牌，同一令牌可用于多个 addOrder/cancelOrder 请求），

  2. 2

    发送相应的 addOrder/cancelOrder 请求，

  3. 3

    接收指示请求是否成功的响应。

下订单 - addOrder

我们的 WebSocket API 文档提供了 addOrder 端点的完整规范，包括必须使用的 JSON 格式，以及每个必填和可选字段的描述。

例如，以下 JSON 消息将下达一个以 150 欧元限价购买 0.25 ETH/EUR 的新订单：

{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}

假设上述订单成功下达（账户余额中有足够的资金等），将收到以下 JSON 消息作为响应：

{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}

取消订单 - cancelOrder

我们的 WebSocket API 文档提供了 cancelOrder 端点的完整规范，包括必须使用的 JSON 格式，以及每个必填和可选字段的描述。

与 REST API 不同，WebSocket API cancelOrder 端点可以通过在 txid 数组中指定每个订单 ID（或用户参考）来同时取消多个订单。

例如，以下 JSON 消息将取消任何具有匹配订单 ID 的未结订单：

{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}

假设订单成功取消，将收到以下 JSON 消息作为响应：

{
"event": "cancelOrderStatus",
"status": "ok"
}

还需帮助？