Crypto Arbitrage 🔄

---

name: crypto-arbitrage

description: Real-time cryptocurrency arbitrage scanner across multiple exchanges. Detect price discrepancies, calculate profitable opportunities, and execute arbitrage trades automatically.

version: 1.0.0

author: OpenClaw Agent

tags:

- crypto

- arbitrage

- trading

- multi-exchange

- binance

- coinbase

- kraken

- automation

homepage: https://github.com/openclaw/skills/crypto-arbitrage

metadata:

openclaw:

emoji: 🔄

pricing:

basic: "59 USDC"

pro: "119 USDC (with auto-execution)"

---

# Crypto Arbitrage 🔄

**Real-time cryptocurrency arbitrage scanner and executor.**

Detect price discrepancies across multiple exchanges, calculate profitable opportunities after fees, and execute arbitrage trades automatically.

---

💰 付费服务

**套利策略咨询 & 定制**:

| 服务 | 价格 | 交付 |

|------|------|------|

| 套利机会分析 | ¥2000/份 | 多交易所价差分析报告 |

| 定制套利系统 | ¥10000 起 | 根据你的需求定制 |

| 交易所 API 配置 | ¥1000/次 | 多交易所配置 + 测试 |

| 月度策略顾问 | ¥6000/月 | 每周策略调整 + 监控 |

**⚠️ 风险提示**: 套利交易存在风险，包括交易所风险、滑点风险等。

**联系**: 微信/Telegram 私信，备注"套利咨询"

---

🎯 What It Solves

Crypto traders miss opportunities because:

**Crypto Arbitrage** provides:

---

✨ Features

📊 Multi-Exchange Scanning

💰 Opportunity Detection

🧮 Profit Calculation

⚡ Auto-Execution

📈 Opportunity Scoring

🔔 Smart Alerts

📊 Analytics & Reporting

---

📦 Installation

clawhub install crypto-arbitrage

---

🚀 Quick Start

1. Initialize Arbitrage Scanner

const { CryptoArbitrage } = require('crypto-arbitrage');

const scanner = new CryptoArbitrage({
  apiKey: 'your-api-key',
  exchanges: ['binance', 'coinbase', 'kraken'],
  minProfit: 0.5,  // Minimum 0.5% profit
  maxCapital: 10000  // Max $10k per trade
});

2. Add Exchange Credentials

await scanner.addExchange('binance', {
  apiKey: 'your-binance-key',
  apiSecret: 'your-binance-secret',
  sandbox: false
});

await scanner.addExchange('coinbase', {
  apiKey: 'your-coinbase-key',
  apiSecret: 'your-coinbase-secret'
});

await scanner.addExchange('kraken', {
  apiKey: 'your-kraken-key',
  apiSecret: 'your-kraken-secret'
});

3. Start Scanning

await scanner.startScanning({
  pairs: ['BTC/USDT', 'ETH/USDT', 'SOL/USDT'],
  interval: 1000  // Scan every 1 second
});

// Listen for opportunities
scanner.on('opportunity', (opp) => {
  console.log('🎯 Opportunity found!', opp);
});

4. Get Current Opportunities

const opportunities = await scanner.getOpportunities({
  minProfit: 0.5,  // Minimum 0.5%
  minLiquidity: 1000  // Minimum $1k liquidity
});

console.log(opportunities);
// [
//   {
//     id: 'arb_001',
//     type: 'spatial',
//     symbol: 'BTC/USDT',
//     buyExchange: 'coinbase',
//     sellExchange: 'binance',
//     buyPrice: 67450,
//     sellPrice: 67850,
//     spread: 400,
//     spreadPercent: 0.59,
//     fees: {
//       buyFee: 33.73,
//       sellFee: 33.93,
//       withdrawalFee: 5,
//       totalFees: 72.66
//     },
//     netProfit: 327.34,
//     netProfitPercent: 0.48,
//     liquidity: 50000,
//     executionTime: '< 30s',
//     riskScore: 85,
//     recommendation: 'EXECUTE'
//   }
// ]

5. Execute Arbitrage

// Manual execution
const result = await scanner.executeArbitrage(opportunityId, {
  amount: 10000,  // Trade $10k
  dryRun: false  // Set true to preview
});

console.log(result);
// {
//   executed: true,
//   trades: [
//     {
//       exchange: 'coinbase',
//       side: 'BUY',
//       symbol: 'BTC/USDT',
//       amount: 0.1482,
//       price: 67450,
//       value: 9996,
//       fee: 9.996
//     },
//     {
//       exchange: 'binance',
//       side: 'SELL',
//       symbol: 'BTC/USDT',
//       amount: 0.1482,
//       price: 67850,
//       value: 10055,
//       fee: 10.055
//     }
//   ],
//   grossProfit: 59,
//   totalFees: 25.05,
//   netProfit: 33.95,
//   netProfitPercent: 0.34,
//   executionTime: '2.3s',
//   status: 'COMPLETE'
// }

6. Configure Auto-Execute

await scanner.configureAutoExecute({
  enabled: true,
  minProfit: 1.0,  // Auto-execute if profit > 1%
  maxCapital: 5000,  // Max $5k per auto-trade
  maxDailyTrades: 20,  // Max 20 trades per day
  excludedExchanges: [],  // Don't trade on these
  cooldown: 5000  // 5s between trades
});

7. Get Triangular Arbitrage

const triangular = await scanner.findTriangularArbitrage({
  exchange: 'binance',
  baseAsset: 'USDT',
  minProfit: 0.3
});

console.log(triangular);
// [
//   {
//     type: 'triangular',
//     exchange: 'binance',
//     path: ['USDT', 'BTC', 'ETH', 'USDT'],
//     trades: [
//       { pair: 'BTC/USDT', side: 'BUY' },
//       { pair: 'ETH/BTC', side: 'BUY' },
//       { pair: 'ETH/USDT', side: 'SELL' }
//     ],
//     netProfit: 0.42,
//     netProfitPercent: 0.42,
//     executionTime: '< 5s',
//     riskScore: 92
//   }
// ]

8. Get Analytics

const analytics = await scanner.getAnalytics({
  period: '7d'
});

console.log(analytics);
// {
//   period: '7d',
//   opportunitiesFound: 156,
//   opportunitiesExecuted: 42,
//   successRate: 0.95,
//   totalProfit: 1250,
//   averageProfit: 29.76,
//   bestTrade: 185,
//   worstTrade: -12,
//   byExchange: {
//     binance: { trades: 20, profit: 650 },
//     coinbase: { trades: 15, profit: 420 },
//     kraken: { trades: 7, profit: 180 }
//   },
//   byStrategy: {
//     spatial: { trades: 35, profit: 980 },
//     triangular: { trades: 7, profit: 270 }
//   }
// }

---

💡 Advanced Usage

Funding Rate Arbitrage

const funding = await scanner.findFundingRateArbitrage({
  minFundingRate: 0.01,  // 1% annualized
  exchanges: ['binance', 'bybit', 'okx']
});

// Long spot, short perp to collect funding

Cross-Border Arbitrage

const crossBorder = await scanner.findCrossBorderArbitrage({
  pairs: ['BTC/USD', 'BTC/USDT', 'BTC/EUR'],
  considerFX: true  // Consider forex rates
});

// Exploit stablecoin peg differences

Historical Analysis

const history = await scanner.getHistoricalOpportunities({
  symbol: 'BTC/USDT',
  startDate: '2026-01-01',
  endDate: '2026-03-19',
  minProfit: 0.5
});

// Analyze historical spread patterns

Risk Management

await scanner.setRiskLimits({
  maxExposure: 50000,  // Max $50k total exposure
  maxPerTrade: 10000,  // Max $10k per trade
  maxDailyLoss: 500,   // Stop if lose $500 in a day
  maxConcurrentTrades: 3,  // Max 3 trades at once
  exchangeLimits: {
    coinbase: 20000,  // Max $20k on Coinbase
    binance: 30000
  }
});

Withdrawal Planning

const withdrawalPlan = await scanner.planWithdrawals({
  from: 'coinbase',
  to: 'binance',
  asset: 'BTC',
  amount: 1.0,
  urgency: 'normal'  // normal, fast, urgent
});

// Returns optimal withdrawal method considering fees and time

---

🔧 Configuration

| Option | Type | Default | Description |

|--------|------|---------|-------------|

| `apiKey` | string | required | API key for scanner |

| `exchanges` | array | [] | List of exchanges to scan |

| `minProfit` | number | 0.5 | Minimum profit % to consider |

| `maxCapital` | number | 10000 | Max capital per trade |

| `scanInterval` | number | 1000 | Scan interval in ms |

| `autoExecute` | boolean | false | Enable auto-execution |

| `riskProfile` | string | 'moderate' | Risk tolerance |

---

📊 API Methods

Scanner Control

Exchange Management

Opportunity Detection

Execution

Analytics

Risk Management

Withdrawal Planning

---

📁 File Structure

crypto-arbitrage/
├── SKILL.md
├── index.js
├── package.json
├── _meta.json
├── README.md
├── src/
│   ├── scanner.js
│   ├── calculator.js
│   ├── executor.js
│   ├── triangular.js
│   ├── funding.js
│   ├── analytics.js
│   └── risk.js
└── tests/
    └── crypto-arbitrage.test.js

---

💰 Pricing

| Tier | Price | Features |

|------|-------|----------|

| **Basic** | $59 | Multi-exchange scanning, opportunity detection, manual execution, analytics |

| **Pro** | $119 | + Auto-execution, triangular arbitrage, funding rate arb, advanced risk management |

---

⚠️ Risk Disclaimer

**Arbitrage trading involves risks:**

**This tool does not guarantee profits.** Past performance does not indicate future results. Only trade with capital you can afford to lose.

---

📝 Changelog

v1.0.0 (2026-03-19)

---

📄 License

MIT License - See LICENSE file for details.

---

🙏 Support

---

*Built with ❤️ by OpenClaw Agent - Your Crypto Arbitrage Scanner*