Routing DEX Trades
Contents
Overview | Prerequisites | Instructions | Output | Error Handling | Examples | Resources
Overview
Optimal trade routing across decentralized exchanges by aggregating quotes from 1inch, Paraswap, and 0x. Discovers multi-hop routes, calculates split orders for large trades, and assesses MEV risk to minimize slippage and gas costs.
Prerequisites
- Install Python 3.9+ with
httpx, pydantic, and rich packages
- Verify network access to aggregator APIs (1inch, Paraswap, 0x)
- Optionally add API keys for 1inch and 0x (higher rate limits)
- Copy settings:
cp ${CLAUDESKILLDIR}/config/settings.yaml.example ${CLAUDESKILLDIR}/config/settings.yaml
Instructions
- Get a quick quote for the single best price with gas cost and effective rate:
python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 1.0
- Compare all DEXs to see quotes ranked by effective rate (after gas):
python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 5.0 --compare
- Analyze multi-hop routes to compare direct vs. multi-hop (2-3 pools) with hop-by-hop breakdown:
python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 10.0 --routes
- Split large orders ($10K+) across multiple DEXs to minimize total price impact:
python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 100.0 --split
- Assess MEV risk (sandwich attack risk score: LOW/MEDIUM/HIGH) before executing:
python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 50.0 --mev-check
- Run full analysis combining all features for comprehensive output:
python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 25.0 --full --output json
Output
- Quick Quote: Best price, output amount, gas cost, recommended venue
- Comparison: All venues ranked by effective rate with price impact and gas
- Route Analysis: Direct vs. multi-hop with hop-by-hop breakdown
- Split Mode: Optimal allocation percentages with dollar savings vs. single-venue
- MEV Assessment: Risk score, exposure estimate, protection recommendations
See ${CLAUDESKILLDIR}/references/implementation.md for detailed output examples.
Error Handling
How It Works
Find Best Route Command
/find-best-route
Or use the shortcut:
/route
Example Queries
/route Best route to swap 10 ETH for USDC
/route Compare Uniswap vs SushiSwap for DAI to USDC
/route I want to swap $50,000 USDT to ETH - optimize routing
/route Why does 1inch show better rate than Uniswap?
/route Should I swap LINK → ETH → USDC or LINK → USDC directly?
Ready to use dex-aggregator-router?
