更新日誌
警告
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-01-27 02:02:41