Руководство по установке

Предварительные требования

• Docker Desktop (требуется только при использовании Redis)
• Поддерживаемый аккаунт биржи с API-ключами
• Публичный IP-адрес вашего сервера (для белого списка API)

Содержание

1. Конфигурация бота
2. Настройка API-ключей
3. Настройка Redis
4. RedisMarketBridge
5. Запуск бота
6. Устранение неполадок
7. Интеграция TradingView

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

Вся конфигурация выполняется через онлайн-конфигуратор.

1. Открыть: Конфигуратор
2. Выбрать MagicTradeBot
3. Настроить:

Экспорт настроек:

1. Нажать Export All YAML
2. Распаковать архив
3. Заменить папку /settings в проекте

magictradebot/
├── settings/  ← заменить
├── MagicTradeBot
├── MagicTradeBot.exe
└── .env

2. Настройка API-ключей

🔐 Безопасность: всегда используйте переменные окружения. Никогда не храните API-ключи в конфигурационных файлах.

Whitelist IP

curl ifconfig.me

Добавьте этот IP в белый список API вашей биржи.

Использование .env

BINANCE_API_KEY=ваш_ключ
BINANCE_API_SECRET=ваш_секрет

⚠️ Добавьте .env в .gitignore

3. Настройка Redis (опционально)

Требуется только если включён Redis.

Запуск Redis через Docker

docker run -d \
--name magictradebot-redis \
-p 6379:6379 \
--restart unless-stopped \
redis:latest

Проверка

docker exec -it magictradebot-redis redis-cli ping

Ожидаемый результат: PONG

4. RedisMarketBridge

Этот компонент передаёт рыночные данные в Redis.

⚠️ Биржа + пары + таймфреймы ДОЛЖНЫ полностью совпадать с конфигурацией бота

Шаги:

1. Настроить через конфигуратор
2. Экспортировать YAML
3. Заменить adapters/redismarketbridge/settings

5. Запуск бота

Порядок запуска

1. Запустить Redis
2. Запустить RedisMarketBridge
3. Подождать 2 минуты
4. Запустить MagicTradeBot

Linux / macOS

chmod +x MagicTradeBot
./MagicTradeBot

Windows

MagicTradeBot.exe

💡 Запускайте из терминала для просмотра логов

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

Ошибки API

• Проверьте IP whitelist
• Проверьте права доступа
• Проверьте переменные окружения

Нет рыночных данных

• Подождите 2 минуты после запуска RedisMarketBridge
• Проверьте соответствие конфигурации

Проблемы Redis

• Проверьте, что Docker запущен
• Открыт порт 6379

7. Интеграция сигналов TradingView

MagicTradeBot поддерживает внешние сигналы из TradingView через webhooks.

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

• TradingView отправляет алерты → webhook
• MagicTradeBot получает сигналы
• Бот автоматически выполняет сделки

Шаг 1 — включить Webhook в боте

В конфигурации бота:

• Включить Signals → Webhook
• Скопировать URL webhook

Пример:

http://your-server:port/webhook

Шаг 2 — создать алерт в TradingView

1. Открыть график TradingView
2. Добавить индикатор или стратегию
3. Нажать Alert
4. Включить Webhook URL
5. Вставить URL бота

Шаг 3 — задать сообщение алерта

Пример JSON payload:

{
  "symbol": "BTCUSDT",
  "action": "buy",
  "price": "{{close}}",
  "time": "{{time}}"
}

Поддерживаемые действия

• buy
• sell
• close

Важные примечания

• Убедитесь, что символ совпадает с конфигурацией бота
• Используйте корректный таймфрейм
• Сначала тестируйте с малыми суммами

⚠️ Неверный формат payload = сигналы игнорируются

Тестирование

Вы можете симулировать webhook:

curl -X POST http://your-server/webhook \
-H "Content-Type: application/json" \
-d '{"symbol":"BTCUSDT","action":"buy"}'

✅ Если всё настроено правильно, бот выполнит сделку

💡 Полную информацию смотрите в официальной документации TradingView.