Swap Tokens
Swap
This guide explains how to swap tokens on Solana using the Toolther interface at https://toolther.app/app/swap. It covers prerequisites, step-by-step actions, slippage settings, and common errors. Swaps are powered by Jupiter with no platform fees, optimal routing, and fast execution.
1. Prerequisites
Connected wallet: Phantom, Solflare, Backpack, or Ledger (via Solflare).
Network selected: Mainnet. Swap is disabled on Devnet — you will see a notice to switch to Mainnet.
Sufficient balance of the token you want to sell (and SOL for transaction fees).
The token pair must have liquidity on Jupiter-supported pools.
2. Page Layout Reference
Header: Connect Wallet button, Settings, and navigation.
Main card: Two token input rows — "From" (sell) and "To" (receive), with token selector and amount field.
Slippage settings: Gear icon to adjust slippage tolerance (default 0.5%).
Swap button: Executes the swap after you enter an amount and approve the quote.
Show history / Hide history: Toggle to expand or collapse your swap history.
History block: List of past swaps with tx hash, pair, amounts, status, and explorer link.
3. Step-by-Step Swapping
Connect your wallet
Click "Connect Wallet" in the header and approve connection.
Choose network
Ensure the app is on Mainnet. If you see "Swap is disabled on Devnet", click the button to switch to Mainnet.
Select tokens
In the "From" row, click the token selector and choose the token you want to sell.
In the "To" row, choose the token you want to receive.
You can search by symbol or paste a mint address for custom tokens.
Enter amount
Type the amount to swap in the "From" field. The app shows an estimated "To" amount and USD value.
The quote updates automatically (with a short delay). Wait for the loading indicator to finish.
Adjust slippage (optional)
Click the gear icon next to the Swap button.
Set slippage tolerance (0.1%–50%). Higher values allow larger price moves but may result in worse execution.
Default 0.5% is suitable for most pairs.
Review and confirm
Check the estimated output, minimum received, and price impact.
Click "Swap".
Approve the transaction in your wallet popup.
Wait for confirmation; the page will show a success notification and the transaction signature.
View history
Click "Show history" to see your past swaps.
Use pagination to load more. Click the tx hash or explorer icon to open the transaction in the block explorer.
4. Field Details and Validation
From token: Any token in your wallet or from the default/popular list. Liquidity position NFTs are excluded.
To token: Any supported token. Cannot be the same as From.
Amount: Must be a positive number. The app converts to base units using the token's decimals.
Slippage: Percentage of acceptable price movement. Minimum received = output × (1 − slippage/100).
5. Slippage and Price Impact
Slippage protects you if the price moves between quote and execution. Too low may cause failed transactions; too high may give worse fills.
Price impact shows how much your trade affects the pool price. Large trades on thin pools have higher impact.
Minimum received is the worst-case output at your chosen slippage. You will not receive less than this (unless the transaction fails).
6. Troubleshooting
Swap disabled: You are on Devnet. Switch to Mainnet in Settings or via the notice button.
No quote / "Try another amount or pair": Check that the pair has liquidity. Try a smaller amount or different tokens.
Insufficient balance: Ensure you have enough of the "From" token and SOL for fees.
Transaction failed after approval: Open the transaction in the explorer from the notification link to inspect logs. Common causes: slippage too low, liquidity moved, or network congestion.
Token not found in selector: Use the search to paste the token mint address. Ensure the token is SPL and has liquidity on Jupiter.
7. Related Topics
Liquidity: Create pools and add liquidity at https://toolther.app/liquidity.
Token creation: Create SPL tokens at https://toolther.app/create_token.
Jupiter: The swap engine aggregates liquidity across Solana DEXes for best execution.
8. Best Practices Checklist
Verify you are on Mainnet before swapping.
Double-check amount and pair before approving.
Use moderate slippage (0.5%–1%) for standard pairs; increase for volatile or low-liquidity pairs.
Record the transaction signature for your records.
Review price impact on large trades — consider splitting into smaller orders if impact is high.
Last updated