Installation Guide

🧠 Overview

Unlike traditional setups, MagicTradeBot requires no complex installation or database dependencies. It’s fully portable and runs on Windows, macOS, and Linux — even on tiny or micro servers.

The bot operates entirely through simple configuration files (YAML and JSON), where you define trading strategies, exchanges, smart signal filters, and notification channels.

📥 Step 1: Download the Bot

Visit the official MagicTradeBot website and download the latest release for your operating system.

Sign in to your account and navigate to the Download section.
Choose your OS: Windows, macOS, or Linux.
Your account automatically includes a Trial License (30 days, full features). You can upgrade to Basic or Pro anytime.

📦 What's Included

File	Type	Description
`magictradebot.exe` / `magictradebot-linux` / `magictradebot-macos`	Executable	Precompiled Rust binary for your OS
`appsettings.yaml`	Configuration	Core bot settings, license key, and environment variables
`tradesettings.yaml`	Configuration	Trading strategy rules, smart stop-loss/TP logic, and cooldowns
`signals.json`	Optional Config	Custom signal filters, alert mapping, and API broadcast setup

⚙️ Step 2: Configure Your Bot

After downloading and unzipping MagicTradeBot, you’ll find an executable file along with several configuration files (YAML and JSON). These files define how your bot behaves, connects to exchanges, and broadcasts trade signals.

🔑 License Configuration

Open the appsettings.yaml file and add your valid license key. You can generate or upgrade your license anytime from your MagicTradeBot Dashboard.

# -----------------------------------------------------------
# License Settings
# -----------------------------------------------------------
License:
  Key: "your_license_here"   # Enter your valid license key here
  # Generate, extend, or upgrade at: https://magictradebot.com

📡 Broadcast & Notification Channels

MagicTradeBot can send trading notifications to your preferred platforms such as Discord, Telegram, or WhatsApp. Configure only the channels you plan to use. Leave unused options as null.

# -----------------------------------------------------------
# Broadcast / Notification Channels
# -----------------------------------------------------------
BroadCast:
  # Configure only the platforms you actually use.
  # Leave as null if not needed.

  # WhatsApp Notifications
  whatsapp_token: null
  whatsapp_phone_id: null

  # Discord Notifications
  discord_webhook_url: null

  # Instagram Notifications
  instagram_token: null

  # Telegram Notifications
  telegram_bot_token: null
  telegram_chat_id: null

Once the basic license and broadcast settings are complete, your bot is ready to start. For advanced configuration—such as exchange credentials, trade strategy, and smart automation settings—please refer to the Configuration Section.

The bot comes pre-configured for scalp trading. You can adjust every parameter based on your strategy or integrate your own signal providers.

🚀 Step 3: Run the Bot

🪟 For Windows

magictradebot.exe

🐧 For Linux / macOS

chmod +x magictradebot-linux
./magictradebot-linux

That’s it! The bot will automatically start scanning the market, execute trades based on configured rules, and broadcast updates to your chosen channels.

📊 Step 4: Monitor and Adjust

You can view logs in the terminal or configure optional log output to log.yaml or external monitoring services (Grafana Loki, Prometheus, Sentry).

Adjust settings anytime — simply stop the bot, modify YAML/JSON files, and restart.

💡 No Installation Required

MagicTradeBot runs directly — no database, no frameworks, no complex setup. Just download, configure, and start trading. Perfect for VPS, mini PCs, or cloud containers.

Pro Tip: Keep configuration backups and update your bot regularly from the official site to ensure optimal performance and security.

⚙️ MagicTradeBot Installation Guide