KuCoin API 升級公告（2026-06-03）

02/06/2026 14:26:00

為改善 API 交易體驗、提升統一交易帳戶（UTA）架構下的交易能力，並降低不同帳戶模式間的整合複雜度，KuCoin 將升級 Pro API 並發布相關 API 更新。
升級後，Pro API 將升級為 UTA API。未來，UTA API 將僅支援統一交易帳戶（UTA）模式。
 

1. 升級時間表

升級預計於 2026 年 6 月 3 日 08:00（UTC）進行，預計持續 180 分鐘。
 

2. 升級影響

在升級期間，用戶可能會遇到以下影響：
  1. PRO WebSocket 可能會出現暫時斷開、資料遺失或延遲。使用者可重新連接 WebSocket 以恢復連線。
 

3. 升級詳情

3.1 UTA API 升級

目前，Pro API 的部分接口同時兼容經典帳戶（Classic Account）與統一帳戶（UTA）。未來，我們將持續聚焦於統一帳戶場景，對 UTA API 進行能力建設與功能優化。與經典帳戶相關的兼容能力將逐步進入維護階段，後續將不再作為新增功能、性能優化及長期能力演進的重點支援方向。
 
[調整詳情]
  • Pro API 將升級為 UTA API，未來將主要支援統一交易帳戶（UTA）。
  • 與經典帳戶相關的兼容能力，UTA API 將進入維護狀態。
 
如果您目前使用「Pro API + 經典帳戶」模式，我們強烈建議您盡快完成以下其中一項遷移選項：
  • 切換至統一交易帳戶（UTA）模式進行交易；
  • 繼續使用經典 API 進行經典帳戶交易。
 
這將有助於確保順利遷移和交易運作不受中斷。
 

3.2 API 升級

  • WebSocket 連線握手與驗證流程優化：
    • 在握手和驗證階段，同步處理將改為非同步處理，以減少阻塞行為並提高單位時間內可處理的驗證請求數量。
    • 當 WebSocket 連線因憑證無效、過期或未經授權而驗證失敗時，伺服器會透過 WebSocket 帧發送 “auth failed” 訊息，讓客戶端能快速識別失敗原因並採取適當措施。此優化不會影響已成功驗證的 WebSocket 連線。

 

    • positionMargin：合約持倉所占用的保證金。
    • riskRatio：逐倉合約的倉位風險率，0.65 表示 65%。

 

  • [修改] UTA Websocket 持倉，新增回應欄位：
    • pM：合約持倉所佔用的保證金
    • r：逐倉合約的倉位風險率，0.65 表示 65%

 

  • [修改] 經典 REST 取得充幣清單 與 經典 REST 取得充幣明細。這些端點已新增以下狀態回傳值，以顯示更詳細的充幣狀態：
    • ROLLBACKING ：正在撤銷充幣，請稍候。
    • ROLLBACK：充幣已回滾，帳戶未收到任何資金。請聯繫支援以獲協助。
    • WAIT_RISK_MGT：該充幣正在進行標準風險驗證，請聯絡支援團隊以獲協助。
    • RISK_MGT_REJECTED：充幣在風險核驗後被拒絕，請聯絡支援團隊以提交所需資料以供審核。
    • PRE_SUCCESS：資金已在最終區塊確認前存入帳戶。
    • WAIT_TRM_MGT：該充幣正在進行標準合規審核，請聯繫客服獲取協助。
    • TRM_MGT_REJECTED ：充幣在風險核驗後被拒絕，請聯絡客服提交所需資料以供審核。

 

  • [修改] UTA 錯誤代碼 ,迭代為新版本，分爲以下幾個模塊：UTA General, UTA Account Opening, UTA Order, UTA Account, UTA Position, UTA Spot Trading, UTA Leverage, UTA Futures Trading, UTA Loan

 

  • [新增] 快速 API - 申請快速提現
    • 在 OAuth 授權流程中支援使用者自定義的 API 密鑰權限，包括授予提現權限
    • 新權限：快速提現（快速 API 提現權限）
    • 支援透過二次驗證進行 API 提現

 

 

 

  • [修改] UTA REST Place Order，新增欄位 closeOrder 以支援關閉指定標的的持倉

 

  • [修改] UTA REST 取得轉帳配額，在查詢參數和回應參數的欄位 accountType 中新增列舉值 UNIFIED
 
 
如需更多有關 API 的資訊，請加入官方 KuCoin API Telegram 社群
您也可以透過電郵與我們聯絡：api@kucoin.com
 
我們對此調整可能帶來的不便深表歉意，並感謝您對 KuCoin API 的持續支持與信任。

免責聲明: 本頁面經由 AI 技術（GPT 提供支持）翻譯，旨在方便您的閱讀。欲獲取最準確資訊，請以原始英文版本為準。