Что такое application.yaml в MagicTradeBot?

Что такое application.yaml?

application.yaml — это основной файл конфигурации, который управляет тем, как MagicTradeBot запускается, подключается к биржам, идентифицирует себя и работает на системном уровне.

Думайте об этом как о конфигурации загрузки MagicTradeBot — прежде чем любая стратегия, мониторинг рынка или логика механизма принятия решений будет запущена, бот читает этот файл, чтобы понять:

  • К какой бирже подключиться
  • Как безопасно аутентифицироваться
  • Следует ли ему работать в демо- или реальном режиме
  • Какую лицензию использовать
  • Базовое поведение во время выполнения (отладка, именование, среда)

Без действительного application.yaml MagicTradeBot не может инициализироваться или работать корректно.

Что контролирует application.yaml?

Файл application.yaml отвечает за глобальные, не связанные со стратегией настройки, включая:

  • Выбор биржи и правила совместимости
  • Аутентификацию API (или сопоставление переменных среды)
  • Проверку лицензии
  • Идентификацию бота и флаги времени выполнения
  • Поведение безопасности и развертывания

Он НЕ определяет:

  • Торговые стратегии
  • Правила стоп-лосс / тейк-профит
  • Логику Market Watch
  • Правила принятия решений DCA или Brain

Они обрабатываются в отдельных файлах конфигурации, специфичных для функций, что обеспечивает чистоту и модульность ответственности.

Объяснение ключевых разделов

1. Конфигурация биржи

Этот раздел сообщает MagicTradeBot, к какой бирже подключиться и как.

Ключевые обязанности:

  • Выбирает биржу (binance, bybit, okx, bitget, hyperliquid)
  • Обеспечивает совместимость режима позиций, специфичного для биржи
  • Безопасно загружает учетные данные API

Здесь MagicTradeBot выполняет строгую проверку, чтобы предотвратить:

  • Неправильные режимы позиций (например, Hedge против One-Way)
  • Сбой выполнения ордеров
  • Неверные расчеты PnL
  • Несоответствия в управлении рисками

Если настроена неподдерживаемая биржа, бот откажется работать.

2. Учетные данные API и безопасность

application.yaml поддерживает два безопасных метода для учетных данных:

Вариант A: Прямой YAML (рекомендуется только для демо/тестирования)

APIKEY: ""
APISECRET: ""
Passphrase: ""

Вариант B: Переменные среды (рекомендуется для производства)

Переменные среды автоматически переопределяют значения YAML.

Эта конструкция:

  • Предотвращает случайное раскрытие ключей
  • Беспрепятственно работает с Docker, VPS и облачными развертываниями
  • Соответствует лучшим практикам корпоративной безопасности

MagicTradeBot никогда не требует разрешений на вывод средств и явно предупреждает против них.

3. Совместимость режима позиций (Критически важно)

Разные биржи поддерживают разные режимы позиций, и MagicTradeBot обеспечивает это при запуске.

Примеры:

  • Bybit → Только режим One-Way
  • Binance / OKX / Bitget → Требуется режим Hedge

Если ваш аккаунт на бирже настроен неправильно:

  • Ордера могут быть отклонены
  • TP/SL могут не сработать
  • Позиции могут закрыться некорректно

Эта проверка существует для защиты капитала и обеспечения детерминированного поведения.

4. Конфигурация лицензии

Раздел лицензии активирует вашу установку MagicTradeBot.

License:
  Key: ""

Лицензия:

  • Разблокирует функции в соответствии с вашим планом
  • Контролирует авторизацию экземпляра
  • Проверяется во время запуска

Без действительного лицензионного ключа бот не перейдет в рабочий режим.

5. Общие настройки приложения

Этот раздел управляет тем, как бот ведет себя во время выполнения — а не тем, как он торгует.

Ключевые параметры:

  • BotName – Помогает идентифицировать этот экземпляр в журналах, панелях мониторинга и оповещениях
  • DemoMode – Включает симулированную торговлю без реальных средств
  • DebugMode – Включает подробное журналирование для диагностики

Эти настройки особенно полезны при запуске:

  • Нескольких экземпляров бота
  • Промежуточных и производственных сред
  • Отладки или расследований службы поддержки

Демо-режим против реального режима

Один из самых важных флагов в application.yaml:

DemoMode: true
  • DemoMode = true → Реальные ордера не размещаются
  • DemoMode = false → Реальная торговля включена

Это позволяет пользователям:

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

Почему MagicTradeBot использует application.yaml

MagicTradeBot использует application.yaml, потому что он обеспечивает:

  • Читаемую человеком структуру
  • Четкое разделение ответственности
  • Безопасные значения по умолчанию для новых пользователей
  • Легкую автоматизацию через переменные среды
  • Совместимость с Docker, облаком и локальными развертываниями

Самое главное, он гарантирует предсказуемое поведение при запуске, что необходимо для автоматизированной торговой системы.

Лучшие практики

  • ✔ Используйте переменные среды для ключей API в производстве
  • ✔ Оставляйте DemoMode включенным во время тестирования
  • ✔ Дважды проверяйте режим позиций биржи перед выходом в реальный режим
  • ✔ Никогда не включайте разрешения на вывод средств для ключей API
  • ✔ Относитесь к application.yaml как к конфигурации инфраструктуры, а не к конфигурации стратегии

Резюме

application.yaml — это основа среды выполнения MagicTradeBot.

Он определяет:

  • Куда подключается бот
  • Как он аутентифицируется
  • Торгует ли он в реальном или демо-режиме
  • Какая лицензия активна
  • Насколько безопасно он работает

Все расширенные интеллектуальные возможности — такие как Smart SL/TP, Market Watch, DCA и мозг MagicTradeBot — построены поверх этого файла, что делает его одним из самых важных компонентов во всей системе.

📎 Related Topics