Docs Download
Home / Docs / Getting Started / Initial Application Configuration

Initial Application Configuration

⚙️ MagicTradeBot v6.0 — Configuration System

MagicTradeBot v6.0 introduces a completely redesigned configuration system. All settings are now modular, structured, and located inside the /settings directory.

💡 Recommended: Use the GUI Bot Configurator instead of editing YAML manually:
https://magictradebot.com/en/bot-configuration

⚠️ Manual editing is intended for advanced users only.

📁 Configuration Structure

/settings/
├── application.yaml
├── connection.yaml
├── trading.yaml
├── position_sizing.yaml
├── money_management.yaml
├── risk_limits.yaml
├── order_execution.yaml
├── decision_engine.yaml
├── signal_registry.yaml
├── tradeview.yaml
├── market_data.yaml
├── market_watch.yaml
├── whale_tracking.yaml
├── dca.yaml
├── trading_gap_rules.yaml
├── excluded_symbols.yaml
├── manual_trade.yaml
└── notifications.yaml

Each file controls a specific subsystem of the bot, allowing fine-grained tuning and better maintainability.


🧠 Core Configuration Modules

🔧 application.yaml

Global application settings, environment, and exchange mode restrictions.

🔌 connection.yaml

Database (SQLite/PostgreSQL) and Redis configuration.

📊 trading.yaml

Core trading behavior, leverage, and execution rules.

📈 position_sizing.yaml

Capital allocation engine (fixed, %, Kelly, risk-based).

💰 money_management.yaml

Trade progression strategies (Fibonacci, Martingale, etc.).

⚠️ risk_limits.yaml

Hard stop-loss and take-profit enforcement.

⚡ order_execution.yaml

Order placement behavior (market, limit, slippage control).

🧠 decision_engine.yaml

Advanced rule engine with 50+ trading conditions.

📡 signal_registry.yaml

Signal routing and execution control.

📺 tradeview.yaml

TradingView webhook signal integration.


📊 Market & Strategy Modules

  • market_data.yaml — Candle/Kline data processing
  • market_watch.yaml — Volatility monitoring & auto-trading
  • dca.yaml — Dollar Cost Averaging system
  • trading_gap_rules.yaml — Dynamic trailing profit logic
  • whale_tracking.yaml — Hyperliquid whale copy-trading

🧩 Control & Utility Modules

  • excluded_symbols.yaml — Prevent trading on specific pairs
  • manual_trade.yaml — Conditional manual trade injection
  • notifications.yaml — Alerts (Telegram, Discord, etc.)

🔐 Environment Variables (Recommended)

API keys and sensitive credentials should never be stored in YAML files. Use environment variables instead.

# Example
BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret
⚠️ Environment variables always override YAML settings.

⚠️ Important Exchange Mode Restrictions

  • Bybit: One-Way Mode ONLY (Hedge Mode NOT supported)
  • Binance: Hedge Mode supported
  • Bitget: Hedge Mode supported
  • OKX: Hedge Mode supported

Using an incorrect mode may result in:

  • Order execution failures
  • Incorrect PnL calculations
  • Risk management inconsistencies

🚀 Quick Start (v6.0)

  1. Open Bot Configurator
  2. Configure your strategy via GUI
  3. Export YAML settings
  4. Replace /settings directory
  5. Set API keys via .env
  6. Run MagicTradeBot
✅ No database required (SQLite default)
✅ No backend setup needed
✅ Fully modular and scalable
Ready to trade? Download MagicTradeBot free and test in paper mode before going live.