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。
官方来源
采集内容仅用于事实核查；如本站与原公告不一致，以官方页面为准。