Carbium Docs

Docs Swap

Troubleshooting

What each message on the swap card means and what to do.

When a swap does not go through, the swap card shows a message.

Where messages show

A message shows on the swap button, in a banner above it, in a dialog, on the swap's status card, or as a short notice on screen. When a swap fails before it is sent, some reasons also stay under the button as "Not executed: " followed by the message, until your next action.

Messages

Message What it means and what to do
"Connect Wallet" No wallet is connected. Press the button and choose a wallet.
"Enter the amount" No amount is entered. Type the amount you pay.
"No route for this pair" There is no route for this pair at this amount. Some pairs lack the liquidity for one. Try a different amount or token.
"No Routes Found" The card has no quote for this amount. Try a different amount or token.
"Insufficient" followed by a token, for example "Insufficient SOL" Your wallet holds less of the named token than the swap needs. For SOL, that includes the SOL for fees and token account rent, also when you pay with another token. Lower the amount or add funds.
"Volatility risk" The dollar value you would receive is far below the dollar value you pay. The button is off. Try a different amount or pair.
"Service issue, retrying..." The card could not get a quote because of a service problem. It retries by itself. Wait until the button reads SWAP again.
"Service disruption detected. Swaps may fail. Please retry shortly." The service has kept failing. Wait and try again shortly.
"High Price Difference" or "High Price Impact", with "Funds may be lost, Press confirm if you still want to continue." A dialog. "High Price Difference" means the dollar value you would receive is well below the dollar value you pay. "High Price Impact" means the swap's price impact is high. Press Confirm to continue, or close the dialog to cancel. See Routes and prices.
"Error fetching $ value" The same dialog, shown when the card lacks a dollar value to compare. Press Confirm to continue, or close the dialog to cancel.
"High price impact - try a different amount or pair" The dollar value you would receive is too far below what you pay. The swap is not sent. Try a different amount or pair.
"High price impact, try changing your inputs" The price impact of this swap is too high. The swap is not sent. Try a different amount or pair.
"Your wallet needs a little SOL for network fees" You are swapping into SOL, your wallet has too little SOL for the network fee, and the swap could not run as Gasless (see Fees). Add a little SOL to your wallet and swap again.
"This route cannot be executed right now, re-quoting" The card has a quote but could not build a transaction for it. Nothing was sent. Wait for the next quote and press SWAP again.
"Wallet not connected" No wallet is connected when the swap starts. Connect your wallet and swap again.
"Could not read the on-chain fee config - retry" The card could not read a fee setting from the network. Nothing was sent. Press SWAP again.
"Route reverted before signing, re-quoting" A check of the transaction failed before you were asked to sign. Nothing was sent. The card fetches a new quote. Press SWAP again.
"Quote expired before it landed - retry" The transaction was sent but was not confirmed before it expired. Press SWAP again.
"Price moved past your minimum. Swap cancelled on chain, re-quoting" The price moved below your Min received and the swap was cancelled on chain. The card fetches a new quote. Press SWAP again.
"Swap landed but failed on-chain, re-quoting" The transaction reached the network and failed there. The card fetches a new quote. Press SWAP again.
"Swap did not return a signature - retry" The swap ended without a transaction to follow. Press SWAP again.
"Transaction Not Executed" with "Failed" The swap's status card shows these when a swap fails after it was sent. A notice on screen gives the reason.
"sendRawTransaction timeout (30s)" Sending the transaction got no answer in time. The transaction may still go through. Check your wallet before you swap again.
"Insufficient Funds!" The swap failed because your wallet does not hold enough for it. Lower the amount or add funds.
"Transaction Simulation Failed!" The transaction failed its check before it was sent. Press SWAP again on a new quote.
"Slippage Limit Exceeded, Try again!" The price moved beyond your slippage tolerance. Press SWAP again on a new quote. You set Slippage tolerance in the card's settings.
"Transaction was not approved in wallet." You rejected the transaction in your wallet, or the wallet did not approve it. Nothing was sent. Press SWAP and approve it.
"Swap could not be processed, try again please" The swap failed and no reason came back. Press SWAP again. Other failures show the message your wallet or the network returned.
"Slippage must be Greater than 0" The custom slippage you entered is zero or empty. Enter a value above zero and press Save.