Giao dịch WebSocket API v1 - addOrder và cancelOrder

Cập nhật lần cuối: 1 tháng 4, 2025
  • Đặt lệnh - addOrder

  • Hủy lệnh - cancelOrder

Giao dịch (đặt và hủy lệnh) thông qua WebSocket API v1 được cung cấp bởi các điểm cuối addOrdercancelOrder. Tương tự như giao dịch thông qua REST API, đ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ở).

Sau khi kết nối với WebSocket API đã được thiết lập, lệnh có thể được đặt và hủy thông qua các bước sau:

  1. 1

    truy xuất mã thông báo xác thực thông qua điểm cuối REST API GetWebSocketsToken (sau khi mã thông báo hợp lệ đã được truy xuất, cùng một mã thông báo có thể được sử dụng cho nhiều yêu cầu addOrder/cancelOrder),

  2. 2

    gửi yêu cầu addOrder/cancelOrder phù hợp,

  3. 3

    nhận phản hồi cho biết yêu cầu có thành công hay không.

Đặt lệnh - addOrder

Tài liệu WebSocket API của chúng tôi cung cấp thông số kỹ thuật đầy đủ cho điểm cuối addOrder, bao gồm định dạng JSON phải được sử dụng, cùng với mô tả của từng trường bắt buộc và tùy chọn.

Ví dụ, thông báo JSON sau đây sẽ đặt một lệnh mới để mua 0,25 ETH/EUR với giá giới hạn €150:

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

Giả sử lệnh trên đã được đặt thành công (có đủ tiền trong số dư tài khoản, v.v.), thông báo JSON sau đây sẽ được nhận làm phản hồi:

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

Hủy lệnh - cancelOrder

Tài liệu WebSocket API của chúng tôi cung cấp thông số kỹ thuật đầy đủ cho điểm cuối cancelOrder, bao gồm định dạng JSON phải được sử dụng, cùng với mô tả của từng trường bắt buộc và tùy chọn.

Không giống như REST API, điểm cuối cancelOrder của WebSocket API có thể được sử dụng để hủy nhiều lệnh cùng lúc, bằng cách chỉ định từng ID lệnh (hoặc tham chiếu người dùng) trong mảng txid.

Ví dụ, thông báo JSON sau đây sẽ hủy bất kỳ lệnh đang mở nào có ID lệnh khớp:

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

Giả sử các lệnh đã được hủy thành công, thông báo JSON sau đây sẽ được nhận làm phản hồi:

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

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