WebSocket API v1 - 下达和取消订单

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

我们的 WebSocket API v1 支持通过 addOrder 和 cancelOrder 端点进行交易。addOrder 端点用于下新订单，而 cancelOrder 端点用于取消现有（开放）订单。

addOrder 和 cancelOrder 都是私有端点，这意味着它们只能通过经过身份验证的 WebSocket 连接访问。

应首先连接到经过身份验证的 WebSocket URL wss://ws-auth.kraken.com/，然后可以无限期地保持此连接打开，同时进行订单的下达和取消。单个 WebSocket 连接旨在支持多个请求，因此无需（也不建议）为每次调用交易端点而进行连接/断开操作。

WebSocket 身份验证令牌可以通过 REST API GetWebSocketsToken 端点检索。

一旦令牌已检索，就可以连接到私有 WebSocket URL wss://ws-auth.kraken.com/，然后 addOrder 和 cancelOrder 端点可以无限期使用（令牌在使用期间不会过期，用于下达和取消订单）。

请注意，用于检索令牌的API 密钥必须同时具有 Modify Orders 和 Cancel/Close Orders 权限，否则将从 WebSocket API 收到权限拒绝错误。

建立经过身份验证的 WebSocket 连接后，可以通过发送如下消息来下订单：

•
{"event":"addOrder", "token":"nT9n23/7oLdq+bNHNMNJ4VvF1hiHhjTnPOaCMiB1GJ0", "pair":"XBT/USD", "type":"buy", "ordertype":"limit", "price":"9857", "volume":"0.002", "leverage":"5", "userref":"8874657"}

随后将收到一个响应，指示请求的状态（订单是被接受还是被拒绝）。对于已成功接受和下达的订单，响应将指示状态为 ok，并类似于以下内容：

•
{"descr":"buy 0.00200000 XBTUSD @ limit 9857.0 with 5:1 leverage","event":"addOrderStatus","status":"ok","txid":"OPOUJF-BWKCL-FG5DQL"}

对于被拒绝且未下达的订单，响应将指示状态为 error，并附带一条错误消息，说明拒绝的原因（无效参数、资金不足等），例如以下因未达到最小订单规模而被拒绝的订单：

•
{"errorMessage":"EOrder:Order minimum not met","event":"addOrderStatus","status":"error"}

建立经过身份验证的 WebSocket 连接后（或最好是重用现有连接），可以通过发送如下消息来取消订单：

•
{"event":"cancelOrder", "token":"s74Ajl83it0dNNKcF072NJ5wDmLTGIceaCbV96eWbFg", "txid":["OJZ3DI-IU6QC-ME7TVE"]}

随后将收到一个响应，指示请求的状态（取消是被接受还是被拒绝）。对于已成功取消的订单，响应将指示状态为 ok，并类似于以下内容：

对于被拒绝的取消请求，响应将指示状态为 error，并附带一条错误消息，说明拒绝的原因（无效订单 ID 等），例如以下因请求取消已取消的订单而被拒绝的情况：

•
{"errorMessage":"EOrder:Unknown order","event":"cancelOrderStatus","status":"error"}

请注意，与 REST API CancelOrder 端点不同，可以在单个 WebSocket 取消消息中指定多个订单 ID。要取消的订单 ID 应作为单独的条目包含在 txid 数组中，如下所示：

•
{"event":"cancelOrder", "token":"c4JjTNHSurKmWDsnrGaCxIuCOa4FurCZK2ppktvT2Yo", "txid":["OLVCRZ-DNKJI-VRTZKY","O67X6E-PBGSR-GU23R5","OECCDC-T2R4V-52CR7T"]}

还需帮助？