Arbitrage Finder

# Arbitrage Finder 🔄

Discover cross-exchange arbitrage opportunities by scanning price differences, factoring in fees and transfer times, and scoring profitability.

## How It Works — Step by Step

### Step 1: Configure Exchanges

Set up the exchanges you want to monitor. The tool uses public ticker APIs (no API keys needed for price scanning).

```bash
bash scripts/arbitrage-finder.sh config \
  --exchanges "binance,okx,bybit,coinbase,kraken,kucoin"
```

### Step 2: Scan for Opportunities

Run a scan across all configured exchanges for a specific asset or all tracked assets:

```bash
# Scan specific pair
bash scripts/arbitrage-finder.sh scan --pair BTC/USDT

# Scan all tracked pairs
bash scripts/arbitrage-finder.sh scan --all

# Scan with minimum spread threshold
bash scripts/arbitrage-finder.sh scan --all --min-spread 0.5
```

### Step 3: Analyze an Opportunity

When a spread is found, analyze it with fees and timing factored in:

```bash
bash scripts/arbitrage-finder.sh analyze \
  --pair ETH/USDT \
  --buy-exchange binance \
  --sell-exchange coinbase \
  --amount 10000
```

This outputs:
- Buy price & total cost (including fees)
- Sell price & total revenue (minus fees)
- Network transfer fee and estimated time
- **Net profit/loss** after all costs
- **Opportunity score** (0-100)

### Step 4: Review History

Track past opportunities and their outcomes:

```bash
bash scripts/arbitrage-finder.sh history --days 7 --pair BTC/USDT
```

### Step 5: Generate Report

```bash
bash scripts/arbitrage-finder.sh report --days 30 --output arb-report.html
```

## Opportunity Scoring

Each opportunity is scored 0-100 based on:

| Factor | Weight | How It's Measured |
|--------|--------|------------------|
| Net Spread | 30% | Spread after ALL fees |
| Liquidity | 25% | Can you fill the order at quoted price? |
| Transfer Speed | 20% | Faster = less price risk |
| Historical Success | 15% | Has this route been profitable before? |
| Volatility Risk | 10% | Price change risk d...