KUCOIN API
主頁更新日誌API DOC V1
語言
  • English
主頁更新日誌API DOC V1
語言
  • English
SDK
Telegram
Kucoin
  1. 主頁
  • 簡介
  • 驗證
  • 枚舉定義
  • 術語定義
  • SDK
  • 速率限制
  • 更新日誌
  • 用戶服務
    • 做市獎勵計劃
    • 貴賓快速通道
    • 經紀商計劃
  • 統一REST
    • 介紹
    • 市場數據
      • 取得公告
      • 取得幣種列表
      • 取得交易對詳情
      • 取得行情
      • 取得訂單簿
      • 取得最近交易歷史
      • 取得K線數據
      • 取得目前資金費率
      • 取得歷史資金費率
      • 取得全倉保證金配置
      • 取得服務器狀態
  • 統一Websocket
    • 基礎資訊
      • 簡介
    • 新增/撤銷 訂單
      • 新增訂單
      • 撤銷訂單
  • 經典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 小時統計資料
        • 取得伺服器時間
        • 取得服務狀態
      • 訂單
        • 新增訂單
        • 新增訂單測試
        • 批次新增訂單
        • 新增獲利止損單
        • 按 OrderId 取消訂單
        • 按 ClientOid 取消訂單
        • 批次取消訂單
        • 取消所有訂單
        • 取消所有止損單
        • 按 OrderId 取得訂單
        • 按 ClientOid 取得訂單
        • 取得訂單清單
        • 取得最近的已結訂單
        • 取得止損單清單
        • 取得開放訂單總價值
        • 取得最近的交易歷史
        • 取得交易歷史
      • 倉位
        • 取得槓桿模式
        • 切換槓桿模式
        • 批量切換槓桿模式
        • 取得倉位模式
        • 切換持倉模式
        • 取得最大可開倉量
        • 取得倉位詳情
        • 取得倉位列表
        • 取得持倉歷史
        • 取得最大可提取保證金
        • 取得全倉槓桿
        • 修改全倉槓桿
        • 新增逐倉槓桿
        • 移除逐倉槓桿
        • 取得全倉槓桿風險限額
        • 獲取全倉保證金要求
        • 取得逐倉槓桿風險限額
        • 修改逐倉槓桿風險限額
      • 資金費用
        • 取得目前資金費率
        • 取得歷史資金費率
        • 取得私人資金費用歷史記錄
    • 賺幣
      • 簡單賺幣
        • 購買
        • 取得贖回預覽
        • 贖回
        • 獲取餘幣寶產品
        • 獲取促銷產品
        • 取得質押產品
        • 取得 KCS 質押產品
        • 取得 ETH 質押產品
        • 取得帳戶持有
      • 結構性產品
        • 結構化產品購買
        • 獲取雙幣盈產品清單
        • 獲取結構化產品訂單
    • VIP 借貸
      • 簡介
      • 取得抵押率
      • 取得貸款資訊
      • 取得帳戶
    • 合夥人
      • 簡介
      • 取得邀請
      • 取得佣金
      • 取得歷史交易
      • 取得交易紀錄
      • 取得Kumining交易明細
    • 經紀商
      • 簡介
      • 經紀商申請
      • 說明
      • API 經紀商
        • 簡介
        • Fast API服務
        • 取得經紀返傭
        • 查詢我的傭金
        • 查詢用戶列表
        • 查詢用戶交易明細
      • 交易所經紀商
        • 簡介
        • 提交 KYC
        • 取得 KYC 狀態
        • 取得 KYC 狀態列表
        • 取得經紀資訊
        • 新增子帳戶
        • 取得子帳戶
        • 新增子帳戶 API
        • 取得子帳戶 API
        • 修改子帳戶 API
        • 刪除子帳戶 API
        • 轉移
        • 取得轉移記錄
        • 取得存款清單
        • 取得存款明細
        • 取得提款明細
        • 取得經紀返傭
    • 跟單交易
      • 簡介
      • 新增訂單
      • 新增訂單測試
      • 新增獲利止損單
      • 按 OrderId 取消訂單
      • 按 ClientOid 取消訂單
      • 取得最大可開倉量
      • 取得最大可提取保證金
      • 新增逐倉槓桿
      • 移除逐倉槓桿
      • 修改逐倉槓桿風險限額
      • 修改逐倉槓桿自動存款狀態
      • 切換槓桿模式
      • 修改全倉槓桿
      • 獲取全倉保證金要求
      • 切換持倉模式
    • 閃兌
      • 簡介
      • 查詢閃兌交易對
      • 查詢閃兌幣種列表
      • 查詢閃兌市價單價格
      • 新增閃兌市價單
      • 查詢閃兌市價單訂單詳情
      • 查詢閃兌市價單訂單歷史
      • 查詢閃兌限價單保護價格
      • 新增閃兌限價單
      • 取消閃兌限價單
      • 查詢閃兌限價單訂單詳情
      • 查詢閃兌限價單活躍訂單和歷史訂單
  • 經典Websocket
    • 基礎資訊
      • 簡介
      • 取得公開Token- 幣幣/槓桿
      • 取得私人槓桿- 幣幣/槓桿
      • 取得公開Token- 合約
      • 取得私人Token- 合約
    • 幣幣交易
      • 公共頻道
        • Ticker
        • Trade
        • 訂單簿 - Level1
        • 訂單簿 - Level5
        • 訂單簿 - Level50
        • 訂單簿 - Increment
        • 集合競價訂單簿 - Level50
        • K線
        • 交易數據
        • 交易對快照數據
        • 市場快照數據
      • 私人頻道
        • 訂單 V2
        • 訂單 V1
        • 餘額
        • 止損單
    • 槓桿交易
      • 公共頻道
        • 指數價格
        • 標記價格
      • 私人頻道
        • 逐倉杠桿倉位推送
        • 全倉槓桿倉位推送
    • 合約交易
      • 公共頻道
        • 行情數據 V2
        • 行情數據 V1
        • 訂單簿 - Level5
        • 訂單簿 - Level50
        • 訂單簿- 增量
        • K線
        • 交易數據
        • 產品行情數據
        • 資金費率結算
        • 交易對快照
      • 私人頻道
        • 訂單
        • 餘額
        • 持倉
        • 保證金模式
        • 全倉模式杠桿修改推送
        • 止損單生命週期監聽事件
  • 錯誤代碼
    • HTTP
    • 幣幣
    • 槓桿
    • 合約
    • 賺取
    • 經紀
    • 跟單交易
    • Websocket
  • 棄用的接口
    • 簡介
    • 帳戶與資金
      • 取得子帳戶清單- 摘要資訊 (V1)
      • 取得子帳戶清單- 幣幣餘額 (V1)
      • 取得存款地址 (V2)
      • 取得存款地址- V1
      • 子帳戶劃轉
      • 取得存款記錄- 舊
      • 內部劃轉
      • 取得合約帳戶轉出帳簿
      • 取得提款記錄- 舊
      • 合約帳戶轉出
      • 合約帳戶轉入
      • 新增存款地址- V1
      • 取款- V1
    • 幣幣交易
      • 訂單
        • 新增訂單- 舊
        • 新增訂單測試- 舊
        • 批次新增訂單- 舊訂單
        • Cancel Order By OrderId- Old
        • 按 ClientOid 取消訂單 - Old
        • 批次取消訂單- 舊
        • 取得訂單清單- 舊
        • 取得最近訂單清單- 舊
        • 按 OrderId 取得訂單- Old
        • 按客戶代碼取得訂單- Old
        • 獲取交易歷史- 舊
        • 獲取最近的交易歷史- 舊
    • 槓桿交易
      • 取得帳戶詳細資料- 保證金
      • 新增訂單- V1
      • 新增訂單測試- V1
      • 取得帳戶清單- 逐倉槓桿- V1
      • 取得帳戶明細- 逐倉槓桿- V1
    • 合約交易
      • 取得倉位詳情- V1
      • 修改逐倉槓桿自動存款狀態
      • 取消所有訂單- V1
    • 合夥人
      • 取得帳戶
    • 經紀商
      • API經紀商
        • 取得經紀返傭
  • 開發中
    • 簡介
  1. 主頁

驗證

產生 API 金鑰#

在簽署任何請求之前,您必須透過 KuCoin 網站 建立 API 金鑰。建立鑰匙時,您需要寫下三項資訊:
鑰匙 (Key)
秘鑰 (Secret)
密碼組 (Passphrase)
鑰匙和秘鑰由 KuCoin 生成並提供,密碼組指的是您用來創建 KuCoin API 的密碼。請注意,這三項資訊一旦遺失將無法復原。如果您遺失了此資訊,請建立新的 API 金鑰。

API KEY PERMISSIONS#

您可以在 KuCoin 的官網上管理 API 的權限。請參閱下列說明文件,以瞭解特定路由需要哪些 API 金鑰權限。

建立請求#

所有私人 REST 請求必須包含下列標題:
KC-API-KEY API 金鑰的字串。
KC-API-SIGN 基本 64 編碼簽章。
KC-API-TIMESTAMP 請求的時間戳記(毫秒)。
KC-API-PASSPHRASE 您在建立 API 金鑰時指定的密碼組。
KC-API-KEY-VERSION 您可以在 API 管理 頁面檢查 API 金鑰版本。
Content-Type 所有要求和回應都是application/json 內容類型。

簽署訊息#

適用於KC-API-SIGN 的標題:
使用 API-Secret 以 sha256 HMAC 加密預湊字串{timestamp+method+endpoint+body} 。請求體是 JSON 字串,必須與 API 傳遞的參數相同。
在傳送請求之前,透過base64 對內容進行編碼。
適用於KC-API-PASSPHRASE 的標題:
使用HMAC-sha256 透過 API-Secret 加密密碼組。
在傳送請求之前,透過base64 對內容進行編碼。
請注意:
加密的時間戳應與請求標題中的 KC-API-TIMESTAMP 欄一致。
要加密的正文應與請求體的內容一致。
方法應該是大寫。
對於 GET、DELETE 請求,所有查詢參數都需要包含在請求的 url 中。例如:/api/v1/deposit-addresses?currency=XBT 。如果沒有請求體(通常用於 GET 請求),則體為""。
對於 POST 請求,所有查詢參數都需要用 JSON 包含在請求體中。(例如{"currency": "BTC"} )。請勿在 JSON 字串中包含額外的空格。
產生簽章時,URL 必須使用未經 URL 編碼的內容參與簽章。
例如:當 url 為 /api/v1/sub/api-key?apiKey=67b3&subName=test&passphrase=abc%21%40%2311
, 參與簽名的 URL 內容應該是原始資訊 /api/v1/sub/api-key?apiKey=67
b3&subName=test&passphrase=abc!@#11

PHP 範例#

Python 範例#

如需更適合生產的實作,請參閱:代碼
Modified at 2025-11-18 09:11:39
Previous
簡介
Next
枚舉定義