finding-arbitrage-opportunities

name	finding-arbitrage-opportunities
description	Detect profitable arbitrage opportunities across CEX, DEX, and cross-chain markets in real-time. Use when scanning for price spreads, finding arbitrage paths, comparing exchange prices, or analyzing triangular arbitrage opportunities. Trigger with phrases like "find arbitrage", "scan for arb", "price spread", "exchange arbitrage", "triangular arb", "DEX price difference", or "cross-exchange opportunity".
allowed-tools	Read, Write, Edit, Grep, Glob, Bash(crypto:arbitrage-*)
version	1.0.0
author	Jeremy Longshore <[e-mail]>
license	MIT
compatible-with	claude-code, codex, openclaw
tags	["crypto","finding-arbitrage"]

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 /scripts/arb_finder.py scan ETH USDC --output json > opportunities.json