NAV
BETA Version
Shell HTTP JavaScript Node.JS PHP Ruby Python Java GO
  • Getting started
  • REST APIs
  • WebSockets
  • Standards and Conventions
  • Errors and Rate Limits
  • 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