KuCoin UTA-API 升級：WebSocket 中斷預期
KuCoin 將於 2026 年 8 月 12 日升級 UTA-API，可能導致 WebSocket 斷線並引入 API 變更。
KuCoin 宣布將於 2026 年 8 月 12 日 12:00 UTC 對其 UTA-API 進行非破壞性升級，預計持續最多 120 分鐘。在此期間，UTA WebSocket 連線可能出現暫時中斷、資料遺失或延遲；使用者可以重新連線以恢復服務。此次升級引入了三項 API 變更：Get Trade History 回應中 ADL 成交的修改、Get Position List 新增 updateTime 欄位，以及子帳戶 API 權限新增 ipWhitelist 要求。除非使用者依賴受影響的 WebSocket 或 API 功能，否則無需採取任何行動。
- 01
升級預定於 2026 年 8 月 12 日 12:00 UTC 進行，預計持續 120 分鐘。
- 02
升級期間，UTA WebSocket 可能出現暫時中斷、資料遺失或延遲。
- 03
使用者可以重新連線 WebSocket 以恢復連線。
關鍵事實
- 升級預定於 2026 年 8 月 12 日 12:00 UTC 進行，預計持續 120 分鐘。
- 升級期間，UTA WebSocket 可能出現暫時中斷、資料遺失或延遲。
- 使用者可以重新連線 WebSocket 以恢復連線。
- Get Trade History：當 fillType 為 'ADL' 時，liquidityRole 將為空，而非 MAKER。
- Get Position List (UTA) 新增回應欄位 updateTime，表示最新持倉更新時間。
- Classic REST 新增/修改子帳戶 API：若權限包含 Transfer (Withdraw)，則需要 ipWhitelist。
誰會受到影響
- KuCoin UTA-API WebSocket 使用者
- UTA REST Get Trade History 使用者
- UTA REST Get Position List 使用者
- 具有 Transfer (Withdraw) 權限的 Classic REST 子帳戶 API 使用者
影響分析
此次升級為非破壞性，但可能導致暫時的 WebSocket 中斷、資料遺失或延遲，影響 UTA 使用者的即時數據源。API 變更會改變回應欄位：Get Trade History 對 ADL 成交將回傳空的 liquidityRole，Get Position List 新增 updateTime，子帳戶 API 現在要求 Transfer (Withdraw) 權限需有 ipWhitelist。這些變更可能需要開發者更新程式碼以處理新欄位和驗證規則。除 WebSocket 連線外，未提及對交易功能的影響。
公告沒有說明什麼
公告未說明 WebSocket 中斷是否影響所有使用者或僅部分使用者，也未詳細說明資料遺失的具體情況。此外，未明確 ipWhitelist 要求是否適用於現有子帳戶 API 配置或僅限新配置。
風險提示
- WebSocket 中斷可能導致即時數據暫時遺失，但使用者可以重新連線。
- API 回應變更可能導致現有整合在未更新時失效。
- 子帳戶 API 變更可能因未配置 ipWhitelist 而導致權限錯誤。
- 升級為非破壞性，但未保證零影響。
- 本文僅用於核對交易所官方公告，不構成投資或交易建議。
本文僅用於資訊整理，不構成投資、法律或稅務建議。數位資產具有高波動和本金損失風險。
常見問題
升級前我需要採取任何行動嗎？
公告未要求任何升級前行動。但如果您使用受影響的 API，升級後可能需要更新程式碼以適應變更。
升級期間 WebSocket 斷線該怎麼辦？
公告指出使用者可以重新連線 WebSocket 以恢復連線。
ipWhitelist 要求是否會影響現有子帳戶 API 配置？
公告未說明該要求是否追溯適用。僅說明當權限包含 Transfer (Withdraw) 時，需要 ipWhitelist。
官方來源
採集內容僅用於事實核查；如本站與原公告不一致，以官方頁面為準。