KUCOIN API
HomeChange LogAPI DOC V2
Language
  • 繁體中文
HomeChange LogAPI DOC V2
Language
  • 繁體中文
SDK
Telegram
Kucoin
  1. Error Code
  • Introduction
  • Authentication
  • Enums Definitions
  • Terms Definitions
  • SDK
  • OpenClaw
  • Rate Limit Rule (UTA)
  • Rate Limit Rule (Classic)
  • Change Log
  • User Service
    • Market Making Incentive Scheme
    • VIP Fast Track
    • Broker Program
  • UTA REST V2
    • Introduction
    • Market Data
      • Get Announcements
      • Get Currency
      • Get Currencies
      • Get Ticker
      • Get Symbol
      • Get Klines
      • Get OrderBook
      • Get Index Price
      • Get Trades
      • Get Position Tiers
      • Get Collateral Ratio
      • Get Borrowable Currencies
      • Get Current Funding Rate
      • Get History Funding Rate
      • Get Futures Open Interest
      • Get Interest Rate Index
      • Get Max Order Quantity
      • Platform 24h Market Statistics
      • Get Call Auction Info
      • Get Fiat Price
      • Get Third-Party Custody Currencies
      • Get Service Status
      • Get KYC Regions
      • Get Client IP Address
    • Account Info
      • Account & Funding
        • Get Account Overview (UTA)
        • Get Account Currency Assets (UTA)
        • Get Account Currency Assets (Classic)
        • Get Apikey Info
        • Get Account Mode
        • Set Account Mode
        • Get Leverage (UTA)
        • Modify Futures Leverage (UTA)
        • Modify Cross Margin Leverage (UTA)
        • Get Borrowing Rates and Limits
        • Get Account Ledger
        • Get Interest History (UTA)
        • Get API Rate Limit
        • Get All API Rate Limit
        • Get API Rate Limit Cap
        • Get Fee Rate
        • KCS Fee Deduction Management
        • Get Third-Party Custody Account Currency Limits
      • Sub Account
        • Get Sub Account Currency Assets
        • Get Sub Account List
        • Get Sub Account API List
        • Set Sub Account Transfer Permission
        • Add Sub Account
        • Add Sub Account API
        • Modify Sub Account API
        • Set Sub Accounts API Rate Limit
        • Delete Sub Account API
      • Deposit
        • Get Deposit Address
        • Get Deposit History
      • Transfer
        • Get Transfer Quotas
        • Flex Transfer
      • Withdraw
        • Get Withdrawal Quotas
        • Get Withdrawal History
        • Withdraw
        • Cancel Withdrawal
    • Orders
      • Place Order
      • Amend 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
      • Get Positions History
      • Get Private Funding Fee History
      • Modify Margin Mode
      • Modify Position Margin
      • Get Margin Mode
    • VIP Lending
      • Get Collateral Ratio
      • Get Loan Info
      • Get Accounts
  • UTA WebSocket V2
    • Introduction
    • Public Channels
      • Ticker
      • Kline
      • Trade
      • Orderbook
      • Mark Price
      • Funding Fee Rate
      • All Funding Fee Rates
      • Call Auction Data
    • Private Channels
      • Execution
      • Execution Lite
      • Order
      • Balance
      • Position
      • LiquidationWarning
      • Leverage
    • Trade
      • Add Order
      • Cancel Order
      • Amend 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
        • Apply for Fast Withdrawal
        • Get Broker Rebate
        • Get Commission
        • Get User List
        • Get User Transactions
      • Exchange Broker
        • Introduction
        • Get Broker Rebate
        • Get Broker RebateV3
        • 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
        • Set Markup Fee
        • Get Markup Fee
    • 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
    • UTA API V2
    • UTA API V1
    • Pro API
    • Classic
      • HTTP
      • Spot
      • Margin
      • Futures
      • Earn
      • Broker
      • CopyTrading
      • Websocket
  • Abandoned Endpoints
    • Introduction
    • 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
        • Get Interest Rate Index
        • Platform 24h Market Statistics
        • Get max order quantity
        • Get Call Auction Info
      • 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 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 List
        • Get sub-account API List
        • Add sub-account API
        • Modify sub-account API
        • Delete sub-account API
        • Get Deposit Address
        • Get Deposit History
        • Get Withdrawal Quotas
        • Withdraw
        • Cancel Withdrawal
        • Get Withdrawal History
        • KCS Fee Deduction Management
        • Get API Rate Limit Cap
        • Set Sub Accounts API Rate Limit
        • Get API Rate Limit
        • Get All API Rate Limit
      • Orders
        • Place Order
        • Amend 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 Position 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
      • Private Channels
        • Order
        • Balance
        • Execution
        • Execution Lite
        • Position
        • Leverage
        • LiquidationWarning
      • Public Channels
        • Kline
        • Ticker
        • Orderbook
        • Call Auction Data
        • Trade
        • Funding Fee
        • Mark Price
      • Manage Order
        • Add Order
        • Cancel Order
        • Amend Order
    • PRO REST
      • Get Cross Margin Config
      • Batch Place Order (Classic)
      • Set DCP (Classic)
      • Get DCP (Classic)
      • Get Account Position Tiers
    • Classic
      • Account & Funding
        • Get Deposit Addresses (V2)
        • Get Deposit Addresses - V1
        • Add Deposit Address - V1
        • Get sub-account List - Summary Info (V1)
        • Get sub-account List - Spot Balance (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
        • 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
  • Developing
    • Introduction
    • Unified API
      • Get Account Asset Valuation
      • Withdrawal
      • Cancel Withdrawal
      • Get Transfer History
  1. Error Code

UTA API V2

Every error response returns a code and a message. Codes are grouped by business module; within each module they are listed in ascending order. Values shown in braces, such as {symbol}, are replaced at runtime. The legacy code column lists the pre-migration code(s) that map to the current code; -- means no legacy code exists.

Contents#

General
System
VIP Lending
Account & Balance
Position & Leverage
Order
Gateway & Authentication
Spot & Margin Trading
Market Data
Futures
Assets
Earn
User
Fee

General#

codemessagelegacy code
400Bad request.400
401Token is required / invalid / expired.401
403No permission.403
404Not found.404
406Param is required.406
415Not support.415
429Active connection exceed limit.429
500System error.500
509Exceed limit.509

System#

codemessagelegacy code
100010System error.100001
100030System error.100003
100040System error.100004
100050System error.100005
100060System error.100006
100070System error.100007
200000Success.200000

VIP Lending#

codemessagelegacy code
103000Parameter error.603000
103070System error.603007
160305System error.603005
166114The existing account is not a unified account.415000
166115System busy. Please try again later.0
166116Not yet enabled VIP lending service yet.130001
166117Loans inactive/pending.130000
166601Please upgrade to Unified Account mode before retrying.606001
166607User loan not found.606007
166616Leverage adjustment is not allowed for this user.606016
166617Leverage adjustment blocked. Insufficient margin after change.606017
166618Leverage adjustment blocked. Borrowing limit would be exceeded.606018

Account & Balance#

codemessagelegacy code
104010Parameter error.104401
104030Business error.104403
104060User not found.104406
109000User not found.109000
109990System error.109099
110405Currency not found.104405
110424When switching to custom mode, please provide "ccyList".104424
110425The number of collateral assets exceeds the limit. Please adjust and try again.104425
110426The ccyList parameter is not supported when switching to all mode.104426
110427Your account status does not support adjusting collateral.104427
114418The current currency cannot be removed from the collateral list.104418
116355Insufficient funds.106355
116365Invalid leverage: limit exceeded.106365
163520Please upgrade to Unified Account mode before retrying.106352
170901Invalid account type.109001
170902Invalid activation status.109002
170903Illegal activation status.109003
170904Requirements not met to switch accounts.109004
170905Your account status is currently restricted. Unable to switch account modes at this time.109005
170906Failed to switch to Unified Account mode.109006
170907Account switch error.109007
170911Switch check failed.109011
170912Account type not supported.109012
170913Account switch error.109013
170915Please complete the quiz on your master account before activating your Unified Account.109015
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.109016

Position & Leverage#

codemessagelegacy code
110010User is not logged in.110201
110030Business error.110003
111003Account not found.110203
111004Contract not found.110204
111005Invalid pageSize.110205
111006Invalid pageNumber.110206
111008Leverage cannot be less than 0.01.110208
111009Leverage cannot be greater than {maxLeverage}.110209
116301User's risk ratio exceeded the threshold.106301
116303Not a futures trading pair.106303
116307Insufficient available margin.106307
116400Trading pair is not a futures contract.406000
116401Invalid position.406001
116403Trading pair not found.406003
116412The isolated position is being liquidated. Try again later.406012
163000Please upgrade to Unified Account mode before retrying.106300

Order#

codemessagelegacy code
110100User does not exist.110100
110101The cancelOrderList cannot be empty.110101
110102Maximum cancelable quantity: {maxQuantity}.110102
110103The orderId parameter does not exist.110103
110104The clientOid parameter cannot be empty.110104
110105Invalid contract.110105
110106The iceberg and hidden parameters cannot both be set to true.110106
110107Please specify one of the following order units: qty (coin), size (contract), or valueQty (value quantity).110107
110108Post-only cannot be used with hidden orders.110108
110109Post-only orders cannot be iceberg orders.110109
110110For inverse futures, sizeUnit must be UNIT.110110
110111Stop-loss trigger price is required.110111
110112The timeInForce parameter is invalid.110112
110113Take-profit trigger price is required.110113
110114Invalid trigger price.110114
110115Trigger price is required.110115
110116UID cannot be empty.110116
110117User ID cannot be empty.110117
110118System error.110118
110120Site type does not exist.110120
110121User not found for closing the position.110121
110122The order channel is invalid.110122
110123clientOid must be ASCII characters.110123
110124Invalid amount step size.110124
110125The amount exceeds the allowed limit.110125
110126The amount is below the minimum requirement.110126
110127The orderId parameter is invalid.110127
110128Parameter {parameter} is not allowed in the request.110128
110129Price parameter is not allowed in market order requests.110129
110130The quantity exceeds the allowed limit.110130
110131The sizeUnit does not exist.110131
110132The sizeUnit field is not allowed in spot trading.110132
110133The trading pair cannot be empty.110133
110134The tradeSource does not exist.110134
110135Invalid site type.110135
110136The takerFeeRate parameter is invalid.110136
110137The specified counterparty order ID is invalid.110137
110138Trigger price does not meet the tick size.110138
110139Iceberg visible amount cannot exceed total order amount.110139
110140Invalid trade direction.110140
110141The order type is invalid.110141
110142Only limit orders can be created.110142
110143Invalid visibleSize tick size.110143
110144Take-profit trigger price does not meet the tick size.110144
110145The tags parameter is invalid.110145
110146Stop-loss trigger price does not meet the tick size.110146
110147Contract has expired.110147
110148The visible size is below the minimum requirement.110148
110149The visible size must be greater than 0.110149
110150The timeInForce parameter is invalid.110150
110151Tags can only contain ASCII characters.110151
110152The self-trade protection is invalid.110152
110153Invalid quantity step size.110153
110154The price cannot be empty.110154
110155Invalid order price.110155
110156Invalid price tick size.110156
110157Post-only cannot be used with iceberg or hidden orders.110157
110158Fee currency Invalid.110158
110159Provide either the quantity or the amount.110159
110160The cancellation time has exceeded the limit.110160
110161The cancel time is invalid.110161
110162The current order type does not support the tpTriggerPriceType parameter.110162
110163The current order type does not support the tpTriggerPrice parameter.110163
110164The current order type does not support the tpOrderPrice parameter.110164
110165The current order type does not support the slTriggerPriceType parameter.110165
110166The current order type does not support the slTriggerPrice parameter.110166
110167The current order type does not support the slOrderPrice parameter.110167
110168Invalid order amount range.110168
110169This order is not an iceberg order. The visibleSize field is invalid.110169
110170The clientOid parameter too long.110170
110171Market orders can't be iceberg orders.110171
110172Invalid leverage.110172
110173The force-hold tag cannot be used with close orders.110173
110174Reduce Only and Force Hold cannot be enabled at the same time.110174
110175The visible size cannot be empty.110175
110176The quantity is invalid.110176
110177Please provide the orderId or clientOid to cancel the order.110177
110178Provide the orderId or clientOid to search for.110178
110179Order not found.110179
110180Order quantity is required.110180
110181The cancelAfter parameter can only be used when timeInForce is set to GTT (Good Till Time).110181
110182The quantity or amount cannot be empty.110182
110183The order amount is invalid.110183
110184The quantity is below the minimum requirement.110184
110186Take-profit trigger price cannot be higher than the maximum limit price.110186
110201Invalid input parameter.102001
112005End time must be later than start time.102005
112011Invalid trading pair.102011
116050Order cancellation in progress.106050
116052Order not found.106052
116053Specified trading pair is currently unavailable for trading.106053
116054Order trading pair mismatch.106054
116055Matching topic for this contract not found in the system.106055
116101Order ID not found.106101
116102Client order ID not found.106102
116104Please upgrade to Unified Account mode before retrying.106104
116150Insufficient available margin.106150
116151Client order ID already exists.106151
116152Order ID already exists.106152
116182No positions available to close/reduce.106182
116183Failed to obtain leverage settings.106183
116190Trading pair not found.106190
116193Currency not found.106193
116194This trading pair is currently unavailable for trading.106194
116204Internal system error.106204
116206The number of active orders exceeds the limit.106206
116207User's risk ratio exceeded the limit.106207
116208Trading suspended for this user.106208
116209This system order has already been processed (idempotent).106209
116210Failed to cancel advanced order.106210
116213Trading is unavailable for your accounts within the VIP lending risk unit.106213
116215The platform's quota has been reached. Unable to place new orders.106215
116216No index price is available for this trading pair.106216
116217Maximum risk limit exceeded.106217
116218The margin mode does not match the current setting.106218
116219Failed to place the reduce-only order. Cancel existing close orders for this contract and try again.106219
116220No matching orders in the specified price range.106220

Gateway & Authentication#

codemessagelegacy code
111201Request timeout.112001
111208Failed to encode request via gateway.112008
111209Network busy.112009
111210User not found.112010
111212Unknown risk ID.112012
111225Failed to parse parameter.112025
111226Route not found. Please check and try again.112026
400000Bad request. Need to send the request with GET / POST (must be capitalized).400000
400001One or more required API authentication headers are missing.400001
400002The request timestamp is invalid or expired.400002
400003The API key does not exist or site mismatch.400003
400004The API passphrase is invalid.400004
400005The request signature is invalid.400005
400006The request IP address is not on the whitelist.400006
400007The API key does not have permission to access this resource.400007
400008API key version 1 is disabled.400008
400009The API key version is invalid.400009
400200The API partner does not exist.400200
400201The API partner signature is invalid.400201
400202KC-API-PARTNER IP is not on the whitelist.400202
400301The user is restricted from accessing this resource.400301
400302Access from this IP address or region is restricted.400302
400303The account is restricted due to KYC requirements.400303
400304The sub-account is restricted due to KYC requirements.400304
400400The authentication token is invalid.400400
400402The site type is invalid.400402
400403Account function temporarily restricted for security reasons. Contact client services for support.280001
404000The requested resource does not exist.404000
405000The request method is not allowed.405000
411100Account function temporarily restricted for security reasons. Contact client services for support.411100
411200The user is on the blacklist.411200
411400Sub account has no permission to visit the resource.411400
415000The media type is not supported.415000
420000The CDN site type is invalid.420000
429000Too many requests. Rate limit exceeded.429000
500000Server busy. Please try again later.500000
502000Bad gateway.502000
503000The service is temporarily unavailable. Please try again later.503000
504000Gateway timeout.504000

Spot & Margin Trading#

codemessagelegacy code
130100This action couldn't be completed due to local laws and regulations in your country/region.301100
130101Sorry, based on your IP address, we are currently unable to provide services in your country or region due to local laws and regulations. We apologize for any inconvenience this may cause. For assistance, please contact customer support.301101
130102For full access to our products and services, please complete Identity Verification.301102
130103For full access to our products and services, please log in to your master account and complete Identity Verification.301103
130105Placing orders is unavailable.301105
130106Request failed. Trading pair {symbol} is unavailable.301106
130114Only limit orders are supported before {time} (UTC+8).301114
130115Order price cannot be higher than the maximum price.301115
130116Order price cannot be lower than the minimum price.301116
130117Unfortunately, trading is currently unavailable in your location due to country, region, or IP restrictions.301117
130118Orders cannot be canceled during the second phase of a call auction.301118
130119Only limit orders are allowed during the call auction phase.301119
130120The order price must be between {minPrice} and {maxPrice} during the call auction phase.301120
130121Orders cannot be canceled during Phase 3 of a call auction.301121
130122Orders cannot be placed during the third phase of a call auction.301122
130123Placing auction orders is not allowed.301123
130124User not authorized.301124
130126The order amount must be at least {minAmount}.301126
130128Trading pair is unavailable.301128
130129Failed to obtain market price.301129
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.600000
130132This product is not available to certain users under Indian tax law. You may still use other KuCoin products that do not involve TDS.600005
130133Sorry, this asset is not available in your country or region.301133
130137STP (Self-Trade Prevention) is not supported in call auctions.301137
130138Post-only and hidden orders are not supported in call auctions.301138
130139RWA trading terms not signed. Go to the latest app and complete the signing by tapping Trade.301139
130140User spot trading status is invalid.301140
130141User margin trading status is invalid.301141
130142Sub-account trading permission is invalid.301142
130143Cross margin trading is not enabled for your Unified Account. Please contact your account manager to enable it.301143
130146The TIF (Time in Force) parameter is not supported during call auctions.301146
130147Conditional orders are not supported during call auctions.301147
130148The current "tradeType" value is not supported during call auctions.301148

Market Data#

codemessagelegacy code
138001Missing required parameters:symbol.410001
138002Incorrect query type, No Found.404000
138003Incorrect candlestick type.400100
138004Unsupported trading pair.400100
138005Missing required parameters:symbol.410001
138006Exceeded the time range, please try again.400100
138007Currencies should not be greater than 10.230006
138008startAt must be less than endAt.230006
138009Invalid time range.230006
138010Currency does not exist.2300034
148000This contract does not exist.404 / 200000 / 200003
148001Funding rate of this contract is not supported.415
148002The parameter 'limit' can not support.4001
148003Parameter 'symbol' can't be empty.300000
148004Parameter 'startAt' is invalid.--
148005Parameter 'endAt' is invalid.--
148006Parameter 'lastId' is invalid.--
148007Parameter 'pageSize' is invalid.--
148008Parameter 'sortOrder' is invalid.--
148009Unsupported interval.--
148010Exceeded the time range, please try again.--
148011Server busy, please retry later.500
148012The query time cannot exceed the current time.--
148013The userId parameter cannot be blank.--
148014Invalid direction. Supported values are in and out.--
148015Invalid businessType. The specified value is not in the list of valid fund flow types.--
148016The start time cannot be later than the end time.--
148017The query time range cannot exceed 1 day (86400000 milliseconds).--
148018Service call failed. Please try again later.--
148019Failed to retrieve the account overview. Please try again later.--
148020User does not exist.230008
148021The requested currency is not a valid futures settlement currency.230006
148022Failed to retrieve the futures settlement currency list. Please try again later.0000000
148023Multiple symbols are not supported when querying historical open interest (OI).--
148024Symbol supports up to 10 unique symbols, when querying real-time OI.--
148025Parameter 'startAt' is invalid. Must be seconds.--
148026Parameter 'endAt' is invalid. Must be seconds.--
148027Parameter 'productType' is invalid, please check.--
148028Parameter 'interval' is invalid.--
148029The query time range cannot exceed 90 days.300000
148030Parameter 'maxCount' cannot exceed 1500.--
148031Failed to query all tickers.200000
148032Failed to query all tickers: {message}.--
148033Failed to query the ticker for {symbol}.--
148034Failed to query the ticker for {symbol}: {message}.--

Futures#

codemessagelegacy code
140001User futures status is invalid.401001
140002Isolated margin futures is not enabled for your Unified Account. Please contact your account manager to enable it.401002
140100Contract does not exist.401100
140101Cannot place a market order due to no opposite-side liquidity in the order book.401101
140102Order price cannot be higher than {maxPrice}.401102
140103Order price is lower than the minimum limit price.401103
140106Service is unavailable in your region due to local regulations. Orders cannot be placed.401106
140108Only close orders are allowed.401108
140110Invalid margin mode.401110
140111The current contract is set to reduce-only. Please place a reduce-only order.401111
140112Mark price does not exist.401112
140116Invalid trigger price type.401116
140121Invalid trigger price.401121
140123Invalid take-profit trigger type.401123
140124Take-profit price does not exist.401124
140126Invalid stop-loss trigger type.401126
140127Stop-loss price does not exist.401127
140130RPI orders only support limit orders.401130
140132RPI orders do not support advanced order types (stop, STP, etc.).401132
140133This contract does not support RPI orders.401133
140134You are not authorized to place RPI orders.401134
140136Trading of stock index perpetual contracts is unavailable in your region.401136
140140BBO orders do not support the specified order type or parameters.401140
140162No valid parameters (price, size).400462

Assets#

codemessagelegacy code
330000An internal server error occurred. Please try again later.190003 / 0000000
330001Invalid request parameter(s). Please check your input and try again.4001 / 190000 / 230006 / 300000
330002The request failed due to a business rule violation.100000 / 200000 / 900105
330003Too many requests. Please slow down and try again.110001 / 200002
330004The requested record does not exist.26001
330005This operation is not permitted under your current account status.26002
330006KYC verification is required to complete this operation.260348
330007Access denied. Your IP address is not permitted to perform this operation.260349
330008This operation is not available in your region.190002 / 260361
330010An unexpected error occurred. Please try again or contact support.--
330011The service is temporarily unavailable. Please try again later.503 / 230005 / 230032 / 230109 / 260367
330012A maximum of 50 UIDs can be queried per request.330012
330013The specified UID does not belong to your sub-accounts.330013
330014subUserIds cannot be empty.330014
330016The account type is not supported. Please use a valid account type.112019
330017The account tag is not supported. Please check the account tag and try again.230031
330018A maximum of 20 currencys can be queried per request.330018
330022Currency does not exist.230102
330023User not found.230103 / 330023
330051The account is being upgraded. Please try again later.112018
331000Internal transfer orders cannot be cancelled.260360
331001Lightning Network withdrawals cannot be cancelled.260359
331003Withdrawal is not available for your account.260354
331004Withdrawal verification failed. Please check your account settings and try again.26000
331005You cannot transfer funds to your own account.260338
331006Your account is currently unavailable for this operation.260336
331007This operation is not supported for sub-accounts.260337
331008Withdrawals are currently disabled. Please try again later.26021
331009A memo/tag is required for this address. Please select the address from your address book.260335
331010The recipient account does not accept transfers at this time.260330
331011Deposits for this currency are currently disabled.26020
331012Spot account withdrawals are not supported for accounts with active loans.260346
331013Cross-site transfers are currently disabled for your account.260397
331014The specified address was not found in your address book.260344
331015This address is not in your whitelist. Please add it as a trusted address first.260325
331016Withdrawal security verification is required. Please complete the verification and try again.260363
331017Unable to retrieve the exchange rate. Please try again later.260408
331018The withdrawal amount exceeds the maximum allowed precision.26030
331019The deposit address is invalid.26031
331020New withdrawal addresses cannot be used within 24 hours of being added.260407
331021Withdrawals on this blockchain are temporarily unavailable. Please try again later.260399
331022Insufficient withdrawal quota for this currency.260406
331023The withdrawal amount exceeds the maximum limit per transaction.260358
331024You have reached the maximum number of on-chain withdrawals allowed.260388
331025The specified blockchain is invalid or not supported.260324 / 900015
331026A memo is required for this withdrawal address.260351
331027This withdrawal address has been disabled via the API.260326
331028This withdrawal is not permitted due to compliance requirements.260366
331029You need to bind more factors to continue this operation, please visit the following link:260420
331030Validation factors verification failed.260421
331031Withdraw param check failed, possible param falsify.260362
331032The withdrawal quota is insufficient or unavailable. Please check your withdrawal limit and try again.260347
331033The withdrawal request cannot be processed. Please try again later.260368
331034This currency only supports external fee deduction. Please ensure sufficient balance in your funding account.260339
331035Insufficient available balance.260340
331036Insufficient balance. Some of your funds are currently locked.260341
331037Exceeded your 24-hour deposit limit. Please try again later.--
332001The destination account type is not enabled.112022
332002The account type or account tag is not supported for this transfer. Please check the transfer accounts and try again.230030
332003This transfer is not supported. Please check the source and destination accounts and try again.400008
332004The amount precision exceeds the allowed limit.400009
332005The request cannot be processed. Please check your input and try again.112014
332006The request cannot be processed. Please check your input and try again.112015
332007The request cannot be processed. Please check your input and try again.332007
332008The request cannot be processed. Please check your input and try again.332008
332009Insufficient balance.26010 / 230003
332013The request cannot be processed. Please check your input and try again.112023
332014The request cannot be processed. Please check your input and try again.112024
332015The request cannot be processed. Please check your input and try again.112026
332016Transfers into the Unified Account are not supported in the current account mode.112027
332017The source account type is not enabled.112021
333000The specified currency is not supported or does not exist.900003
333001The requested currency and chain combination is not supported.900014
333003This trading pair does not exist.900001
339000The request timed out. Please check the result later or try again.10001
339001Failed to open the position. Please try again later.10100
339002Margin trading is not enabled. Please enable it before using this service.10103 / 210022
339003The margin trading agreement has not been signed. Please sign it with the master account on the app or website before using this service.210052
339004Liquidation is in progress. Please try again later.10105
339005Asset transfer is currently disabled.210033
339006Transfers are currently unavailable because liquidation is in progress. Please try again later.210027
339007Transfers out are currently unavailable because borrowing is in progress.210029
339008Transfers out are currently unavailable because repayment is in progress.210030
339009This trading pair does not support isolated margin.210015
339010Your account permissions are restricted. Please contact customer support.210034

Earn#

codemessagelegacy code
800000Position does not exist.151404
800001Product does not exist.151001
800002Subscription not started.151002
800003Subscription ended.151003
800004Subscription amount is less than the user's minimum subscription quota.151004
800005Subscription amount exceeds the user's maximum subscription quota.151005
800006Product is fully subscribed.151006
800007Only new users can participate in the subscription.151007
800008You currently do not meet the conditions to purchase this product.151008
800009Insufficient balance.151009
800010Quantity precision is incorrect.151010
800011Sorry, the current activity is too popular, please try again later.151011
800012Cannot redeem before the product expires.151016
800013Please cancel your order before redeeming.151017
800014Redemption amount exceeds the redeemable amount.151018
800015Remaining holding quantity is too small to generate income, please redeem all.151019
800016Redeemable quantity is less than the quantity required for penalty interest.151020
800017ETH Staking: This currency is not supported at the moment.151021
800018ETH Staking: Less than the minimum subscription quantity.151022
800019ETH Staking: The product is temporarily sold out, please wait for quota replenishment.151023
800020When redeeming early, the parameter confirmPunishRedeem must be passed in.151024
800021Identity verification invalid.151025
800022This service is currently unavailable in your country or region.151026
800023This service is currently unavailable in your country or region.151027
800024Unsupported account type.151028
801000Product does not exist.500014
801001Sorry, the current activity is too popular, please try again later.500017
801002Insufficient balance.500041

User#

codemessagelegacy code
810001Unauthorized: Please sign in to continue.200000
810002clientUid is required.300000
810003First name is required.300000
810004First name cannot exceed 256 characters.300000
810005Last name is required.300000
810006Last name cannot exceed 128 characters.300000
810007Issuing country is required.300000
810008Document type is required.300000
810009Document number is required.300000
810010Document number cannot exceed 255 characters.300000
810011Date of birth is required.300000
810012Document expiry date is required.300000
810013Selfie photo is required.300000
810014Request can not be null.300000
810015brokerMasterUserId cannot be empty.300000
810016Document front photo is required.300000
810017BVN and NIN IDs can only be used for Nigerian users.300000
810018NID cards are only supported for users from Bangladesh.300000
810019Aadhaar cards can only be used for users in India.300000
810020Available ID types: ID Card, Driving License, Passport, BVN, NIN, National ID, Aadhaar.300000
810021Document back photo is required.200000
810022Country code must follow the standard 2-digit ISO format.200000
810023Sorry, our services aren't available in your country at the moment. Select a different country to try again.200000
810024Invalid clientUid.200000
810025Thailand and Turkey are not supported for this siteType.200000
810026Insufficient permissions to perform this operation.200000
810027Your broker account must pass KYC verification first.200000
810028KYC verification for this UID is in progress, kindly wait for the result.200000
810029KYC cannot be resubmitted: application is either under review or already approved.200000
810030Our service only accepts users aged 18 and above.200000
810031Expired ID documents cannot be used for verification.200000
810032Front photo file size cannot exceed 10 MB.200000
810033Invalid selfie photo.200000
810034Selfie file size cannot exceed 10 MB.200000
810035Invalid document back photo.200000
810036Back photo file size cannot exceed 10 MB.200000
810037Total size of front, back and selfie photos cannot exceed 20 MB.200000
810038File upload failed, please try again.200000
810039Each uploaded photo cannot exceed 10 MB.300000
810040The uploaded photo is invalid.200000
810041clientUids list must contain 1–100 entries.300000
810042clientUids list cannot be empty.300000
810043pageNumber cannot be less than 1.300000
810044pageSize cannot be less than 1.300000
810045pageSize cannot be greater than 100.300000
810046pageNumber is required.300000
810047pageSize is required.300000
810048Please resubmit your request.1
810049Please resubmit your request.200000
810050The system is overloaded now, please try again later.0
820100Downloading.100001
820101Param error.280006
820102User not exists.400004
820103Broker not exists.400005
820104Cross site operation not allowed.500003
820300Request parameter illegal.400400
830100Sub-account UID must be numeric.300000
830101User does not exist.500112
830102Sub-account does not exist.500112
830103The account is not a master account.500006
830105This feature is not supported on the current site.5000116
830106Invalid permissions.400100
830107The sub-account name already exists.200000
830108The sub-account nickname already exists.200000
830109Invalid sub-account type.200000
830110The maximum number of sub-accounts has been reached.500122
830111This user has been offboarded.500013
830112The master account's trading permissions are frozen.200000
830113Trading permissions are enabled for the master account, but no phone number or Google Authenticator is available under security settings.200000
830114Sub-account request blocked, futures trading is not yet enabled on the master account.200000
830115Sub-account request blocked, margin trading is not yet enabled on the master account.200000
830116Failed to create sub-account.200000
830117Failed to send permission blocklist notification.1004
830118Please log in.401
830119Sub-accounts are not allowed to perform this action.200000
830120KCS Fee Deduction is not available for the current account.200000
830121Internal server error.200000
830199Network error. Please try again later.100010 / 100020 / 100030 / 100040 / 100050 / 100060
830200Request parameter illegal.400100
830201Trading permissions are enabled for the master account, but no phone number or Google Authenticator is available under security settings.200000
830202The sub-account username does not exist, or the sub-account does not belong to this master account.200000
830203The sub-account is frozen.200000
830204Internal server error.500000
830205Insufficient user permissions.500106
830206Whitelist size does not meet the requirements.500010
830207API name length does not meet the requirements.500003
830208Password format is invalid.500005
830209Password length does not meet the requirements.500004
830210API key does not exist or has an abnormal status.404000

Fee#

codemessagelegacy code
860001Request parameter illegal.400100
860002Invalid effective type.600130
860003Invalid trade type.600134
860004Max 5 decimal places allowed.600137
860005subUids cannot be empty.400100
860006Number of uids exceeds the limit.600131
860007Invalid SubUid.400100
860008Provide at least one of the following: taker mark-up fee or maker mark-up fee.600133
860009Too Many Requests.429000
860010Invalid uids.600136
860011Effective time can not be earlier than UTC T+1 0:10:00.600135
860012Taker fee rate cannot be negative.200000
860015Taker fee rate invalid.200000
860016userId cannot be empty.200000
860017symbolCode cannot be empty.200000
860018siteType cannot be empty.200000
860019The futures pair you entered does not exist. Please check and try again.100003
860020tradeType cannot be empty.200000
860021Invalid parameter.100001
860022Application submission failed.300020
860023Taker markup fee and maker markup fee must be set at the same time.400600
860024The taker markup fee cannot be less than the maker markup fee.--
860025The maker markup fee must not exceed the taker markup fee by more than 0.025%.--
860026Markup fee does not exist.--
860027Request parameter illegal.--
860028Symbol invalid.--
860029Exceeded allowed mark-up range.--
860030Invalid fee rate.--
860031Symbol not support.--
860091Internal check error.--
Modified at 2026-08-27 02:26:00
Previous
Browser Extension Wallet
Next
UTA API V1