KuCoin
Đăng nhập
language_currency
Trang chủ
Thông báo
Thông báo nâng cấp API KuCoin Margin

Thông báo nâng cấp API KuCoin Margin

06:33:02 04/07/2025

Tùy chỉnh

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

Để cung cấp cho người dùng một 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 Đòn bẩy của KuCoin đang thực hiện việc di chuyển và nâng cấp tần suất cao. Việc di chuyển này sẽ được thực hiện theo nhiều đợt và dự kiến hoàn thành vào cuối tháng 3 năm 2026.

1. Phạm vi di chuyển:

Đối với người dùng đã kích hoạt Ký quỹ, nếu không có vị thế hoặc tài sản Ký quỹ nào trong quá trình di chuyển, điều này sẽ không ảnh hưởng đến bạn.

2. Tác động của việc di chuyển:

     2.1 Người dùng không sử dụng API (người dùng cuối)

  • Trải nghiệm người dùng trên Web/App sẽ không thay đổi trước và sau khi di chuyển.

     2.2 Người dùng API

  • Việc di chuyển này sẽ có ảnh hưởng nhất định đến phương thức gọi giao diện API và cách hiển thị trạng thái tài sản. Việc di chuyển này sẽ được thông báo từng đợt. Vui lòng thực hiện các thao tác tương ứng kịp thời sau khi nhận được email thông báo. Hệ thống sẽ thực hiện di chuyển 7 ngày sau khi gửi email. (Để giảm thiểu tác độ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: Làm sạch thủ công các lệnh tần suất thấp

a. Người dùng cần tự hủy các lệnh đã đặt thông qua 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 hủy chủ động, hệ thống sẽ tự động hủy lệnh trong quá trình di chuyển (bao gồm cả lệnh thông thường và lệnh nâng cao).

  • Nếu bạn không xác nhận trạng thái đơn hàng, vui lòng liên hệ dịch vụ khách hàng để được tư vấn.

Bước 2: Chuyển thủ công các tài sản tần suất thấp (người dùng API)

a. Người dùng cần chuyển thủ công tài sản từ tài khoản tần suất thấp sang tài khoản tần suất cao và chuyển sang giao diện API mới (xem chi tiết trong api-doc).

b. Get Transfer Quotas - KUCOIN API Hiện tại, tài sản ở phía C (Web và Ứng dụng) được hiển thị là "ĐÃ KHOÁ", và không thể thực hiện các lệnh giao dịch tần suất cao.

Bước 3: Bắt đầu di chuyển

Bước 1 và 2 không bắt buộc, nhưng sau khi thực hiện di chuyển, 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.

Ghi chú quan trọng:

  1. 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 sẽ bị ảnh hưởng);

Trong quá trình thực hiện di chuyển, 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 tra cứu tài sản, giao dịch và chuyển. Vui lòng sắp xếp các thao tác trước để tránh ảnh hưởng đến giao dịch.

  1. Hủy bắt buộc các lệnh tần suất thấp;

Nếu người dùng không hủy lệnh tần suất thấp trước, hệ thống sẽ tự động hủy các lệnh tần suất thấp thông thường và lệnh nâng cao chưa được thực hiện trong quá trình di chuyển.

  1. Các tài sản được hiển thị là "đóng băng" trong một khoảng thời gian ngắn;

Trong giai đoạn chuẩn bị di chuyển, các tài sản có tần suất giao dịch cao có thể được hiển thị là “đóng băng” trong giao diện cũ và sẽ trở lại bình thường sau khi di chuyển hoàn tất.

  1. Mẹo 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 đảm bảo chuyển đổi trước, nếu không, có thể trả về lỗi.

  1. Việc di chuyển chính thức sẽ diễn ra 7 ngày sau khi nhận thông báo qua email;

Việc di chuyển chính thức sẽ bắt đầu 7 ngày sau khi gửi thông báo qua email. Người dùng được khuyến nghị theo dõi hộp thư đến của mình kỹ lưỡng và hoàn thành tất cả các bước chuẩn bị cần thiết trước ngày di chuyển để đảm bảo quá trình chuyển đổi diễn ra suôn sẻ và tránh gián đoạn dịch vụ.

Nội dung di chuyển 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ỹ độc lập: /api/v3/isolated/accounts

  •  Sau khi di chuyển, dữ liệu tài sản trước và sau khi di chuyển sẽ giữ nguyên sự nhất quán. Một khi việc di chuyển hoàn tất, tất cả các truy vấn về margin, margin_v2 và ALL sẽ trả về kết quả nhất quán (tương tự đối với tài khoản cô lập).

Lưu ý: Các giao diện truy vấn tài sản cũ (/api/v1/margin/account dành cho ký quỹ chéo và /v1/isolated/accounts dành cho ký quỹ độc lập) sẽ vẫn được giữ lại sau khi di chuyển, nhưng các tài sản có tần suất cao sẽ được hiển thị là “Đóng băng” đối với những người dùng chưa di chuyển.

Truy vấn sổ giao dịch

1. Giao diện V1: /api/v1/accounts/ledgers

  • Sổ cái có thể được truy vấn cho cả tài khoản tần suất cao và tần suất thấp trước và sau khi di chuyển, với phạm vi thời gian giống như trước đây.

2. Giao diện V3: /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 phạm vi thời gian giới hạn trong ba ngày gần nhất.

Người dùng có thể chọn giao diện dựa trên nhu cầu của họ.

Chuyển

  •  Giao diện chuyển vẫn giữ nguyên. Giao diện trước vẫn có thể được sử dụng để chuyển giữa các tài khoản tần suất cao và tần suất thấp.

    • Trước khi di chuyển: Hỗ trợ chuyển giữa các tài khoản tần suất cao và tần suất thấp trong cùng một người dùng.

    • Sau khi di chuyển: margin và margin_v2 sẽ được coi là cùng một tài khoản, và các khoản chuyể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ỹ độc lập).

Truy vấn lệnh lịch sử

1. Giao diện V1: /api/v1/orders?status=done

  • Các lệnh lịch sử có thể được truy vấn cho cả lệnh tần suất cao và tần suất thấp, với cùng khoảng thời gian.

2. Giao diện V3: /api/v3/hf/margin/orders/done

  • Chỉ hỗ trợ truy vấn các lệnh tần suất cao và chỉ có thể trả về dữ liệu trong ba 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. Giao diện V1: Hỗ trợ đặt, hủy và truy vấn các lệnh tần suất thấp đang hoạt động.

2. Giao diện V3: Hỗ trợ đặt, hủy và truy vấn các lệnh tần suất cao đang hoạt động.

Các lệnh tần suất cao và tần suất 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 nên sử dụng giao diện tương ứng dựa trên loại lệnh.

Thay đổi giao diện di chuyển:

  • Lưu ý: Nên làm rõ các thay đổi giao diện trước và sau khi di chuyển để tránh ảnh hưởng đến việc sử dụng.

Hành động

Giao diện trước khi di chuyển

Sau giao diện di chuyển

Đặt lệnh

Đặt hàng thông thường: /api/v1/margin/order

Lệnh dừng: /api/v1/stop-order

Lệnh thông 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

Theo orderId: /api/v1/orders/{orderId}

Theo clientOid: /api/v1/order/client-order/{clientOid}

Hủy hàng loạt: /api/v1/orders

Theo orderId: /api/v3/hf/margin/orders/{orderId}?symbol={symbol}

Theo clientOid: /api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol}

Hủy hàng loạt: /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ác cặp giao dịch đang hoạt động: /api/v3/hf/margin/order/active/symbols

Cảnh báo rủi ro

Giao dịch ký quỹ là việc vay vốn với một lượng vốn tương đối nhỏ để giao dịch các tài sản tài chính và đạt lợi nhuận lớn hơn. Tuy nhiên, do rủi ro thị trường, biến động giá và các yếu tố khác, bạn được khuyến nghị hết sức thận trọng trong các hành động đầu tư, lựa chọn mức đòn bẩy phù hợp cho giao dịch ký quỹ và kịp thời dừng lỗ một cách hợp lý. 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 đã hỗ trợ!

Đội ngũ KuCoin

Tìm kiếm viên ngọc crypto tiếp theo trên KuCoin!

Đăng ký ngay trên KuCoin! >>>

Tải ứng dụng KuCoin >>>

Theo dõi chúng tôi trên X (Twitter) >>>

Tham gia cùng chúng tôi trên Telegram >>>

Tham gia các cộng đồng toàn cầu của 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.