token-swap-best-practices
Skill8 starsChanged 9 months agoMITView on GitHub
Best practices for token swaps — DEX aggregator comparison, slippage management, gas optimization, cross-chain swaps, and common pitfalls. Use when helping users execute swaps, choose DEXs, or troubleshoot failed transactions.
In this repository45 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms-full.txtllms.txt
- llms.txtllms.txt
- sperax-skillsSkill
- agent-wallet-securitySkill
- ai-agent-defi-guideSkill
- airdrop-hunting-guideSkill
- arbitrum-defi-guideSkill
- chainlink-oracle-guideSkill
- cross-chain-bridge-guideSkill
- crypto-governance-guideSkill
- crypto-market-sentimentSkill
- crypto-news-aggregationSkill
- crypto-portfolio-managementSkill
- crypto-price-data-guideSkill
- crypto-tax-basicsSkill
- dca-strategy-guideSkill
- defi-dashboard-buildingSkill
- defi-lending-guideSkill
- defillama-analytics-guideSkill
- defi-risk-assessmentSkill
- defi-yield-strategiesSkill
- erc8004-agent-identitySkill
- gas-optimization-guideSkill
- impermanent-loss-explainedSkill
- mev-protection-guideSkill
- nft-analytics-guideSkill
- onchain-analytics-guideSkill
- plutus-plsassets-guideSkill
- plutus-protocol-overviewSkill
- plutus-vaults-guideSkill
- restaking-explainedSkill
- smart-contract-reading-guideSkill
- sperax-ecosystem-overviewSkill
- sperax-farms-guideSkill
- sperax-spa-stakingSkill
- sperax-usds-guideSkill
- stablecoin-mechanicsSkill
- subgraph-development-guideSkill
- token-approval-safetySkill
- token-discovery-guideSkill
- web3-glossarySkill
- whale-watching-guideSkill
- yield-vault-guideSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 41
If a swap fails with "insufficient output":
- Distinctive: line 43
Check if the token has transfer taxes (some meme tokens have 5–10% tax)
- Distinctive: line 45
Wait — price may be moving rapidly
- Distinctive: line 71
When you need to move tokens between chains:
- Distinctive: line 85
Check bridge liquidity: before large transfers
- Distinctive: line 96
Not shown in quoted price
- Distinctive: line 117
Before swapping, you must approve the router to spend your tokens:
- Distinctive: line 119
Consider using exact-amount approvals for security
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Token Swap Best Practices
A practical guide for AI agents helping users execute safe, efficient token swaps.
DEX Aggregators
Aggregators split your trade across multiple liquidity sources for the best price.
| Aggregator | Strengths | Chains |
| 1inch | Most liquidity sources, limit orders | Ethereum, Arbitrum, Polygon, BSC, + |
| 0x (Matcha) | Professional-grade, RFQ system | Ethereum, Arbitrum, Polygon, + |
| Paraswap | MEV protection, gasless swaps | Ethereum, Arbitrum, Polygon, + |
| Jupiter | Best for Solana | Solana |
| CowSwap | Batch auctions (MEV-free) | Ethereum, Arbitrum |
Always prefer aggregators over single DEXs — they find better prices by checking multiple sources.
Slippage Settings
Slippage tolerance = how much price movement you'll accept.
| Setting | When to Use | Risk |
| 0.1–0.3% | Stablecoin pairs | May fail on volatile tokens |
| 0.5% | Standard swaps | Good default |
| 1.0% | Low-liquidity tokens | Higher MEV exposure |
| 3–5% | Very low liquidity | Significant MEV risk |
| >5% | Almost never | Extreme MEV vulnerability |
Default recommendation: 0.5% for most swaps.
When Swaps Fail
If a swap fails with "insufficient output":
- Try slightly higher slippage (0.5% → 1.0%)
- Check if the token has transfer taxes (some meme tokens have 5–10% tax)
- Try a smaller amount
- Wait — price may be moving rapidly
Gas Optimization
Timing
Gas prices fluctuate. For non-urgent swaps:
- Cheapest: Weekends, early UTC morning
- Most expensive: Weekdays during US/EU business hours
- Check: etherscan.io/gastracker or L2-specific dashboards
Chain Selection
| Chain | Typical Swap Cost | Speed |
| Ethereum L1 | $5–50+ | 12 sec |
| Arbitrum | $0.01–0.30 | 2 sec |
| Base | $0.01–0.20 | 2 sec |
| Polygon | $0.01–0.05 | 2 sec |
| BSC | $0.05–0.50 | 3 sec |
| Solana | $0.001–0.01 | 0.4 sec |
Recommendation: For routine swaps, use L2s like Arbitrum (where Sperax ecosystem lives) for cents-level gas costs.
Cross-Chain Swaps
When you need to move tokens between chains:
Bridge Options
| Bridge | Supported Chains | Speed | Notes |
| Stargate | 15+ chains | 1–5 min | Most reliable for stablecoins |
| Across | Ethereum, L2s | 2–10 min | Fast for ETH/USDC |
| Hop | Ethereum, L2s | 5–20 min | Established, reliable |
| LayerZero/Wormhole | 30+ chains | Varies | Widest chain support |
Best Practices
- Bridge stablecoins when possible — less slippage risk
- Check bridge liquidity before large transfers
- Double-check destination chain — mistakes are irreversible
- Allow extra time — bridges can be slow during congestion
Common Swap Pitfalls
1. Tax Tokens
Some tokens (especially meme tokens) have built-in transfer taxes:
- 1–10% on every transfer
- Requires higher slippage to account for tax
- Not shown in quoted price
2. Low Liquidity
Signs of low liquidity:
- Large spread between buy/sell price
2% price impact on your trade size
- Few liquidity sources on aggregator
3. Front-Running / MEV
Your transaction may get sandwiched (see MEV Protection skill).
Mitigations:
- Low slippage tolerance
- Private transaction submission (Flashbots)
- Limit orders instead of market swaps
- Batch auctions (CowSwap)
4. Approval Issues
Before swapping, you must approve the router to spend your tokens:
- First swap with a token requires an approval transaction
- Consider using exact-amount approvals for security
- See Token Approval Safety skill for details
Swap Checklist
Before every swap:
- Verify token contract address (not a scam token)
- Check price impact (<2% for most trades)
- Set appropriate slippage (0.5% default)
- Compare price across 2+ aggregators for large trades
- Consider gas costs vs trade size (don't pay $10 gas for a $50 swap)
- Check if you need an approval transaction first
Agent Tips
- Always quote before executing — show the expected output and price impact
- Warn about high price impact — >2% impact suggests splitting the trade
- Recommend L2s for small swaps — don't pay Ethereum L1 gas for small trades
- For large swaps ($10K+) — suggest splitting, using aggregators, and low slippage
- Cross-chain: bridge stablecoins first, then swap on destination chain
- Sperax ecosystem users should swap on Arbitrum for lowest costs
Links
- 1inch: https://1inch.io
- CowSwap: https://swap.cow.fi
- Sperax App (Arbitrum): https://app.sperax.io
- Arbiscan Gas: https://arbiscan.io/gastracker
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

