KuCoin 保證金 API 升級公告

04/07/2025 14:33:02

親愛的 KuCoin 用戶，

為提供用戶更佳的交易環境並優化交易體驗，KuCoin 的槓桿 API 正進行高頻率遷移與升級。此次遷移將分多批次進行，預計於 2026 年 3 月底前完成。

1. 遷移範圍：

對於已啟用保證金的用戶，如果在遷移期間沒有保證金持倉或資產，則不會對您造成影響。

2. 遷移的影響：

2.1 非 API 用戶（C 端用戶）

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

2.2 API 使用者

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

3. 遷移流程：

第一步：手動清理低頻率訂單

a. 使用者需自行取消透過低頻率 API 及 C 端（網頁/應用程式）下達的訂單；

b. 高頻訂單無需取消；

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

步驟 2：手動轉帳低頻率資產（API 用戶）

a. 使用者需手動將低頻率帳戶資產轉帳至高頻率帳戶，並切換至新的 API 介面（詳見 api-doc）。

b. 获取轉帳配額 - KUCOIN API 此時，C端（網頁和App）的資產顯示為「FROZEN」，無法進行高頻交易。

第三步：開始遷移

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

重要提示：

帳戶暫時無法使用（C端用戶和API用戶均會受到影響）；

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

強制取消低頻率訂單；

如果用戶未提前取消低頻率訂單，系統將在遷移過程中強制取消未成交的低頻率普通訂單和進階訂單。

資產會短暫顯示為「凍結」；

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

介面相容性提示；

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

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

官方遷移將於電子郵件通知發出後 7 天開始。建議用戶密切關注郵件收件箱，並在遷移日期前完成所有必要準備，以確保順利過渡，避免服務中斷。

詳細遷移內容：

資產查詢

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

遷移後，遷移前後的資產資料將保持一致。遷移完成後，margin、margin_v2 和所有查詢將返回一致的結果（隔離帳戶亦同）。

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

交易紀錄查詢

1. V1 介面：/api/v1/accounts/ledgers

遷移前後，均可查詢高頻率和低頻率帳戶的帳本，時間範圍與之前相同。

2. V3 介面：/api/v3/hf/margin/account/ledgers

此功能僅支援查詢高頻率帳戶交易，時間範圍限於過去三天。

用戶可根據需求選擇介面。

轉帳

轉帳介面保持不變。先前的介面仍可用於高頻與低頻帳戶之間的轉帳。
- 遷移前：同一用戶內的高頻與低頻帳戶之間支援轉帳。
- 遷移後：保證金和 margin_v2 將被視為同一個帳戶，此兩個帳戶之間的轉帳將不再支援（逐倉槓桿亦同）。

歷史訂單查詢

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

歷史訂單可查詢高頻率和低頻率訂單，時間範圍相同。

2. V3 介面：/api/v3/hf/margin/orders/done

此功能僅支援查詢高頻委託單，且僅能返回過去三天的資料。用戶可根據自身需求進行選擇。

下單 / 取消訂單 / 活動訂單查詢

1. V1 介面：支援下單、取消及查詢活躍的低頻率訂單。

2. V3 介面：支援下單、取消和查詢活躍的高頻訂單。

高頻率和低頻率訂單彼此不相容，包括止盈和停損功能。用戶應根據訂單類型使用相應的介面。

遷移介面變更：

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

行動	遷移前介面	遷移介面後
下單	普通訂單：/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
取消訂單	按訂單 ID：/api/v1/orders/{orderId} 透過客戶訂單ID：/api/v1/order/client-order/{clientOid} 批量取消：/api/v1/orders	根據訂單 ID：/api/v3/hf/margin/orders/{orderId}?symbol={symbol} 透過客戶訂單 ID：/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/order/active/symbols