New to Claude Skills? Learn how to install them →

jeremylongshore on GitHub

Finding Arbitrage Opportunities

Free

Detect and analyze crypto arbitrage opportunities in real-time.

Get this skill

Free · Opens the source repo

What Finding Arbitrage Opportunities does

Finding Arbitrage Opportunities is a skill designed to help users identify and capitalize on profitable arbitrage opportunities across centralized exchanges (CEX), decentralized exchanges (DEX), and cross-chain markets. By aggregating prices from various sources, the skill enables users to scan for price spreads, analyze triangular arbitrage paths, and discover potential profit across different trading venues. This tool is particularly useful for traders looking to optimize their strategies and maximize returns by taking advantage of price discrepancies in the fast-paced cryptocurrency market.

The skill operates using a series of Python scripts that allow users to perform quick scans, detailed comparisons, and real-time monitoring of price spreads. Users can execute commands to check for arbitrage opportunities on specific trading pairs, compare prices across multiple exchanges, or even analyze complex triangular arbitrage scenarios within a single exchange. Additionally, the skill supports cross-chain comparisons, making it versatile for traders operating in multi-chain environments.

To get started, users need a basic understanding of arbitrage concepts and trading fees, along with the necessary Python environment set up. The skill does not require API keys for basic functionality, but users can enhance their experience by integrating exchange API keys for real-time order book access. The output provides actionable insights, including profit estimates, risk levels, and recommended actions, enabling users to make informed trading decisions quickly.

This skill is ideal for cryptocurrency traders, analysts, and developers interested in automating their arbitrage strategies. By leveraging this tool, users can stay ahead of market movements and efficiently identify opportunities that may otherwise go unnoticed in the rapidly evolving crypto landscape.

When to use it

Use this skill when you want to scan for arbitrage opportunities in the cryptocurrency market or when analyzing price spreads between different exchanges.

When not to use it

Avoid using this skill if you are not familiar with arbitrage concepts or if you require a tool for long-term investment strategies rather than short-term trading.

What you can build with it

Quick Spread Scan

Perform a quick scan to find the best buy/sell opportunities for a specific trading pair across exchanges.

Triangular Arbitrage Discovery

Analyze a single exchange for triangular arbitrage opportunities to maximize profit potential.

Cross-Chain Price Comparison

Compare stablecoin prices across different blockchains to identify arbitrage opportunities in multi-chain environments.

How to install Finding Arbitrage Opportunities

View source

1. Install with the skills CLI

npx skills add jeremylongshore/claude-code-plugins-plus-skills/finding-arbitrage-opportunities --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by jeremylongshore

Finding Arbitrage Opportunities

Overview

Detect and analyze arbitrage opportunities across cryptocurrency exchanges and DeFi protocols. Aggregates prices from CEX and DEX sources, calculates net profit after fees, and identifies direct, triangular, and cross-chain arbitrage paths.

Prerequisites

  • Python 3.9+ with httpx, rich, and networkx packages
  • Internet access for API calls (no API keys required for basic use)
  • Optional: Exchange API keys for real-time order book access
  • Understanding of arbitrage concepts and trading fees

Instructions

  1. Quick spread scan on a specific pair:

    python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC
    

    Shows current prices per exchange, spread %, estimated profit after fees, and recommended action.

  2. Multi-exchange comparison across specific exchanges:

    python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC \
      --exchanges binance,coinbase,kraken,kucoin,okx
    
  3. DEX price comparison across decentralized exchanges:

    python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC --dex-only
    

    Compares Uniswap V3, SushiSwap, Curve, Balancer with gas cost estimates.

  4. Triangular arbitrage discovery within a single exchange:

    python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py triangular binance --min-profit 0.5
    
  5. Cross-chain opportunities across different blockchains:

    python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py cross-chain USDC \
      --chains ethereum,polygon,arbitrum
    
  6. Real-time monitoring with threshold alerts:

    python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py monitor ETH USDC \
      --threshold 0.5 --interval 5
    
  7. Export opportunities for bot integration:

    python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC --output json > opportunities.json
    

Output

  • Quick mode (default): Best opportunity with profit estimate, buy/sell recommendation, risk level
  • Detailed mode (--detailed): All exchange prices, fee breakdown, slippage estimates, historical spread context
  • Monitor mode: Real-time updates with threshold alerts and trend indicators

See ${CLAUDE_SKILL_DIR}/references/implementation.md for exchange fee tables and output format examples.

Error Handling

ErrorCauseFix
Rate limitedToo many API requestsReduce polling frequency or add API key
Stale pricesData older than 10sFlagged with warning; retry
No spreadEfficient market pricingNormal condition; try different pairs
Insufficient liquidityTrade exceeds order book depthReduce trade size

Examples

Quick ETH/USDC spread scan - Find best buy/sell across all CEX exchanges:

python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC

Sample detection output:

  ARB OPPORTUNITY: ETH/USDC
  Buy:  Binance  @ $3,198.50  |  Sell: Coinbase @ $3,214.20
  Spread: 0.49%  |  Net Profit (after fees): 0.29% ($9.27 per ETH)
  Risk: LOW  |  Confidence: HIGH  |  Window: ~30s

Triangular arb on Binance - Discover circular paths with minimum 0.5% net profit:

python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py triangular binance --min-profit 0.5

Cross-chain USDC opportunities - Compare stablecoin prices across L1/L2 chains:

python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py cross-chain USDC --chains ethereum,polygon,arbitrum

Calculate exact profit - Detailed fee breakdown for a specific trade:

python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py calc \
  --buy-exchange binance --sell-exchange coinbase --pair ETH/USDC --amount 10  # 10 = trade size in ETH

Resources

  • CoinGecko API - Free price data
  • CCXT Library - Unified exchange API
  • Uniswap Subgraph - DEX data
  • ${CLAUDE_SKILL_DIR}/references/implementation.md - Exchange fee tables, configuration, advanced arbitrage types, disclaimer

Frequently asked questions about Finding Arbitrage Opportunities

Similar skills