Claude-code-plugins routing-dex-trades

install
source · Clone the upstream repo
git clone https://github.com/jeremylongshore/claude-code-plugins-plus-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jeremylongshore/claude-code-plugins-plus-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/crypto/dex-aggregator-router/skills/routing-dex-trades" ~/.claude/skills/jeremylongshore-claude-code-plugins-routing-dex-trades && rm -rf "$T"
manifest: plugins/crypto/dex-aggregator-router/skills/routing-dex-trades/SKILL.md
source content

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

  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:
    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):
    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:
    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:
    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:
    python ${CLAUDE_SKILL_DIR}/scripts/dex_router.py ETH USDC 50.0 --mev-check
    
  6. 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

ErrorCauseSolution
API Rate LimitedToo many requestsWait 60s or add API key for higher limits
Quote ExpiredStale price dataRefresh before execution; quotes valid ~30s
No Route FoundLow liquidity tokenTry larger DEXs or reduce trade size
Network TimeoutAggregator downRetry 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