ChipaDocs

Getting Started

🤖 RussBot is a free, open-source binary options trading bot for PocketOption, built on BinaryOptionsToolsV2 → Get it on GitLab
💬 Need help? Join the Chipa Discord · ⚡ Go no-code with ChipaEditor

From zero to your first automated trade in five steps.

1. Install Dependencies

pip install pandas numpy BinaryOptionsToolsV2

See the Installation guide for virtual environments and the Windows executable.

2. Getting Your SSID

RussBot authenticates with PocketOption using your session ID (SSID):

  1. Log into your PocketOption account in your browser
  2. Open Developer Tools (F12) → Network tab
  3. Filter for WS (WebSocket) traffic and reload the page
  4. Click the WebSocket connection and look at the first sent messages — copy the full 42["auth", {...}] session string (or extract the SSID from your browser cookies)

⚠️ Keep your SSID secret. It grants full access to your trading account. Never share it or commit it to version control. The launcher masks it when displaying your configuration.

💡 Start on demo. Use a demo-account SSID until you’ve watched the bot trade for a while and understand the strategy.

3. Test Before Trading

Verify data loading and indicators work with your connection:

# Test historical data loading
python test_history.py

# Test indicator calculations
python test_indicators.py

See Testing for what these scripts check.

4. Run the Bot

python run_bot.py

The launcher gives you a simple menu:

🤖 RussBot Trading Bot v2.0
🎯 Multi-Asset Trading System

1. 🎯 Start Bot          — launches the multi-asset bot
2. ⚙️  Configure          — edit trading, indicator, system & user settings
3. 🌐 Join Community     — opens the Discord community
4. 🚪 Exit

It checks your dependencies, creates a default config.json on first run, and walks you through configuration interactively. See Configuration for every setting.

Option B — Single-asset bot

python trading_bot.py

Prompts for your SSID, an asset (default EURUSD_otc), and a trade amount (default 1.0), then starts trading one asset on 15-second candles. Details in Single-Asset Bot.

Option C — Multi-asset bot

# Recommended: check payouts first
python payout_checker.py

# Then run the multi-asset bot
python multi_asset_bot.py

Trades many assets concurrently, one process per asset, skipping anything paying ≤ 90%. Details in Multi-Asset Bot and Payout Checker.

5. Watch It Work

Once running, the bot prints real-time feedback for every candle:

📊 Market Analysis:
Price: 1.08452
EMA(10): 1.08447
CCI(7): 96.34
MACD: 0.00012
Buy Check - Green: True, Above EMA: True, CCI~100: True (CCI: 96.34), EMA Up: True
🟢 EXECUTING BUY TRADE - Asset: EURUSD_otc, Amount: 1.0
✅ Buy trade executed - ID: a1b2c3...
🎉 BUY Trade a1b2c3... WON!

What happens at startup:

  1. Connects to PocketOption with your SSID and prints your balance
  2. Pre-loads the last hour of historical candles so indicators are ready immediately (no waiting for 26+ live candles)
  3. Subscribes to timed candles and analyzes each one against the strategy rules
  4. Executes trades only when all four signal conditions align, respecting the 16-second cooldown

Risk Disclaimer

⚠️ Binary options trading carries significant financial risk. RussBot is educational software — test on demo first, start small, and never trade money you can’t afford to lose.

Next Steps

  • Strategy — understand exactly when and why the bot trades
  • Configuration — tune indicator periods, tolerances, and payout filters
  • Multi-Asset Bot — scale up to concurrent trading
  • 💬 Chipa Discord — share your results and get tuning advice; and if you’d rather design strategies visually, try ChipaEditor