KUCOIN API
HomeChange LogAPI DOC V1
Language
  • 繁體中文
HomeChange LogAPI DOC V1
Language
  • 繁體中文
SDK
Telegram
Kucoin
  1. Error Code
  • Introduction
  • Authentication
  • Enums Definitions
  • Terms Definitions
  • SDK
  • OpenClaw
  • Rate Limit
  • Change Log
  • User Service
    • Market Making Incentive Scheme
    • VIP Fast Track
    • Broker Program
  • UTA REST
    • Introduction
    • Market Data
      • Get Announcements
      • Get Currency
      • Get Currencies
      • Get Symbol
      • Get Ticker
      • Get OrderBook
      • Get Klines
      • Get Trades
      • Get Collateral Ratio
      • Get Index Price
      • Get Current Funding Rate
      • Get History Funding Rate
      • Get Position Tiers
      • Get Futures Open Interest
      • Get Service Status
      • Get Third-Party Custody Currencies
      • Get Borrowable Currencies
      • Get KYC Regions
      • Get Client IP Address
      • Get Fiat Price
    • Account
      • Get Account Overview (UTA)
      • Get Account Currency Assets (UTA)
      • Get Account Currency Assets (Classic)
      • Get Sub Account Currency Assets
      • Get Transfer Quotas
      • Flex Transfer
      • Set Sub Account Transfer Permission
      • Get Account Mode
      • Set Account Mode
      • Get Fee Rate
      • Get Account Ledger
      • Get Interest History (UTA)
      • Modify Futures Leverage (UTA)
      • Get Deposit Address
      • Get Third-Party Custody Account Currency Limits
      • Modify Cross Margin Leverage (UTA)
      • Get Leverage (UTA)
      • Get Borrowing Rates and Limits
      • Get Apikey Info
      • Add sub-account
      • Get sub-account API List
      • Add sub-account API
      • Modify sub-account API
      • Delete sub-account API
      • Get Withdrawal Quotas
      • Withdraw
      • Cancel Withdrawal
      • Get API Rate Limit Cap
      • Set Sub Accounts API Rate Limit
      • Get API Rate Limit
      • Get All API Rate Limit
    • Orders
      • Place Order
      • Cancel Order
      • Batch Cancel Orders By ID
      • Batch Cancel Orders By Symbol
      • Get Order Details
      • Get Open Order List
      • Get Order History
      • Get Trade History
    • Positions
      • Get Position List (UTA)
      • Get Positions History (UTA)
      • Get Private Funding Fee History
      • Batch Modify Margin Mode
      • Modify Isolated Futures Margin
      • Get Margin Mode
    • VIP Lending
      • Introduction
      • Get Collateral Ratio
      • Get Loan Info
      • Get Accounts
  • UTA WebSocket
    • Base Info
      • Introduction
      • Get Private Token - Pro API Private Channels
    • Public Channels
      • Kline
      • Ticker
      • Orderbook
      • Trade
    • Private Channels
      • Order
      • Balance
      • Execution Lite
      • Position
      • Leverage
      • LiquidationWarning
    • Add/Cancel Order
      • Add Order
      • Cancel Order
  • Classic REST
    • Account Info
      • Account & Funding
        • Get Account Summary Info
        • Get Apikey Info
        • Get Account Type - Spot
        • Get Account List - Spot
        • Get Account Detail - Spot
        • Get Account - Cross Margin
        • Get Account - Isolated Margin
        • Get Account - Futures
        • Get Account Ledgers - Spot/Margin
        • Get Account Ledgers - Trade_hf
        • Get Account Ledgers - Margin_hf
        • Get Account Ledgers - Futures
      • Sub Account
        • Add sub-account
        • Add sub-account Margin Permission
        • Add sub-account Futures Permission
        • Get sub-account List - Summary Info
        • Get sub-account Detail - Balance
        • Get sub-account List - Spot Balance (V2)
        • Get sub-account List - Futures Balance (V2)
      • Sub Account API
        • Get sub-account API List
        • Add sub-account API
        • Modify sub-account API
        • Delete sub-account API
      • Deposit
        • Add Deposit Address (V3)
        • Get Deposit Address (V3)
        • Get Deposit History
      • Withdrawals
        • Get Withdrawal Quotas
        • Withdraw (V3)
        • Cancel Withdrawal
        • Get Withdrawal History
        • Get Withdrawal History By ID
      • Transfer
        • Get Transfer Quotas
        • Flex Transfer
      • Trade Fee
        • Get Basic Fee - Spot/Margin
        • Get Actual Fee - Spot/Margin
        • Get Actual Fee - Futures
    • Spot Trading
      • Market Data
        • Get Announcements
        • Get Currency
        • Get All Currencies
        • Get Symbol
        • Get All Symbols
        • Get Ticker
        • Get All Tickers
        • Get Trade History
        • Get Klines
        • Get Part OrderBook
        • Get Full OrderBook
        • Get Call Auction Part OrderBook
        • Get Call Auction Info
        • Get Fiat Price
        • Get 24hr Stats
        • Get Market List
        • Get Client IP Address
        • Get Server Time
        • Get Service Status
        • Get KYC Regions
      • Orders
        • Add Order
        • Add Order Sync
        • Add Order Test
        • Batch Add Orders
        • Batch Add Orders Sync
        • Cancel Order By OrderId
        • Cancel Order By OrderId Sync
        • Cancel Order By ClientOid
        • Cancel Order By ClientOid Sync
        • Cancel Partial Order
        • Cancel All Orders By Symbol
        • Cancel All Orders
        • Modify Order
        • Get Order By OrderId
        • Get Order By ClientOid
        • Get Symbols With Open Order
        • Get Open Orders
        • Get Open Orders By Page
        • Get Closed Orders
        • Get Trade History
        • Get DCP
        • Set DCP
        • Add Stop Order
        • Cancel Stop Order By ClientOid
        • Cancel Stop Order By OrderId
        • Batch Cancel Stop Orders
        • Get Stop Orders List
        • Get Stop Order By OrderId
        • Get Stop Order By ClientOid
        • Add OCO Order
        • Cancel OCO Order By OrderId
        • Cancel OCO Order By ClientOid
        • Batch Cancel OCO Order
        • Get OCO Order By OrderId
        • Get OCO Order By ClientOid
        • Get OCO Order Detail By OrderId
        • Get OCO Order List
    • Margin Trading
      • Market Data
        • Get Symbols - Cross Margin
        • Get Symbols - Isolated Margin
        • Get Mark Price Detail
        • Get Margin Config
        • Get Mark Price List
        • Get Margin Collateral Ratio
        • Get Market Available Inventory
      • Orders
        • Add Order
        • Add Order Test
        • Cancel Order By OrderId
        • Cancel Order By ClientOid
        • Cancel All Orders By Symbol
        • Get Symbols With Open Order
        • Get Open Orders
        • Get Closed Orders
        • Get Trade History
        • Get Order By OrderId
        • Get Order By ClientOid
        • Add Stop Order
        • Cancel Stop Order By OrderId
        • Cancel Stop Order By ClientOid
        • Batch Cancel Stop Orders
        • Get Stop Orders List
        • Get Stop Order By OrderId
        • Get Stop Order By ClientOid
        • Add OCO Order
        • Cancel OCO Order By OrderId
        • Cancel OCO Order By ClientOid
        • Batch Cancel OCO Order
        • Get OCO Order By OrderId
        • Get OCO Order By ClientOid
        • Get OCO Order Detail By OrderId
        • Get OCO Order List
      • Debit
        • Get Borrow Interest Rate
        • Borrow
        • Get Borrow History
        • Repay
        • Get Repay History
        • Get Interest History
        • Modify Leverage
      • Credit
        • Get Loan Market
        • Get Loan Market Interest Rate
        • Purchase
        • Modify Purchase
        • Get Purchase Orders
        • Redeem
        • Get Redeem Orders
      • Risk Limit
        • Get Margin Risk Limit
    • Futures Trading
      • Introduction
      • Market Data
        • Get Symbol
        • Get All Symbols
        • Get Ticker
        • Get All Tickers
        • Get Full OrderBook
        • Get Part OrderBook
        • Get Trade History
        • Get Klines
        • Get Mark Price
        • Get Spot Index Price
        • Get Interest Rate Index
        • Get Premium Index
        • Get 24hr stats
        • Get Server Time
        • Get Service Status
      • Orders
        • Add Order
        • Add Order Test
        • Batch Add Orders
        • Add Take Profit And Stop Loss Order
        • Cancel Order By OrderId
        • Cancel Order By ClientOid
        • Batch Cancel Orders
        • Cancel All Orders
        • Cancel All Stop orders
        • Get Order By OrderId
        • Get Order By ClientOid
        • Get Order List
        • Get Recent Closed Orders
        • Get Stop Order List
        • Get Open Order Value
        • Get Recent Trade History
        • Get Trade History
      • Positions
        • Get Margin Mode
        • Switch Margin Mode
        • Batch Switch Margin Mode
        • Get Position Mode
        • Switch Position Mode
        • Get Max Open Size
        • Get Position Details
        • Get Position List
        • Get Positions History
        • Get Max Withdraw Margin
        • Get Cross Margin Leverage
        • Modify Cross Margin Leverage
        • Add Isolated Margin
        • Remove Isolated Margin
        • Get Cross Margin Risk Limit
        • Get Cross Margin Requirement
        • Get Isolated Margin Risk Limit
        • Modify Isolated Margin Risk Limit
      • Funding Fees
        • Get Current Funding Rate
        • Get Public Funding History
        • Get Private Funding History
    • Earn
      • Simple Earn
        • Purchase
        • Get Redeem Preview
        • Redeem
        • Get Savings Products
        • Get Promotion Products
        • Get Staking Products
        • Get KCS Staking Products
        • Get ETH Staking Products
        • Get Account Holding
      • Structured Earn - Dual
        • Structured Product Purchase
        • Get Dual Investment Products
        • Get Structured Product Orders
    • VIP Lending
      • Introduction
      • Get Collateral Ratio
      • Get Loan Info
      • Get Accounts
    • Affiliate
      • Introduction
      • Get Invited
      • Get Commission
      • Get Trade History
      • Get Transaction
      • Get Kumining
    • Broker
      • Introduction
      • Broker Application
      • Instructions
      • Broker Pro
        • Introduction
        • Broker Fast API Service
        • Get Broker Rebate
        • Get Commission
        • Get User List
        • Get User Transactions
      • Exchange Broker
        • Introduction
        • Submit KYC
        • Get KYC Status
        • Get KYC Status List
        • Get Broker Info
        • Add sub-account
        • Get sub-account
        • Add sub-account API
        • Get sub-account API
        • Modify sub-account API
        • Delete sub-account API
        • Transfer
        • Get Transfer History
        • Get Deposit List
        • Get Deposit Detail
        • Get Withdraw Detail
        • Get Broker Rebate
        • Apply for Fast Withdrawal
    • Copy Trading
      • Introduction
      • Add Order
      • Add Order Test
      • Add Take Profit And Stop Loss Order
      • Cancel Order By OrderId
      • Cancel Order By ClientOid
      • Get Max Open Size
      • Get Max Withdraw Margin
      • Add Isolated Margin
      • Remove Isolated Margin
      • Modify Isolated Margin Risk Limit
      • Modify Isolated Margin Auto-Deposit Status
      • Switch Margin Mode
      • Modify Cross Margin Leverage
      • Get Cross Margin Requirement
      • Switch Position Mode
    • Convert
      • Introduction
      • Get Convert Symbol
      • Get Convert Currencies
      • Get Convert Quote
      • Add Convert Order
      • Get Convert Order Detail
      • Get Convert Order History
      • Add Convert Limit Order
      • Get Convert Limit Quote
      • Get Convert Limit Order Detail
      • Get Convert Limit Orders
      • Cancel Convert Limit Order
  • Classic WebSocket
    • Base Info
      • Introduction
      • Get Public Token - Classic Spot/Margin
      • Get Private Token - Classic Spot/Margin
      • Get Public Token - Classic Futures
      • Get Private Token - Classic Futures
    • Spot Trading
      • Public Channels
        • Ticker
        • All Tickers
        • Orderbook - Level 1
        • Orderbook - Level 5
        • Orderbook - Level 50
        • Orderbook - Increment
        • Call Auction Orderbook - Level 50
        • Call Auction Data
        • Klines
        • Trade
        • Symbol Snapshot
        • Market Snapshot
      • Private Channels
        • Order V2
        • Order V1
        • Balance
        • Stop Order
    • Margin Trading
      • Public Channels
        • Index Price
        • Mark Price
      • Private Channels
        • Order V2
        • Order V1
        • Balance
        • Stop Order
        • Cross Margin Position
        • Isolated Margin Position
    • Futures Trading
      • Public Channels
        • Ticker V2
        • Ticker V1
        • Orderbook - Level 5
        • Orderbook - Level 50
        • Orderbook - Increment
        • Klines
        • Trade
        • Instrument
        • Funding Fee Settlement
        • Symbol Snapshot
      • Private Channels
        • Orders
        • Balance
        • Positions
        • Margin Mode
        • Cross Margin Leverage
        • Stop Orders
    • Add/Cancel Order
      • Add Order
      • Cancel Order
  • Web3 Wallet
    • Browser Extension Wallet
  • Error Code
    • HTTP
    • Spot
    • Margin
    • Futures
    • Earn
    • Broker
    • CopyTrading
    • Websocket
    • Pro API
    • UTA API
  • Abandoned Endpoints
    • Introduction
    • Account & Funding
      • Get sub-account List - Summary Info (V1)
      • Get sub-account List - Spot Balance (V1)
      • Get Deposit Addresses (V2)
      • Get Deposit Addresses - V1
      • Sub-account Transfer
      • Get Deposit History - Old
      • Internal Transfer
      • Get Futures Account Transfer Out Ledger
      • Get Withdrawal History - Old
      • Futures Account Transfer Out
      • Futures Account Transfer In
      • Add Deposit Address - V1
      • Withdraw - V1
    • Spot Trading
      • Orders
        • Add Order - Old
        • Add Order Test - Old
        • Batch Add Orders - Old
        • Cancel Order By OrderId - Old
        • Cancel Order By ClientOid - Old
        • Batch Cancel Order - Old
        • Get Orders List - Old
        • Get Recent Orders List - Old
        • Get Order By OrderId - Old
        • Get Order By ClientOid - Old
        • Get Trade History - Old
        • Get Recent Trade History - Old
    • Margin Trading
      • Get ETF Info
      • Get Account Detail - Margin
      • Add Order - V1
      • Add Order Test - V1
      • Get Account List - Isolated Margin - V1
      • Get Account Detail - Isolated Margin - V1
    • Futures Trading
      • Modify Isolated Margin Auto - Deposit Status
      • Cancel All Orders - V1
      • Get Position Details - V1
    • Affiliate
      • Get Account
    • Broker
      • Broker Pro
        • Get Broker Rebate
    • PRO REST
      • Get Cross Margin Config
      • Batch Place Order (Classic)
      • Set DCP (Classic)
      • Get DCP (Classic)
      • Get Account Position Tiers
    • Pro Websocket
      • Execution
  • Developing
    • Introduction
  1. Error Code

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:50:58
Previous
Pro API
Next
Introduction