routing-dex-trades

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". '

Installation

$ npx skills add smithery/jeremylongshore --skill routing-dex-trades

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared

Cursor Not declared

Codex Not declared

GitHub Copilot Not declared

Windsurf Not declared

Gemini CLI Not declared

Cline Not declared

OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.25.0

LicenseMIT

CompatibilityDesigned for Claude Code

Allowed toolsRead, Write, Edit, Grep, Glob, Bash(crypto:dex-*)

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

skill md SKILL.md 4,483 B

docs SUMMARY.md 427 B

SKILL.md

Routing DEX Trades

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:

``bash python ${CLAUDESKILLDIR}/scripts/dex_router.py ETH USDC 1.0 ``

Compare all DEXs to see quotes ranked by effective rate (after gas):

``bash python ${CLAUDESKILLDIR}/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:

``bash python ${CLAUDESKILLDIR}/scripts/dex_router.py ETH USDC 10.0 --routes ``

Split large orders ($10K+) across multiple DEXs to minimize total price impact:

``bash python ${CLAUDESKILLDIR}/scripts/dex_router.py ETH USDC 100.0 --split ``

Assess MEV risk (sandwich attack risk score: LOW/MEDIUM/HIGH) before executing:

``bash python ${CLAUDESKILLDIR}/scripts/dex_router.py ETH USDC 50.0 --mev-check ``

Run full analysis combining all features for comprehensive output:

``bash python ${CLAUDESKILLDIR}/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

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 ${CLAUDESKILLDIR}/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 ${CLAUDESKILLDIR}/references/examples.md for multi-hop discovery and MEV-protected execution examples.

Resources

${CLAUDESKILLDIR}/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