Swap
Exchange tokens at the best on-chain rate via SDEX or Soroswap routing
TL;DR
The Aggregate swap surface exchanges tokens at the best available on-chain rate. The aggregator checks both SDEX orderbook and Soroswap pool liquidity, picks the route with least slippage, and shows you a quote before you confirm.
Step-by-Step: Execute a Swap
Navigate to the Aggregate tab. Click "Aggregate" in the left sidebar navigation.
Select the Swap mode. The Aggregate surface defaults to Swap. Make sure the "Swap" tab is active (not "Bridge").
Choose your tokens. Select the source token (e.g., USDC) and destination token (e.g., XLM) from the dropdowns.
Enter the amount. Type the amount you want to swap. The aggregator immediately fetches quotes from both SDEX and Soroswap.
Review the quote. The interface shows:
- Expected output — how many tokens you'll receive
- Route — whether SDEX or Soroswap gives the better rate
- Price impact — percentage impact on the pool/orderbook
- Minimum received — worst-case with slippage tolerance (3%)
Click Swap. This triggers the transaction build and shows the approval card.
Approve in your wallet. Your wallet extension (Freighter/xBull/Albedo) pops up asking you to sign the transaction.
Swap confirmed. The interface shows the completed swap with final amounts.
How Routing Works
The aggregator picks the best route automatically:
| Swap Size | Typical Route | Why |
|---|---|---|
| Small (under $100) | SDEX orderbook | Deep liquidity, zero slippage at limit price |
| Medium ($100–$1000) | Soroswap AMM | Consistent fills, predictable pricing |
| Large (over $1000) | Split across both | Reduces total price impact |
Slippage Protection
Default slippage tolerance is 3% (97% minimum output). If price impact exceeds 1.5%, a warning appears on the quote. You can adjust slippage in settings.
Troubleshooting
| Issue | Solution |
|---|---|
| "Insufficient balance" | Check your wallet has enough of the source token |
| "No route found" | The token pair may not have liquidity — try a different pair |
| "Transaction failed" | Price moved during signing — try again with higher slippage |
| Quote shows high impact | Split into smaller swaps or wait for more liquidity |