routing-dex-trades — Claude Code skill for routing DEX swaps
routing-dex-trades — a skill that pulls quotes from 1inch, Paraswap, and 0x to find swap routes with lower slippage and gas. Use it before trading to compare venues or split a large order.
MIT 1 installs ★ 2,935 updated 2026-11-01
npx skills add jeremylongshore/tons-of-skills-marketplace --skill routing-dex-trades -a claude-codeWhat routing-dex-trades does
The skill queries three aggregators and ranks venues by effective rate, the price you actually get after gas. It can also discover multi-hop routes through two or three pools and show the hop-by-hop breakdown. Orders from $10K up can be split across DEXs to reduce total price impact.
Everything runs through a Python script, dex_router.py, with flags per mode. --compare ranks all venues, --routes puts direct against multi-hop, --split allocates a large order across venues, and --mev-check scores sandwich attack risk as LOW, MEDIUM, or HIGH. --full runs the whole analysis and outputs JSON.
You need Python 3.9+ with httpx, pydantic, and rich. Without API keys for 1inch and 0x the skill still works, but request limits will bite sooner — add keys if you plan to run it often. Copy settings from config/settings.yaml.example to config/settings.yaml first.
What it helps with
- compare swap prices across DEXs
- find a multi-hop route instead of a direct one
- split a large order across venues
- check sandwich attack risk before executing
- calculate the effective rate after gas
Example prompts for the agent
- Compare prices for a 5 ETH to USDC swap and show the best venue
- Split a 100 ETH order across DEXs to reduce price impact
- Check MEV risk for a 50 ETH to USDC swap
How to install routing-dex-trades
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill routing-dex-trades -a claude-code2Manually: put the files in place
~/.claude/skills/routing-dex-trades/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/routing-dex-trades/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill routing-dex-trades -a codex2Manually: put the files in place
.agents/skills/routing-dex-trades/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill routing-dex-trades -a cursor2Manually: put the files in place
.cursor/skills/routing-dex-trades/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/routing-dex-trades2Manually: put the files in place
.github/skills/routing-dex-trades/SKILL.md1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill routing-dex-trades -a gemini-cli2Platform CLI
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/routing-dex-tradesManually: put the files in place
.devin/skills/routing-dex-trades/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill routing-dex-trades -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about routing-dex-trades
How do I install routing-dex-trades in Claude Code?
Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill routing-dex-trades -a claude-code. The skill lands in ~/.claude/skills/routing-dex-trades/SKILL.md.
What does routing-dex-trades do?
It aggregates quotes from 1inch, Paraswap, and 0x, finds swap routes with lower slippage and gas, splits large orders, and scores MEV risk.
What do I need before using it?
Python 3.9+ with httpx, pydantic, and rich, plus network access to the aggregator APIs. API keys for 1inch and 0x are optional but raise rate limits.
Source text
SKILL.md · MIT
--- name: routing-dex-trades description: 'Route trades across multiple DEXs to find optimal prices with minimal slippage and gas costs. Use when comparing DEX prices, finding optimal swap routes, analyzing price impact, splitting large orders, or assessing MEV risk. Trigger with phrases like "find best swap", "compare DEX prices", "route trade", "optimal swap route", "split order", "DEX aggregator", "check slippage", or "MEV protection". ' allowed-tools: Read, Write, Edit, Grep, Glob, Bash(crypto:dex-*) version: 1.26.0 author: Jeremy Longshore <[email protected]> license: MIT tags: - crypto - cost-optimization - routing-dex compatibility: Designed for Claude Code --- # Routing DEX Trades ## Contents [Overview](#overview) | [Prerequisites](#prerequisites) | [Instructions](#instructions) | [Output](#output) | [Error Handling](#error-handling) | [Examples](#examples) | [Resources](#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 1. Install Python 3.9+ with `httpx`, `pydantic`, and `rich` packages 2. Verify network access to aggregator APIs (1inch, Paraswap, 0x) 3. Optionally add API keys for 1inch and 0x (higher rate limits) 4. Copy settings: `cp ${CLAUDE_SKILL_DIR}/config/settings.yaml.example ${CLAUDE_SKILL_DIR}/config/settings.yaml` ## Instructions 1. Get a quick quote for the single best price with gas cost and effective rate: ```bash python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 1.0 ``` 2. Compare all DEXs to see quotes ranked by effective rate (after gas): ```bash python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 5.0 --compare ``` 3. Analyze multi-hop routes to compare direct vs. multi-hop (2-3 pools) with hop-by-hop breakdown: ```bash python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 10.0 --routes ``` 4. Split large orders ($10K+) across multiple DEXs to minimize total price impact: ```bash python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 100.0 --split ``` 5. Assess MEV risk (sandwich attack risk score: LOW/MEDIUM/HIGH) before executing: ```bash python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 50.0 --mev-check ``` 6. Run full analysis combining all features for comprehensive output: ```bash 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 [`references/implementation.md`](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 [`references/errors.md`](references/errors.md) for comprehensive error handling. ## Examples **Compare prices for a 5 ETH swap:** ```bash python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 5.0 --compare ``` **Find optimal split for a large order:** ```bash python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 100.0 --split ``` **Check MEV risk before executing:** ```bash python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 50.0 --mev-check ``` See [`references/examples.md`](references/examples.md) for multi-hop discovery and MEV-protected execution examples. ## Resources - [`references/implementation.md`](references/implementation.md) - Trade size guide, split optimization, MEV scoring, API config - [1inch API](https://docs.1inch.io/) - Primary aggregator - [Paraswap API](https://developers.paraswap.network/) - Secondary aggregator - [0x API](https://0x.org/docs/api) - Third aggregator - [Flashbots Protect](https://docs.flashbots.net/flashbots-protect/overview) - MEV protection
© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace