Bot Configuration

Learn how to configure your FreqTrade bot for optimal performance.

Basic Configuration

Every bot needs a configuration file that defines its behavior. FreqTradeHub provides both a visual editor and direct JSON editing.

Essential Parameters

{
  "bot_name": "MyTradingBot",
  "max_open_trades": 3,
  "stake_currency": "USDT",
  "stake_amount": "unlimited",
  "tradable_balance_ratio": 0.99,
  "fiat_display_currency": "USD",
  "timeframe": "5m",
  "dry_run": true,
  "cancel_open_orders_on_exit": false
}

Parameter Explanation

Parameter	Description	Recommended Value
max_open_trades	Maximum number of trades open at once	3-5 for beginners
stake_currency	Quote currency for trades	USDT, BTC, or ETH
stake_amount	Amount per trade	Start with fixed amount
timeframe	Candlestick timeframe	5m or 15m
dry_run	Paper trading mode	Always start with true

Exchange Configuration

API Credentials

Configure your exchange connection:

{
  "exchange": {
    "name": "binance",
    "key": "your-api-key",
    "secret": "your-api-secret",
    "ccxt_config": {
      "enableRateLimit": true
    },
    "ccxt_async_config": {
      "enableRateLimit": true,
      "rateLimit": 200
    }
  }
}

Pair Lists

Define which trading pairs your bot should trade:

{
  "pair_whitelist": [
    "BTC/USDT",
    "ETH/USDT",
    "BNB/USDT",
    "ADA/USDT",
    "DOT/USDT"
  ],
  "pair_blacklist": [
    "BNB/.*",
    ".*UP/.*",
    ".*DOWN/.*"
  ]
}

Strategy Configuration

Built-in Strategies

Select from pre-configured strategies:

1. RSI Strategy

   • Buy when RSI < 30
   • Sell when RSI > 70
   • Good for ranging markets

2. MACD Strategy

   • Trade on MACD crossovers
   • Follows trends
   • Medium-term trades

3. Bollinger Bands

   • Buy at lower band
   • Sell at upper band
   • Volatility-based

Custom Strategy Parameters

{
  "strategy": "RSIStrategy",
  "strategy_parameters": {
    "buy_rsi": 30,
    "sell_rsi": 70,
    "rsi_period": 14
  }
}

Risk Management

Stop Loss Configuration

Protect your capital with stop losses:

{
  "stoploss": -0.10,
  "trailing_stop": true,
  "trailing_stop_positive": 0.01,
  "trailing_stop_positive_offset": 0.02,
  "trailing_only_offset_is_reached": false
}

Position Sizing

Control your risk per trade:

{
  "position_sizing": {
    "method": "fixed",
    "stake_amount": 100,
    "max_position_size": 1000,
    "min_position_size": 10
  }
}

Advanced Settings

Order Types

Configure order execution:

{
  "order_types": {
    "entry": "limit",
    "exit": "limit",
    "emergency_exit": "market",
    "force_entry": "market",
    "force_exit": "market",
    "stoploss": "market",
    "stoploss_on_exchange": false
  }
}

Pricing

Fine-tune entry and exit pricing:

{
  "entry_pricing": {
    "price_side": "same",
    "use_order_book": true,
    "order_book_top": 1,
    "price_last_balance": 0.0
  },
  "exit_pricing": {
    "price_side": "same",
    "use_order_book": true,
    "order_book_top": 1
  }
}

Configuration Templates

Conservative Template

For risk-averse traders:

{
  "max_open_trades": 3,
  "stake_amount": 50,
  "stoploss": -0.05,
  "trailing_stop": true,
  "trailing_stop_positive": 0.005,
  "timeframe": "1h"
}

Aggressive Template

For experienced traders:

{
  "max_open_trades": 10,
  "stake_amount": 200,
  "stoploss": -0.15,
  "trailing_stop": true,
  "trailing_stop_positive": 0.01,
  "timeframe": "5m"
}

Scalping Template

For quick trades:

{
  "max_open_trades": 5,
  "stake_amount": 100,
  "stoploss": -0.02,
  "minimal_roi": {
    "0": 0.01,
    "10": 0.005,
    "20": 0
  },
  "timeframe": "1m"
}

Testing Your Configuration

Dry Run Mode

Always test with paper trading first:

1. Set "dry_run": true
2. Run for at least 1 week
3. Monitor performance
4. Adjust parameters as needed

Configuration Validation

FreqTradeHub automatically validates your configuration:

• Checks for syntax errors
• Validates parameter ranges
• Ensures exchange compatibility
• Warns about risky settings

Best Practices

1. Start Small - Use minimum trade amounts initially
2. Use Stop Losses - Always protect your downside
3. Diversify - Trade multiple pairs
4. Monitor Regularly - Check your bot daily
5. Keep Learning - Join our Discord community

Troubleshooting

Common Issues

Issue	Solution
Bot not trading	Check dry_run mode and balance
High losses	Review stop loss settings
API errors	Verify API permissions
No profits	Adjust strategy parameters

Next Steps

• Exchange Connection →
• Strategy Selection →
• Risk Management →

---

Need help? Join our Discord for community support.