# SolanaMevBot — Full Documentation
> High-speed automated arbitrage bot for Solana blockchain

SolanaMevBot is an onchain arbitrage trading bot that monitors 14+ Solana DEXes and executes atomic arbitrage trades automatically. It charges a 10% fee only on successful profitable trades.

## Overview

SolanaMevBot is a high-speed automated arbitrage bot built for the Solana blockchain. It continuously monitors price discrepancies across 14+ decentralized exchanges (DEXes) and executes atomic arbitrage trades to capture profit. The bot runs 24/7, requiring no manual intervention once configured.

Key features:
- Monitors 14+ Solana DEXes simultaneously
- Executes atomic arbitrage (all-or-nothing transactions — no risk of partial fills)
- Fully onchain — trades are verifiable and transparent
- 10% fee on profit only — no upfront costs, no subscriptions
- Supports circular arbitrage routes across multiple pools
- Integrates with Jito for MEV-optimized transaction submission

## Getting Started

### Prerequisites
- A Solana wallet with SOL for trading
- The SolanaMevBot CLI binary (available from GitHub releases)

### Quick Start
1. Download the latest release from https://github.com/Cetipoo/solana-mev-bot/releases
2. Configure your wallet and RPC endpoint
3. Set up your trading parameters (token pairs, min profit threshold, Jito tip)
4. Start the bot

The bot will begin scanning for arbitrage opportunities across all supported DEXes and execute trades automatically when profitable routes are found.

## How It Works

### Arbitrage Detection
The bot continuously reads onchain state from all supported DEX pools. It constructs a graph of token pairs and prices, then searches for profitable circular routes (e.g., SOL → USDC → BONK → SOL where the output SOL exceeds the input).

### Transaction Execution
When a profitable route is found:
1. The bot crafts an atomic transaction containing all swap instructions
2. The transaction is submitted via Jito bundles for priority execution
3. If the entire route executes profitably, the trade settles
4. If any step fails, the entire transaction reverts (no loss)

### Fee Structure
- 10% fee on net profit only
- Fee is calculated after deducting the Jito tip
- Formula: fee = (profit - jito_tip) * 10%
- No profit = no fee (zero risk to the user)
- Fee is sent to: solanamevbot.sol

## Supported DEXes
- Raydium (AMM V4)
- Raydium CPMM
- Raydium CLMM (Concentrated Liquidity)
- Pumpfun Swap
- Meteora DLMM
- Meteora Dynamic Pool
- Meteora DAMM V2
- Orca Whirlpool
- Humidifi
- Vertigo
- Heaven Dex
- Pancake Swap
- Byreal
- Futarchy

## Bot Configuration

Key configuration options:
- **RPC Endpoint**: Your Solana RPC URL (dedicated/paid RPC recommended)
- **Wallet**: Path to your keypair file
- **Auto Market Selection**: Follow recently observed profitable Pump AMM and Meteora DLMM arbitrages without maintaining a static pool list
- **Min Profit**: Minimum profit threshold in lamports before executing
- **Jito Tip**: Amount to tip Jito validators for priority inclusion
- **Token Filters**: Which tokens/pools to monitor
- **Circular Routes**: Configure multi-hop arbitrage paths

## Onchain Program
- Program Address: MEViEnscUm6tsQRoGd9h6nLQaQspKj7DB2M5FwM3Xvz
- Fee Account: solanamevbot.sol
- Viewable on Solscan: https://solscan.io/account/MEViEnscUm6tsQRoGd9h6nLQaQspKj7DB2M5FwM3Xvz

## Links
- Documentation: https://solanamevbot.com/docs
- Getting Started Guide: https://solanamevbot.com/docs/onchain-bot/getting-started
- How It Works: https://solanamevbot.com/docs/onchain-bot/how-it-works
- Bot Configuration: https://solanamevbot.com/docs/onchain-bot/bot-configurations
- Fee Structure: https://solanamevbot.com/docs/fees
- Blog: https://solanamevbot.com/blog
- Discord: https://discord.gg/JHDV6cQRDJ
- GitHub Releases: https://github.com/Cetipoo/solana-mev-bot/releases
- Dune Dashboard: https://dune.com/cetipo/solanamevbot-dashboard