🤖 QA Injective MM Bot | Professional Market Making System 🚀

"Professional-grade market making bot for Injective Protocol" 💎

A sophisticated multi-wallet market making system for Injective Protocol that provides real-time price correction between testnet and mainnet, complete with a modern web dashboard for monitoring and control.

🎯 What This Bad Boy Does

Think of this as your personal army of trading bots that:

🔥 Fights price discrepancies between testnet and mainnet like a crypto ninja
💰 Makes money by correcting testnet prices to match real market prices
🎪 Creates rich orderbooks with randomized orders that look totally natural
⚡ Runs 3 wallets in parallel because one wallet is for peasants, three is for legends
🛡️ Never gets rekt with intelligent sequence management and cooldowns

🌟 Features That'll Make You Say "WAGMI"

🎮 Core Trading Features

🔥 Multi-Wallet Parallel Execution - 3 wallets trading simultaneously like synchronized swimmers
📊 Real-Time Price Correction - Fixes testnet prices faster than you can say "diamond hands"
🎲 Rich Orderbook Creation - Places 0.1-10.0 INJ orders across multiple price levels (looks totally organic)
🛡️ Sequence Mismatch Protection - Smart cooldown system that prevents your bot from having a meltdown
⚡ Instant Shutdown - Ctrl+C works immediately (no more waiting for your bot to finish its coffee break)

🧠 Market Intelligence

📈 Live Price Monitoring - Compares mainnet vs testnet prices in real-time
🎯 Price Movement Tracking - Shows you exactly which direction prices need to go (UP/DOWN arrows)
🌐 Mainnet Price Integration - Gets real market prices directly from Injective mainnet
🎪 Dynamic Order Sizing - Randomizes order sizes so your bot doesn't look like a robot

🔒 Security & Risk Management

🔐 Secure Wallet Loading - Private keys stored in .env files (not in plain text like a noob)
⏰ Cooldown System - 10-second chill period when sequence mismatches happen
✅ Order Validation - Comprehensive error handling (your bot won't crash and burn)
📊 Balance Monitoring - Tracks wallet balances and sequence numbers in real-time
🔄 Graceful Error Recovery - Automatically refreshes sequences and retries failed orders

🏗️ System Architecture

🎯 High-Level Architecture

graph TB
    subgraph "🌐 Web Dashboard"
        UI[📱 Web Interface]
        API[🚀 FastAPI Backend]
        WS[⚡ WebSocket Server]
    end
    
    subgraph "🤖 Trading Engine"
        MWT[📱 Multi-Wallet Trader]
        WT1[🎯 Wallet 1 Trader]
        WT2[🎯 Wallet 2 Trader]
        WT3[🎯 Wallet 3 Trader]
    end
    
    subgraph "🌐 Injective Networks"
        TN[🧪 Testnet]
        MN[🌐 Mainnet]
    end
    
    subgraph "📊 Data Layer"
        CONFIG[⚙️ Configuration]
        LOGS[📝 Logs]
        DATA[📊 Market Data]
    end
    
    UI --> API
    API --> WS
    WS --> MWT
    MWT --> WT1
    MWT --> WT2
    MWT --> WT3
    
    WT1 --> TN
    WT2 --> TN
    WT3 --> TN
    
    MWT --> MN
    
    MWT --> CONFIG
    MWT --> LOGS
    MWT --> DATA
    
    API --> CONFIG
    API --> LOGS

🔄 Trading Flow Diagram

sequenceDiagram
    participant W as 🌐 Web Dashboard
    participant B as 🤖 Bot Engine
    participant T as 🧪 Testnet
    participant M as 🌐 Mainnet
    
    W->>B: Start Bot Command
    B->>T: Connect to Testnet
    B->>M: Connect to Mainnet
    
    loop Trading Cycle
        B->>T: Get Testnet Price
        B->>M: Get Mainnet Price
        B->>B: Calculate Price Difference
        
        alt Price Difference > Threshold
            B->>T: Place Correction Orders
            B->>W: Update Status & Logs
        else Price Difference < Threshold
            B->>W: Update Status (Monitoring)
        end
        
        B->>B: Wait 10 seconds
    end
    
    W->>B: Stop Bot Command
    B->>T: Cancel All Orders
    B->>W: Update Status (Stopped)

🏗️ Component Architecture

🚀 QA Injective MM Bot System
├── 🌐 Web Dashboard (web/)
│   ├── 📱 Frontend
│   │   ├── index.html          # Main dashboard UI
│   │   ├── script.js           # Real-time JavaScript logic
│   │   └── styles.css          # Tailwind CSS styling
│   │
│   ├── 🚀 Backend
│   │   ├── app.py              # FastAPI application
│   │   ├── requirements.txt    # Python dependencies
│   │   └── static/             # Static web assets
│   │
│   └── 🔧 Features
│       ├── ⚡ WebSocket real-time updates
│       ├── 📊 Live bot status monitoring
│       ├── 💰 Wallet balance tracking
│       ├── 🎛️ Bot start/stop controls
│       └── 📝 Live activity feed
│
├── 🤖 Trading Engine (scripts/)
│   ├── 📱 multi_wallet_trader.py    # Main trading system
│   │   ├── 🎯 WalletTrader Class    # Individual wallet management
│   │   ├── ⚡ Parallel Execution     # Multi-wallet coordination
│   │   ├── 📊 Price Correction Logic # Mainnet/testnet alignment
│   │   └── 🎪 Rich Orderbook Creation # Randomized orders
│   │
│   └── 🛑 batch_cancel_orders.py    # Emergency order cancellation
│       ├── 🔥 Multi-Wallet Support  # Cancel from all wallets
│       ├── 📈 Spot & Derivative     # Support both market types
│       └── ⚡ Batch Operations      # Efficient bulk cancellation
│
├── ⚙️ Configuration (config/)
│   ├── markets_config.json          # Market definitions & settings
│   └── README.md                    # Configuration documentation
│
├── 📊 Data Layer (data/)
│   ├── 🌐 mainnet_*_market_data.json # Real market data
│   ├── 🧪 testnet_*_market_data.json # Testnet market data
│   └── 📋 *_comparison_report.txt    # Market analysis reports
│
├── 🛠️ Utilities (utils/)
│   ├── 📝 logger.py                  # Centralized logging
│   ├── 🔒 secure_wallet_loader.py   # Secure wallet management
│   ├── 📊 market_comparison_unified.py # Market data analysis
│   └── 💰 balance_checker.py        # Wallet balance monitoring
│
└── 🔐 Security
    ├── .env                         # Encrypted wallet keys
    ├── env.example                  # Configuration template
    └── logs/                        # Secure log storage

🌐 Web Dashboard

The QA Injective MM Bot includes a modern web dashboard for real-time monitoring and control:

🎮 Dashboard Features

📊 Real-time Bot Status - Live monitoring of bot state (Running/Stopped)
💰 Wallet Balance Tracking - Real-time balance updates for all wallets
📈 Market Data Display - Current market information and trading pairs
📝 Live Activity Feed - Real-time trading logs and system events
🎛️ Bot Controls - Start/Stop bot functionality
🌐 Network Status - Shows which network the bot is running on (Testnet/Mainnet)
📱 Responsive Design - Works on desktop, tablet, and mobile devices

🚀 Launching the Web Dashboard

Start the Web Server:

cd web
python app.py

Access the Dashboard:

Open your browser and go to: http://localhost:8000
The dashboard will automatically connect via WebSocket for real-time updates

Dashboard Controls:

Start Bot: Click the green "Start Bot" button to begin trading
Stop Bot: Click the red "Stop Bot" button to halt all trading
Refresh Balances: Manually refresh wallet balance data
View Logs: Access full trading logs in a modal window

🔧 Web Interface Architecture

🌐 Web Dashboard
├── 📱 Frontend (HTML/CSS/JavaScript)
│   ├── 🎨 Modern UI with Tailwind CSS
│   ├── ⚡ Real-time WebSocket updates
│   ├── 📊 Interactive charts and status indicators
│   └── 📱 Responsive mobile design
│
├── 🚀 Backend (FastAPI)
│   ├── 🔌 REST API endpoints
│   ├── 🌐 WebSocket connections
│   ├── 📊 Real-time data streaming
│   └── 🎛️ Bot control interface
│
└── 📊 Data Integration
    ├── 📈 Live market data
    ├── 💰 Wallet balance tracking
    ├── 📝 Trading log streaming
    └── ⚙️ Configuration management

🚀 Complete System Launch

🎯 Two Ways to Run the Bot

Option 1: 🌐 Web Dashboard (Recommended)

# 1. Start the web dashboard
cd web
python app.py

# 2. Open browser to http://localhost:8000
# 3. Use the web interface to start/stop the bot
# 4. Monitor real-time status, balances, and logs

Option 2: 🤖 Command Line Only

# 1. Start the trading bot directly
python scripts/multi_wallet_trader.py

# 2. Monitor via console output and log files
# 3. Use Ctrl+C to stop

📋 Prerequisites

Python 3.8+ (because we're not living in the stone age)
Injective testnet wallets with INJ tokens (get them from the faucet)
Virtual environment (keeps your system clean like a good crypto hygiene)

🛠️ Installation (The Setup of Champions)

Clone and Setup 🏗️

git clone <repository-url>
cd qa-python-injective-trading-bot
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

Configure Your Wallets 🔐

cp env.example .env
# Edit .env with your wallet private keys (keep them secret!)

Set Up Your Wallet Configuration 💰 Edit your .env file with your wallet details:

# Wallet 1 - The Primary Market Maker
WALLET_1_PRIVATE_KEY=your_private_key_1_here
WALLET_1_NAME=Primary Market Maker
WALLET_1_ENABLED=true
WALLET_1_MAX_ORDERS=5
WALLET_1_BALANCE_THRESHOLD=100

# Wallet 2 - The QA Market Maker  
WALLET_2_PRIVATE_KEY=your_private_key_2_here
WALLET_2_NAME=QA Market Maker
WALLET_2_ENABLED=true
WALLET_2_MAX_ORDERS=5
WALLET_2_BALANCE_THRESHOLD=100

# Wallet 3 - The QA Market Taker
WALLET_3_PRIVATE_KEY=your_private_key_3_here
WALLET_3_NAME=QA Market Taker
WALLET_3_ENABLED=true
WALLET_3_MAX_ORDERS=5
WALLET_3_BALANCE_THRESHOLD=100

Configure Markets 📊 Edit config/markets_config.json:

{
  "markets": {
    "INJ/USDT": {
      "testnet_market_id": "0x0611780ba69656949525013d947713300f56c37b6175e02f26bffa495c3208fe",
      "mainnet_market_id": "0xa508cb32923323679f29a032c70342c147c17d0145625922b0ef22e955c844c0",
      "enabled": true,
      "type": "spot",
      "deviation_threshold": 5.0
    }
  }
}

Launch the Bot 🚀

# Start multi-wallet trading (the main event!)
python3 scripts/multi_wallet_trader.py

# Cancel all orders (emergency stop)
python3 scripts/batch_cancel_orders.py

🎮 How It Works (The Magic Behind the Curtain)

🔄 Trading Logic Flow

┌─────────────────────────────────────────────────────────────────┐
│                    🤖 QA Injective MM Bot Logic                │
└─────────────────────────────────────────────────────────────────┘

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   🧪 Testnet │    │   🌐 Mainnet │    │   📊 Bot Logic │
│   Prices    │    │   Prices    │    │   Engine    │
└─────────────┘    └─────────────┘    └─────────────┘
       │                   │                   │
       │ Get Testnet Price │                   │
       ├──────────────────►│                   │
       │                   │ Get Mainnet Price │
       │                   ├──────────────────►│
       │                   │                   │
       │                   │                   │ Calculate
       │                   │                   │ Price Diff
       │                   │                   │
       │                   │                   │
       │                   │                   │ Price Diff
       │                   │                   │ > 2%?
       │                   │                   │
       │                   │                   │ ┌─────────┐
       │                   │                   │ │   YES   │
       │                   │                   │ └─────────┘
       │                   │                   │      │
       │                   │                   │      │
       │                   │                   │      ▼
       │                   │                   │ ┌─────────────┐
       │                   │                   │ │ 🎪 Place    │
       │                   │                   │ │ Orders to   │
       │                   │                   │ │ Correct     │
       │                   │                   │ │ Price       │
       │                   │                   │ └─────────────┘
       │                   │                   │      │
       │                   │                   │      │
       │                   │                   │      ▼
       │                   │                   │ ┌─────────────┐
       │                   │                   │ │ ⏰ Wait 10s │
       │                   │                   │ │ & Repeat    │
       │                   │                   │ └─────────────┘
       │                   │                   │
       │                   │                   │ ┌─────────┐
       │                   │                   │ │   NO    │
       │                   │                   │ └─────────┘
       │                   │                   │      │
       │                   │                   │      │
       │                   │                   │      ▼
       │                   │                   │ ┌─────────────┐
       │                   │                   │ │ ⏸️ Monitor  │
       │                   │                   │ │ Only        │
       │                   │                   │ └─────────────┘
       │                   │                   │      │
       │                   │                   │      │
       │                   │                   │      ▼
       │                   │                   │ ┌─────────────┐
       │                   │                   │ │ ⏰ Wait 10s │
       │                   │                   │ │ & Repeat    │
       │                   │                   │ └─────────────┘

🎯 Multi-Wallet Parallel Execution

┌─────────────────────────────────────────────────────────────────┐
│                    🎯 Multi-Wallet Coordination                │
└─────────────────────────────────────────────────────────────────┘

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  💰 Wallet 1 │    │  💰 Wallet 2 │    │  💰 Wallet 3 │
│  (Primary)   │    │  (QA Maker)  │    │  (QA Taker)  │
└─────────────┘    └─────────────┘    └─────────────┘
       │                   │                   │
       │                   │                   │
       ▼                   ▼                   ▼
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 🎯 Trader 1  │    │ 🎯 Trader 2  │    │ 🎯 Trader 3  │
│ Thread      │    │ Thread      │    │ Thread      │
└─────────────┘    └─────────────┘    └─────────────┘
       │                   │                   │
       │                   │                   │
       ▼                   ▼                   ▼
┌─────────────────────────────────────────────────────────────────┐
│                    🧪 Injective Testnet                        │
│                                                                 │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐            │
│  │ INJ/USDT    │  │ stINJ/INJ   │  │ INJ/USDT-   │            │
│  │ Market      │  │ Market      │  │ PERP Market │            │
│  └─────────────┘  └─────────────┘  └─────────────┘            │
│                                                                 │
│  Each wallet places orders on ALL markets simultaneously       │
│  creating a rich, natural-looking orderbook                    │
└─────────────────────────────────────────────────────────────────┘

🔄 Trading Cycle

📊 Price Check - Bot checks testnet vs mainnet prices
🎯 Decision Time - If price difference > 2%, it's time to make money!
🎪 Order Placement - Creates rich orderbook with randomized orders
⏰ Wait & Repeat - 10-second cooldown, then repeat the cycle

💰 Price Correction Logic

Testnet Price: $12.8180
Mainnet Price: $12.6645
Difference: 1.21% (within 2% threshold)
Action: ⏸️ Monitoring only (no trades needed)

Testnet Price: $13.5000  
Mainnet Price: $12.6645
Difference: 6.58% (above 2% threshold)
Action: 🚀 PLACE ORDERS TO CORRECT PRICE!

🎲 Order Sizing (The Art of Looking Natural)

Range: 0.1 to 10.0 INJ per order
Options: 23 different size variations
Strategy: Randomized sizes to avoid detection
Result: Orderbook that looks totally organic

📊 Market Data Management

🔍 Market Comparison Tool

Compare testnet vs mainnet market data:

# Compare all markets automatically
python3 utils/market_comparison_unified.py --compare-all

# Compare specific markets
python3 utils/market_comparison_unified.py \
  --testnet data/testnet_spot_market_data.json \
  --mainnet data/mainnet_spot_market_data.json \
  --output my_report.txt

📁 Data Directory Structure

data/
├── 🌐 mainnet_derivative_market_data.json
├── 🌐 mainnet_spot_market_data.json
├── 🧪 testnet_derivative_market_data.json
├── 🧪 testnet_spot_market_data.json
├── 📋 derivative_market_data_comparison_report.txt
└── 📋 spot_market_data_comparison_report.txt

⚙️ Trading Parameters (The Settings of Success)

🎯 Order Sizing

Range: 0.1 to 10.0 INJ per order
Randomization: 23 different size options
Distribution: Natural-looking orderbook depth
Strategy: Avoid looking like a bot

📈 Price Levels

BUY Orders: +0.1% to +1.0% above current price
SELL Orders: -0.1% to -1.0% below current price
Correction Threshold: 2% price difference triggers action
Market-Specific Thresholds: Each market can have its own threshold

⏰ Timing

Order Delay: 5 seconds between orders
Cooldown: 10 seconds when sequence mismatches occur
Cycle Interval: 10 seconds between trading cycles
Sequence Refresh: Automatic sequence synchronization

🛠️ Development (For the Builders)

📁 Project Structure

├── 📱 scripts/                   # Trading scripts
│   ├── multi_wallet_trader.py    # Main trading system
│   └── batch_cancel_orders.py    # Order management utility
├── ⚙️ config/                    # Configuration files
│   ├── markets_config.json       # Market configuration
│   └── README.md                 # Config documentation
├── 📊 data/                      # Market data storage
│   ├── mainnet_*_market_data.json
│   ├── testnet_*_market_data.json
│   └── *_comparison_report.txt
├── 🛠️ utils/                     # Essential utilities
│   ├── logger.py                 # Logging functionality
│   ├── secure_wallet_loader.py   # Secure wallet configuration
│   └── market_comparison_unified.py # Market comparison tool
├── 🔒 .env                       # Your secret wallet keys
├── 📋 env.example                # Template for .env
└── 🐍 venv/                      # Virtual environment

🔧 Adding New Features

New Trading Strategies: Extend the WalletTrader class
Additional Markets: Add new entries to markets_config.json
Enhanced Logging: Customize the logger utility
Market Analysis: Use the comparison tool for insights

🚨 Important Notes (Read This or Get Rekt)

🧪 Testnet Only

This bot is configured for Injective testnet only
Use testnet wallets and tokens (free money!)
Never use mainnet private keys (unless you want to lose real money)
Testnet tokens are free from the faucet

⚠️ Risk Disclaimer

This is experimental software (use at your own risk)
Start with small amounts (don't go all-in on your first trade)
Monitor the bot continuously (don't just set it and forget it)
Test thoroughly before using with real money

📊 Performance Stats

Order Success Rate: ~95% (some timeout errors are normal)
Price Impact: Can move prices 15-30% per cycle
Sequence Conflicts: Rare with current timing settings
Resource Usage: Low CPU/memory footprint
Transaction Hash Logging: ✅ All trades are tracked with blockchain hashes

🔮 Future Enhancements (The Roadmap to Glory)

🚀 Planned Features

🌐 Web Dashboard: Real-time monitoring and control interface
📈 Perpetual Trading: Support for derivatives markets
🛡️ Risk Management: Position limits and stop-loss mechanisms
📊 Performance Analytics: Detailed P&L and success rate tracking
🎯 Multi-Market Support: Trade multiple assets simultaneously
🤖 AI-Powered Strategies: Machine learning for better price predictions

🏗️ Clean Architecture

📱 Standalone Scripts: Self-contained trading functionality
🧩 Modular Design: Easy to extend and modify
🎯 Focused Purpose: Single responsibility per component
📦 Minimal Dependencies: Only essential libraries

🆘 Troubleshooting (When Things Go Wrong)

🔧 Common Issues

"No wallets found" - Check your .env file has the right format
"Sequence mismatch" - Bot will auto-retry, just wait
"Mainnet price failed" - Network issue, bot will retry
"Ctrl+C not working" - Fixed! Now works immediately

📝 Logs

Console Output: Real-time trading activity
Log Files: logs/trading.log with full history
Log Rotation: Automatic 10MB rotation
Transaction Hashes: All trades logged with blockchain hashes

📞 Support (We Got Your Back)

For issues, questions, or contributions:

📖 Check the configuration files for customization options
👀 Monitor the console output for detailed error messages
🔍 Use the market comparison tool for data analysis
⚙️ Review the trading parameters for optimization
🐛 Check the logs for detailed error information

🎉 Success Stories

"This bot made me more money in testnet than my real trading account" - Anonymous Crypto Enthusiast

"Finally, a bot that doesn't crash when I press Ctrl+C" - Satisfied User

"The transaction hash logging is so clean, I can track every trade" - OCD Trader

📚 Quick Reference

🚀 Essential Commands

# Start web dashboard
cd web && python app.py

# Start bot directly
python scripts/multi_wallet_trader.py

# Cancel all orders
python scripts/batch_cancel_orders.py

# Compare market data
python utils/market_comparison_unified.py --compare-all

🌐 Web Dashboard URLs

Main Dashboard: http://localhost:8000
API Status: http://localhost:8000/api/status
Bot Control: http://localhost:8000/api/control
WebSocket: ws://localhost:8000/ws

📁 Key Files

Bot Script: scripts/multi_wallet_trader.py
Web App: web/app.py
Configuration: config/markets_config.json
Environment: .env
Logs: logs/trading.log

🎯 Network Information

Trading Network: Injective Testnet
Price Reference: Injective Mainnet
Web Interface: Localhost (Port 8000)
WebSocket: Real-time updates

🏆 Final Words

Built with ❤️ for the Injective ecosystem

The QA Injective MM Bot provides professional-grade market making capabilities with a modern web interface. Use it wisely, trade responsibly, and may your profits be ever in your favor. 🚀🌙

GM! LFG! WAGMI! 💎🙌

P.S. If this bot makes you rich, remember to tip your developer! 😉

Name		Name	Last commit message	Last commit date
Latest commit History 15 Commits
config		config
data		data
docs		docs
scripts		scripts
tests		tests
utils		utils
web		web
.gitignore		.gitignore
ARCHITECTURE.md		ARCHITECTURE.md
PROJECT_STRUCTURE.md		PROJECT_STRUCTURE.md
README.md		README.md
derivative_trader.py		derivative_trader.py
env.example		env.example
requirements.txt		requirements.txt
spot_trader.py		spot_trader.py
trader.py		trader.py

InjectiveLabs/qa-python-injective-trading-bot

Folders and files

Latest commit

History

Repository files navigation