KUCOIN API
主頁更新日誌API DOC V1
語言
  • English
主頁更新日誌API DOC V1
語言
  • English
SDK
Telegram
Kucoin
  1. 主頁
  • 簡介
  • 驗證
  • 枚舉定義
  • 術語定義
  • SDK
  • OpenClaw
  • 速率限制
  • 更新日誌
  • 用戶服務
    • 做市獎勵計劃
    • 貴賓快速通道
    • 經紀商計劃
  • UTA REST
    • 介紹
    • 市場數據
      • 取得公告
      • 取得單幣種資訊
      • 取得多幣種詳情
      • 取得交易對詳情
      • 取得行情
      • 取得訂單簿
      • 取得K線數據
      • 取得最近交易歷史
      • 取得抵押率
      • 取得指數價格
      • 取得目前資金費率
      • 取得歷史資金費率
      • 取得風險限制分檔
      • 取得合約未平倉量
      • 取得服務器狀態
      • 取得第三方託管支持結算幣種
      • 取得可借幣種資訊
      • 取得 KYC 區域信息
      • 取得用戶端 IP 位址
      • 取得法幣換算價格
    • 帳戶
      • 取得帳戶總覽(UTA)
      • 取得帳戶幣種資產(UTA)
      • 取得帳戶幣種資產(經典)
      • 取得子帳戶幣種資產
      • 取得轉帳配額
      • 萬向劃轉
      • 設置子子劃轉權限
      • 取得帳戶模式
      • 設定帳戶模式
      • 取得實際費率
      • 取得帳戶流水記錄
      • 取得利息歷史(UTA)
      • 調整合約槓桿(UTA)
      • 取得充值地址
      • 取得第三方託管帳戶幣種額度
      • 調整全倉槓桿(UTA)
      • 查詢槓桿(UTA)
      • 取得借幣利率與限額
      • 取得 Apikey 資訊
      • 新增子帳戶
      • 取得子帳戶API列表
      • 新增子帳戶 API
      • 修改子帳戶 API
      • 刪除子帳戶 API
      • 取得提款額度
      • 提款
      • 取消提款
      • 查詢 API 速率限制上限
      • 為子帳戶設定 API 速率限制
      • 查詢 API 速率限制
      • 查詢所有 API 速率限制
    • 訂單
      • 下單
      • 撤單
      • 根据 ID 批量撤單
      • 根据 Symbol 批量撤單
      • 取得訂單詳情
      • 取得開放訂單列表
      • 取得訂單歷史記錄
      • 取得交易歷史記錄
    • 倉位
      • 取得倉位列表(UTA)
      • 取得倉位歷史(UTA)
      • 取得私人資金費用歷史記錄
      • 批量修改保證金模式
      • 修改逐倉合約保證金
      • 取得倉位保證金模式
    • VIP借貸
      • 簡介
      • 取得抵押率
      • 取得貸款資訊
      • 取得帳戶
  • UTA WebSocket
    • 基礎資訊
      • 簡介
      • 取得私有Token - Pro API推送
    • 公共頻道
      • K線
      • 行情數據
      • 訂單簿
      • 交易數據
    • 私有頻道
      • 訂單
      • 餘額
      • 成交 Lite
      • 持倉
      • 槓桿
      • 強平預警
    • 新增/撤銷 訂單
      • 新增訂單
      • 撤銷訂單
  • 經典 REST
    • 帳戶資訊
      • 帳戶與資金
        • 取得帳戶摘要資訊
        • 取得 Apikey 資訊
        • 取得帳戶類型 - 幣幣
        • 取得帳戶清單 - 幣幣
        • 取得帳戶詳細資料 - 幣幣
        • 取得帳戶 - 全倉槓桿
        • 取得帳戶 - 逐倉槓桿
        • 取得帳戶 - 合約
        • 取得流水記錄 - 幣幣/保證金
        • 取得流水記錄 - 現貨高頻
        • 取得流水記錄 - 槓桿高頻
        • 取得流水記錄 - 合約
      • 子帳戶
        • 新增子帳戶
        • 新增子帳戶保證金權限
        • 新增子帳戶合約權限
        • 取得所有子帳戶信息
        • 取得單個子賬戶資產信息
        • 取得子帳戶清單- 幣幣餘額 (V2)
        • 取得子帳戶清單- 合約餘額 (V2)
      • 子帳戶 API
        • 取得子帳戶API列表
        • 新增子帳戶 API
        • 修改子帳戶 API
        • 刪除子帳戶 API
      • 存款
        • 新增存款地址 (V3)
        • 取得存款地址 (V3)
        • 取得存款記錄
      • 提款
        • 取得提款額度
        • 提款 (V3)
        • 取消提款
        • 取得提款紀錄
        • 按 ID 取得提款紀錄
      • 轉移
        • 取得轉移配額
        • 萬向劃轉
      • 交易費用
        • 取得基本費用- 幣幣/保證金
        • 取得實際費用- 幣幣/保證金
        • 取得實際費用- 合約
    • 幣幣交易
      • 市場數據
        • 取得公告
        • 取得幣種列表
        • 取得所有幣種詳情
        • 取得交易對詳情
        • 取得所有交易對詳情
        • 取得行情
        • 取得全部行情
        • 取得交易歷史
        • 取得K線數據
        • 取得部分訂單簿
        • 取得完整訂單簿
        • 取得集合競價部分訂單簿
        • 取得集合競價資訊
        • 取得法幣換算價格
        • 取得 24 小時統計資料
        • 取得市場清單
        • 取得用戶端 IP 位址
        • 取得伺服器時間
        • 取得服務狀態
        • 取得 KYC 區域信息
      • 訂單
        • 新增訂單
        • 新增訂單同步
        • 新增訂單測試
        • 批次新增訂單
        • 批次新增訂單同步
        • 按 OrderId 取消訂單
        • 按 OrderId 取消訂單同步
        • 按 ClientOid 取消訂單
        • 按 clientOid 取消訂單同步
        • 取消部分訂單
        • 按交易對取消所有訂單
        • 取消所有訂單
        • 修改訂單
        • 按 OrderId 取得訂單
        • 按 ClientOid 取得訂單
        • 取得活躍訂單的交易對
        • 取得活躍訂單
        • 按頁面取得開放訂單
        • 取得已完成訂單
        • 取得交易歷史
        • 取得 DCP
        • 設定 DCP
        • 新增止損單
        • 按 ClientOid 取消止損單
        • 按 OrderId 取消止損單
        • 批次取消止損單
        • 取得止損單清單
        • 按 OrderId 取得止損單
        • 按 ClientOid 取得止損單
        • 新增 OCO 訂單
        • 按 OrderId 取消 OCO 訂單
        • 按 ClientOid 取消 OCO 訂單
        • 批次取消 OCO 訂單
        • 按 OrderId 取得 OCO 訂單
        • 按 ClientOid 取得 OCO 訂單
        • 按 OrderId 取得 OCO 訂單的詳細資料
        • 取得 OCO 訂單清單
    • 槓桿交易
      • 市場數據
        • 取得交易對 - 全倉槓桿
        • 取得交易對 - 逐倉槓桿
        • 獲取標記價格詳情
        • 取得保證金配置
        • 取得標記價格價目表
        • 查詢槓桿幣種階梯質押率
        • 查詢平台可借入數量
      • 訂單
        • 新增訂單
        • 新增訂單測試
        • 按 OrderId 取消訂單
        • 按 ClientOid 取消訂單
        • 按交易對取消所有訂單
        • 取得開放訂單的交易對
        • 取得開放訂單
        • 取得已結束訂單
        • 取得交易歷史
        • 按 OrderId 取得訂單
        • 按 ClientOid 取得訂單
        • 新增止損單
        • 按 OrderId 取消止損單
        • 按 ClientOid 取消止損單
        • 批次取消止損單
        • 取得止損單清單
        • 按 OrderId 取得止損單
        • 按 ClientOid 取得止損單
        • 新增 OCO 訂單
        • 按 OrderId 取消 OCO 訂單
        • 按 ClientOid 取消 OCO訂單
        • 批次取消 OCO 訂單
        • 按 OrderId 取得 OCO 訂單
        • 按 ClientOid 取得 OCO 訂單
        • 按 OrderId 取得 OCO 訂單的詳細資料
        • 取得 OCO 訂單清單
      • 借記
        • 取得借貸利率
        • 借幣
        • 取得借貸記錄
        • 還幣
        • 取得還幣記錄
        • 取得利息記錄
        • 修改槓桿
      • 信貸
        • 取得貸款市場
        • 取得貸款市場利率
        • 購買
        • 修改購買
        • 取得購買訂單
        • 贖回
        • 取得贖回訂單
      • 風險上限
        • 取得保證金風險限額
    • 合約交易
      • 簡介
      • 市場數據
        • 取得交易對詳情
        • 取得所有交易對詳情
        • 取得行情
        • 取得全合約最新行情
        • 取得完整買賣盤
        • 取得部分買賣盤
        • 取得交易歷史
        • 取得K線數據
        • 獲取標記價格
        • 取得幣幣指數價格
        • 取得利率指數
        • 取得溢價指數
        • 取得 24 小時統計資料
        • 取得伺服器時間
        • 取得服務狀態
      • 訂單
        • 新增訂單
        • 新增訂單測試
        • 新增獲利止損單
        • 批次新增訂單
        • 按 ClientOid 取消訂單
        • 批次取消訂單
        • 取消所有訂單
        • 取消所有止損單
        • 按 OrderId 取消訂單
        • 按 OrderId 取得訂單
        • 按 ClientOid 取得訂單
        • 取得訂單清單
        • 取得最近的已結訂單
        • 取得止損單清單
        • 取得開放訂單總價值
        • 取得最近的交易歷史
        • 取得交易歷史
      • 倉位
        • 取得槓桿模式
        • 切換槓桿模式
        • 批量切換槓桿模式
        • 取得倉位模式
        • 切換持倉模式
        • 取得最大可開倉量
        • 取得倉位詳情
        • 取得倉位列表
        • 取得持倉歷史
        • 取得最大可提取保證金
        • 取得全倉槓桿
        • 修改全倉槓桿
        • 新增逐倉槓桿
        • 移除逐倉槓桿
        • 取得全倉槓桿風險限額
        • 獲取全倉保證金要求
        • 取得逐倉槓桿風險限額
        • 修改逐倉槓桿風險限額
      • 資金費用
        • 取得目前資金費率
        • 取得歷史資金費率
        • 取得私人資金費用歷史記錄
    • 賺幣
      • 簡單賺幣
        • 購買
        • 取得贖回預覽
        • 贖回
        • 獲取餘幣寶產品
        • 獲取促銷產品
        • 取得質押產品
        • 取得 KCS 質押產品
        • 取得 ETH 質押產品
        • 取得帳戶持有
      • 結構性產品
        • 結構化產品購買
        • 獲取雙幣盈產品清單
        • 獲取結構化產品訂單
    • VIP 借貸
      • 簡介
      • 取得抵押率
      • 取得貸款資訊
      • 取得帳戶
    • 合夥人
      • 簡介
      • 取得邀請
      • 取得佣金
      • 取得Kumining交易明細
      • 取得歷史交易
      • 取得交易紀錄
    • 經紀商
      • 簡介
      • 經紀商申請
      • 說明
      • 經紀商 Pro
        • 簡介
        • 經紀商 Fast API 服務
        • 取得經紀返傭
        • 查詢我的傭金
        • 查詢用戶列表
        • 查詢用戶交易明細
      • 交易所經紀商
        • 簡介
        • 提交 KYC
        • 取得 KYC 狀態
        • 取得 KYC 狀態列表
        • 取得經紀資訊
        • 新增子帳戶
        • 取得子帳戶
        • 新增子帳戶 API
        • 取得子帳戶 API
        • 修改子帳戶 API
        • 刪除子帳戶 API
        • 轉移
        • 取得轉移記錄
        • 取得存款清單
        • 取得存款明細
        • 取得提款明細
        • 取得經紀返傭
        • 申請快速提幣
    • 跟單交易
      • 簡介
      • 新增訂單
      • 新增訂單測試
      • 新增獲利止損單
      • 按 OrderId 取消訂單
      • 按 ClientOid 取消訂單
      • 取得最大可開倉量
      • 取得最大可提取保證金
      • 新增逐倉槓桿
      • 移除逐倉槓桿
      • 修改逐倉槓桿風險限額
      • 修改逐倉槓桿自動存款狀態
      • 切換槓桿模式
      • 修改全倉槓桿
      • 獲取全倉保證金要求
      • 切換持倉模式
    • 閃兌
      • 簡介
      • 查詢閃兌交易對
      • 查詢閃兌幣種列表
      • 新增閃兌市價單
      • 查詢閃兌市價單價格
      • 查詢閃兌市價單訂單詳情
      • 查詢閃兌市價單訂單歷史
      • 新增閃兌限價單
      • 查詢閃兌限價單保護價格
      • 查詢閃兌限價單訂單詳情
      • 查詢閃兌限價單活躍訂單和歷史訂單
      • 取消閃兌限價單
  • 經典 WebSocket
    • 基礎資訊
      • 簡介
      • 取得公開Token - 幣幣/槓桿
      • 取得私人槓桿 - 幣幣/槓桿
      • 取得公開Token - 合約
      • 取得私人Token - 合約
    • 幣幣交易
      • 公共頻道
        • 單一行情數據
        • 全量行情數據
        • 訂單簿 - 深度 1
        • 訂單簿 - 深度 5
        • 訂單簿 - 深度 50
        • 訂單簿 - 增量
        • 集合競價訂單簿 - 深度 50
        • 集合競價數據
        • K線
        • 交易數據
        • 交易對快照數據
        • 市場快照數據
      • 私人頻道
        • 訂單 V2
        • 訂單 V1
        • 餘額
        • 止損單
    • 槓桿交易
      • 公共頻道
        • 指數價格
        • 標記價格
      • 私人頻道
        • 訂單 V2
        • 訂單 V1
        • 餘額
        • 止損單
        • 全倉槓桿倉位推送
        • 逐倉杠桿倉位推送
    • 合約交易
      • 公共頻道
        • 行情數據 V2
        • 行情數據 V1
        • 訂單簿 - 深度 5
        • 訂單簿 - 深度 50
        • 訂單簿 - 增量
        • K線
        • 交易數據
        • 產品行情數據
        • 資金費率結算
        • 交易對快照
      • 私人頻道
        • 訂單
        • 餘額
        • 持倉
        • 保證金模式
        • 全倉模式杠桿修改推送
        • 止損單生命週期監聽事件
    • 新增/撤銷 訂單
      • 新增訂單
      • 撤銷訂單
  • Web3 錢包
    • 插件钱包
  • 錯誤代碼
    • HTTP
    • 幣幣
    • 槓桿
    • 合約
    • 賺取
    • 經紀
    • 跟單交易
    • Websocket
    • Pro API
    • UTA API
  • 棄用的接口
    • 簡介
    • 帳戶與資金
      • 取得子帳戶清單 - 摘要資訊 (V1)
      • 取得子帳戶清單 - 幣幣餘額 (V1)
      • 取得存款地址 (V2)
      • 取得存款地址 - V1
      • 子帳戶劃轉
      • 取得存款記錄- 舊
      • 內部劃轉
      • 取得合約帳戶轉出帳簿
      • 取得提款記錄 - 舊
      • 合約帳戶轉出
      • 合約帳戶轉入
      • 新增存款地址 - V1
      • 取款 - V1
    • 幣幣交易
      • 訂單
        • 新增訂單 - 舊
        • 新增訂單測試 - 舊
        • 批次新增訂單 - 舊訂單
        • Cancel Order By OrderId - Old
        • 按 ClientOid 取消訂單 - Old
        • 批次取消訂單 - 舊
        • 取得訂單清單 - 舊
        • 取得最近訂單清單 - 舊
        • 按 OrderId 取得訂單 - Old
        • 按客戶代碼取得訂單 - Old
        • 獲取交易歷史 - 舊
        • 獲取最近的交易歷史 - 舊
    • 槓桿交易
      • 取得 ETF 資訊
      • 取得帳戶詳細資料 - 保證金
      • 新增訂單 - V1
      • 新增訂單測試 - V1
      • 取得帳戶清單 - 逐倉槓桿 - V1
      • 取得帳戶明細 - 逐倉槓桿 - V1
    • 合約交易
      • 修改逐倉槓桿自動存款狀態
      • 取消所有訂單 - V1
      • 取得倉位詳情 - V1
    • 合夥人
      • 取得帳戶
    • 經紀商
      • 經紀商 Pro
        • 取得經紀返傭
    • PRO REST
      • 取得全倉保證金配置
      • 批量下單(經典)
      • 設置 DCP(經典)
      • 取得 DCP(經典)
      • 取得帳戶倉位風險限額
    • Pro Websocket
      • 成交
  • 開發中
    • 簡介
  1. 主頁

枚舉定義

TimeInForce#

Time in Force 是一種在交易過程中使用的特殊策略。用於指定訂單在執行或到期前保持有效的時間。
請注意:訂單填寫包括自行填寫。
ParamDescription
GTCGTC(有效直至取消), 只在取消時到期
GTTGood Till Time, 在指定時間到期
IOCImmediate Or Cancel, 執行可以立即執行的部分,取消其餘部分;這不會進入買賣盤。
FOKFill Or Kill, 如果訂單無法完全成交,則取消訂單。
RPIRetail Price Improvement, 零售價格優化訂單。

RPI 訂單#

Warning
請注意:目前 RPI 功能仍處於內部開發與測試階段,尚未正式對外開放使用。第一階段僅支援合約(Futures)業務線,不支援現貨/槓桿。
RPI(Retail Price Improvement)訂單是一種新的訂單類型,可爲個人交易者提供更有針對性的市場流動性和更優的執行價格。
RPI 訂單在撮合時具備交易對手限制,僅可與非算法、非 API 下單的零售訂單成交。該機制旨在爲零售用戶提供更優的成交體驗,同時幫助做市商在更可控的風險環境下參與被動做市。目前僅特定做市商合作夥伴可以下達 RPI 訂單。
關於RPI的細節文檔,請參考: 什麼是 RPI 訂單

STP (自成交防範)#

自成交防範是進階設定中的選項。預設未選取。如果您在下單時指定 STP,您的訂單就不會被另一個同樣屬於您的訂單撮合。相反,如果沒有預先指定 STP,您的訂單可能會被您自己的另一個訂單撮合。應該注意的是,只有吃單者的保護策略才是有效的。
對於幣幣 STP,需要注意的是 STP 功能只發生在 UID 層級,而幣幣已經支援主帳戶層級 STP 白名單功能。如有需要,請加入我們的官方 API Telegram 群組:https://t.me/KuCoin_API, 或發送電郵至 api@kucoin.com,或聯絡您的帳戶經理。
對於合約 STP,STP 預設為 master-UID 層級。不需要啟用白名單功能。不過,下單時您需要攜帶「stp」參數。啟動此功能後,master-UID 及所有在 master-UID 之下的 sub-UID 將無法執行自我執行。
參數說明
DC減小並取消,取消較小數量的訂單,並將較大數量的訂單變更為新舊差異
CO取消舊訂單,取消舊訂單
CN取消新訂單,取消新訂單
CB取消兩邊,取消兩邊

隱藏委託及冰山單 (Hidden & Iceberg)#

隱藏委託和冰山單可以在進階設定中設定(冰山單是隱藏委託的一種特殊類型)。下限價單或止損限價單時,您可以選擇根據隱藏委託或冰山單執行。
隱藏委託不會顯示在買賣盤中。
與隱藏委託不同,冰山單分為可見部分和隱藏部分。從事冰山單時,必須設定可見的訂單大小。冰山單的最小可見數量為總訂單數量的 1/20。
配對時,先配對冰山單的可見部分。一旦可見的部分完全撮合,隱藏的部分就會出現。這將持續到訂單全部完成為止。
請注意:
系統會針對隱藏委託和冰山單收取吃單手續費係數。
如果您同時設定冰山單和隱藏委託,您的訂單將預設為冰山單執行。

Cancel Reason (统一账户交易撤单原因)#

You have canceled the order.
Unfilled portion of Immediate or Cancel (IOC) order canceled.
Unfilled Fill or Kill (FOK) order canceled.
Post-only order would have been filled and was canceled instead.
Order book is busy. Please try again later.
Self‑trade protection triggered.
Good Till Time (GTT) order expired due to timeout.
Self‑trade order ID mismatch.
Trading pair not found.
Insufficient available balance.
No matching orders in the order book.
Matchable amount is 0.
Matched amount exceeds limit.
Price protection triggered.
Request expired.
Good Till Time (GTT) parameter error.
Order error.
Order modified, old order canceled.
Order modified, new order canceled.
Duplicate Fill or Kill (FOK) order.
No matching orders in the order book.
Exceeded 1,000 matches for a single order, unfilled portion canceled.
No matching orders in the specified price range.
No position remaining, close order canceled.
Insufficient margin for the order.
Position is undergoing auto‑deleveraging (ADL).
Reduce‑only order size exceeds position size.
The order price is higher (when short) or lower (when long) than the position bankruptcy price.
Funds are being settled. Please try again later.
Risk limit is currently being adjusted. Please try again later.
Insufficient balance.
Contract is being settled. Please try again later.
System error.
Duplicate ID.
Lending pool limit exceeded, auto‑repay triggered.
Order canceled due to Auto‑Repay.
Liquidation process triggered.
Take‑profit or stop‑loss triggered.
Order canceled by the system.
Order canceled due to restrictions on certain account features.
No matching orders in the specified price range.
Modified at 2026-05-22 06:26:37
Previous
驗證
Next
術語定義