Common Errors
This section provides an overview of the common errors that you may encounter when utilizing the CoinPayments API.
By familiarizing yourself with these errors, you will be better equipped to handle potential issues and troubleshoot effectively.
Understanding these errors will contribute to a smoother integration process and ensure a more seamless payment experience for your users.
Unauthorized (401)
This error occurs when user authorization fails due to an invalid API signature.
Common issues causing this error:
- An invalid
clientIdorclientSecret. - The client does not have valid business verification.
- The integration has been deleted or disabled on the dashboard.
- The API signature is not constructed properly.
- One of the required headers were not found.
- Signature was signed more than 1 minute before making the API request.
- Integration has an
AllowedIPswhitelist configured.
Please see Authenticating with the API and Generating API request signature for more information.
Bad Request (400)
This error occurs when there is an issue validating the provided data for the requested resource.
Ensure you are sending all required parameters with the correct type by referencing the specific route documentation.
Within the API response you will find a description of the applicable validation error for the request.
Insufficient Funds
This error can occur when withdrawing funds to an external address, or when converting currencies.
This is caused by the user's wallet not having a sufficient balance to cover the transaction amount and any applicable fees.
Invalid Address
When creating a transaction for a withdrawal or conversion, if the provided address is not valid or formatted correctly, this error is triggered. Users should ensure the address they provided follows the required format.
Examples of valid addresses:
Valid UTXO-Based Coin Addresses:
- Bitcoin (BTC):
1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2 - Bitcoin Cash (BCH):
bitcoincash:qr7uq7uvujmzhcv29tw92q0hs7fwpht4fvl4a4kj9a - Litecoin (LTC):
LZx9pzGfH6mKSzVsJZnryeVrRzt6X8uZ9r
Valid Token Coin Addresses:
- Ethereum (ETH):
0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf - ERC-20 Tokens (e.g., DAI, USDT):
0x6B175474E89094C44Da98b954EedeAC495271d0F
Invalid or Unsupported Currency
This error occurs when the API request involves an invalid or unsupported currency.
Please see Supported Currencies for more information.
Rate Limits
The API has a default rate limit of 70 requests per second.
Rate limits have been implemented to prevent abuse and ensure the stability and optimal performance of our systems.
If you are encountering issues with this limitation, please Contact us to discuss your integration further.