tomevault-io 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, andrichpackages - Verify network access to aggregator APIs (1inch, Paraswap, 0x)
- Optionally add API keys for 1inch and 0x (higher rate limits)
- Copy settings:
cp ${CLAUDE_SKILL_DIR}/config/settings.yaml.example ${CLAUDE_SKILL_DIR}/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 ${CLAUDE_SKILL_DIR}/references/implementation.md for detailed output examples.
Error Handling
| Error | Cause | Solution |
|---|---|---|
| API Rate Limited | Too many requests | Wait 60s or add API key for higher limits |
| Quote Expired | Stale price data | Refresh before execution; quotes valid ~30s |
| No Route Found | Low liquidity token | Try larger DEXs or reduce trade size |
| Network Timeout | Aggregator down | Retry or check aggregator status page |
See ${CLAUDE_SKILL_DIR}/references/errors.md for comprehensive error handling.
Examples
Compare prices for a 5 ETH swap:
python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 5.0 --compare
Find optimal split for a large order:
python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 100.0 --split
Check MEV risk before executing:
python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 50.0 --mev-check
See ${CLAUDE_SKILL_DIR}/references/examples.md for multi-hop discovery and MEV-protected execution examples.
Resources
${CLAUDE_SKILL_DIR}/references/implementation.md- Trade size guide, split optimization, MEV scoring, API config- 1inch API - Primary aggregator
- Paraswap API - Secondary aggregator
- 0x API - Third aggregator
- Flashbots Protect - MEV protection
Converted and distributed by TomeVault — claim your Tome and manage your conversions.