Thông Báo Nâng Cấp API Ký Quỹ KuCoin
Kính gửi Quý Người Dùng KuCoin,
Để mang lại môi trường giao dịch tốt hơn và tối ưu hóa trải nghiệm giao dịch, API Ký Quỹ của KuCoin đang được nâng cấp và di chuyển tần suất cao. Quá trình di chuyển này sẽ được thực hiện thành nhiều đợt và dự kiến hoàn thành vào cuối năm 2025.
1. Phạm vi Di Chuyển:
Đối với người dùng đã kích hoạt Margin, nếu không có vị thế ký quỹ hoặc tài sản trong suốt quá trình di chuyển, việc này sẽ không ảnh hưởng đến bạn.
2. Ảnh Hưởng Của Quá Trình Di Chuyển:
2.1 Người Dùng Không Sử Dụng API (Người dùng C-end)
- Trải nghiệm người dùng trên Web/App sẽ không thay đổi trước và sau quá trình di chuyển.
2.2 Người Dùng API
- Quá trình di chuyển này sẽ có một số ảnh hưởng đến phương thức gọi giao diện API và hiển thị trạng thái tài sản. Việc di chuyển sẽ được thông báo theo từng đợt. Vui lòng thực hiện các thao tác tương ứng ngay sau khi nhận được email thông báo. Hệ thống sẽ tiến hành di chuyển sau 7 ngày kể từ khi email được gửi. (Để giảm thiểu ảnh hưởng, bạn có thể chuyển sang API tần suất cao trước).
3. Quy Trình Di Chuyển:
Bước 1: Thủ công xử lý các lệnh tần suất thấp
a. Người dùng cần tự hủy các lệnh được đặt bởi API tần suất thấp và C-end (Web/App);
b. Các lệnh tần suất cao không cần phải hủy;
-
Nếu bạn không tự hủy, hệ thống sẽ buộc hủy lệnh trong quá trình di chuyển (bao gồm cả lệnh thường và lệnh nâng cao).
-
Nếu bạn không xác nhận được trạng thái lệnh của mình, vui lòng liên hệ bộ phận chăm sóc khách hàng để được tư vấn.
Bước 2: Thủ công chuyển tài sản tần suất thấp (người dùng API)
a. Người dùng cần thủ công chuyển tài sản tài khoản tần suất thấp sang tài khoản tần suất cao và chuyển đổi sang giao diện API mới (xem chi tiết trong tài liệu api-doc).
b. Nhận Hạn Mức Chuyển - API KUCOIN Tại thời điểm này, tài sản trên C-end (Web và App) được hiển thị là "FROZEN", và không thể thực hiện các lệnh tần suất cao.
Bước 3: Bắt đầu chuyển đổi
* Bước 1 và 2 không bắt buộc, nhưng sau khi thực hiện chuyển đổi, hệ thống sẽ tự động hủy các lệnh tần suất thấp và chuyển tài sản tần suất thấp sang tài khoản tần suất cao.
Lưu ý quan trọng:
-
Tài khoản tạm thời không khả dụng (cả người dùng C-end và người dùng API đều bị ảnh hưởng);
Trong quá trình thực hiện chuyển đổi, tài khoản người dùng sẽ tạm thời không khả dụng trong 2-3 phút, bao gồm các chức năng truy vấn tài sản, giao dịch và chuyển khoản. Vui lòng sắp xếp các hoạt động trước để tránh ảnh hưởng đến giao dịch.
-
Hủy bắt buộc các lệnh tần suất thấp;
Nếu người dùng không tự hủy các lệnh tần suất thấp trước, hệ thống sẽ bắt buộc hủy các lệnh thông thường và lệnh nâng cao tần suất thấp chưa được thực hiện trong quá trình chuyển đổi.
-
Tài sản được hiển thị là "frozen" trong thời gian ngắn;
Trong giai đoạn chuẩn bị chuyển đổi, tài sản tần suất cao có thể được hiển thị là "frozen" trên giao diện cũ và sẽ trở lại bình thường sau khi chuyển đổi hoàn tất.
-
Mẹo về tương thích giao diện;
Giao diện cũ sẽ không còn hỗ trợ các truy vấn liên quan đến tài khoản tần suất cao. Hãy chắc chắn hoàn thành việc chuyển đổi trước, nếu không có thể xuất hiện lỗi.
-
Chuyển đổi chính thức sẽ diễn ra sau 7 ngày kể từ khi gửi email thông báo;
Quá trình chuyển đổi chính thức sẽ bắt đầu 7 ngày sau khi email thông báo được gửi. Người dùng được khuyến khích theo dõi hộp thư đến của mình và hoàn thành mọi chuẩn bị cần thiết trước ngày chuyển đổi để đảm bảo quá trình diễn ra suôn sẻ và tránh gián đoạn dịch vụ.
Nội dung chuyển đổi chi tiết:
Truy vấn tài sản
-
Chúng tôi khuyến nghị sử dụng giao diện API mới để truy vấn tài sản:
-
Truy vấn tài sản tài khoản ký quỹ chéo: /api/v3/margin/accounts
-
Truy vấn tài sản tài khoản ký quỹ riêng biệt: /api/v3/isolated/accounts
-
-
Sau khi chuyển đổi, dữ liệu tài sản trước và sau chuyển đổi sẽ nhất quán. Khi quá trình chuyển đổi hoàn tất, cả margin, margin_v2 và tất cả các truy vấn sẽ trả về kết quả nhất quán (tương tự với các tài khoản riêng biệt).
Lưu ý: Giao diện truy vấn tài sản cũ (/api/v1/margin/account cho cross-margin và /v1/isolated/accounts cho ký quỹ riêng biệt) sẽ vẫn khả dụng sau khi chuyển đổi, nhưng các tài sản có tần suất cao sẽ hiển thị là "Đóng băng" đối với người dùng chưa chuyển đổi.
Truy vấn Sổ Giao dịch
1. V1 Interface: /api/v1/accounts/ledgers
- Sổ giao dịch có thể được truy vấn cho cả tài khoản tần suất cao và thấp trước và sau khi chuyển đổi, với cùng phạm vi thời gian như trước.
2. V3 Interface: /api/v3/hf/margin/account/ledgers
- Chỉ hỗ trợ truy vấn giao dịch tài khoản tần suất cao, với giới hạn phạm vi thời gian trong 3 ngày gần nhất.
Người dùng có thể chọn giao diện phù hợp với nhu cầu của mình.
Chuyển khoản
-
Giao diện chuyển khoản vẫn được giữ nguyên. Giao diện trước đây vẫn có thể được sử dụng để chuyển khoản giữa tài khoản tần suất cao và thấp.
-
Trước khi Chuyển đổi: Hỗ trợ chuyển khoản giữa tài khoản tần suất cao và thấp trong cùng một người dùng.
-
Sau khi Chuyển đổi: margin và margin_v2 sẽ được coi là cùng một tài khoản, và việc chuyển khoản giữa hai tài khoản này sẽ không còn được hỗ trợ (tương tự đối với ký quỹ riêng biệt).
-
Truy vấn Lịch sử Lệnh
1. V1 Interface: /api/v1/orders?status=done
- Có thể truy vấn lệnh lịch sử cho cả lệnh tần suất cao và thấp, với cùng phạm vi thời gian.
2. V3 Interface: /api/v3/hf/margin/orders/done
- Chỉ hỗ trợ truy vấn lệnh tần suất cao và chỉ có thể trả dữ liệu trong 3 ngày gần nhất. Người dùng có thể lựa chọn theo nhu cầu của mình.
Đặt Lệnh/Hủy Lệnh/Truy vấn Lệnh Đang Hoạt Động
1. V1 Interface: Hỗ trợ đặt lệnh, hủy lệnh và truy vấn lệnh đang hoạt động tần suất thấp.
2. V3 Interface: Hỗ trợ đặt lệnh, hủy lệnh và truy vấn lệnh đang hoạt động tần suất cao.
Lệnh tần suất cao và thấp không tương thích với nhau, bao gồm các chức năng chốt lời và cắt lỗ. Người dùng cần sử dụng giao diện tương ứng dựa trên loại lệnh.
Thay đổi Giao diện Chuyển đổi:
-
Lưu ý: Khuyến nghị làm rõ các thay đổi giao diện liên quan trước và sau khi chuyển đổi để tránh ảnh hưởng đến việc sử dụng.
|
Hành động |
Giao diện Trước Khi Chuyển đổi |
Giao diện Sau Khi Chuyển đổi |
|
Đặt Lệnh |
Lệnh Thông thường: /api/v1/margin/order Lệnh Dừng: /api/v1/stop-order |
Đặt lệnh thường: /api/v3/hf/margin/order Lệnh dừng: /api/v3/hf/margin/stop-order OCO: /api/v3/hf/margin/oco-order |
|
Hủy lệnh |
Bằng orderId: /api/v1/orders/{orderId} Bằng clientOid: /api/v1/order/client-order/{clientOid} Hủy theo lô: /api/v1/orders |
Bằng orderId: /api/v3/hf/margin/orders/{orderId}?symbol={symbol} Bằng clientOid: /api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol} Hủy theo lô: /api/v3/hf/margin/orders?symbol={symbol}&tradeType={tradeType} |
|
Truy vấn lệnh đang hoạt động |
/api/v1/orders?status=active |
/api/v3/hf/margin/orders/active?tradeType={tradeType}&symbol={symbol} Truy vấn cặp giao dịch đang hoạt động: /api/v3/hf/margin/order/active/symbols |
Cảnh báo rủi ro
Ký quỹ (margin trading) là việc vay vốn với số vốn ban đầu tương đối thấp để giao dịch các tài sản tài chính và thu được lợi nhuận lớn hơn. Tuy nhiên, do các rủi ro thị trường, biến động giá và các yếu tố khác, chúng tôi khuyến nghị bạn nên thận trọng trong các quyết định đầu tư, lựa chọn mức đòn bẩy phù hợp cho giao dịch ký quỹ, và thực hiện cắt lỗ kịp thời. KuCoin không chịu trách nhiệm cho bất kỳ tổn thất nào phát sinh từ giao dịch.
Cảm ơn bạn đã ủng hộ!
Đội ngũ KuCoin
Tìm kiếm viên ngọc crypto tiếp theo trên KuCoin!
Đăng ký tài khoản KuCoin ngay bây giờ! >>>
Theo dõi chúng tôi trên X (Twitter) >>>
Tham gia Telegram của chúng tôi>>>
Tham gia cộng đồng toàn cầu KuCoin>>>
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.