KUCOIN API
主頁更新日誌API DOC V1
語言
  • English
主頁更新日誌API DOC V1
語言
  • English
SDK
Telegram
Kucoin
  1. 主頁
  • 簡介
  • 驗證
  • 枚舉定義
  • 術語定義
  • SDK
  • OpenClaw
  • 速率限制
  • 更新日誌
  • 用戶服務
    • 做市獎勵計劃
    • 貴賓快速通道
    • 經紀商計劃
  • Pro REST
    • 介紹
    • 市場數據
      • 取得公告
      • 取得單幣種資訊
      • 取得多幣種詳情
      • 取得交易對詳情
      • 取得行情
      • 取得訂單簿
      • 取得K線數據
      • 取得最近交易歷史
      • 取得抵押率
      • 取得全倉保證金配置
      • 取得指數價格
      • 取得目前資金費率
      • 取得歷史資金費率
      • 取得風險限制分檔
      • 取得合約未平倉量
      • 取得服務器狀態
    • 帳戶
      • 取得帳戶總覽(UTA)
      • 取得帳戶幣種資產(UTA)
      • 取得帳戶幣種資產(經典)
      • 取得子帳戶幣種資產
      • 取得轉帳配額
      • 萬向劃轉
      • 設置子子劃轉權限
      • 取得帳戶模式
      • 設定帳戶模式
      • 取得實際費率
      • 取得帳戶流水記錄
      • 取得利息歷史(UTA)
      • 調整槓桿(UTA)
      • 取得充值地址
    • 訂單
      • 下單
      • 批量下單(經典)
      • 撤單
      • 根据 ID 批量撤單
      • 根据 Symbol 批量撤單
      • 取得訂單詳情
      • 取得開放訂單列表
      • 取得訂單歷史記錄
      • 取得交易歷史記錄
      • 設置 DCP(經典)
      • 取得 DCP(經典)
    • 倉位
      • 取得倉位列表(UTA)
      • 取得倉位歷史(UTA)
      • 取得帳戶倉位風險限額
  • Pro WebSocket
    • 基礎資訊
      • 簡介
      • 取得私有Token - Pro API推送
    • 公共頻道
      • K線
      • 行情數據
      • 訂單簿
      • 交易數據
    • 私有頻道
      • 訂單
      • 餘額
      • 成交
      • 持倉
      • 槓桿
      • 強平預警
    • 新增/撤銷 訂單
      • 新增訂單
      • 撤銷訂單
  • 經典 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 訂單清單
    • 槓桿交易
      • 市場數據
        • 取得交易對 - 全倉槓桿
        • 取得交易對 - 逐倉槓桿
        • 取得 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. 主頁

OpenClaw

OpenClaw Skills Hub#

KuCoin Skills Hub 是一個面向 OpenClaw 的公開 Skills 倉庫,使 AI agents 能夠透過可重複使用、按業務域劃分的 OpenClaw skills 存取 KuCoin 交易所資料。當前實作基於 KuCoin Classic REST API,且僅提供唯讀存取能力。
每個 skill 都以標準 OpenClaw skill 的形式封裝,並可安裝至 OpenClaw workspace,在其中可供目前的 agent session 使用。安裝完成後,agents 可透過基於 skill 的提示來呼叫對應的業務能力,而無需直接處理 REST endpoint。
Note
目前所有可用 skills 僅支援 GET(唯讀)endpoints。現階段不支援會改變狀態的操作,包括下單、撤單、劃轉、還款、申購、贖回,以及其他寫入型操作。

Overview#

Protocol: KuCoin Classic REST API
Access Mode: Read-only
Integration Target: OpenClaw, AI agents, LLM-powered tools
Current Repository: https://github.com/Kucoin/kucoin-skills-hub

Skill Directory#

SkillBusiness DomainMain Capabilities
spotSpot Trading現貨市場資料、高頻訂單查詢、止損訂單查詢,以及 OCO 訂單查詢
margin-tradingMargin Trading全倉槓桿資料、逐倉槓桿資料、借貸歷史、還款歷史、出借資料,以及風險限額查詢
futures-tradingFutures Trading合約市場資料、訂單查詢、倉位查詢,以及資金費用查詢
assetsAssets帳戶餘額、帳戶流水、子帳戶、充值、提現,以及交易費率查詢
earnEarn活期 Earn 產品查詢,以及結構化 Earn 產品查詢
convertConvert即時兌換報價、市價單歷史,以及限價單查詢
brokerBrokerAffiliate 查詢、Broker Pro 查詢,以及 ND Exchange Broker 查詢

Quick Start#

Step 1. Start a new OpenClaw session#

在安裝 KuCoin skills 之前,先開啟 OpenClaw 並進入將要執行安裝的目標 session。
建立或進入 kucoin TUI session:
image.png
Notes
Skill 安裝是在 OpenClaw TUI session 上下文中執行的。
在執行任何 KuCoin Skills Hub 安裝命令之前,應先啟動該 session。

Step 2. Install KuCoin skills#

Summary
將特定 skill 或完整的 KuCoin Skills Hub 安裝至目前的 OpenClaw workspace。
以下步驟中的所有 npx skills ... 命令,都應直接輸入至目前啟用的 OpenClaw session 輸入框中,類似 /status 這類 session CLI 指令的輸入方式。
image.png
安裝單一特定 skill,例如 spot:
將全部 skills 安裝至目前的 OpenClaw workspace:
如果安裝過程停在互動式 skill selector,請以非互動模式重新執行:
將全部 skills 全域安裝,而不是安裝到目前 project workspace:
image.png
Notes
當只需要單一 skill 時,請使用 --skill <name>。
當需要完整的 KuCoin skill 集時,請使用安裝全部 skills 的命令。
Skills CLI 預設只會掃描第一層目錄。
由於 KuCoin Skills Hub 將每個 skill 儲存在 skills/<name>/SKILL.md 之下,因此需要使用 --full-depth 才能正確發現 skills。
若未使用 --full-depth,repository 可能雖然 clone 成功,但安裝器可能無法偵測到所有巢狀 skill 定義。
預設情況下,當偵測到多個 skills 時,安裝可能會停在互動式選擇器。
加上 --yes 可讓安裝以非互動方式繼續進行。
Skills 可安裝在 project/workspace level 或 global level。
在 project 安裝模式下,skills 只會連結到目前 OpenClaw workspace 上下文中。
不同的 OpenClaw workspaces 或 sessions 可能需要分別執行安裝。

Step 3. Confirm the installed skill set#

Summary
目前 repository 在完整成功安裝後,會將以下七個 skills 加入目前啟用的 OpenClaw workspace。
assets
broker
convert
earn
futures-trading
margin-trading
spot

Step 4. Verify the installed skills#

Summary
使用以下命令來驗證目前啟用的 OpenClaw workspace 中有哪些 project-level skills 可用。
image.png
Notes
此命令會列出目前 workspace 可用的 skills。
安裝完成後應執行此命令,以確認預期的 skills 已被正確發現並連結。

Step 5. Remove unnecessary skills#

Summary
使用以下命令從目前的 project workspace 中移除已安裝的 skills。
互動式移除已安裝的 skills:
Notes
根據 Session CLI 流程,移除行為仍可能涉及互動式選擇。
在某些情況下,移除後仍可能需要手動檢查最終的 workspace 狀態。

Step 6. Review security implications before use#

Summary
匯入的 skills 是在目前 agent 環境內執行的能力層,因此在敏感 workspace 中使用前,應先審查每個已安裝的 skill。
Notes
安裝過程中,Skills CLI 可能會顯示匯入 skills 的安全性或風險評估結果。
不同掃描器可能給出不同結論,包括:
安全評估
高風險標記
socket 相關警示
相依性相關警示
由於已安裝的 skills 會以目前 agent 與 workspace 的實際權限執行,因此在以下環境中使用前應先審查:
API 憑證
生產交易系統
私有資料
其他敏感資源
Security Warning
已安裝的 OpenClaw skills 會以目前 agent 與 workspace 的實際權限執行。在包含 API 憑證、生產交易系統、私有資料或其他敏感資源的環境中啟用前,請先審查 skill 內容。

Usage#

安裝完成後,skills 是透過 OpenClaw agent 介面使用,而不是作為獨立的 shell 命令來使用。
範例 1,安裝 spot 之後,可向 agent 發送如下請求:
 What's the BTC price on KuCoin?                                                                                                           
image.png
範例 2,安裝 futures-trading 之後,可向 agent 發送如下請求:
 Get the Spot Index Price for the BTCUSDT contract.                                                                                        
image.png
在此模型中,skill 充當能力層,將 agent 請求映射到對應的 KuCoin API 查詢流程。

Notes#

Skills 按業務能力進行組織,且可獨立安裝。
目前 repository 僅提供唯讀整合能力。
Project 安裝與 global 安裝是兩個不同的範圍。
Skill 是否可用,取決於其安裝所在的 OpenClaw workspace 或安裝範圍。
Skills Hub 的目的是減少基於 AI-agent 的 KuCoin 存取場景中重複的自訂整合工作。
隨著未來加入更多 KuCoin API 能力,skill 覆蓋範圍可能進一步擴展。
Modified at 2026-03-24 06:57:56
Previous
SDK
Next
速率限制