Kính gửi người dùng HTX,

Nhằm nâng cao chất lượng và hiệu suất dịch vụ giao dịch hợp đồng tương lai, HTX sẽ tiến hành nâng cấp và chuyển đổi API toàn diện cho Hệ thống Giao dịch Hợp đồng Tương lai USDT-M. Kế hoạch ​​này đánh dấu một cuộc đại tu toàn bộ cơ sở hạ tầng giao dịch cốt lõi của chúng tôi, được thiết kế để mang lại cho người dùng trải nghiệm dịch vụ API hiệu suất cao hơn, ổn định hơn và chuẩn hóa hơn. Các nội dung liên quan được thông báo như sau:

I. Lịch trình chuyển đổi

• Ngày bắt đầu: 15:00:00 (UTC+7) ngày 26 tháng 5 năm 2026
• Ngày kết thúc: 22:59:59 (UTC+7) ngày 13 tháng 7 năm 2026

Lưu ý: Sau thời hạn chuyển đổi, phiên bản API cũ sẽ bị ngừng hoạt động vĩnh viễn. Bất kỳ tài khoản nào chưa hoàn tất chuyển đổi sẽ mất khả năng đặt lệnh, hủy lệnh hoặc thực hiện các thao tác giao dịch khác. Người dùng nên lên kế hoạch và thực hiện chuyển đổi trước thời hạn này. (Tài khoản đã nâng cấp lên Chế độ Thế chấp Nhiều Tài sản sẽ không bị ảnh hưởng bởi quá trình chuyển đổi này.)

II. Phạm vi chuyển đổi

• Nâng cấp này yêu cầu tích hợp lại tất cả giao diện hợp đồng tương lai (bao gồm cả copy trading ), ngoại trừ các giao diện dữ liệu thị trường. Những danh mục sau đây phải được cập nhật:
  • Giao diện liên quan đến tài khoản (tài sản, số dư, v.v.)
  • Giao diện liên quan đến lệnh (đặt lệnh, hủy lệnh, truy vấn, v.v.)
  • Giao diện liên quan đến vị thế (vị thế hiện tại, giới hạn vị thế, v.v.)
  • Giao diện Bot giao dịch/Lệnh điều kiện
  • Giao diện thông tin cơ bản
• Tài liệu API mới: https://www.htx.com/en-us/opend/newApiPages/?id=5521
• Tài liệu API cũ: https://www.htx.com/en-us/opend/newApiPages/?id=504

III. Chi tiết tối ưu hóa

Đợt nâng cấp API này mang lại những cải tiến đáng kể trên nhiều phương diện:

• Tinh gọn kiến trúc giao diện: Hệ thống giao diện đã được rà soát và hợp nhất một cách có hệ thống. Số lượng giao diện cốt lõi đã giảm đáng kể, làm giảm độ phức tạp tích hợp và cải thiện khả năng bảo trì cũng như khả năng sử dụng.
• Cải thiện hiệu suất giao dịch: Các quy trình cốt lõi—bao gồm đặt lệnh, hủy lệnh, thực hiện lệnh và thanh toán—đã được tối ưu hóa triệt để để mang lại độ trễ thấp hơn và thông lượng cao hơn, đảm bảo phản hồi giao dịch ổn định và hiệu quả hơn trong điều kiện thị trường có mức độ đồng thời cao.
• Tăng cường tính nhất quán dữ liệu: Cấu trúc dữ liệu tài khoản, vị thế và thực hiện lệnh đã được thống nhất, làm giảm sự sai lệch dữ liệu giữa các giao diện khác nhau và giúp các nhà phát triển dễ dàng xử lý và tích hợp dữ liệu đa chiều.
• Thống nhất mô hình kiểm soát rủi ro: Các tính toán ký quỹ, chỉ số rủi ro và logic giá đánh dấu đã được chuẩn hóa nhằm nâng cao tính nhất quán và khả năng dự đoán của các quy tắc kiểm soát rủi ro, giúp người dùng thực hiện đánh giá rủi ro và mô hình hóa chiến lược chính xác hơn.
• Nâng cấp tiêu chuẩn giao diện: Tên gọi giao diện và cấu trúc tham số được thống nhất và rõ ràng hơn, phương thức xác thực được chuẩn hóa hơn, đồng thời cấu trúc tài liệu cũng được tối ưu tương ứng để nâng cao hiệu quả tích hợp và khả năng tương thích.
• Khả năng mở rộng mạnh hơn: Kiến trúc được nâng cấp cung cấp sự hỗ trợ mạnh mẽ hơn cho việc mở rộng các tính năng giao dịch và khả năng định lượng trong tương lai. Chúng tôi sẽ tiếp tục cải tiến và cung cấp các khả năng API mạnh mẽ hơn.

IV. Hướng dẫn chuyển đổi (Đề xuất)

• Tạo tài khoản phụ kiểm thử
  • Nên tạo một tài khoản phụ dưới tài khoản chính hiện có của bạn để kiểm thử và gỡ lỗi chuyển đổi.
  • Gọi giao diện /v5/account/asset_mode để nâng cấp tài khoản phụ lên Chế độ Thế chấp Một Tài sản (asset_mode=2) hoặc Chế độ Thế chấp Nhiều Tài sản (asset_mode=1) mới.
• Điều chỉnh giao diện
  • Điều chỉnh đường dẫn yêu cầu, tham số và phương thức chữ ký theo tài liệu API mới nhất.
• Xác minh giao diện cốt lõi: Đặt/hủy lệnh, truy vấn vị thế, truy vấn tài sản tài khoản, báo cáo thực hiện lệnh, v.v.

Lưu ý:

1. Đối với tài khoản đã hoàn thành nâng cấp chế độ (asset_mode=1 / asset_mode=2), các giao diện riêng tư (giao dịch, tài khoản, vị thế, v.v.) chỉ có thể truy cập thông qua API V5. Giao diện riêng tư phiên bản cũ sẽ không còn khả dụng.

2. Vui lòng ưu tiên chuyển đổi và kiểm thử hồi quy các giao diện cốt lõi như đặt lệnh, hủy lệnh, vị thế và tài sản. Nên bắt đầu càng sớm càng tốt để tránh gián đoạn do các hoạt động chuyển đổi tập trung gần hạn chót.

V. Kênh hỗ trợ

Nếu bạn gặp bất kỳ sự cố nào trong quá trình chuyển đổi, bạn có thể nhận hỗ trợ thông qua các kênh sau đây:

• Nhóm hỗ trợ kỹ thuật Telegram: https://t.me/htx_api
• Dịch vụ khách hàng trực tuyến: Hỗ trợ 24/7
• Liên hệ với đội ngũ Hỗ trợ khách hàng của chúng tôi thông qua Trung tâm trợ giúp trên trang web chính thức của chúng tôi hoặc bằng cách gửi email tới [email protected].

Cảm ơn bạn đã luôn ủng hộ và tin tưởng HTX. Nếu bạn có bất kỳ câu hỏi nào, vui lòng liên hệ với dịch vụ khách hàng trực tuyến của chúng tôi.

Đội ngũ HTX

Ngày 26 tháng 5 năm 2026