WebSocket API v1 - đặt và hủy lệnh

Cập nhật lần cuối: 1 thg 4, 2025

API WebSocket v1 của chúng tôi hỗ trợ giao dịch thông qua các điểm cuối addOrder và cancelOrder. Điểm cuối addOrder được sử dụng để đặt lệnh mới và điểm cuối cancelOrder được sử dụng để hủy các lệnh hiện có (đang mở).

Cả addOrder và cancelOrder đều là các điểm cuối riêng tư, nghĩa là chúng chỉ có thể được truy cập thông qua kết nối WebSocket đã xác thực.

Một kết nối ban đầu nên được thực hiện đến URL WebSocket đã xác thực wss://ws-auth.kraken.com/ , sau đó có thể được giữ mở vô thời hạn trong khi các lệnh được đặt và hủy. Một kết nối WebSocket duy nhất được thiết kế để hỗ trợ nhiều yêu cầu, vì vậy không cần thiết (hoặc không khuyến nghị) phải kết nối/ngắt kết nối cho mỗi lần gọi đến các điểm cuối giao dịch.

Xác thực WebSocket

Mã thông báo xác thực WebSocket có thể được truy xuất thông qua điểm cuối GetWebSocketsToken của REST API.

Sau khi mã thông báo đã được truy xuất, một kết nối có thể được thực hiện đến URL WebSocket riêng tư wss://ws-auth.kraken.com/ và các điểm cuối addOrder và cancelOrder sau đó có thể được sử dụng vô thời hạn (mã thông báo sẽ không hết hạn khi nó đang được sử dụng để đặt và hủy lệnh).

Lưu ý rằng khóa API được sử dụng để truy xuất mã thông báo phải có cả quyền Sửa đổi lệnh và Hủy/Đóng lệnh, nếu không, lỗi từ chối quyền sẽ được nhận từ WebSocket API.

Đặt lệnh

Sau khi kết nối WebSocket đã xác thực được thiết lập, một lệnh có thể được đặt bằng cách gửi một thông báo như sau:

  • •

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

Sau đó, một phản hồi sẽ được nhận cho biết trạng thái của yêu cầu (liệu lệnh có được chấp nhận hay từ chối). Đối với một lệnh đã được chấp nhận và đặt thành công, phản hồi sẽ cho biết trạng thái ok và tương tự như sau:

  • •

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

Đối với một lệnh bị từ chối và không được đặt, phản hồi sẽ cho biết trạng thái lỗi, cùng với một thông báo lỗi cho biết lý do từ chối (đối số không hợp lệ, không đủ tiền, v.v.), chẳng hạn như từ chối sau đây đối với một lệnh không đáp ứng kích thước lệnh tối thiểu:

  • •

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

Hủy lệnh

Sau khi kết nối WebSocket đã xác thực được thiết lập (hoặc tốt hơn là sử dụng lại kết nối hiện có), một lệnh có thể được hủy bằng cách gửi một thông báo như sau:

  • •

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

Sau đó, một phản hồi sẽ được nhận cho biết trạng thái của yêu cầu (liệu việc hủy có được chấp nhận hay từ chối). Đối với một lệnh đã được hủy thành công, phản hồi sẽ cho biết trạng thái ok và tương tự như sau:

  • •

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

Đối với một yêu cầu hủy bị từ chối, phản hồi sẽ cho biết trạng thái lỗi, cùng với một thông báo lỗi cho biết lý do từ chối (ID lệnh không hợp lệ, v.v.), chẳng hạn như từ chối sau đây đối với yêu cầu hủy một lệnh đã bị hủy trước đó:

  • •

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

Lưu ý rằng không giống như điểm cuối CancelOrder của REST API, có thể chỉ định nhiều ID lệnh trong một tin nhắn hủy WebSocket duy nhất. Các ID lệnh cần hủy nên được đưa vào dưới dạng các mục riêng biệt trong mảng txid, như sau:

  • •

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

Bạn cần thêm trợ giúp?