When calling the /quote endpoint, various errors may be returned depending on request conditions, user input, or internal routing logic. This guide outlines the possible error codes, their meanings, and how to handle them.

​
Expected Errors

These are known validation and routing issues that developers should gracefully handle in their integrations:

Error CodeDescription
AMOUNT_TOO_LOWThe amount provided is below the minimum threshold required for a quote.
CHAIN_DISABLEDThe origin or destination chain is currently disabled or unsupported.
EXTRA_TXS_NOT_SUPPORTEDExtra transactions are not supported for this trade type.
FORBIDDENUser does not have the required role or permission.
INSUFFICIENT_FUNDSThe user’s wallet does not have enough balance to perform the swap.
INSUFFICIENT_LIQUIDITYThere is not enough liquidity available to complete the swap.
INVALID_ADDRESSThe provided user address is not valid.
INVALID_EXTRA_TXSThe total value of extra transactions exceeds the intended output.
INVALID_GAS_LIMIT_FOR_DEPOSIT_SPECIFIED_TXSDeposit-specified transactions are only allowed for exact output swaps.
INVALID_INPUT_CURRENCYThe provided input currency address is invalid or not supported.
INVALID_OUTPUT_CURRENCYThe provided output currency address is invalid or not supported.
INVALID_SLIPPAGE_TOLERANCESlippage value is not a valid integer string representing basis points.
NO_INTERNAL_SWAP_ROUTES_FOUNDNo valid swap route exists internally for the selected token pair.
NO_QUOTESNo available quotes for the given parameters.
NO_SWAP_ROUTES_FOUNDNo route was found to fulfill the quote request with the given parameters.
ROUTE_TEMPORARILY_RESTRICTEDThis route is temporarily restricted due to high traffic or throttling.
SANCTIONED_CURRENCYThe token involved in the transaction is on a sanctions list.
SANCTIONED_WALLET_ADDRESSThe sender or recipient wallet address is sanctioned or blacklisted.
SWAP_IMPACT_TOO_HIGHThe swap’s price impact exceeds acceptable thresholds.
UNAUTHORIZEDThe user is not authenticated or lacks valid authorization.
UNSUPPORTED_CHAINThe specified chain is not supported by the platform.
UNSUPPORTED_CURRENCYThe specified currency is not supported for input or output.
UNSUPPORTED_EXECUTION_TYPEThe execution type used is not supported for fee estimation or execution.
UNSUPPORTED_ROUTEThe swap route combination is not supported.
USER_RECIPIENT_MISMATCHUser and recipient addresses must match for this type of swap.

​
Unexpected Errors

These indicate infrastructure or downstream failures and are not common:

Error CodeDescription
DESTINATION_TX_FAILEDThe relay transaction failed on the destination chain.
ERC20_ROUTER_ADDRESS_NOT_FOUNDThe router contract for a token could not be located.
UNKNOWN_ERRORAn unclassified or unexpected error occurred.
SWAP_QUOTE_FAILEDFailed to calculate a quote, possibly due to third-party pricing failure.
PERMIT_FAILEDPermit signature validation failed for token approvals.

​
Example Error Responses

Invalid Input Currency

{
  "message": "Invalid input or output currency",
  "errorCode": "INVALID_INPUT_CURRENCY"
}

​
No Routes Found

{
  "message": "No routes found",
  "errorCode": "NO_SWAP_ROUTES_FOUND"
}

​
Destination Transaction Failed

{
  "message": "Destination transaction failed",
  "errorCode": "DESTINATION_TX_FAILED",
  "errorData": "execution reverted"
}