This page documents the common error codes and HTTP status codes you may encounter, along with how to resolve them.

Error Codes

Error CodeDescriptionResolution
1000Internal server error. This error can be caused by various issues, including expired Org Access Tokens.Check your server configuration, including whether Org Access Tokens have expired, then retry later.
1002The HTTP method used in the request is not supported.Use a supported HTTP method.
1003, 2003One or more required parameters are missing from the request.Provide all required parameters.
1006, 2006One or more parameters have an invalid format or contain unsupported values.Provide valid parameters in the expected format.
12002The specified token is not supported.Choose a supported token.
12007, 30012Insufficient balance to perform the requested operation.Ensure that the source address has enough balance to cover the amount.
12009Duplicate request ID.Use a unique request ID.
12025The UTXOs specified in included_utxos or excluded_utxos are invalid.Verify the UTXOs specified in included_utxos or excluded_utxos.
2000An error occurred during processing.Please try again later.
2010Rate limit exceeded due to too many requests in a short time.Please try again later.
2021The request handler is missing or not implemented.Provide a valid handler for the request.
2022The request is missing required headers.Include all required headers.
2023The API signature is missing or invalid.Verify that the API signature is valid and correct.
2024API Key authentication failed.Use a valid API Key, or confirm that the source IP is whitelisted.
2025, 4001Access to the requested resource is forbidden.Check the permissions associated with the API Key.
2026Too many requests.Please try again later.
2028The requested resource was not found.Check the request URL.
2029The provided status flag is invalid.Provide a valid value for the status flag.
2040A resource with the same key already exists.Use a unique key.
30007The amount is invalid. The value is not a valid number or does not match the required format or range.Provide a valid amount that matches the expected format and range.
30008The absolute amount is invalid. The absolute value is too small, too large, or must be non-zero.Ensure the absolute value of the amount meets the requirements.
30010The amount provided is below the fee threshold. The amount is too small to process.Increase the amount to exceed this threshold.
30023(Applies to exchange wallets) The transaction account type is invalid.Provide a valid transaction account type.
30032(Applies to MPC wallets) Invalid combination of key-share holders.Verify that a valid master signer combination is configured.
40001Wallet not exist.
40002Missing api key.
40003The public key not exist.
40004The public key and Wallet id not match.
40005Token not exist.
40006Invalid chain id.
40007Wallet balance not enough.
40008The token’s withdraw not open.
40009The request already exists.
40010Withdraw amount should lager than withdraw fee.
40011Invalid withdraw status.
40012Configue webhook url first.
40013Invalid wallet status.
40014Invalid wallet id.
40015Invalid withdraw address.
60010The specified token is not yet enabled for this team.Enable the token for your team.

HTTP Status Codes

Status CodeDescriptionResolution
200Success.Not applicable.
400Bad request.Check the request parameters.
401Unauthorized.Verify the API Key and signature.
403Forbidden.Ensure you have the required permissions.
404Not found.Check the request URL.
405Method not allowed.Use a supported HTTP method.
406Not acceptable.Ensure the request content type is JSON.
429Too many requests.Reduce request frequency and retry later.
500Internal server error.Check server configuration, including whether Org Access Tokens have expired, then retry.
502Bad gateway.Check connectivity and try again later.
503Service unavailable.Try again later.