Thông báo nâng cấp API của KuCoin (2026-06-03)

Để cải thiện trải nghiệm giao dịch API, nâng cao khả năng giao dịch trong khuôn khổ Tài khoản Giao dịch Thống nhất (UTA) và giảm độ phức tạp khi tích hợp giữa các chế độ tài khoản khác nhau, KuCoin sẽ nâng cấp Pro API và phát hành các bản cập nhật API liên quan.
Sau khi nâng cấp, Pro API sẽ được nâng cấp lên UTA API. Về sau, UTA API sẽ chỉ hỗ trợ chế độ Unified Trading Account (UTA).
 

1. Lịch trình nâng cấp

Việc nâng cấp được lên lịch vào lúc 08:00 ngày 3 tháng 6 năm 2026 (UTC) và dự kiến kéo dài 180 phút.
 

2. Tác động của việc nâng cấp

Trong thời gian nâng cấp, người dùng có thể trải qua các tác động sau:
  1. WebSocket PRO có thể gặp sự gián đoạn tạm thời, mất dữ liệu hoặc trễ. Người dùng có thể kết nối lại với WebSocket để khôi phục kết nối.
 

3. Chi tiết nâng cấp

3.1 Nâng cấp API UTA

Hiện tại, một số điểm cuối Pro API tương thích với cả Tài khoản cổ điển và Tài khoản giao dịch thống nhất (UTA). Trong tương lai, chúng tôi sẽ tiếp tục tập trung vào khung Tài khoản giao dịch thống nhất và tiếp tục nâng cao API UTA với các tính năng mới và tối ưu hóa tính năng. Hỗ trợ tương thích liên quan đến Tài khoản cổ điển sẽ chuyển sang chế độ bảo trì và sẽ không còn là trọng tâm chính cho việc phát triển tính năng mới, cải thiện hiệu suất hoặc sự phát triển lâu dài của nền tảng.
 
[Chi tiết điều chỉnh]
  • API Pro sẽ được nâng cấp lên API UTA, chủ yếu hỗ trợ Tài khoản Giao dịch Thống nhất (UTA) về sau.
  • Hỗ trợ tương thích liên quan đến Tài khoản cổ điển trong API UTA sẽ chuyển sang chế độ bảo trì.
 
Nếu bạn hiện đang sử dụng mô hình “Pro API + Tài khoản cổ điển”, chúng tôi khuyến nghị mạnh mẽ hoàn thành một trong các tùy chọn di chuyển sau càng sớm càng tốt:
  • Chuyển sang chế độ Tài khoản Giao dịch Thống nhất (UTA) để giao dịch;
  • Tiếp tục sử dụng Classic API để giao dịch Tài khoản cổ điển.
 
Điều này sẽ giúp đảm bảo quá trình di chuyển diễn ra suôn sẻ và hoạt động giao dịch không bị gián đoạn.
 

3.2 Nâng cấp API

  • Tối ưu hóa quy trình kết nối và xác thực WebSocket:
    • Việc xử lý đồng bộ sẽ được chuyển sang xử lý bất đồng bộ trong các giai đoạn bắt tay và xác thực, giảm hành vi chặn và cải thiện số lượng yêu cầu xác thực có thể xử lý trong mỗi đơn vị thời gian.
    • Khi kết nối WebSocket không xác thực do thông tin xác thực không hợp lệ, hết hạn hoặc không được ủy quyền, máy chủ sẽ gửi tin nhắn “auth failed” qua khung WebSocket, giúp khách hàng nhanh chóng xác định nguyên nhân lỗi và thực hiện các hành động phù hợp. Tối ưu hóa này không ảnh hưởng đến các kết nối WebSocket đã xác thực thành công.

 

    • positionMargin: Ký quỹ bị chiếm dụng bởi vị thế giao sau.
    • riskRatio: Tỷ lệ rủi ro của một vị thế giao sau cô lập.

 

  • [Chỉnh sửa] UTA Websocket Vị thế, đã thêm trường phản hồi:
    • pM: Ký quỹ bị chiếm dụng bởi vị thế giao sau.
    • r: Tỷ lệ rủi ro của một vị thế giao sau cô lập. Ví dụ: 0.65 đại diện cho 65%.

 

  • [Chỉnh sửa] Classic REST Get Deposit List và Classic REST Get Deposit Detail. Các endpoint đã thêm các giá trị trạng thái trả về sau để hiển thị các trạng thái nạp chi tiết hơn:
    • ROLLBACKING: Hủy bỏ khoản nạp. Vui lòng chờ.
    • PHỤC HỒI: Giao dịch nạp đã được hoàn lại. Không có khoản tiền nào được ghi vào tài khoản. Vui lòng liên hệ hỗ trợ để được trợ giúp.
    • WAIT_RISK_MGT: Giao dịch nạp đang được xác minh rủi ro theo quy trình tiêu chuẩn. Vui lòng liên hệ hỗ trợ để được trợ giúp.
    • RISK_MGT_REJECTED: Việc nạp bị từ chối sau khi xác minh rủi ro. Vui lòng liên hệ hỗ trợ để gửi thông tin cần thiết để xem xét.
    • PRE_SUCCESS: Số dư đã được ghi có vào tài khoản trước khi xác nhận khối cuối cùng.
    • WAIT_TRM_MGT: Giao dịch nạp đang được xác minh tuân thủ tiêu chuẩn. Vui lòng liên hệ hỗ trợ để được trợ giúp.
    • TRM_MGT_REJECTED : Việc nạp bị từ chối sau khi xác minh rủi ro. Vui lòng liên hệ hỗ trợ để gửi thông tin cần thiết để xem xét.

 

  • [Thêm] Fast API - Đăng ký rút tiền nhanh
    • Hỗ trợ quyền khóa API do người dùng định nghĩa trong quy trình ủy quyền OAuth, bao gồm cấp quyền rút tiền
    • Quyền mới: Rút tiền nhanh (quyền rút tiền qua API nhanh)
    • Hỗ trợ rút tiền qua API với xác thực 2 yếu tố

 

 

 

  • [Chỉnh sửa] UTA REST Đặt lệnh, thêm trường mới closeOrder để hỗ trợ đóng vị thế cho cặp ký hiệu được chỉ định

 

  • [Chỉnh sửa] UTA REST Get Transfer Quotas, thêm enum mới UNIFIED vào trường accountType trong tham số truy vấn và tham số phản hồi
 
 
Để biết thêm thông tin về API, vui lòng tham gia Cộng đồng Telegram chính thức của KuCoin API
Bạn cũng có thể liên hệ với chúng tôi qua email tại: api@kucoin.com
 
Chúng tôi xin chân thành xin lỗi vì bất kỳ sự bất tiện nào mà điều chỉnh này có thể gây ra, và cảm ơn sự hỗ trợ và niềm tin liên tục của bạn vào KuCoin API.

Tuyên bố từ chối trách nhiệm: Trang này được dịch bằng công nghệ AI (do GPT cung cấp) để thuận tiện cho bạn. Để biết thông tin chính xác nhất, hãy tham khảo bản gốc tiếng Anh.