Errors and Rate Limits

HTTPS Errors

HTTPS Errors are all request with response status code different than 200 (successful HTTP), must be considered as failure of a particular API call. You should expect additional JSON inside the body of the response with the error message encapsulated inside it as shown in the example.

We recommend, as best practice, to store all error messages somewhere along with request data for further manual review. We use the following error codes:

Error Code	Description
400 (Bad Request)	Something is wrong with your request, possibly due to invalid argument.
401 (Unauthorized)	Lack of valid authentication credentials, your API key is wrong/invalid.
403 (Forbidden)	The request was rejected due to a permission issue. Your API does not have enough privileges/credits to access this resource.
404 (No Data)	You requested specific single item that we don’t have at this moment.
429 (Too Many Requests)	Your API key rate limits have been exceeded.
500 (Internal Server Error)	An unexpected server error was encountered, we are working on fixing this.

Rate Limits

Crypto API’s professional service is subject to API call rate limits, based on your subscription plan tier. If you are interested in custom subscription tier for higher limits, reach out to us.

If you exceed these limits, your requests will return an HTTPS Status Code 429.

The rate limits are on call per day, per hour, per minute & per second in correspondence to available credits. Your daily credits are accounted for 24 hrs from the initial call to our API-Gateway.

Error Codes

CryptoAPI responses may result with an internal error code and description.

Response Body

{
    "meta": {
        "error": {
            "code": 6001,
            "message": "Asset not found"
        }
    }
}

We use the following error codes:

General error codes

Error Code	Description
1	General error: %s
16	Please provide a proper query parameter, refer to the documentation for more information
15	Password is too weak
16	Request method not supported: %s
17	Required request body is missing
18	Could not delete payment forwarding with uuid: %s
19	Wrong password
20	We are facing technical issues, please try again later
21	Transaction not found
22	Could not retrieve webhooks for this user
23	Could not delete webhook with id: %s
24	We are facing technical issues, please try again later
26	Block not found
27	We are facing technical issues, please try again later
28	Password cannot be null or empty
29	Address not found
30	Bad JSON formatting
31	Blockchain connection error: %s
32	Invalid authentication credentials
33	Invalid API Key
34	Authorization header is missing
35	Not enough privileges for the requested operation
36	We are facing technical issues, please try again later
37	We are facing technical issues, please try again later
38	Use HTTPS requests
39	Unsupported Media Type. Content-Type header should be 'application/json'.
40	Method must be one of: %s
41	URI not found. Check the documentation.
50	Wrong or missing blockchain network
60	This endpoint has not been enabled for your package plan. Please contact us if you need this or upgrade your plan.
61	Your package plan includes only % days historical data. Please contact us if you need more or upgrade your plan.
62	Insufficient credits
63	Request limit reached. Maximum %1$d requests per %2$d seconds.
200	Your request has been successfully executed.
400	Something is wrong with your request, possibly due to invalid argument.
401	Lack of valid authentication credentials, your API key is wrong/invalid.
403	The request was rejected due to a permission issue. Your API does not have enough privileges/credits to access this resource.
404	You requested specific single item that we don’t have at this moment.
429	Your API key rate limits have been exceeded.
500	An unexpected server error was encountered, we are working on fixing this.

Exchanges error codes

Error Code	Description	Additional info
6000	Exchange rate not found for the pair	Exchange rate not found for the pair
6001	Asset not found	There is no Asset that corresponds to the given name
6002	Invalid time format	Timestamp value contains non-numeric symbols
6003	Exceeded limit of % records per request
6004	Unknown symbol

ETH error codes

Error Code	Description	Additional Info
3000	%s is not a valid Ethereum address
3001	Value is not provided
3002	Could not generate new address
3003	Could not generate new account
3004	fromAddress cannot be null or empty
3005	toAddress cannot be null or empty
3006	privateKey cannot be null or empty	deploy smart contract and transaction create with privateKey
3007	There is no registry for address: %s	When trying to send a tx with non-existing keystore file
3008	fromAddress cannot be equal to toAddress
3009	Sign.Signature failure
3010	There is already a registry for this address	When making a payment forwarding(duplicate error)
3011	BigInt or BigDecimal conversion error	when value is not a number
3012	Password is too weak...	token transfer and payment forwarding
3013	signed_tx cannot be empty or null
3014	Ethereum VM errors (different messages)	e.g. not enough eth; nonce error
3015	%s is not a valid Ethereum network
3016	byteCode cannot be null or empty
3017	Byte code is not in the correct format
3018	Could not sign the transaction
3019	Could not estimate gas price
3020	Could not estimate gas limit
3021	Webhook validator default messages	when url or event is missing
3022	Not enough tokens
3023	Balance is not enough	when sending tokens
3024	contract cannot be null or empty	when sending tokens
3025	Check input data, no reference found to provided contract and fromAddress	when sending tokens
3026	Invalid address or contract	token balance

BTC error codes

Error Code	Description
2000	Can not decode transaction
2001	Can not create transaction
2002	Can not sign transaction
2003	Can not send transaction
2004	txs must not be empty
2005	Transaction '%s' is invalid
2006	txHex must not be empty
2007	Address is not valid
2008	Block '%s' has '%d' transaction. Index '%d' out of range.
2009	Sum of input values is different then sum of output values
2010	Not enough balance in '%s' available '%.8f', but needed is '%.8f' (including fee)
2100	Field 'walletName' Error: %s
2101	addresses' contains invalid address(es): %s
2102	Wallet '%s' is Hierarchical Deterministic wallet, please check https://docs.cryptoapis.io/?http#btc-wallet-api for HD wallets
2103	Wallet '%s' is Normal wallet, please check https://docs.cryptoapis.io/?http#btc-wallet-api for Normal wallets
2104	addressCount must not be empty
2105	addressCount must be number value between 1 and 10
2106	walletName' must not be empty
2107	walletName' must be string
2108	walletName' is too long. Max size is 64 characters, actual is %d
2109	walletName' is too short. Min size is 3 characters, actual is %d
2110	Wallet '%s' already exists
2111	Field 'addresses' Error: %s
2112	addresses' must not be empty
2113	addresses' must be array
2114	addresses' contains duplicate address(es)
2115	Wallet '%s' does not exist
2116	Address '%s' can not be found in wallet '%s'
2117	password' must be string
2118	password' is too long. Max size is 64 characters, actual is %d
2119	password' is too weak. Min size is 10 characters, actual is %d
2120	Wallet can not be decrypted with this 'password'
2201	from' address must not be empty
2202	from' address must be string
2203	from' address is not valid
2204	to' address must not be empty
2205	to' address must be string
2206	to' address is not valid
2204	to' address must be different from 'from' address
2207	callback' url must not be empty
2208	callback' url must be string
2209	callback' url is not valid
2210	password' url must not be empty
2211	password' url must be string
2212	password' is too long. Max size is 64 characters, actual is %d
2213	password' is too weak. Min size is 10 characters, actual is %d
2214	wallet' name must not be empty
2215	wallet' name must be string
2216	wallet' name is too long. Max size is 64 characters, actual is %d
2217	wallet' name is too short. Min size is 3 characters, actual is %d
2217	wallet' can not be decrypted with this 'password'
2218	Payment Forwarding from address '%s' already created
2219	Address '%s' can not be found in wallet '%s'
2217	Payment Forwarding not found
2301	event' address must not be empty
2302	event' should be UNCONFIRMEDTX, NEWBLOCK, CONFIRMED_TX or ADDRESS
2303	address' must not be empty
2304	address' must be string
2305	address' is not valid
2306	confirmations' must not be empty
2307	confirmations' must be number value between 1 and 100
2308	confirmations' is not valid
2309	transaction' must not be empty
2310	transaction' size must be exactly 64 characters
2311	transaction' is not valid
2312	url' must not be empty
2313	url' must be string
2314	url' is not valid

BCH error codes

Error Code	Description
4000	Can not decode transaction
4001	Can not create transaction
4002	Can not sign transaction
4003	Can not send transaction
4004	txs must not be empty
4005	Transaction '%s' is invalid
4006	txHex must not be empty
4007	Address is not valid
4008	Block '%s' has '%d' transaction. Index '%d' out of range.
4009	Sum of input values is different then sum of output values
4010	Not enough balance in '%s' available '%.8f', but needed is '%.8f' (including fee)
4100	Field 'walletName' Error: %s
4101	addresses' contains invalid address(es): %s
4102	Wallet '%s' is Hierarchical Deterministic wallet, please check https://docs.cryptoapis.io/?http#bch-wallet-api for HD wallets
4103	Wallet '%s' is Normal wallet, please check https://docs.cryptoapis.io/?http#bch-wallet-api for Normal wallets
4104	addressCount must not be empty
4105	addressCount must be number value between 1 and 10
4106	walletName' must not be empty
4107	walletName' must be string
4108	walletName' is too long. Max size is 64 characters, actual is %d
4109	walletName' is too short. Min size is 3 characters, actual is %d
4110	Wallet '%s' already exists
4111	Field 'addresses' Error: %s
4112	addresses' must not be empty
4113	addresses' must be array
4114	addresses' contains duplicate address(es)
4115	Wallet '%s' does not exist
4116	Address '%s' can not be found in wallet '%s'
4117	password' must be string
4118	password' is too long. Max size is 64 characters, actual is %d
4119	password' is too weak. Min size is 10 characters, actual is %d
4120	Wallet can not be decrypted with this 'password'
4201	from' address must not be empty
4202	from' address must be string
4203	from' address is not valid
4204	to' address must not be empty
4205	to' address must be string
4206	to' address is not valid
4204	to' address must be different from 'from' address
4207	callback' url must not be empty
4208	callback' url must be string
4209	callback' url is not valid
4210	password' url must not be empty
4211	password' url must be string
4212	password' is too long. Max size is 64 characters, actual is %d
4213	password' is too weak. Min size is 10 characters, actual is %d
4214	wallet' name must not be empty
4215	wallet' name must be string
4216	wallet' name is too long. Max size is 64 characters, actual is %d
4217	wallet' name is too short. Min size is 3 characters, actual is %d
4217	wallet' can not be decrypted with this 'password'
4218	Payment Forwarding from address '%s' already created
4219	Address '%s' can not be found in wallet '%s'
4217	Payment Forwarding not found
4301	event' address must not be empty
4302	event' should be UNCONFIRMEDTX, NEWBLOCK, CONFIRMED_TX or ADDRESS
4303	address' must not be empty
4304	address' must be string
4305	address' is not valid
4306	confirmations' must not be empty
4307	confirmations' must be number value between 1 and 100
4308	confirmations' is not valid
4309	transaction' must not be empty
4310	transaction' size must be exactly 64 characters
4311	transaction' is not valid
4312	url' must not be empty
4313	url' must be string
4314	url' is not valid

LTC error codes

Error Code	Description
5000	Can not decode transaction
5001	Can not create transaction
5002	Can not sign transaction
5003	Can not send transaction
5004	txs must not be empty
5005	Transaction '%s' is invalid
5006	txHex must not be empty
5007	Address is not valid
5008	Block '%s' has '%d' transaction. Index '%d' out of range.
5009	Sum of input values is different then sum of output values
5010	Not enough balance in '%s' available '%.8f', but needed is '%.8f' (including fee)
5100	Field 'walletName' Error: %s
5101	addresses' contains invalid address(es): %s
5102	Wallet '%s' is Hierarchical Deterministic wallet, please check https://docs.cryptoapis.io/?http#ltc-wallet-api for HD wallets
5103	Wallet '%s' is Normal wallet, please check https://docs.cryptoapis.io/?http#ltc-wallet-api for Normal wallets
5104	addressCount must not be empty
5105	addressCount must be number value between 1 and 10
5106	walletName' must not be empty
5107	walletName' must be string
5108	walletName' is too long. Max size is 64 characters, actual is %d
5109	walletName' is too short. Min size is 3 characters, actual is %d
5110	Wallet '%s' already exists
5111	Field 'addresses' Error: %s
5112	addresses' must not be empty
5113	addresses' must be array
5114	addresses' contains duplicate address(es)
5115	Wallet '%s' does not exist
5116	Address '%s' can not be found in wallet '%s'
5117	password' must be string
5118	password' is too long. Max size is 64 characters, actual is %d
5119	password' is too weak. Min size is 10 characters, actual is %d
5120	Wallet can not be decrypted with this 'password'
5201	from' address must not be empty
5202	from' address must be string
5203	from' address is not valid
5204	to' address must not be empty
5205	to' address must be string
5206	to' address is not valid
5204	to' address must be different from 'from' address
5207	callback' url must not be empty
5208	callback' url must be string
5209	callback' url is not valid
5210	password' url must not be empty
5211	password' url must be string
5212	password' is too long. Max size is 64 characters, actual is %d
5213	password' is too weak. Min size is 10 characters, actual is %d
5214	wallet' name must not be empty
5215	wallet' name must be string
5216	wallet' name is too long. Max size is 64 characters, actual is %d
5217	wallet' name is too short. Min size is 3 characters, actual is %d
5217	wallet' can not be decrypted with this 'password'
5218	Payment Forwarding from address '%s' already created
5219	Address '%s' can not be found in wallet '%s'
5217	Payment Forwarding not found
5301	event' address must not be empty
5302	event' should be UNCONFIRMEDTX, NEWBLOCK, CONFIRMED_TX or ADDRESS
5303	address' must not be empty
5304	address' must be string
5305	address' is not valid
5306	confirmations' must not be empty
5307	confirmations' must be number value between 1 and 100
5308	confirmations' is not valid
5309	transaction' must not be empty
5310	transaction' size must be exactly 64 characters
5311	transaction' is not valid
5312	url' must not be empty
5313	url' must be string
5314	url' is not valid