Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Manage your API keys, billing, and usage on the Developer Platform. Questions? Reach us via Support.
List of errors that can be returned by the Metis Swap API, Swap Program or from other programs like DEXes, System or Token programs.
| Error Code | Error Name | Debug |
|---|---|---|
| 6001 | SlippageToleranceExceeded | Try higher fixed slippage or try dynamicSlippage |
| 6008 | NotEnoughAccountKeys | Likely modified swap transaction causing missing account keys |
| 6014 | IncorrectTokenProgramID | Likely attempted to take platform fees on a Token2022 token (This is also 0x177e) |
| 6017 | ExactOutAmountNotMatched | Similar to slippage |
| 6024 | InsufficientFunds | Insufficient funds for either swap amount, transaction fees or rent fees |
| 6025 | InvalidTokenAccount | A token account passed in is invalid, it can be uninitialized or not expected |
| Program | Link |
|---|---|
| Token Program | https://github.com/solana-program/token/blob/main/program/src/error.rs |
| Token2022 Program | https://github.com/solana-program/token-2022/blob/main/program/src/error.rs |
| Associated Token Account Program | https://github.com/solana-program/associated-token-account/blob/main/program/src/error.rs |
| Other Solana Programs | https://github.com/solana-program |
| Error | Description |
|---|---|
| Error related to tick array or bitmap extension account | Similar to slippage, the price or market has “moved out of range”, hence the swap transaction failed. |
| Error | Description | Debug |
|---|---|---|
| NO_ROUTES_FOUND | No routes were found for the requested swap | * Check jup.ag if it’s routable * Check the liquidity of the token’s markets * See Market Listing for grace period and liquidity criteria |
| COULD_NOT_FIND_ANY_ROUTE | Unable to find any valid route for the swap | * Check jup.ag if it’s routable * Check the liquidity of the token’s markets * See Market Listing for grace period and liquidity criteria |
| ROUTE_PLAN_DOES_NOT_ CONSUME_ALL_THE_AMOUNT | The calculated route cannot process the entire input amount, you can get more output amount by reducing your input amount | * Try reducing your input amount |
| MARKET_NOT_FOUND | The specified market address was not found | * Verify the market address exists and is active |
| TOKEN_NOT_TRADABLE | The specified token mint is not available for trading | * Check jup.ag if it’s routable * Check the liquidity of the token’s markets |
| NOT_SUPPORTED | Generic error for unsupported operations | * Check the specific error message for details |
| CIRCULAR_ARBITRAGE_ IS_DISABLED | Attempted to swap a token for itself | * Input and output tokens must be different |
| CANNOT_COMPUTE_ OTHER_AMOUNT_THRESHOLD | Failed to calculate the minimum output amount based on slippage | * Verify the input amount and slippage parameters are valid |
| Error | Description | Debug |
|---|---|---|
| MAX_ACCOUNT_GREATER_THAN_MAX | The specified number of accounts exceeds the maximum allowed | * Reduce the number of accounts in the transaction |
| INVALID_COMPUTE_UNIT_PRICE_AND_PRIORITIZATION_FEE | Both compute unit price and prioritization fee were specified | - Use either compute unit price or prioritization fee, not both |
| FAILED_TO_GET_SWAP_AND_ACCOUNT_METAS | Failed to generate the swap transaction | * Check the error message for specific details |
| Error Type | Best Practice |
|---|---|
| Slippage exceeding threshold | Show the user the current slippage tolerance and the incurred slippage |
| Insufficient funds | Show the user the current balance of the account and the required balance |
| Non Jupiter Program Errors | Allow the user to retry with a different route and/or exclude the specific DEX from the quote request |
| Token not tradable | Show the user the token is not tradable and provide context on why it’s not tradable |
Was this page helpful?
