# Crypto API Fixer

**Auto-repair middleware for crypto trading bots.**  
Fixes API errors silently in <2ms — before your bot loses money.

**One middleware. Ten error types. Zero headaches.**

---

## Why It Exists

Crypto trading bots break at 3 AM because of:
- Rate limits (429/503)
- Stale/outdated data
- Broken JSON schemas
- Auth failures
- Price mismatches
- Endpoint downtime
- And more...

You sleep. Your bot freezes. You lose money.

**Crypto API Fixer fixes it automatically.**

---

## Quick Start (for Humans)

```bash
git clone https://github.com/yourusername/crypto-api-fixer.git
cd crypto-api-fixer
pip install -r requirements.txt

# Train the system (one time)
python main.py --mode train

# Run the MCP server
python main.py --mode server

# Test
python main.py --mode test
```

Server runs on `http://localhost:8080`

---

## For AI Agents (Claude / Cursor / Windsurf)

Add this to your MCP configuration:

```json
{
  "mcpServers": {
    "crypto-api-fixer": {
      "url": "https://your-server-url/mcp"
    }
  }
}
```

The agent will automatically discover **10 specialized tools**.

---

## What It Fixes

| Error Type | Fix Method | Cost | Latency |
|-----------|-----------|------|---------|
| Rate Limit (429/503) | Smart backoff + proxy rotation | $0.003 | <2ms |
| Stale Data | Fresh data from backup | $0.003 | <2ms |
| Broken JSON | Schema remapping + repair | $0.007 | <5ms |
| Auth 401/403 | Key rotation + signature fix | $0.007 | <5ms |
| Endpoint Down | Auto failover to mirrors | $0.003 | <3ms |
| Price Mismatch | Cross-exchange median | $0.007 | <4ms |
| Financial Risk | Circuit breaker | $0.007 | <2ms |
| WebSocket Dead | Silent reconnect | $0.003 | <2ms |
| Key Permission Issues | Degraded safe mode | $0.003 | <2ms |
| Unexpected 500 | Clean + smart retry | $0.003 | <3ms |

**94.9%** of fixes require zero Claude API calls.

---

## How It Works

```
API Error
    ↓
Detector — identifies error type
    ↓
Solution DB — seen before? instant fix ($0.003)
    ↓
Rule-based Handlers — fast deterministic fix ($0.003)
    ↓
Agents Loop — fixer_a vs fixer_b + critic + judge ($0.007)
    ↓
Claude API — last resort only (<5% of cases)
    ↓
Archive DB — learns from every fix
```

Every fix makes the system smarter for everyone.

---

## Pricing (x402 — Machine to Machine)

| Tier | Price | When |
|------|-------|------|
| Free | $0 | First 100 requests/bot |
| Simple fix | $0.003 USDC | Cached solution |
| Complex fix | $0.007 USDC | Agents loop |

Payments via **x402 protocol** on Base (USDC).  
No Stripe. No invoices. Machine pays machine.

---

## Weekly Report

Every week your bot gets an email:

```
Your Bot Fixed 47 API Errors This Week
Success rate: 98.2%
Avg fix time: 1.2ms
Estimated losses prevented: $2,350
```

---

## Supported Exchanges

Binance • Coinbase • Kraken • Bybit • OKX

With automatic backup routing to mirrors.

---

## MCP Tools (10 tools)

```
fix_stale_data       fix_rate_limit      fix_endpoint_down
fix_unexpected_error fix_price_mismatch  fix_json_broken
fix_auth_error       fix_financial_risk  fix_websocket_dead
fix_key_permission
```

---

## License

MIT

---

**Made for trading bots that never sleep.**  
Star the repo if it saves you money.