Руководство пользователя — Глобальная настройка и управление кредитным плечом

Обзор

Это руководство объясняет, как использовать параметры конфигурации левериджа в tradesettings.yaml в разделе Общие настройки для управления левериджем по всем торговым символам на вашей бирже.

1. SetLeverageStartup

SetLeverageStartup: false

Цель: Применить заданный леверидж ко всем торговым символам при запуске бота.

Когда включать (true)

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

Когда отключать (false)

• ✅ После успешного обновления левериджа: Чтобы избежать ненужных вызовов API
• ✅ Обычная работа: Чтобы предотвратить сброс левериджа при каждом перезапуске
• ✅ Когда леверидж уже настроен: Если все символы имеют правильный леверидж

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

• Всегда устанавливайте false после успешного обновления левериджа, чтобы избежать:
  • Ненужных вызовов API при каждой инициализации
  • Потенциальных ограничений скорости со стороны биржи
  • Более медленного времени запуска

# Шаг 1: Включите для обновления левериджа
SetLeverageStartup: true

# Шаг 2: Запустите бот (леверидж будет применен)
# Шаг 3: Остановите бот

# Шаг 4: Отключите перед следующим запуском
SetLeverageStartup: false

Пример рабочего процесса

1. Установите желаемый леверидж в конфигурации (например, 10x)
2. Включите SetLeverageStartup: true
3. Запустите бот → Леверидж применен ко всем символам
4. Остановите бот
5. Отключите SetLeverageStartup: false
6. Перезапустите бот для нормальной торговли

2. SetMaxLeverage

SetMaxLeverage: false

Цель: Автоматически использовать максимальный леверидж, разрешенный биржей для каждого символа, вместо настроенного значения левериджа.

Как это работает

Когда false (по умолчанию):

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

Когда true:

• Получает максимальный поддерживаемый леверидж для каждого символа
• Использует меньшее значение между настроенным и максимальным на бирже

Примеры сценариев

# Сценарий 1: Символ поддерживает ваш леверидж
Ваша настройка: 20x
Максимум символа: 50x
Результат:       20x

# Сценарий 2: Символ имеет меньший максимальный леверидж
Ваша настройка: 20x
Максимум символа: 5x
Результат:       5x
Вывод бота:      "ℹ️ Максимальный леверидж для XYZUSDT — 5x, используется 5x вместо 20x"

# Сценарий 3: Символ имеет больший максимальный леверидж
Ваша настройка: 10x
Максимум символа: 125x
Результат:       10x

Когда включать (true)

• ✅ Безопасный подход для избежания ошибок, связанных с левериджем
• ✅ Смешанные типы символов с разными лимитами левериджа
• ✅ Консервативная торговля с автоматической настройкой под лимиты
• ✅ Боты для нескольких бирж с разными правилами

Когда отключать (false)

• ✅ Единый леверидж, поддерживаемый для всех символов
• ✅ Стратегия требует точных значений левериджа
• ✅ Оптимизация производительности (меньше вызовов API)

Интеграция с symbols.json

Процесс обновления левериджа

1. Бот считывает леверидж из tradesettings.yaml
2. Если SetMaxLeverage: true → Получает максимальный леверидж
3. Рассчитывает окончательный леверидж (минимум между настроенным и максимальным)
4. Применяет леверидж через API биржи
5. ✅ Обновляет symbols.json с фактически примененным левериджем
6. Бот использует леверидж из symbols.json для торговли

Почему обновление symbols.json важно

• Обеспечивает согласованность с биржей
• Сохраняется при перезапусках
• Видимое отслеживание фактически используемого левериджа

⚠️ Важно: Время синхронизации

# ❌ НЕПРАВИЛЬНО
SetLeverageStartup: true
SetMaxLeverage: true

# ✅ ПРАВИЛЬНО (Однократное обновление)
SetLeverageStartup: true
SetMaxLeverage: true
# После успеха:
SetLeverageStartup: false
SetMaxLeverage: false

Рекомендуемые рабочие процессы конфигурации

Первоначальная настройка (новый бот)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true

1. Настройте указанные параметры
2. Запустите бот → Леверидж применен и symbols.json обновлен
3. Остановите бот
4. Отключите оба параметра
5. Перезапустите для нормальной работы

Изменение значения левериджа

# tradesettings.yaml
Leverage: 15
SetLeverageStartup: true
SetMaxLeverage: true

1. Обновите значение левериджа
2. Включите SetLeverageStartup
3. Запустите бот → Применен новый леверидж
4. Остановите бот
5. Снова отключите перед следующим запуском

Обычная работа (рекомендуется)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: false
SetMaxLeverage: false

Бот считывает леверидж из symbols.json (уже настроен и обновлен).

Добавление новых символов

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true

1. Добавьте новые символы на биржу
2. Включите SetLeverageStartup
3. Запустите бот → Леверидж применен ко всем символам
4. Остановите бот
5. Отключите перед нормальной торговлей

Устранение неполадок

• Проблема: Бот продолжает сбрасывать леверидж
  Причина: SetLeverageStartup: true оставлен включенным
  Решение: Установите false после первоначальной настройки
• Проблема: Леверидж не применяется
  Причина: SetLeverageStartup: false во время обновления
  Решение: Временно включите и перезапустите
• Проблема: Ошибки API о лимитах левериджа
  Причина: Настроенный леверидж превышает максимум биржи
  Решение: Включите SetMaxLeverage: true
• Проблема: Несоответствие в symbols.json
  Причина: Ручное изменение или рассинхронизация
  Решение: Включите SetLeverageStartup: true один раз для повторной синхронизации

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

✅ Делайте

• Установите SetLeverageStartup: false после успешных обновлений
• Используйте SetMaxLeverage: true для первоначальной настройки
• Проверяйте значения левериджа в symbols.json
• Храните резервные копии перед изменениями
• Тестируйте на одном символе перед применением ко всем

❌ Не делайте

• Оставляйте SetLeverageStartup: true в нормальной работе
• Изменяйте леверидж без включения SetLeverageStartup
• Редактируйте symbols.json вручную
• Включайте оба параметра повторно (вызывает перегрузку API)

Таблица быстрого参考

Поддержка

1. Проверьте логи бота на наличие ошибок
2. Убедитесь, что разрешения API биржи включают изменение левериджа
3. Убедитесь, что все символы существуют на бирже
4. Проверьте symbols.json на правильность левериджа
5. Ознакомьтесь с ограничениями левериджа, специфичными для биржи