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 金鑰必須同時擁有修改訂單和取消/關閉訂單權限，否則將從 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"]}

需要更多幫助？