For information on changes for our US clients, please visit our Support Center article.

API error messages

Introduction

Most API requests are completed successfully, but sometimes things go wrong and an error message is returned instead of the expected response.
Our API provides a variety of descriptive error messages intended to provide the reason for the error and provide suggestions for the appropriate solution.
API error messages can be divided into several different groups (depending upon the type of error, the underlying cause, and the optimal solution), but the format of the API error messages is consistent, and is as follows:
"Severity Level""Error Category":"Error Message"
The "Severity Level" can be either E for an error or W for a warning. The "Error Category" can be one of General, API, Query, Order, Trade, Funding or Service. The "Error Message" can be any text string that describes the reason for the error (such as Invalid arguments).
For example, an error indicating that an invalid currency pair had been used in a ticker query would be as follows:
EQuery:Unknown asset pair
Note that some third party software (mobile apps, trading bots, etc.) choose to hide the original API error and present a customized error instead, hence an alternative error format or content is possible depending upon the software being used.
  • General usage errors
  • Rate limit errors
  • Trading (placing/cancelling orders) errors
  • Funding (deposit/withdrawal) errors
  • Service status errors
  • Internal errors
  • Cloudflare (networking) errors

General usage errors

EGeneral:Permission denied
EAPI:Invalid key
EQuery:Unknown asset pair
EGeneral:Invalid arguments
EAPI:Invalid signature
ESession:Invalid session
EAPI:Bad request
EGeneral:Unknown Method

Rate limit errors

EOrder:Rate limit exceeded
EGeneral:Temporary lockout

Trading errors

EOrder:Cannot open position
EOrder:Cannot open opposing position
EOrder:Margin allowance exceeded
EOrder:Insufficient margin
EOrder:Insufficient initial margin
EOrder:Insufficient funds (insufficient user funds)
EOrder:Order minimum not met (volume too low)
EOrder:Orders limit exceeded
EOrder:Positions limit exceeded
EOrder:Order not editable
EOrder:Not enough leaves qty
EOrder:Margin position size exceeded
EGeneral:Invalid arguments:display volume minimum not met
EGeneral:Invalid arguments:display-volume
EGeneral:Invalid arguments:iceberg:ordertype

Funding errors

EFunding:Too many addresses
EFunding:No funding method
EFunding:Unknown withdraw key
EFunding:Invalid amount
EFunding:Failed
EGeneral:Invalid arguments:beneficiary_recipient

Service status errors

EService:Unavailable or EService:Busy

Internal errors

EGeneral:Internal error
ETrade:Locked
EAPI:Feature disabled
Cloudflare Errors