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. 錯誤代碼

UTA API

UTA General#

CodeMeaning
100030System error.
100060Unable to perform this action on the contract.
100070System error.
111201Request timeout
111208Gateway could not encode request
111209Network is congested
111210Could not find user { Param }
111225Failed to parse parameter.
111226Route not found. Please check and try again.

UTA Account Opening#

CodeMeaning
109000User does not exist
170901Account type invalid
170902Account open status invalid
170903Account open status illegal
170904Pre confirmed not passed
170905User status check not passed
170906Switch account open status failed
170907Account switch error.
170911Switch check fail
170912Account type not supported.
170913Account switch error.
170915Please complete the quiz on your master account before activating your Unified Account.
170916During the beta period, the maximum number of sub-accounts that can be set as a Unified Account has been reached. Please switch accounts or contact support if necessary.
109990System error

UTA Order#

CodeMeaning
116050Order is being canceled
163000User not found
116050Order is being canceled
116052Order not found
116053The symbol is currently not enabled for trading
116054The symbol was not found in the system
116055The 2.0 match topic was not found for contract { ContractId } in the system
116101Not found the order id { OrderId }
116102Not found the client order id { ClientOrderId }
116104User not found.
116150Insufficient account balance.
116151ClientOrderId already exists in the system
116152OrderId already exists in the system
116182There wasn't any position to close/reduce
116183Could not get leverage config
116190The symbol id { Param } was not found in the system
116193The currency id { Param } was not found in the system
116194The symbol is currently not enabled for trading
116204System internal error
116206Open orders exceed max limit error
116207User risk ratio exceed max limit error
116208User status is pausing trade
116209System order idempotent error
116210Advanced order canceled error
116211Trading is unavailable in the current state.
116215The platform's quota has been reached. Unable to place new orders.
116217Maximum risk limit exceeded.
116218Margin mode does not match. Only CROSS and ISOLATED are supported.
116219Failed to place the reduce-only order. Cancel existing close orders for this contract and try again.
116220No matching orders in the specified price range.

UTA Account#

CodeMeaning
163520InvalidUnifiedUser id { Param }
116355Insufficient funds (left: { Param })
116365Invalid account leverage { Param1 } violating threshold { Param2 }
104010Parameter error.
104030Business error.
110405Currency not found.
104060User not found.

UTA Position#

CodeMeaning
116400Symbol is not futures
116401Invalid position
116403The symbol was not found in the system
116412The isolated position is being liquidated. Try again later.
110030business error
110010User not authorized
111003account does not exist
111004contract does not exist
111005ultra-position.pageSize.invalid
111006ultra-position.pageNumber.invalid

UTA Spot Trading#

CodeMeaning
130100This operation cannot be completed at this time due to local laws, regulations, or policies in the country or region in which you reside
130101According to your current IP, we are unable to provide services due to local laws, regulations, or policies. We apologize for the inconvenience caused. For any questions, contact customer service
130102To enjoy the full range of our products and services, we kindly request you complete the identity verification process
130103To enjoy the full range of our products and services, log in to your master account and complete the identity verification process
130105Placing orders is unavailable.
130106Request failed. Trading pair {0} is unavailable.
130114Only limit orders are supported before {0} (UTC+8).
130115Order price cannot be higher than the maximum price.
130116Order price cannot be lower than the minimum price.
130117Unfortunately, trading is currently unavailable in your location due to country, region, or IP restrictions.
130118Orders cannot be canceled during the second phase of a call auction.
130119Only limit orders are allowed during the call auction phase.
130120The order price must be between {0} and {1} during the call auction phase.
130121Orders cannot be canceled during Phase 3 of a call auction.
130122Orders cannot be placed during the third phase of a call auction.
130123Placing auction orders is not allowed.
130124User not authorized
130126The order amount must be at least {0} {1}.
130128Trading pair is unavailable.
130129Failed to obtain market price.
130131Based on your KYC identity and IP location, you may be subject to Indian tax regulations. Please provide your PAN for tax reporting and ensure that it is accurate.
130132This product is not available to certain users under Indian tax law. You may still use other KuCoin products that do not involve TDS.
130133Sorry, this digital asset is not available in your country or region.
130137STP (Self-Trade Prevention) is not supported in call auctions.
130138Post-only and hidden orders are not supported in call auctions.
130139RWA trading terms not signed. Go to the latest app and complete the signing by tapping Trade.
130140User spot trading status is invalid.
130141User margin trading status is invalid.
130142Sub-account trading permission is invalid.
130143Cross margin trading is not enabled for your Unified Account. Please contact your account manager to enable it.
130146validation.callAuction.tifNotSupported
130147validation.callAuction.advancedOrderNotSupported
130148validation.callAuction.tradeTypeNotSupported

UTA Leverage#

CodeMeaning
163000User not found
116301User risk rate beyond threshold
116303Not future symbol
116307User available net value insufficient

UTA Futures Trading#

CodeMeaning
140001User futures status is invalid.
140002Isolated margin futures is not enabled for your Unified Account. Please contact your account manager to enable it.
140100Contract does not exist.
140101Cannot place market order since there are currently no contra orders in the market.
140102Order price cannot be higher than {0}.
140103Order price is lower than the minimum limit price.
140106Service is unavailable in your region due to local regulations. Orders cannot be placed.
140108Only close orders are allowed.
140110Invalid margin mode.
140111The current contract is set to reduce-only. Please place a reduce-only order.
140112Mark price does not exist.
140116Invalid trigger price type.
140121Invalid trigger price.
140123Invalid take-profit trigger type.
140124Take-profit price does not exist.
140126Invalid stop-loss trigger type.
140127Stop-loss price does not exist.
140130RPI orders only support limit orders.
140132RPI orders do not support advanced order types (stop, iceberg, hidden, STP, etc.).
140133This contract does not support RPI orders.
140134You are not authorized to place RPI orders.
140136Trading of stock index perpetual contracts is unavailable in your region.
140140BBO orders do not support the specified order type or parameters.

UTA Loan#

CodeMeaning
103070System error.
103000Parameter error.
160305currency.res.invalid
166601User does not exist
166607User loan does not exist
166616Leverage adjustment is not allowed for this user.
166617Leverage adjustment blocked. Insufficient margin after change.
166618Leverage adjustment blocked. Borrowing limit would be exceeded.
Modified at 2026-06-05 14:51:31
Previous
Pro API
Next
簡介