First Launch

Why Two Separate Bots?

The ByNinja Trading Bot operates using a highly stable dual-process architecture. The Telegram Bot and the Trading Bot run independently. This ensures that even if one process encounters an unexpected error, the other continues working seamlessly. The run.sh script acts as a process manager, automatically restarting the bots if they crash, guaranteeing 24/7 uninterrupted operation.

For ultimate reliability, the system is split into two isolated processes. If the trading engine faces network latency or an unexpected python exception, your Telegram control remains fully responsive. The run.sh script will instantly restart the crashed process. Both bots communicate with each other seamlessly via a secure local TCP connection.

By default, the bots synchronize their actions through the following local TCP port (configured in your settings):

TCP_SERVER_PORT = 55110

1. Launch the Telegram Bot

First, open your terminal and navigate to the root directory of the bot repository. Start the Telegram bot process. It acts as your control center and notification system.

cd byninja-trading-bot
./run.sh telegram

Expected Telegram Bot Logs

TelegramBot - INFO - 🔍 Checking Telegram connection...
TelegramBot - INFO - Telegram connected | Bot: @Bot
TelegramBot - INFO - ✅ Telegram connected successfully
TelegramBot - INFO - 📋 Telegram command menu registered successfully.
TelegramTCP - INFO - 🚀 TCP server started on port 55110
TelegramBot - INFO - đŸŽ¯ Server ready to work on port 55110
TelegramTCP - INFO - 🔍 Waiting for client connection...
TelegramBot - INFO - 💡 All TCP messages will be forwarded to Telegram
TelegramTCP - INFO - 🚀 Server started on localhost:55110
TelegramBot - INFO - 🕹ī¸ Telegram command handler started...
TelegramTCP - INFO - 🔗 Client connected: ('*.*.*.*', *****)

2. Launch the Trading Bot

Open a new terminal window, navigate to the repository root again, and launch the core trading engine. This process handles the actual market analysis and Binance execution.

cd byninja-trading-bot
./run.sh trading

Expected Trading Bot Logs

TradingBot - DEBUG - đŸĨˇ BYNINJA TRADING BOT v0.1.0
TradingBot - DEBUG - ============================================================
TradingBot - INFO - ✅ Loaded 0 records from active_positions.pkl
TradingBot - DEBUG - 🔄 Background save thread started
TradingBot - INFO - 📁 File pending_orders.pkl not found, creating new
TradingBot - DEBUG - 🔄 Background save thread started
TradingBot - INFO - 📁 File symbol_controls.pkl not found, creating new
TradingBot - DEBUG - 🔄 Background save thread started
TradingBot - INFO - ✅ Loaded 11 records from closed_trades_v0.1.0.pkl
TradingBot - DEBUG - 🔄 Background save thread started
TradingBot - INFO - 📊 RiskManager initialized for version 0.1.0
TradingBot - INFO - 📈 Loaded 11 closed trades
TradingBot - INFO - đŸĨˇ ByNinja Trading Bot initialization with capital: $1000.00
TradingBot - INFO - ✅ Successfully connected to Binance
TradingBot - DEBUG - đŸŽ¯ Available trading pairs: 5
TradingBot - DEBUG -    - AVAXUSDT
TradingBot - DEBUG -    - LINKUSDT
TradingBot - DEBUG -    - DOTUSDT
TradingBot - DEBUG -    - XRPUSDT
TradingBot - DEBUG -    - ATOMUSDT
TradingBot - INFO - 🔄 Starting TCP client
TradingTCP - INFO - 🔄 Connecting to TCP server...
TradingTCP - INFO - ✅ Connected to server localhost:55110
TradingTCP - INFO - ✅ TCP client connected successfully
TradingBot - INFO - đŸĨˇ STARTUP BYNINJA TRADING BOT v0.1.0
TradingBot - DEBUG - 🔍 Intelligent monitoring for AVAXUSDT
TradingBot - DEBUG - 🔍 Intelligent monitoring for LINKUSDT
TradingBot - DEBUG - 🔍 Intelligent monitoring for DOTUSDT
TradingBot - DEBUG - 🔍 Intelligent monitoring for XRPUSDT
TradingBot - INFO - 📊 Started monitoring for:
   - AVAXUSDT
   - LINKUSDT
   - DOTUSDT
   - XRPUSDT
   - ATOMUSDT
TradingBot - DEBUG - 🔍 Intelligent monitoring for ATOMUSDT
TradingBot - DEBUG - ✅ All systems started. Bot is active.
TradingBot - DEBUG - 💡 Bot active. Press Ctrl+C to stop.
TradingBot - DEBUG - 💰 Balance: USDT=$32024.00, assets: 230

3. Active Monitoring & Trading

Once the Trading Bot is active, it continuously monitors your specified pairs for EMA cross signals, analyzes volume spikes, and executes trades with pinpoint accuracy. You will see real-time market analysis logs.

TradingBot - DEBUG - DOTUSDT   | ENTRY | $  1.2370 | S200 -0.004%>-0.008% đŸŸĸ | S50 -0.012%>+0.005% 🔴 | S20 -0.004%>+0.010% 🔴 | D200/50 -0.145%>+0.060% 🔴 | D50/20 -0.123%>+0.080% 🔴 | Vol  0.1x>1.2x 🔴
TradingBot - DEBUG - XRPUSDT   | EXIT  | $  1.3913 | PnL: +0.24% đŸŸĸ | TS: +0.06% | TP: +2.30% | SL: -1.15% | Time: 05:07:27
TradingBot - DEBUG - ATOMUSDT  | ENTRY | $  1.9630 | S200 -0.015%>-0.008% 🔴 | S50 -0.018%>+0.005% 🔴 | S20 -0.024%>+0.010% 🔴 | D200/50 -0.322%>+0.070% 🔴 | D50/20 -0.102%>+0.110% 🔴 | Vol  0.3x>1.2x 🔴
TradingBot - DEBUG - DOTUSDT   | ENTRY | $  1.2370 | S200 -0.004%>-0.008% đŸŸĸ | S50 -0.012%>+0.005% 🔴 | S20 -0.004%>+0.010% 🔴 | D200/50 -0.145%>+0.060% 🔴 | D50/20 -0.123%>+0.080% 🔴 | Vol  0.1x>1.2x 🔴
TradingBot - DEBUG - LINKUSDT  | ENTRY | $  9.2800 | S200 -0.009%>-0.008% 🔴 | S50 -0.015%>+0.005% 🔴 | S20 -0.017%>+0.010% 🔴 | D200/50 -0.226%>+0.060% 🔴 | D50/20 -0.104%>+0.090% 🔴 | Vol  0.0x>1.2x 🔴
TradingBot - DEBUG - XRPUSDT   | EXIT  | $  1.3913 | PnL: +0.24% đŸŸĸ | TS: +0.06% | TP: +2.30% | SL: -1.15% | Time: 05:07:28
TradingBot - DEBUG - AVAXUSDT  | ENTRY | $  9.2700 | S200 +0.001%>-0.008% đŸŸĸ | S50 -0.002%>+0.005% 🔴 | S20 +0.016%>+0.010% đŸŸĸ | D200/50 -0.177%>+0.060% 🔴 | D50/20 -0.102%>+0.100% 🔴 | Vol  2.6x>1.2x đŸŸĸ
TradingBot - DEBUG - LINKUSDT  | ENTRY | $  9.2800 | S200 -0.009%>-0.008% 🔴 | S50 -0.015%>+0.005% 🔴 | S20 -0.017%>+0.010% 🔴 | D200/50 -0.226%>+0.060% 🔴 | D50/20 -0.104%>+0.090% 🔴 | Vol  0.0x>1.2x 🔴
TradingBot - DEBUG - DOTUSDT   | ENTRY | $  1.2370 | S200 -0.004%>-0.008% đŸŸĸ | S50 -0.012%>+0.005% 🔴 | S20 -0.004%>+0.010% 🔴 | D200/50 -0.145%>+0.060% 🔴 | D50/20 -0.123%>+0.080% 🔴 | Vol  0.1x>1.2x 🔴
TradingBot - DEBUG - AVAXUSDT  | ENTRY | $  9.2800 | S200 +0.002%>-0.008% đŸŸĸ | S50 +0.002%>+0.005% 🔴 | S20 +0.026%>+0.010% đŸŸĸ | D200/50 -0.174%>+0.060% 🔴 | D50/20 -0.096%>+0.100% 🔴 | Vol  2.6x>1.2x đŸŸĸ
TradingBot - DEBUG - XRPUSDT   | EXIT  | $  1.3914 | PnL: +0.25% đŸŸĸ | TS: +0.06% | TP: +2.30% | SL: -1.15% | Time: 05:07:57
TradingBot - DEBUG - ATOMUSDT  | ENTRY | $  1.9630 | S200 -0.015%>-0.008% 🔴 | S50 -0.018%>+0.005% 🔴 | S20 -0.024%>+0.010% 🔴 | D200/50 -0.322%>+0.070% 🔴 | D50/20 -0.102%>+0.110% 🔴 | Vol  0.3x>1.2x 🔴
TradingBot - DEBUG - LINKUSDT  | ENTRY | $  9.2900 | S200 -0.008%>-0.008% đŸŸĸ | S50 -0.010%>+0.005% 🔴 | S20 -0.005%>+0.010% 🔴 | D200/50 -0.229%>+0.060% 🔴 | D50/20 -0.098%>+0.090% 🔴 | Vol  0.0x>1.2x 🔴
TradingBot - DEBUG - XRPUSDT   | EXIT  | $  1.3913 | PnL: +0.24% đŸŸĸ | TS: +0.06% | TP: +2.30% | SL: -1.15% | Time: 05:08:27
TradingBot - DEBUG - AVAXUSDT  | ENTRY | $  9.2700 | S200 +0.004%>-0.008% đŸŸĸ | S50 +0.002%>+0.005% 🔴 | S20 +0.024%>+0.010% đŸŸĸ | D200/50 -0.175%>+0.060% 🔴 | D50/20 -0.088%>+0.100% 🔴 | Vol  0.5x>1.2x 🔴
Next Step: Telegram Commands →