Người dùng thân mến,

HTX đã thêm API tự động hủy lệnh, được gọi là Dead man’s switch, để bảo vệ tài sản của người dùng khi kết nối với sàn giao dịch bị mất do lỗi mạng hoặc hệ thống. HTX đã thêm API “Dead man’s switch” vào lúc 18:00 ngày 11 tháng 1 năm 2021 (GMT + 8), cho phép người dùng hủy tất cả lệnh của người dùng trên thị trường giao ngay khi vô tình bị ngắt kết nối khỏi nền tảng. Chi tiết như sau:

Tự động hủy lệnh

Bật / tắt “Dead man’s switch”. Nếu Dead man’s switch được bật lệnh và lệnh mua API không được gửi hai lần trong thời gian đã định, nền tảng sẽ hủy tất cả lệnh của bạn trên thị trường giao ngay（hủy tối đa 500 lệnh).

Yêu cầu HTTP

POST/v2/algo-orders/cancel-all-after

Yêu cầu mẫu

POST / v2 / order /cel-all-after {"timeout": "10"} （Các thông số được đặt trong HTTP Body）Yêu cầu tham số

Tên	Bắt buộc	Loại	Mô tả	Giá trị cố định	Phạm vi giá trị
Thời gian chờ (Timeout)	true	int	thời lượng time out (đơn vị ：giây); xem ghi chú để biết thêm chi tiết	NA	0 or >=5 giây

Lưu ý:

• Cách tốt nhất là đặt thời gian chờ là 60 giây và gửi lệnh mua API sau mỗi 15 giây nếu bạn muốn bật Dead man’s switch. Điều này sẽ giữ cho lênh của bạn không thay đổi trong thời gian mạng tạm thời bị tắc nghẽn và bảo vệ tài sản của bạn trong những trường hợp bất khả kháng như mất điện. Do đó, chúng tôi khuyên bạn nên đặt thời gian ch ờ> = 5 giây để tránh bị hủy đơn lệnh không cần thiết do giới hạn tần suất hoặc do tắc nghẽn mạng.
• Đặt thời gian chờ là 0 nếu bạn muốn hủy hoạt động API và giữ cho lệnh của bạn mở.

Phản hồi mẫu

Tên	Bắt buộc	Loại	Mô tả
code	true	int	status code
message	false	string	error description (if any)
data	true	object
{ currentTime	true	long	current time
triggerTime }	true	long	trigger time

Phản hồi mẫu - Bật thành công

Yêu cầu:

{

"code": 200,

"data": [

{

    "currentTime":"1587971400",

    "triggerTime":"1587971460"

  }

]

}

Phản hồi mẫu - Bật / Tắt thành công

Yêu cầu:

{

"code": 200,

"data": [

{

    "currentTime":"1587971400",

    "triggerTime":"0"

  }

]

}

Phản hồi mẫu - Bật / Tắt không thành công

Yều cầu:

{

"code": 2003,

"message": "missing mandatory field"

}

Các API mới được thêm vào sẽ ảnh hưởng như thế nào?

Người dùng API cần đánh giá các cải tiến API sẽ giúp ích như thế nào đối với các giao dịch của họ và cập nhật các Ứng dụng có liên quan cho phù hợp.

Ngày có hiệu lực: Ngày 11 tháng 1 năm 2021 (GMT + 8)

Các bạn có thể tham khảo thêm qua HTX API Docshoặc Quá trình cập nhật API Changeđể biết thêm chi tiết.

Người dùng API cần đánh giá các cải tiến API sẽ giúp ích như thế nào đối với các giao dịch của họ và cập nhật các Ứng dụng có liên quan cho phù hợp.

• Announcement on Adding Automatic Order Cancellation API on HTX.pdf
  100 KBDownload