Какие настройки необходимо выполнить перед первым запуском MagicTradeBot?

  • Home
  • Documentation
  • Какие настройки необходимо выполнить перед первым запуском MagicTradeBot?

Руководство по первоначальной настройке

Перед первым запуском MagicTradeBot необходимо настроить небольшой набор обязательных и рекомендуемых параметров, чтобы бот запустился корректно, безопасно подключился к вашей бирже и работал без ошибок.

MagicTradeBot разработан с безопасными настройками по умолчанию, поэтому вам не нужно настраивать каждый файл заранее. Приведенные ниже шаги описывают минимально необходимую и рекомендуемую настройку для первого успешного запуска.

1. Настройка биржи в application.yaml

Вы должны указать, к какой бирже подключится MagicTradeBot.

Exchange:
  Name: "bybit"

Поддерживаемые биржи:

  • Binance
  • Bybit
  • OKX
  • Bitget
  • Hyperliquid

⚠️ Важно: У каждой биржи есть строгие требования к режиму позиций (One-Way или Hedge). Убедитесь, что ваш аккаунт на бирже настроен соответствующим образом, прежде чем запускать бота.

2. Установка учетных данных API биржи (Обязательно)

MagicTradeBot требует доступ к API для размещения и управления сделками.

Рекомендуемый метод: Переменные среды (Лучшая практика)

Использование переменных среды настоятельно рекомендуется, особенно для продакшена, потому что:

  • Ключи API не хранятся в файлах
  • Ключи безопаснее и их легче менять
  • Переменные среды автоматически переопределяют значения YAML

Настройка переменных среды по ОС

✅ Windows (PowerShell)
setx BINANCE_API_KEY "ваш_ключ_api_здесь"
setx BINANCE_API_SECRET "ваш_секрет_api_здесь"

Перезапустите терминал (или систему) после установки переменных.

✅ Linux / macOS (Терминал)
export BINANCE_API_KEY="ваш_ключ_api_здесь"
export BINANCE_API_SECRET="ваш_секрет_api_здесь"

Чтобы сделать их постоянными, добавьте строки в:

  • ~/.bashrc
  • ~/.zshrc
  • Ваш файл профиля оболочки
✅ Docker / Docker Compose
environment:
  - BINANCE_API_KEY=${BINANCE_API_KEY}
  - BINANCE_API_SECRET=${BINANCE_API_SECRET}

Поддерживаемые имена переменных среды

Примеры:

  • BINANCE_API_KEY, BINANCE_API_SECRET
  • BYBIT_API_KEY, BYBIT_API_SECRET
  • OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE
  • BITGET_API_KEY, BITGET_API_SECRET, BITGET_PASSPHRASE
  • HYPERLIQUID_PRIVATE_KEY

🔐 Никогда не включайте разрешения на вывод средств для ключей API.

3. Укажите ваш лицензионный ключ

В application.yaml:

License:
  Key: "ваш_лицензионный_ключ_здесь"

Как получить лицензионный ключ

  1. Войдите на https://magictradebot.com
  2. Перейдите в раздел Загрузки
  3. Скопируйте ваш лицензионный ключ

Важные замечания

  • Бот может работать и без лицензии
  • Однако функциональность будет ограничена
  • Проверка лицензии происходит при запуске

4. Просмотр основных настроек торговли (trading.yaml)

Для новых пользователей этот файл не требует обязательных изменений.

Вы можете при желании просмотреть или скорректировать:

  • Начальную сумму торговли
  • Кредитное плечо по умолчанию
  • Лимиты риска

Если не уверены, оставьте значения по умолчанию — они безопасны для первых запусков и демо-режима.

5. Первоначальная настройка символов и кредитного плеча (Очень важно)

Шаг 1: Включить синхронизацию символов (Только для первого запуска)

В trading.yaml (или файле конфигурации символов):

SyncSymbolsOnStartup: true

Это:

  • Получит все поддерживаемые символы с биржи
  • Создаст или обновит symbols.json
  • Удалит исключенные из листинга символы
  • Добавит недавно добавленные в листинг символы

➡️ Запустите бота и дождитесь завершения синхронизации символов
➡️ Следите за файлом symbols.json
➡️ Остановите бота после завершения синхронизации

Шаг 2: Отключить синхронизацию символов (Необязательно)

После первой синхронизации вы можете установить:

SyncSymbolsOnStartup: false

Если вы хотите автоматического обновления символов, оставьте значение true постоянно.

Шаг 3: Одноразовая настройка кредитного плеча (Необязательно, но рекомендуется)

Если вы хотите, чтобы MagicTradeBot настраивал кредитное плечо автоматически:

SetLeverageStartup: true
SetMaxLeverage: false
  • Это применит настроенное вами плечо (например, 10x) ко всем поддерживаемым символам
  • Запустите бота один раз
  • Подождите несколько минут для обновления плеча
  • Затем установите для обоих параметров значение false

⚠️ НЕ оставляйте эти параметры включенными постоянно, иначе плечо будет сбрасываться при каждом перезапуске.

Максимальное кредитное плечо (Для скальпинга)

Если вы хотите максимальное плечо, разрешенное биржей:

SetMaxLeverage: true

Используйте это только один раз, затем снова отключите.

6. Выбор символов для торговли (Необязательно)

Вы можете:

  • Торговать всеми синхронизированными символами (500+)
  • Или ограничить торговлю только выбранными символами

Пример:

BTCUSDT
ETHUSDT
SOLUSDT
XRPUSDT

Если вы торгуете всеми символами, оставьте:

SyncSymbolsOnStartup: true

7. Настройка уведомлений (Настоятельно рекомендуется)

Настройте хотя бы один канал уведомлений в notification.yaml:

  • Telegram
  • Discord

Это позволит вам получать:

  • Исполнение сделок
  • Ошибки и сбои
  • Оповещения Market Watch
  • Экстренные события

Работа без уведомлений возможна, но не рекомендуется.

Финальный контрольный список (Первый запуск)

Перед запуском MagicTradeBot убедитесь, что:

  • ✅ Биржа выбрана в application.yaml
  • ✅ Учетные данные API установлены (желательно через переменные среды)
  • ✅ Лицензионный ключ добавлен (необязательно, но рекомендуется)
  • ✅ Синхронизация символов включена для первого запуска
  • ✅ Необязательная настройка плеча выполнена один раз
  • ✅ Канал уведомлений настроен

Вот и все.
Никакой другой настройки не требуется для безопасного и правильного начала торговли.

📎 Related Topics