功能描述

Real-time cryptocurrency arbitrage scanner across multiple exchanges. Detect price discrepancies, calculate profitable opportunities, and execute arbitrage t...

使用说明 (SKILL.md)

Crypto Arbitrage 🔄

Name: Crypto Arbitrage
Author: chenghaifeng08-creator

Real-time cryptocurrency arbitrage scanner and executor.

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

🎯 What It Solves

Crypto traders miss opportunities because:

❌ Can't monitor multiple exchanges simultaneously
❌ Manual calculation is too slow
❌ Fees eat into profits unexpectedly
❌ Withdrawal times kill opportunities
❌ No systematic approach to arbitrage
❌ Missing triangular arbitrage opportunities

Crypto Arbitrage provides:

✅ Real-time multi-exchange price monitoring
✅ Instant profit calculation (including fees)
✅ Withdrawal time awareness
✅ Auto-execution for fast opportunities
✅ Triangular arbitrage detection
✅ Risk-adjusted opportunity scoring

✨ Features

📊 Multi-Exchange Scanning

Support for 20+ exchanges (Binance, Coinbase, Kraken, OKX, Bybit, etc.)
Real-time price feeds via WebSocket
Order book depth analysis
Liquidity assessment
Historical spread tracking

💰 Opportunity Detection

Spatial arbitrage (same asset, different exchanges)
Triangular arbitrage (3+ pairs on same exchange)
Cross-border arbitrage (USD vs USDT vs other stablecoins)
Futures-spot basis arbitrage
Funding rate arbitrage

🧮 Profit Calculation

Real-time fee calculation (maker/taker)
Withdrawal fee inclusion
Network gas fee estimation
Slippage estimation
Net profit after all costs
ROI and annualized return

⚡ Auto-Execution

One-click arbitrage execution
Configurable auto-execute thresholds
Smart order routing
Partial fill handling
Failed trade recovery
Position reconciliation

📈 Opportunity Scoring

Risk-adjusted scores (0-100)
Execution speed requirements
Liquidity scores
Exchange reliability ratings
Historical success rate

🔔 Smart Alerts

Price threshold alerts
Spread alerts (absolute and percentage)
ROI threshold alerts
Liquidity alerts
Exchange status changes

📊 Analytics & Reporting

Historical opportunity tracking
Success/failure analysis
Profit attribution by strategy
Exchange performance comparison
Tax-ready trade reports

📦 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: '\x3C 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: '\x3C 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

startScanning(options) - Start opportunity scanning
stopScanning() - Stop scanning
pauseScanning() - Pause temporarily
resumeScanning() - Resume scanning

Exchange Management

addExchange(name, credentials) - Add exchange
removeExchange(name) - Remove exchange
getExchangeStatus(name) - Check exchange status
testConnection(name) - Test API connection

Opportunity Detection

getOpportunities(options) - Get current opportunities
findTriangularArbitrage(options) - Find triangular arb
findFundingRateArbitrage(options) - Find funding rate arb
findCrossBorderArbitrage(options) - Find cross-border arb

Execution

executeArbitrage(opportunityId, options) - Execute arb
configureAutoExecute(config) - Setup auto-execute
cancelOrder(orderId) - Cancel pending order
getExecutionStatus(executionId) - Check execution status

Analytics

getAnalytics(options) - Get performance analytics
getHistoricalOpportunities(options) - Historical data
getExchangePerformance() - Exchange comparison
getStrategyPerformance() - Strategy comparison

Risk Management

setRiskLimits(limits) - Set risk limits
getRiskExposure() - Current exposure
getDailyPnL() - Today's P&L
getMaxDrawdown() - Max drawdown

Withdrawal Planning

planWithdrawals(options) - Plan optimal withdrawal
getWithdrawalFees(asset) - Get withdrawal fees
getWithdrawalTimes(asset) - Get withdrawal times
estimateNetworkFees(asset) - Estimate gas/network fees

📁 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:

Exchange API failures
Withdrawal delays
Price slippage
Network congestion
Exchange insolvency risk
Regulatory 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)

Initial release
Multi-exchange scanning (20+ exchanges)
Spatial arbitrage detection
Triangular arbitrage detection
Funding rate arbitrage
Real-time profit calculation
Auto-execution engine
Risk management
Analytics and reporting

📄 License

MIT License - See LICENSE file for details.

🙏 Support

GitHub: https://github.com/openclaw/skills/crypto-arbitrage
Discord: OpenClaw Community
Email: [email protected]

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

安全使用建议

This package appears to be a demo/simulator rather than a production arbitrage engine despite marketing language claiming live multi-exchange auto-execution. Before installing or supplying any real exchange credentials: 1) Inspect the full index.js to confirm whether it actually connects to exchange APIs (look for exchange REST/WebSocket clients and network endpoints). 2) Never supply API keys with withdrawal permissions — use read-only or trading-limited keys and, if possible, sandbox/test accounts. 3) Run the tests and start the scanner in dry-run mode first; validate behavior with small amounts or simulated funds. 4) Verify the repository and publisher (homepage/commit history) and prefer well-audited, open-source exchange adapters. 5) Do not enable auto-execute until you have confirmed real API integrations, safety checks, and rate-limit/error handling. If you want this to run live, expect additional code changes and secure key-handling (env vars, secrets manager) and a security review before trusting it with real funds.

功能分析

Type: OpenClaw Skill Name: crypto-arbitrage Version: 1.0.0 The crypto-arbitrage skill is a functional simulation of a cryptocurrency trading bot. While the documentation (SKILL.md and README.md) describes advanced features like multi-exchange execution and real-time WebSocket feeds, the implementation in index.js is entirely local and uses simulated price data and trade results. The code handles sensitive exchange credentials (API keys/secrets) but lacks any networking dependencies or logic to exfiltrate this data or perform actual trades. It appears to be a well-structured template or educational mock-up for the OpenClaw platform.

能力评估

⚠ Purpose & Capability

The SKILL.md claims real-time WebSocket feeds, support for 20+ exchanges and auto-execution. The included index.js, however, uses simulated price data and does not implement real exchange API/WebSocket integrations (comments say 'in production, fetch from exchange APIs'). This is misleading: the code appears to be a demo rather than a production-ready arbitrage engine.

✓ Instruction Scope

Runtime instructions focus on adding exchange API keys via addExchange(), starting scans, and optionally enabling auto-execute. The instructions do not direct the agent to read unrelated system files or exfiltrate arbitrary data. They do, however, expect sensitive exchange credentials to be provided at runtime.

ℹ Install Mechanism

There is no install spec (instruction-only), which is low-risk, but the package includes code files and package.json in the manifest. That mismatch is worth noting but not necessarily malicious. package.json has no external dependencies and no remote download URLs — nothing in the install surface appears to pull arbitrary code from untrusted hosts.

ℹ Credentials

The skill does not declare required env vars in the registry metadata, yet index.js reads process.env.ARBITRAGE_API_KEY optionally and SKILL.md/test examples require exchange API keys and secrets (added via addExchange()). Requesting exchange API keys is expected for this purpose, but you should NOT provide keys with withdrawal or unlimited permissions. The absence of declared required env vars is an inconsistency to be aware of.

✓ Persistence & Privilege

always is false and the skill is user-invocable. Autonomous invocation is enabled by default (normal). Combined with trading capability this increases blast radius if the skill were to perform real trades, but currently the implementation simulates execution; nevertheless, enabling auto-execute should be treated cautiously.

版本历史

v1.0.0

Initial release

元数据

Slug crypto-arbitrage

版本 1.0.0

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 1

常见问题