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
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.
Multi-exchange comparison across specific exchanges:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC \
--exchanges binance,coinbase,kraken,kucoin,okx
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.
Triangular arbitrage discovery within a single exchange:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py triangular binance --min-profit 0.5
Cross-chain opportunities across different blockchains:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py cross-chain USDC \
--chains ethereum,polygon,arbitrum
Real-time monitoring with threshold alerts:
python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py monitor ETH USDC \
--threshold 0.5 --interval 5
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
| Error |
Cause |
Fix |
| Rate limited |
Too many API requests |
Reduce polling frequency or add API key |
| Stale prices |
Data older than 10s |
Flagged with warning; retry |
| No spread |
Efficient market pricing |
Normal condition; try different pairs |
| Insufficient liquidity |
Trade exceeds order book depth |
Reduce 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
1---2name: finding-arbitrage-opportunities3description: 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".4license: MIT5---6# Finding Arbitrage Opportunities
7
8## Overview
9
10Detect 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.
11
12## Prerequisites
13
14- Python 3.9+ with `httpx`, `rich`, and `networkx` packages
15- Internet access for API calls (no API keys required for basic use)
16- Optional: Exchange API keys for real-time order book access
17- Understanding of arbitrage concepts and trading fees
18
19## Instructions
20
211. **Quick spread scan** on a specific pair:
22 ```bash
23 python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC
24 ```
25 Shows current prices per exchange, spread %, estimated profit after fees, and recommended action.
26
272. **Multi-exchange comparison** across specific exchanges:
28 ```bash
29 python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC \
30 --exchanges binance,coinbase,kraken,kucoin,okx
31 ```
32
333. **DEX price comparison** across decentralized exchanges:
34 ```bash
35 python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC --dex-only
36 ```
37 Compares Uniswap V3, SushiSwap, Curve, Balancer with gas cost estimates.
38
394. **Triangular arbitrage discovery** within a single exchange:
40 ```bash
41 python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py triangular binance --min-profit 0.5
42 ```
43
445. **Cross-chain opportunities** across different blockchains:
45 ```bash
46 python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py cross-chain USDC \
47 --chains ethereum,polygon,arbitrum
48 ```
49
506. **Real-time monitoring** with threshold alerts:
51 ```bash
52 python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py monitor ETH USDC \
53 --threshold 0.5 --interval 5
54 ```
55
567. **Export opportunities** for bot integration:
57 ```bash
58 python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC --output json > opportunities.json
59 ```
60
61## Output
62
63- **Quick mode** (default): Best opportunity with profit estimate, buy/sell recommendation, risk level
64- **Detailed mode** (`--detailed`): All exchange prices, fee breakdown, slippage estimates, historical spread context
65- **Monitor mode**: Real-time updates with threshold alerts and trend indicators
66
67See `${CLAUDE_SKILL_DIR}/references/implementation.md` for exchange fee tables and output format examples.
68
69## Error Handling
70
71| Error | Cause | Fix |
72|-------|-------|-----|
73| Rate limited | Too many API requests | Reduce polling frequency or add API key |
74| Stale prices | Data older than 10s | Flagged with warning; retry |
75| No spread | Efficient market pricing | Normal condition; try different pairs |
76| Insufficient liquidity | Trade exceeds order book depth | Reduce trade size |
77
78## Examples
79
80**Quick ETH/USDC spread scan** - Find best buy/sell across all CEX exchanges:
81```bash
82python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py scan ETH USDC
83```
84
85Sample detection output:
86```
87 ARB OPPORTUNITY: ETH/USDC
88 Buy: Binance @ $3,198.50 | Sell: Coinbase @ $3,214.20
89 Spread: 0.49% | Net Profit (after fees): 0.29% ($9.27 per ETH)
90 Risk: LOW | Confidence: HIGH | Window: ~30s
91```
92
93**Triangular arb on Binance** - Discover circular paths with minimum 0.5% net profit:
94```bash
95python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py triangular binance --min-profit 0.5
96```
97
98**Cross-chain USDC opportunities** - Compare stablecoin prices across L1/L2 chains:
99```bash
100python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py cross-chain USDC --chains ethereum,polygon,arbitrum
101```
102
103**Calculate exact profit** - Detailed fee breakdown for a specific trade:
104```bash
105python ${CLAUDE_SKILL_DIR}/scripts/arb_finder.py calc \
106 --buy-exchange binance --sell-exchange coinbase --pair ETH/USDC --amount 10 # 10 = trade size in ETH
107```
108
109## Resources
110
111- [CoinGecko API](https://www.coingecko.com/en/api) - Free price data
112- [CCXT Library](https://github.com/ccxt/ccxt) - Unified exchange API
113- [Uniswap Subgraph](https://thegraph.com/hosted-service/subgraph/uniswap/uniswap-v3) - DEX data
114- `${CLAUDE_SKILL_DIR}/references/implementation.md` - Exchange fee tables, configuration, advanced arbitrage types, disclaimer
micsapp