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

枚舉定義

TimeInForce#

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

RPI 訂單#

Warning
請注意:目前 RPI 功能仍處於內部開發與測試階段,尚未正式對外開放使用。第一階段僅支援合約(Futures)業務線,不支援現貨/槓桿;且 RPI 目前僅支援 Pro API 經典帳戶,尚不支援 UTA。
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。
配對時,先配對冰山單的可見部分。一旦可見的部分完全撮合,隱藏的部分就會出現。這將持續到訂單全部完成為止。
請注意:
系統會針對隱藏委託和冰山單收取吃單手續費係數。
如果您同時設定冰山單和隱藏委託,您的訂單將預設為冰山單執行。
Modified at 2026-01-23 08:44:18
Previous
驗證
Next
術語定義