Skip to main content
This article explains the common error codes and HTTP status codes you may encounter when using the Cobo WaaS 2.0 API and how to resolve the errors.

Error codes

Error codeDescriptionSolution
1000Internal Server Error. This error can be caused by several issues including expired Org Access Tokens.Check your server configuration settings, including whether your Org Access Token has expired, and try again later.
2002The HTTP method used in the request is not supported.Use a supported HTTP method.
1003, 2003One or more required parameters are missing in the request.Provide all required parameters.
1006, 2006One or more parameters are in an invalid format or contain unsupported values.Provide valid parameters in the expected format.
12002The specified token is not supported by Cobo.Choose a supported token. Call the List supported tokens operation to get the full list of supported tokens.
12007, 30012Insufficient balance to perform the requested operation.Ensure the source address has sufficient balance to cover the transferred 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.
2000Internal error occurred during processing.Please try again later.
2010Rate limit exceeded. 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.
2023Missing or invalid API signature.Verify your API signature and ensure it is correct. You can refer to Calculate the API signature for details.
2024API key authentication failed.Use a valid API key. If your API key is permanent, ensure the request is sent from a whitelisted IP address. See Register an API key for details.
2025, 4001Forbidden access to the requested resource.Check the permissions associated with your API key. You can refer to Permissions and wallet scopes for details.
2026Too many requests.Please try again later.
2028The requested resource was not found.Check the request URL.
2029The provided status property is invalid.Provide a valid value for the status property.
2040A resource with the same key already exists.Use a unique key.
2050, 2052No available pricing plan, or usage limit has been exceeded.Purchase a pricing plan or upgrade your existing one. For more information, see Introduction to Bills & Payments.
2051The current pricing plan has expired.Renew your pricing plan to continue using the service. For more information, see Introduction to Bills & Payments.
30001The current pricing plan does not support this feature.Upgrade to a pricing plan that includes this feature. For more information, see Introduction to Bills & Payments.
30007Invalid amount. The value is not a valid number or does not meet the required format or range.Provide a valid amount that meets the expected format and range.
30008Invalid absolute amount. The absolute value of the amount is either too small, too large, or zero when a non-zero value is required.Ensure the absolute value of the amount meets the required conditions.
30010The provided amount is below the dust threshold. It is too small to be processed or transferred.Increase the amount to exceed the dust threshold.
30011The provided amount is below the minimum deposit threshold.Increase the deposit amount to meet the minimum threshold.
30013Insufficient balance to cover the required transaction fee.Ensure the source address has enough balance to cover transaction fees.
30014The destination address is invalid.Provide a valid destination address.
30023(This error only applies to Exchange Wallets) Invalid trading account type.Provide a valid trading account type.
30032(This error only applies to MPC Wallets) Invalid key share holder group.Check if a valid Main Group or Signing Group has been configured.
60010The specified token has not been enabled for this organization.Enable the token for your organization.

HTTP status codes

Status codeDescriptionSolution
200OK.N/A
400Bad request.Check the request parameters.
401Unauthorized.Check the API key, API signature, or timestamp.
403Forbidden.Ensure you have the required permissions.
404Not Found.Check the requestURL.
405Method Not Allowed.Use a supported HTTP method.
406Not Acceptable.Ensure the request content format is JSON.
429Too Many Requests.Reduce request frequency and try again later.
500Internal Server Error. This error can be caused by several issues including expired Org Access Tokens.Check your server configuration settings, including whether your Org Access Token has expired, and try again later.
502Bad Gateway.Check the connectivity and try again later.
503Service Unavailable.Try again later.
Feel free to share your feedback to improve our documentation!