API Reference

Error Codes

List of error codes

ERROR CODE

HTTP Status Code

ERROR MESSAGE

DESCRIPTION

200

200

Success request

0000

200

success

Success request

0001

400

Required field '%s' missing or invalid

Required field '%s' missing or invalid. E.g. Required field quantity missing or invalid

0001

400

Incorrect signature

The server is not able to valid your signature request. Please check your signature whether it have the correct signing.

0003

400

Rate limit exceeded

Rate limit exceed per configuration. Please manage the number of your request

0102

400

Invalid APIKey

There was an issue validating your API Key permission. Please check your API Key permission

0103

400

APIKey expired

API-key has expired. Please login to Account management console to renew the API key

0104

400

accountId is not allowed

The accountId defined is not permissible

0201

400

Instrument not found

The instrument defined cannot be located

0202

400

Invalid IP

Our server detected the IP addresses submitted for the API request does not match API key whitelisted IP address

0206

400

Unsupported order type

Invalid order type being sent to the server

0207

400

Invalid price

Invalid price being sent to the server

0209

400

Invalid price precision

The precision price is over the maximum allowed for this asset

0210

400

Price outside of allowed range

Price of the order below minPrice or exceeds maxPrice range. Please check exchangeInfo

0211

400

Order not found

Our server not able to locate the orderId defined

0401

400

Insufficient asset

There is insufficient balance to submit the order

-1000

400

An unknown error occurred while processing the request

An issue generated by our server

-1001

400

Internal error

Unable to process your request. Please try again

-1002

400

Unauthorized operation

Server is not able to validate your API Key. Please ensure you have the valid API Key to the corresponding environment

-1004

400

Bad request

There was an issue with to process your request. Please check your parameters or values are valid

-1005

400

No permission

It appears there is insufficient trading permission. Please check your permission

-1006

400

Execution status unknown

An unexpected response was received from the message bus

-1007

400

Timeout waiting for response from server

Timeout waiting for response from backend server. Send status unknown; execution status unknown

-1014

400

Unsupported order combination

The order combination specified is not supported

-1015

400

Too many new orders, current limit is %s orders per %s

Reach the rate limit .Please slow down your request speed.
Too many new orders.

-1020

400

Unsupported operation

User operation is not supported

-1021

400

Timestamp for this request is outside of the recvWindow

Timestamp for this request was 1000ms ahead of the server's time.

Please check the difference between your local time and server time

-1024

400

Duplicate request

Duplicate request received

-1101

400

Feature has been offline

Feature has been offline, please check with API team for further details

-1115

400

Invalid timeInForce

Invalid time in force being sent

-1117

400

Invalid order side

Invalid side being sent

-1123

400

Invalid client order id

Invalid client order ID being sent

-1124

400

Invalid price

Invalid price being sent

-1126

400

Invalid quantity

Invalid quantity being sent

-1129

400

Invalid parameters, quantity and amount are not allowed to be sent at the same time.

The combination of quantity and amount is not allowed to be submitted at the same time

-1130

400

Illegal parameter '%s'

Invalid data sent for a parameter. E.g. "Illegal parameter 'symbol'"

-1132

400

Order price greater than the maximum

Order price exceeds maxPrice. Check ExchangeInfo

-1133

400

Order price lower than the minimum

Order price below the threshold minPrice. Check ExchangeInfo

-1135

400

Order quantity greater than the maximum

Order quantity exceeds the maxQty. Check ExchangeInfo

-1136

400

Order quantity lower than the minimum

Order quantity below threshold minQty. Check ExchangeInfo

-1137

400

Order quantity precision too large

Order quantity precision is too large

-1139

400

Order has been filled

Unable to fulfill request as order has been filled

-1140

400

Order amount lower than the minimum

The transaction amount is below the threshold minAmount. Check ExchangeInfo

-1141

400

Duplicate order

The server have detected an existing clientOrderId sent before

-1142

400

Order has been cancelled

Unable to fulfill rquest as order has been canceled

-1143

400

Order not found on order book

Unable to locate orderbook

-1144

400

Order has been locked

Order has been locked

-1145

400

Cancellation on this order type not supported

This order type does not support cancellation

-1146

400

Order creation timeout

Not able to create the order and timed out

-1147

400

Order cancellation timeout

Not able to cancel the order and timed out

-1148

400

Order amount precision too large

Market Cash Amount precision is too long

-1149

400

Order creation failed

Order creation failed

-1150

400

Order cancellation failed

Order cancellation failed

-1151

400

The trading pair is not open yet

The trading is not yet listed for trading

-1152

400

User does not exist

Unable to find user

-1153

400

Invalid price type

Invalid price type being sent

-1154

400

Invalid position side

Invalid side being sent

-1155

400

The trading pair is not available for api trading

API trading is suspended for API trading

-1156

400

Limit maker order rejected: Improper price may cause immediate fill.

Creation of limit maker order failed as the order execute immediately.For HashKey Global only.

-1160

400

Account does not exist

Account does not exist

-1161

400

Balance transfer failed

Transfer internal funds failed

-1162

400

Unsupport contract address

Contract address submitted is not valid

-1163

400

Illegal withdrawal address

Withdraw address is not valid

-1164

400

Withdraw failed

Withdraw failed, check if the withdrawal amount meets the minimum withdrawal amount

-1165

400

Withdrawal amount cannot be null

Withdrawal amount needs to be more than 0

-1166

400

Withdrawal amount exceeds the daily limit

Withdrawal amount exceeded the daily limit allowed

-1167

400

Withdrawal amount less than the minimum

Withdrawal amount less than the min withdraw amount limit

-1168

400

Illegal withdrawal amount

Withdrawal amount characters are not valid

-1169

400

Withdraw not allowed

Withdrawal is currently suspended

-1170

400

Deposit not allowed

Deposit is currently suspended

-1171

400

Withdrawal address not in whitelist

Withdrawal address has not yet been whitelisted

-1172

400

Invalid from account id

The fromAccountId is invalid

-1173

400

Invalid to account id

The toAccountId is invalid

-1174

400

Transfer not allowed between the same account

The fromAccount should not be equal toAccount

-1175

400

Invalid fiat deposit status

The fiat deposit status submitted is invalid

-1176

400

Invalid fiat withdrawal status

The fiat withdrawal status submitted is invalid

-1177

400

Invalid fiat order type

The fiat order type submitted is invalid

-1182

400

The newly whitelisted withdrawal address will take effect in 30 min. Please try it later.

The newly whitelisted withdrawal address will take effect after a certain time period for the sake of safety. During the mean time, the address is not available

-1193

400

Order creation count exceeds the limit

Order count have exceeded the amount allowed

-1194

400

Market order creation forbidden

Creation of market order is forbidden

-1200

400

Order buy quantity too small

Buy limit quantity below the threshold minQty. Check ExchangeInfo

-1201

400

Order buy quantity too large

Buy limit quantity exceeds maxQty. Check ExchangeInfo

-1202

400

Order sell quantity too small

Sell limit quantity below the threshold minQty. Check ExchangeInfo

-1203

400

Order sell quantity too large

Sell limit quantity exceeds the maxQty. Check ExchangeInfo

-1204

400

From account must be a main account

Transfer fromAccountId needs to be a main account

-1205

400

Account not authorized

Account is not authorised

-1206

400

Order amount greater than the maximum

The transaction amount is below the threshold maxAmount. Check ExchangeInfo

-1207

400

The status of deposit is invalid

The status of deposit submitted is invalid

-1208

400

The orderType of fiat is invalid

The status of orderType is not valid

-1209

400

The status of withdraw is invalid

The status of withdraw is not valid

-2010

400

Limit maker order rejected: Improper price may cause immediate fill.

New order request was rejected. Usually this is due to new LIMIT_MAKER order not able to be maker, our system will auto reject the order For HashKey Hong Kong only

-2011

400

Order cancellation rejected

Cancel request was rejected

-2016

400

API key creation exceeds the limit

The number of API key created have exceeded the limit

-2017

400

Open orders exceeds the limit of the trading pair

The number of open orders have exceeded the limit for the trading pair

-2018

400

Trade user creation exceeds the limit

The number of trade user created have exceeded the limit

-2019

400

Trader and omnibus user not allowed to login app

The trader and omnibus user is not allowed to login to the app

-2020

400

Not allowed to trade this trading pair

The

-2021

400

Not allowed to trade this trading pair

-2022

400

Order batch size exceeds the limit

The number of orders in batchOrders request exceeds its limit

-2023

400

Need to pass KYC verification

Need to pass KYC verification in order to use API trading

-2024

400

Fiat account does not exist

Fiat account ID defined does not exist

-2025

400

Custody account not exist

Custody account ID defined does not exist

-2026

400

Invalid type

The type defined is invalid

-2027

400

Exceed maximum time range of 30 days

The startTime and endTime defined for Fund statement request exceeds the 30 days limit

-3117

400

Invalid permission

Invalid permission is detected. E.g. APIKey does not have the accountID permission to query the balance of the account

-3143

400

Currently, your trading account has exceeded its limit and is temporarily unable to perform trades

The trading account have exceeds its limit capacity. We have temporarily suspended your trading

-3144

400

Currently, your trading account has exceeded its limit and is temporarily unable to perform transfers

The trading account have exceeds its limit capacity. We have temporarily suspended your transfer

-3145

400

Please DO NOT submit request too frequently

We have detected the rate of your API request have been submitted too frequently. Please manage your API request.

-4001

400

Invalid asset

The asset specified is invalid

-4002

400

Withdrawal amount less than the minimum withdrawal amount

The withdrawal amount submitted is less than the minimum amount

-4003

400

Insufficient Balance

There was insufficient balance for the asset you are trying to withdraw

-4004

400

Invalid bank account number

The bank account has not been whitelisted yet

-4006

400

Kyc is not certified

The user has not passed KYC

-4007

400

Withdrawal channels are not supported

The withdrawal channel is not yet supported via API

-4008

400

This currency does not support this customer type

The currency is not supported for the client type

-4009

400

No withdrawal permission

The API Key do not have withdrawal permission

-4010

400

Withdrawals on the same day exceed the maximum limit for a single day

The withdrawal request exceeds the daily maximum limit

-4011

400

System error

The system has an internal error. Please contact our API Team

-4012

400

Parameter error

The parameter entered was invalid

-4013

400

Withdraw repeatedly

The withdrawal has been submitted multiple times. Please wait and try again