KuCoin 保證金 API 升級公告

04/07/2025 06:33:02

自定義圖片

親愛的 KuCoin 用戶：

為了向用戶提供更好的交易環境並優化交易體驗，KuCoin 的槓桿 API 正在進行高頻遷移與升級。此次遷移將以多批次方式進行，預計於 2025 年底完成。

1. 遷移範圍：

對於已啟用保證金的用戶，如果在遷移期間無保證金倉位或資產，此次遷移將不會對您產生影響。

2. 遷移影響：

2.1 非 API 用戶（C 端用戶）

Web/應用程式上的用戶體驗在遷移前後將保持不變。

2.2 API 用戶

此次遷移將對 API 介面調用方式及資產狀態顯示產生一定影響。遷移通知將分批次發送。請在收到電子郵件通知後，及時完成相應操作。系統將在電子郵件發送 7 天後進行遷移。（為減少影響，您可以提前切換至高頻 API）。

3. 遷移流程：

步驟一：手動清理低頻訂單

a. 用戶需要自行取消通過低頻 API 和 C 端（Web/應用程式）下達的訂單；

b. 高頻訂單無需取消；

如果您未主動取消，系統將在遷移過程中強制取消訂單（包括普通訂單和高級訂單）。
如未確認訂單狀態，請聯繫客服進行諮詢。

步驟二：手動轉移低頻資產（API 用戶）

a. 用戶需手動將低頻帳戶資產轉移至高頻帳戶並切換至新 API 介面（詳情請參考 api-doc）。

b.獲取轉移配額 - KUCOIN API此時，C端（網頁及 App）資產顯示為「FROZEN」，且無法操作高頻訂單。

步驟 3：啟動遷移

*步驟 1 和步驟 2 並非必須，但一旦執行遷移，系統將自動取消低頻訂單，並將低頻資產轉移至高頻帳戶。

重要事項：

帳戶暫時不可用（C端用戶及 API 用戶均會受到影響）；

在執行遷移期間，使用者帳戶將暫時不可用 2-3 分鐘，涉及資產查詢、交易及轉帳功能。請提前安排操作，以免影響交易。

低頻訂單強制取消；

若使用者未提前取消低頻訂單，系統將在遷移過程中強制取消未完成的低頻普通訂單及高級訂單。

資產短時間顯示為「凍結」；

在遷移準備階段，舊介面中高頻資產可能短暫顯示為「凍結」，遷移完成後將恢復正常。

介面兼容性提示；

舊介面將不再支持高頻帳戶相關查詢。請務必提前完成切換，否則可能返回異常。

正式遷移將於電子郵件通知後 7 天進行；

正式遷移將於電子郵件通知發送後的 7 天內開始。建議使用者密切留意電子郵件，並在遷移日期前完成所有必要準備，以確保順利過渡並避免服務中斷。

遷移詳情：

資產查詢

我們建議使用新 API 介面進行資產查詢：
- 全倉保證金帳戶資產查詢： /api/v3/margin/accounts
- 逐倉保證金帳戶資產查詢： /api/v3/isolated/accounts

遷移完成後，遷移前後的資產數據將保持一致。一旦遷移完成，保證金、margin_v2 及 ALL 查詢將返回一致結果（逐倉帳戶亦相同）。

注意：舊資產查詢介面（/api/v1/margin/account 用於全倉槓桿，/v1/isolated/accounts 用於逐倉槓桿）在遷移後仍可用，但對於尚未完成遷移的用戶，高頻資產將顯示為「凍結」。

交易明細查詢

1. V1 Interface：/api/v1/accounts/ledgers

在遷移前後，仍可查詢高頻及低頻帳戶的交易明細，查詢的時間範圍保持不變。

2. V3 Interface：/api/v3/hf/margin/account/ledgers

僅支援查詢高頻帳戶的交易明細，查詢時間範圍限定為最近三天。

用戶可根據需求選擇相應的查詢介面。

資金劃轉

劃轉介面保持不變。之前的介面仍可用於高頻帳戶與低頻帳戶之間的資金劃轉。
- 遷移前：支持同一用戶名下高頻帳戶與低頻帳戶之間的資金劃轉。
- 遷移後：margin 和 margin_v2 將視為同一帳戶，這兩個帳戶之間的資金劃轉不再支持（逐倉槓桿同樣適用）。

歷史訂單查詢

1. V1 Interface：/api/v1/orders?status=done

可查詢高頻與低頻帳戶的歷史訂單，查詢時間範圍保持不變。

2. V3 Interface：/api/v3/hf/margin/orders/done

僅支持查詢高頻帳戶的歷史訂單，且僅能返回最近三天的數據。用戶可根據需求選擇合適的介面。

訂單下單／撤單／活動訂單查詢

1. V1 Interface：支持低頻訂單的下單、撤單及活動訂單查詢。

2. V3 Interface：支持高頻訂單的下單、撤單及活動訂單查詢。

高頻與低頻訂單不互相兼容，包括止盈與止損功能。用戶需根據訂單類型使用對應的介面。

遷移介面變更：

注意：建議提前明確遷移前後涉及的介面變更，以免影響使用。

操作	遷移前介面	遷移後介面
訂單下單	普通訂單：/api/v1/margin/order 止損訂單：/api/v1/stop-order	一般訂單：/api/v3/hf/margin/order 止損訂單：/api/v3/hf/margin/stop-order OCO 訂單：/api/v3/hf/margin/oco-order
訂單取消	透過 orderId：/api/v1/orders/{orderId} 透過 clientOid：/api/v1/order/client-order/{clientOid} 批量取消訂單：/api/v1/orders	透過 orderId：/api/v3/hf/margin/orders/{orderId}?symbol={symbol} 透過 clientOid：/api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol} 批量取消訂單：/api/v3/hf/margin/orders?symbol={symbol}&tradeType={tradeType}
活躍訂單查詢	/api/v1/orders?status=active	/api/v3/hf/margin/orders/active?tradeType={tradeType}&symbol={symbol} 查詢活躍的交易對：/api/v3/hf/margin/order/active/symbols