功能描述

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.

💰 付费服务

套利策略咨询 & 定制:

服务	价格	交付
套利机会分析	¥2000/份	多交易所价差分析报告
定制套利系统	¥10000 起	根据你的需求定制
交易所 API 配置	¥1000/次	多交易所配置 + 测试
月度策略顾问	¥6000/月	每周策略调整 + 监控

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

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

🎯 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

安全使用建议

There are several red flags you should consider before installing or providing credentials: 1) The README and SKILL.md promise live, multi-exchange trading and auto-execution, but package.json declares no networking/trading dependencies and the visible code simulates prices — the implemented behavior may not match the claims. 2) The skill asks you (in docs) to add exchange API keys/secrets, yet the registry metadata lists no required env vars; do NOT provide API keys with withdrawal permissions. 3) If you still want to test it, run the package in an isolated sandbox, inspect the full index.js for any network calls (axios/fetch/websocket/ccxt/REST clients) and any code that performs HTTP POSTs to unexpected endpoints. 4) Use API keys with minimal permissions (enable trading only if needed, disable withdrawals, set IP restrictions), start with tiny funds or a sandbox/testnet account, and enable exchange-based 2FA and whitelisting. 5) Prefer to request the maintainer source verification or use a reputable, reviewed implementation — given the mismatch between claims and code, treat this package as potentially incomplete or misleading until you can verify the actual exchange integration.

功能分析

Type: OpenClaw Skill Name: crypto-arbitrage-automaton Version: 1.0.1 The skill claims to be a real-time cryptocurrency arbitrage scanner and executor supporting over 20 exchanges, but the implementation in `index.js` is entirely a simulation using random number generation and hardcoded values. Most notably, `package.json` lists zero dependencies, which is impossible for a functional multi-exchange trading bot. While the code lacks explicit data exfiltration or malicious execution logic, it encourages users to input sensitive exchange API keys and secrets into a 'sham' tool that performs no actual trading, creating a high risk for credential mishandling or future exploitation.

能力评估

⚠ Purpose & Capability

The description and SKILL.md promise real-time WebSocket feeds, 20+ exchange support, and auto-execution. The shipped package.json has no dependencies (no ccxt, no exchange SDKs, no websocket/net libs) and the visible index.js uses simulated prices and internal maps rather than making external API/WebSocket calls. This is a clear mismatch between claimed capabilities and implemented code.

⚠ Instruction Scope

Runtime instructions explicitly ask the user to add exchange API keys/secrets and to enable auto-execution. Those instructions imply network interaction and placing orders, but the code fragments provided simulate trading rather than showing actual exchange integrations. The SKILL.md also references contacting via external messaging for paid services (WeChat/Telegram) which is unrelated to runtime behavior but not itself harmful; still, asking for API keys in instructions while metadata declares none is a scope inconsistency.

✓ Install Mechanism

There is no install script that downloads arbitrary code from unknown hosts; the skill is instruction/code-bundled and would be installed normally. No high-risk external download URLs or extract steps were present.

⚠ Credentials

The code uses process.env.ARBITRAGE_API_KEY as a fallback and the SKILL.md instructs adding exchange API keys/secrets at runtime, yet the registry lists no required env vars or primary credential. Asking users to supply API keys/secrets (which could grant trading/withdrawal access) is expected for this domain, but the lack of declared env requirements and the mismatch with implemented code is misleading and potentially dangerous if users hand over sensitive keys.

ℹ Persistence & Privilege

always is false (good). The skill supports auto-execution — and agents are allowed to invoke skills autonomously by default. That combination increases blast radius if the skill actually performs trades. This is not automatically disqualifying but worth caution: auto-execution plus provided API keys could allow real trades.

版本历史

v1.0.1

- Added detailed SKILL.md documenting all crypto-arbitrage-automaton features, usage, and advanced scenarios. - Clarified pricing tiers and included risk disclaimers. - Usage examples provided for scanning, execution, opportunity detection, and analytics. - Outlined support for various arbitrage strategies: spatial, triangular, cross-border, futures-spot, and funding rate. - Installation instructions and quick-start code examples included for easy onboarding.

元数据

Slug crypto-arbitrage-automaton

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题