finding-arbitrage-opportunities

# Finding Arbitrage Opportunities

## Overview

This skill detects and analyzes arbitrage opportunities across cryptocurrency exchanges and DeFi protocols. It aggregates prices from multiple sources, calculates net profit after fees and costs, and identifies both direct and triangular arbitrage paths.

## Prerequisites

Before using this skill, ensure you have:
- 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

### Step 1: Configure Data Sources

Configure your price sources in `{baseDir}/config/settings.yaml`:

```yaml
# Primary data sources
data_sources:
  coingecko:
    enabled: true
    base_url: "https://api.coingecko.com/api/v3"
    rate_limit: 10  # calls per minute (free tier)

exchanges:
  - binance
  - coinbase
  - kraken
  - kucoin
  - okx
```

Or use environment variables for API keys:
```bash
export BINANCE_API_KEY="your-key"
export COINBASE_API_KEY="your-key"
```

### Step 2: Quick Spread Scan

Scan for arbitrage opportunities on a specific pair:
```bash
python {baseDir}/scripts/arb_finder.py scan ETH USDC
```

This shows:
- Current prices on each exchange
- Spread percentage
- Estimated profit after fees
- Recommended action

### Step 3: Multi-Exchange Comparison

Compare prices across specific exchanges:
```bash
python {baseDir}/scripts/arb_finder.py scan ETH USDC \
  --exchanges binance,coinbase,kraken,kucoin,okx
```

Output includes:
| Exchange | Bid | Ask | Spread | Net Profit |
|----------|-----|-----|--------|------------|
| Binance | 2541.20 | 2541.50 | 0.01% | - |
| Coinbase | 2543.80 | 2544.10 | 0.01% | +$2.30 |

### Step 4: DEX Price Comparison

Scan decentralized exchanges for arbitrage:
```bash
python {baseDir}/scripts/arb_finder.py scan ETH USDC --dex-only
```

Compares:
- Uniswap V3
- SushiSwap
- Curve
- Balancer

Includes gas c