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. 私人頻道

餘額

wss://ws-api-spot.kucoin.com

Topic:/account/balance#

Description
當帳戶餘額發生變更時,您將收到此消息。消息包含變更的詳細信息。
推送頻率: 實時

相關事件#

TypeDescription
main.deposit存款
main.withdraw_hold凍結提現金額
main.withdraw_done提現完成
main.transfer轉帳(主帳戶)
main.other其他操作(主帳戶)
trade.hold凍結(交易帳戶)
trade.setted結算(交易帳戶)
trade.transfer轉帳(交易帳戶)
trade.other其他操作(交易帳戶)
trade_hf.hold凍結(高頻交易帳戶)
trade_hf.setted結算(高頻交易帳戶)
trade_hf.transfer轉帳(高頻交易帳戶)
trade_hf.other其他操作(高頻交易帳戶)
margin.hold凍結(保證金帳戶)
margin.setted結算(保證金帳戶)
margin.transfer轉帳(保證金帳戶)
margin.other其他操作(保證金帳戶)
isolated_{symbol}.hold凍結(逐倉保證金帳戶)
isolated_{symbol}.setted結算(逐倉保證金帳戶)
isolated_{symbol}.transfer轉帳(逐倉保證金帳戶)
isolated_{symbol}.other其他操作(逐倉保證金帳戶)
marginV2.hold凍結(高頻保證金帳戶)
marginV2.setted結算(高頻保證金帳戶)
marginV2.transfer轉帳(高頻保證金帳戶)
marginV2.other其他操作(高頻保證金帳戶)
isolatedV2_{symbol}.hold凍結(逐倉高頻保證金帳戶)
isolatedV2_{symbol}.setted結算(逐倉高頻保證金帳戶)
isolatedV2_{symbol}.transfer轉帳(逐倉高頻保證金帳戶)
isolatedV2_{symbol}.other其他操作(逐倉高頻保證金帳戶)
other其他

Subscribe Message#

{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/account/balance",
  "response": true,
  "privateChannel": "true"
}

Response#

Data Schema
帳戶

Example
{
    "topic": "/account/balance",
    "type": "message",
    "subject": "account.balance",
    "id": "354689988084000",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "accountId": "548674591753",
        "currency": "USDT",
        "total": "21.133773386762",
        "available": "20.132773386762",
        "hold": "1.001",
        "availableChange": "-0.5005",
        "holdChange": "0.5005",
        "relationContext": {
            "symbol": "BTC-USDT",
            "orderId": "6721d0632db25b0007071fdc",
            "tradeId": "11116472408358913"
        },
        "relationEvent": "trade.hold",
        "relationEventId": "354689988084000",
        "time": "1730269283892"
        
    }
}
      

Request

Query Params

Modified at 2025-09-04 02:55:03
Previous
訂單 V1
Next
止損單