A sophisticated, high-performance Solana trading bot that automatically follows target wallets and executes trades across multiple DEX platforms. Built with real-time transaction monitoring, intelligent risk management, and comprehensive control interfaces.
- Real-time Transaction Monitoring: Uses gRPC streams to monitor target wallets instantly
- Multi-DEX Support: PumpFun, PumpSwap, Raydium LaunchLab, Raydium CPMM
- Dynamic Position Sizing: Percentage-based buy amounts that scale with target wallet activity
- Intelligent Risk Management: Advanced stop-loss, trailing stops, and position management
- Real-time Dashboard: Web-based interface with live portfolio tracking
- Performance Metrics: Detailed P&L tracking, success rates, and trading statistics
- Portfolio Management: Complete transaction history and token tracking
- Risk Monitoring: Real-time balance checks and alert systems
- Remote Control: Start/stop bot from anywhere via Telegram
- Live Notifications: Buy/sell alerts, balance warnings, and error notifications
- Interactive Interface: Button-based controls and status monitoring
- Customizable Alerts: Configure which notifications you want to receive
- Zero-Latency Trading: Sub-second execution using gRPC streams
- Smart Caching: In-memory caching for optimal performance
- Cooldown Management: Prevents spam trading and duplicate transactions
- Error Recovery: Automatic retry logic and graceful error handling
graph TB
subgraph "External Services"
GRPC[gRPC Stream<br/>Yellowstone]
RPC[Solana RPC<br/>Endpoint]
TG[Telegram Bot<br/>API]
DEX1[PumpFun<br/>DEX]
DEX2[PumpSwap<br/>DEX]
DEX3[Raydium<br/>DEX]
end
subgraph "Core Bot System"
MON[Transaction Monitor<br/>Real-time Stream Processing]
PORT[Portfolio Manager<br/>In-memory Tracking]
BOT[Trading Bot<br/>Strategy Engine]
CACHE[Cache Layer<br/>Blacklist & Balances]
end
subgraph "Trading Functions"
BUY[Token Buy<br/>Multi-DEX Support]
SELL[Token Sell<br/>Smart Execution]
SWAP[Jupiter Swap<br/>Integration]
end
subgraph "Control Interfaces"
DASH[Web Dashboard<br/>Real-time UI]
TGCTRL[Telegram Controller<br/>Remote Control]
API[REST API<br/>Data Access]
end
subgraph "Data Flow"
ALERT[Alert System<br/>Notifications]
LOG[Logger<br/>File & Console]
STATS[Statistics<br/>Performance Tracking]
end
%% External connections
GRPC --> MON
RPC --> BUY
RPC --> SELL
TG --> TGCTRL
%% Core system flow
MON --> PORT
MON --> BOT
PORT --> CACHE
BOT --> BUY
BOT --> SELL
BUY --> DEX1
BUY --> DEX2
BUY --> DEX3
SELL --> DEX1
SELL --> DEX2
SELL --> DEX3
%% Control interfaces
DASH --> API
TGCTRL --> BOT
API --> PORT
API --> STATS
%% Data flow
BOT --> ALERT
BOT --> LOG
BOT --> STATS
MON --> ALERT
%% Styling
classDef external fill:#e1f5fe
classDef core fill:#f3e5f5
classDef trading fill:#e8f5e8
classDef control fill:#fff3e0
classDef data fill:#fce4ec
class GRPC,RPC,TG,DEX1,DEX2,DEX3 external
class MON,PORT,BOT,CACHE core
class BUY,SELL,SWAP trading
class DASH,TGCTRL,API control
class ALERT,LOG,STATS data
- Node.js 16+
- Solana wallet with private key
- RPC endpoint (Helius, QuickNode, or similar)
- Telegram bot token (optional)
-
Clone the repository
git clone <repository-url> cd solana-copy-trading-bot
-
Install dependencies
npm install
-
Configure environment
cp .env.ex .env # Edit .env with your configuration -
Start the bot
npm start
-
Access dashboard (optional)
npm run dashboard # Open http://localhost:3000
# Solana Configuration
RPC_URL=https://your-rpc-endpoint
PRIVATE_KEY=your_wallet_private_key
PUB_KEY=your_wallet_public_key
# Trading Configuration
BUY_AMOUNT=0.1 # Fixed buy amount in SOL
BUY_AMOUNT_PERCENTAGE=1.0 # Percentage of target wallet's SOL change (optional)
TARGET_WALLET=wallet1,wallet2 # Comma-separated target wallets
# gRPC Configuration
GRPC_ENDPOINT=your_grpc_endpoint
GRPCTOKEN=your_grpc_token
# Telegram (Optional)
TELEGRAM_BOT_TOKEN=your_bot_token# Risk Management
LIMIT_BALANCE=0.1 # Minimum balance to start trading
SLIPPAGE_BPS=50 # Slippage tolerance (0.5%)
# Performance
MAX_RETRIES=3 # Maximum retry attempts
RETRY_DELAY=1000 # Delay between retries (ms)
# Dashboard
DASHBOARD_PORT=3000 # Web dashboard port# Start the trading bot
npm start
# Start with dashboard
npm run dashboard
# Development mode (with auto-restart)
npm run dev/start- Main control panel/status- Check bot status and balance/balance- View wallet balance/alerts- Configure notifications/help- Show all commands
- Real-time Monitoring: Live portfolio and performance data
- Manual Trading: Buy/sell tokens directly from the interface
- Portfolio Management: View all positions and transaction history
- Performance Analytics: Detailed trading statistics and P&L tracking
The bot can automatically adjust buy amounts based on target wallet activity:
# Buy 50% of target wallet's SOL change
BUY_AMOUNT_PERCENTAGE=0.5
# Buy 200% of target wallet's SOL change (2x leverage)
BUY_AMOUNT_PERCENTAGE=2.0Supports multiple DEX platforms:
- PumpFun: Bonding curve trading
- PumpSwap: AMM-based trading
- Raydium LaunchLab: Launchpad tokens
- Raydium CPMM: Constant product market maker
- Stop Loss: Automatic position closure on losses
- Trailing Stops: Dynamic stop-loss adjustment
- Position Limits: Maximum position size controls
- Balance Monitoring: Automatic trading halt on low balance
- Active Bots: Number of running trading bots
- Portfolio Value: Total value of all positions
- Success Rate: Percentage of profitable trades
- P&L Tracking: Real-time profit/loss monitoring
Recent successful trades demonstrating the bot's effectiveness:
- Profit: +$12.25 (+45.36%)
- Transactions:
- Profit: +$5.44 (+57.66%)
- Transactions:
- Profit: +$18.2 (+166.3%)
- Transactions:
- Profit: +$3.68 (+40.51%)
- Transactions:
Note: These are real trading results from the bot following target wallets. All transactions are verifiable on Solana blockchain explorers.
- Console Logging: Detailed transaction logs
- File Logging: Persistent log storage
- Telegram Alerts: Real-time notifications
- Error Tracking: Comprehensive error logging
- Private Key Protection: Secure key management
- Input Validation: All inputs are validated and sanitized
- Rate Limiting: Protection against rapid-fire requests
- Error Handling: Graceful error recovery and logging
- Solana Mainnet: Full production support
- Devnet: Testing and development
- Custom RPC: Any Solana RPC endpoint
GET /api/status- Bot status and healthGET /api/tokens- Portfolio tokensGET /api/transactions- Transaction historyGET /api/performance- Trading metrics
-
Bot won't start
- Check wallet balance (minimum 0.1 SOL)
- Verify RPC endpoint connectivity
- Ensure private key is correct
-
No trades executing
- Check target wallet configuration
- Verify gRPC endpoint and token
- Monitor console logs for errors
-
High slippage
- Increase
SLIPPAGE_BPSvalue - Check market liquidity
- Consider smaller position sizes
- Increase
# Manual status check
kill -SIGUSR1 <process_id>
# Strategy debug
kill -SIGUSR3 <process_id>
# Balance check
kill -SIGUSR2 <process_id>- RPC Endpoint: Use premium RPC for better performance
- gRPC Stream: Ensure stable connection for real-time data
- Memory: Allocate sufficient RAM for caching
- Network: Use low-latency connection for faster execution
- Monitor console logs for performance metrics
- Use dashboard for real-time monitoring
- Set up Telegram alerts for important events
- Regular balance and performance checks
- Advanced Charting: Technical analysis integration
- Multi-Wallet Support: Manage multiple trading wallets
- Strategy Backtesting: Historical performance testing
- Mobile App: Native mobile interface
- API Trading: REST API for external integrations
- Telegram: @radiodev
- Repository: Private repository always available to land 0block
- Check the troubleshooting section
- Review console logs for error messages
- Verify your configuration
- Contact support via Telegram
This project is proprietary software. All rights reserved.
🚀 Happy Trading! May your trades be profitable and your stops be tight!
