Skip to content

mkbeh/arb-bot-rs

Repository files navigation

⚡ arb-bot-rs

GitHub CI

Arbitrage bot is a high-frequency arbitrage trading system that automatically identifies and executes profitable arbitrage opportunities on cryptocurrency exchanges.

📖 Full Documentation | 📊 Live Monitoring Setup


📖 Table of Contents

⚡ Quick Start

Get up and running in minutes! This bot is optimized for Linux but works on macOS/Windows with minor tweaks.

🛠 Prerequisites

  • Rust: Version 1.94.0 or newer. Install via rustup.

🏗 Build from Source

Clone and build the CLI binary:

git clone https://github.com/mkbeh/arb-bot-rs.git
cd arb-bot-rs
cargo build -p cli --release --all-features

✅ Running Tests

Verify everything works with our full test suite:

cargo test --all

🚀 Execution & CLI

The CLI is intuitive—check available commands:

./target/release/bot --help

Core Commands:

  • list: List supported exchanges.
  • version: Show bot version.
  • run: Start the arbitrage engine.

Configure: Copy the example config and add your API keys.

cp config.example.toml config.toml

Launch Example (Binance spot trading):

RUST_LOG=INFO ./target/release/bot run --exchange binance --config config.toml

📊 Observability & Monitoring

Grafana Prometheus

Track every tick with Prometheus + Grafana. Setup instructions in /deploy.

Key Metrics Dashboard:

Category Metric Insight
📈 Market Data Update Rate 🔄 Frequency of order book events across all exchanges.
Hot Pairs 💱 Identification of the most volatile trading pairs.
Engine Analysis Speed ⏱️ Number of arbitrage chains processed per second.
Top Chains 💰 Most frequent and profitable currency paths.
🎯 Strategy Profit Ratio 📊 Success rate of profitable detections vs. total analyzed.
Opportunity Count ✅ Total count of viable arbitrage signals identified.
🛠️ Execution Order Status 📝 Real-time log of filled, failed, or canceled attempts.

Dashboard Preview

The dashboard provides a live look at the bot's decision-making process and market impact.

img

Live dashboard showing market data throughput, arbitrage processing rates, and trading performance.

🏛 Supported Exchanges

List of supported cryptocurrency exchanges.

Exchange Status Features
Binance ✅ Live Spot trading, market orders, WebSocket feeds
Kucoin ✅ Live Spot trading, market orders, WebSocket feeds
Solana ⏳ WIP On-chain swaps (Jupiter, Raydium, Orca, etc)

❤️ Support Us – Become Part of the Magic!

Open-source projects thrive because of visionaries like you. If this code has sparked a flame of inspiration in your heart, share the spark! Your crypto support is the fuel for new features, bug fixes, and groundbreaking updates. We accept donations in BTC, ETH, and USDT – simple, swift, and borderless.

Crypto Address QR Code
Bitcoin (BTC) bc1qw0sz039alzpmk2qcg549pwv3vd0e6casj5dstp
Ethereum (ETH) 0x00875cdA702B0e6fba3AdeaA6bEB585Db3a7f0f1
Tether (USDT) 0x00875cdA702B0e6fba3AdeaA6bEB585Db3a7f0f1 (ERC-20)
Solana (SOL) CP9nNp1jMZS6QK4aoQuRGXKRwHdQ72Rr6ZK3kZcANAz9

Every satoshi, every ether – it's a step toward something greater. Thank you for believing in openness! 🌍✨

Become a Star: A GitHub star is free, but it means the world. ⭐

License

License: MIT

This project is open-source under the MIT License. Use it freely, but trade responsibly.

"Code is poetry. Share it generously!" — inspired by Richard Stallman.

About

Cryptocurrency exchanges arbitrage bot.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages