Error codes

When a request fails, the API returns an HTTP 4xx status code with a JSON body containing one or more error details:

{
  "errors": {
    "ER325": {
      "code": "ER325",
      "message": "Wallet address is required.",
      "solution": "Provide a valid wallet address in the request."
    }
  }
}

Each error includes a unique code, a human-readable message, and a suggested solution. The full list of error codes per endpoint is available in the OpenAPI specification (V1, V2).

Authentication errors (ER8xx)

Code	Message	Solution
ER800	Authorization token is invalid.	Check the token format and value.
ER801	Authorization token has expired.	Refresh the token using your refresh token.
ER802	Authorization token not found.	Include the Authorization: Bearer {token} header.
ER803	Multiple authentication methods provided.	Use either a JWT token or an API key, not both.
ER805	API key is invalid.	Check your API key value.
ER806	User authorization token is invalid.	Check the user token or re-authenticate the user.

Rate limiting (ER920)

Code	Message	Solution
ER920	Too many requests.	Wait before retrying. See rate limits.

Validation errors (ER0xx, ER3xx)

These errors indicate invalid or missing fields in your request. Common examples:

Code	Message	Solution
ER038	Bad credentials.	Check your username and password.
ER300	Invalid KYC share token.	Provide a valid SumSub share token string.
ER325	Wallet address is required.	Include a walletAddress in the request.
ER326	Invalid currency pair.	Use a valid pair from the currency pairs endpoint.
ER327	Invalid payment method.	Use a valid code from the payment methods endpoint.
ER328	Client not found.	Check your authentication token.
ER332	Payment method is required.	Include paymentMethod in the request body.

Order errors (ER9xx)

Code	Message	Solution
ER900	Quote has expired.	Request a new quote.
ER901	Quote is invalid.	Request a new quote. The quote string may have been modified.
ER999	An unknown error occurred.	Contact your account manager with the request details.

CAIP-19 errors (ER4xx)

Code	Message	Solution
ER401	Invalid source currency.	Check the sourceCurrency CAIP-19 identifier.
ER402	Invalid target currency.	Check the targetCurrency CAIP-19 identifier.
ER403	Source currency not found.	The CAIP-19 identifier does not match a supported currency.

HTTP status codes

Status	Meaning
200	Success.
400	Bad request. Check the error codes in the response body.
401	Unauthorized. Authentication failed or token expired.
429	Too many requests. Rate limit exceeded.
500	Server error. Contact your account manager.