更新日誌
警告
2026.03.04
参数收敛与低频接口停用
提示：为了解本次变更的背景与迁移安排，请先阅读 KuCoin 先前发布的公告《KuCoin 槓桿 API 升級公告》：
https://www.kucoin.com/zh-hant/announcement/kucoin-margin-notice-250702
V2 的账户类型参数（MARGIN、ISOLATED）。MARGIN_V2、ISOLATED_V2 与不带 V2 的参数语义一致，但将逐步被不带 V2 的参数取代。| # | 接口 | 参数映射与说明（均指向现货杠杆高频账户） | 变更点 |
|---|---|---|---|
| 1 | Classic REST - 取得轉移配額 | 推荐：MARGIN（高頻全倉）、ISOLATED（高頻逐倉）V2： MARGIN_V2、ISOLATED_V2（语义一致；将逐步被不带 V2 的参数取代） | 不再支援現貨槓桿低頻帳戶的查詢 |
| 2 | Classic REST - 萬向劃轉 | 推荐：MARGIN、ISOLATEDV2： MARGIN_V2、ISOLATED_V2（语义一致；将逐步被不带 V2 的参数取代）规则：当入参 type=INTERNAL 时，不带 V2 与 V2 等价；当 type≠INTERNAL 时，不支持 MARGIN_V2 与 ISOLATED_V2，推荐使用 MARGIN 与 ISOLATED。 | 不再支援現貨槓桿低頻與高頻帳戶之間的劃轉 |
| 3 | Classic REST - 取得帳戶 - 全倉 | 推荐：MARGIN（高頻全倉）V2： MARGIN_V2（语义一致；将逐步被不带 V2 的参数取代） | 参数语义收敛：MARGIN 统一表示高频全仓；MARGIN_V2 将逐步被取代 |
| 4 | Classic REST - 取得帳戶 - 逐倉槓桿 | 推荐：ISOLATED（高頻逐倉）V2： ISOLATED_V2（语义一致；将逐步被不带 V2 的参数取代） | 参数语义收敛：ISOLATED 统一表示高频逐仓；ISOLATED_V2 将逐步被取代 |
| 5 | Classic REST - 取得流水記錄 - 槓桿高頻 | 受影响字段（回参）：accountType（现货杠杆枚举值）当前：返回 MARGIN_V2、ISOLATED_V2后续：将逐步切换为返回 MARGIN、ISOLATED（取代 V2 值） | 回参字段更新：accountType 当前返回 V2 枚举值，后续将逐步迁移为不带 V2 的枚举值 |
| 6 | Abandoned Endpoints - 內部劃轉 | 推荐：margin、isolatedV2： margin_v2、isolated_v2（语义一致；将逐步被不带 V2 的参数取代） | 不再支援現貨槓桿低頻與高頻帳戶之間的劃轉 |
| 7 | Abandoned Endpoints - 新增訂單 - V1 | N/A（杠杆低频交易下单接口；无高频参数映射） | 杠杆低频接口，已无法使用。 |
| 8 | Abandoned Endpoints - 新增訂單測試 - V1 | N/A（杠杆低频交易下单测试接口；无高频参数映射） | 杠杆低频接口，已无法使用。 |
| 9 | Abandoned Endpoints - 取得帳戶清單 - 逐倉槓桿 - V1 | N/A（杠杆低频逐仓账户列表接口；无高频参数映射） | 杠杆低频接口，已无法使用。 |
| 10 | Abandoned Endpoints - 取得帳戶明細 - 逐倉槓桿 - V1 | N/A（杠杆低频逐仓账户详情接口；无高频参数映射） | 杠杆低频接口，已无法使用。 |
V2 的账户类型参数：MARGIN、ISOLATED。*_V2 参数的兼容，但应规划逐步移除依赖：*_V2 将被不带 V2 的参数逐步取代。type≠INTERNAL 时使用 MARGIN、ISOLATED；仅当 type=INTERNAL 时，V2 与非 V2 等价。V2 参数必须使用小写：margin、isolated、margin_v2、isolated_v2。2026.02.15
2026.02.09
| 類別 | Pro API 限頻 | 範圍 / 備註 |
|---|---|---|
| 最大並發連線數 | ≤ 512 個並發連線（公有 私有分開計算，總計 1024） | 私有（需認證）按 UID 計算；公有（無需認證）按 IP 計算。母帳號與子帳號完全獨立（UID 不同）。 |
| 連線建立頻率 | 每分鐘 30 個新連線 | 以單一連線計算（不按 UID 或 IP 聚合）。 |
| 客戶端到服務端訊息（Client → Server） | 每 10 秒 100 條訊息 | 以單一連線計算。 |
| 訂閱 / 取消訂閱請求 | 單次請求不限制主題數 | 不適用 |
| 單一連線最大訂閱主題數 | ≤ 200 個主題 | 適用於全部產品線。 |
2026.02.09
2026.01.27
2026.01.17
| # | Pro API | 端點 | 變更維度 | 變更詳情 |
|---|---|---|---|---|
| 1 | REST | 取得訂單簿 | 現貨 / 合約 | 現貨：sequence 由 String → Number； 合約： price / size 由 Number → String（含 RPI）。 |
| 2 | REST | 取得最近交易歷史 | 現貨 / 合約 | 現貨：sequence 由 String → Number； 合約： size 由 Number → String； 合約：移除回參字段 makerOrderId、takerOrderId、contractId； 合約：回參 JSON 結構調整為與現貨一致。 |
| 3 | WS | 交易數據 | 現貨 | 現貨：E 由 String → Number。 |
| 4 | REST | 取得K線數據 | 現貨 / 合約 | 現貨：Array 順序調整為 開 → 高 → 低 → 收； 合約： Start time 口徑改為 秒，且由 String → Number。 |
| 5 | WS | K線 | 合約 | 合約：新增字段 S（start），用於標識是否為最新一條 K 線。 |
| 6 | WS | 餘額 | UTA | UTA：新增字段 l（小寫 L）與 U。 |
| 7 | WS | 成交 | 合約 / 枚舉 | 合約：E 由 String → Number； 枚舉： S 取值統一為 BUY / SELL（大寫）；oT 取值統一為 MARKET / LIMIT（大寫）。 |
| 8 | WS | 訂單 | UTA | UTA：os 由 String → Number。 |
| 9 | REST | 取得訂單詳情 取得開放訂單列表 取得訂單歷史記錄 | UTA / 合約 | UTA：status 由 String → Number； 合約：修復 avgPrice 在部分場景可能為負數的問題。 |
| 10.1 | REST | 取得帳戶信息（經典） 取得子帳戶信息 取得轉帳限額 萬向劃轉 取得帳戶流水記錄 新增充值地址 取得充值地址 | 參數 | AccountType 枚舉：TRADING 調整為 SPOT（請求與回參均調整）。 |
| 10.2 | WS | 餘額 | 參數 | AccountType 枚舉：TRADING 調整為 SPOT（請求與回參均調整）。 |
| 11 | REST | 取得帳戶流水記錄 | 合約 / 枚舉 | 合約：id 由 Number → String； 合約： balance / amount 由 Number → String； 枚舉： direction 取值統一為 IN / OUT（大寫）。 |
| 12.1 | REST | 新增充值地址 | URL | URL 統一為：POST /api/ua/v1/asset/deposit/address。 |
| 12.2 | REST | 取得充值地址 | URL | URL 統一為：GET /api/ua/v1/asset/deposit/address。 |
| 12.3 | REST | 批量下單（經典） | URL | URL 調整為：POST /api/ua/v1/{accountMode}/order/place-batch。 |
2026.01.16
| # | Pro API | 端點 | 變更維度 | 變更詳情 |
|---|---|---|---|---|
| 1 | REST | 下單 | api-rate-limit-weight | 每次請求扣除的限頻權重降低為 1。 |
| 2 | REST | 撤單 | api-rate-limit-weight | 每次請求扣除的限頻權重降低為 1。 |
2026.01.12
| 類別 | 端點 | URL | 變更欄位 |
|---|---|---|---|
| Pro REST | 取得行情 | GET /api/ua/v1/market/ticker | ts（統一為奈秒 ns） |
| Pro REST | 取得最近交易歷史 | GET /api/ua/v1/market/trade | ts（統一為奈秒 ns） |
| Pro REST | 取得帳戶流水記錄 | GET /api/ua/v1/account/ledger | ts（統一為奈秒 ns） |
| Pro REST | 取得訂單詳情 | GET /api/ua/v1/{accountMode}/order/detail | orderTime / updatedTime（統一為奈秒 ns） |
| Pro REST | 取得開放訂單列表 | GET /api/ua/v1/{accountMode}/order/open-list | orderTime / updatedTime（統一為奈秒 ns） |
| Pro REST | 取得訂單歷史記錄 | GET /api/ua/v1/{accountMode}/order/history | orderTime / updatedTime（統一為奈秒 ns） |
| Pro REST | 取得交易歷史記錄 | GET /api/ua/v1/{accountMode}/order/execution | executionTime（統一為奈秒 ns） |
| Pro REST | 取得倉位歷史（UTA） | GET /api/ua/v1/position/history | closingTime / creationTime（統一為奈秒 ns） |
| Pro REST | 取得倉位列表（UTA） | GET /api/ua/v1/{accountMode}/position/open-list | closingTime / creationTime（統一為奈秒 ns） |
| Pro WebSocket | 訂單簿（snapshot / increment） | WS | M（統一為奈秒 ns） |
| Pro WebSocket | 行情數據 | WS | M（統一為奈秒 ns） |
| Pro WebSocket | 交易數據 | WS | M（統一為奈秒 ns） |
| Pro WebSocket | K線（SPOT / FUTURES） | WS | O（startAt）/ C（endAt）（統一為秒 s，10 位） |
| Pro REST | 取得交易對詳情（Instrument） | GET /api/ua/v1/market/instrument | unitSize（反向合約：-1 → 1；1 張合約 = 1 USD） |
| Pro REST | 取得交易對詳情（Instrument） | GET /api/ua/v1/market/instrument | name / displayBaseCurrency（合約新增回傳欄位，支援多語言相容） |
2025.01.02
警告
2025.12.31
| Pro API | 變更說明 |
|---|---|
| WebSocket 行情數據 | 所有與價格相關的回傳欄位（b、a、l）由 Number 變更為 String。 更新 M 欄位的說明。 |
| WebSocket 訂單簿 | 1. 新增 Depth 1 訂單簿資料支援。 2. 快照推送格式與增量推 送格式統一： • 移除 E； • 新增 C 與 O； • 快照推送中 O = C。 3. 合約訂單簿資料結構由一維陣列調整為與現貨一致的 二維陣列格式。 4. 數量欄位型別由 Number 變更為 String。 |
| WebSocket K線 | 1. Start time 與 End time 由 String 變更為 Number，並統一使用 秒（seconds） 作為時間單位。 2. 價格 與 數量（合約張數） 由 Number 變更為 String。 |
| RESTful 取得訂單簿 | 合約（Futures）sequence 欄位型別由 String 變更為 Long。 |
2025.12.30
| Pro API WebSocket | 帳戶與交易類型支援 |
|---|---|
| 訂單 | Classic 帳戶： 支援所有交易類型。 UTA 帳戶： 支援現貨與合約交易。 保證金（逐倉 / 全倉）預計於 明年 Q1–Q2 支援。 |
| 持倉 | Classic 帳戶： 支援 合約 交易類型。 UTA 帳戶： 支援 合約 交易類型。 保證金（逐倉 / 全倉）預計於 明年 Q1–Q2 支援。 |
| 餘額 | Classic 帳戶： 支援所有交易類型。 UTA 帳戶： 支援現貨與合約交易。 保證金（逐倉 / 全倉）預計於 明年 Q1–Q2 支援。 |
| 成交 | Classic 帳戶： 支援所有交易類型。 UTA 帳戶： 目前尚未支援。 |
2025.12.26
2025.12.15
2025.12.10
2025.11.24
2025.11.21
2025.11.17
2025.11.14
2025.10.24
2025.10.17
| 接口 | 請求參數變更 |
|---|---|
| 新增訂單 | 新增參數 positionSide，用於啟用對沖模式設定。 |
| 新增訂單測試 | 新增參數 positionSide，用於啟用對沖模式設定。 |
| 新增獲利止損單 | 新增參數 positionSide，用於啟用對沖模式設定。 |
| 取得最大可提取保證金 | 新增參數 positionSide，用於啟用對沖模式設定。 |
| 新增逐倉槓桿 | 新增參數 positionSide，用於啟用對沖模式設定。 |
| 移除逐倉槓桿 | 新增參數 positionSide，用於啟用對沖模式設定。 |
| 修改逐倉槓桿自動存款狀態 | 新增參數 positionSide，用於啟用對沖模式設定。 |
2025.09.30
| 接口 | 描述 |
|---|---|
| 切換槓桿模式 | 修改當前交易對的保證金模式。 |
| 修改全倉槓桿 | 修改當前交易對的全倉槓桿倍數。 |
| 獲取全倉保證金要求 | 根據持倉價值查詢交易對的全倉保證金需求。 |
| 接口 | 請求參數變更 |
|---|---|
| 新增訂單 | 最大槓桿設為 20，並且 marginMode 支援 Cross。 |
| 新增訂單測試 | 最大槓桿設為 20，並且 marginMode 支援 Cross。 |
| 新增獲利止損單 | 最大槓桿設為 20，並且 marginMode 支援 Cross。 |
2025.09.29
域名統一：所有針對統一交易帳戶的 API 請求都將使用統一網域：https://api.kucoin.com。
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
2025.09.26
2025.09.25
| 接口 | API Permission 變更 |
|---|---|
| 取得最近的交易歷史 | 從 Futures 改為 General |
| 取得槓桿模式 | 從 Futures 改為 General |
| 取得最大可開倉量 | 從 Futures 改為 General |
| 取得倉位詳情 | 從 Futures 改為 General |
| 取得倉位列表 | 從 Futures 改為 General |
| 取得持倉歷史 | 從 Futures 改為 General |
| 取得最大可提取保證金 | 從 Futures 改為 General |
| 取得全倉槓桿 | 從 Futures 改為 General |
| 取得全倉槓桿風險限額 | 從 Futures 改為 General |
| 取得私人資金費用歷史記錄 | 從 Futures 改為 General |
2025.09.12
2025.09.11
2025.09.03
2025.08.19
以上接口新增 cancelReason 響應參數
2025.08.12
2025.08.11
2025.07.30
2025.07.24
2025.07.22
2025.07.21
2025.07.18
2025.07.04
2025.07.01
2025.06.30
2025.06.27
2025.06.25
2025.06.12
2025.05.29
2025.05.28
2025.05.19
2025.05.15
2025.05.14
2025.05.13
2025.05.10
2025.03.28
2025.03.13
2025.03.05
2025.02.28
2025.02.27
2025.02.26
2025.02.21
2025.02.19
2025.02.06
2025.01.21
2024.01.07
2024.01.03
2024.12.17
2024.12.01
Modified at 2026-03-05 10:56:58