MagicTradeBot v3.1 — Представляем функцию копирования сделок китов на Hyperliquid

Опубликовано: 17 октября, 2025

Новый модуль Hyperliquid Whale Tracker в MagicTradeBot позволяет отслеживать торговую активность на уровне кошельков на Hyperliquid и других децентрализованных биржах, основанных на кошельках. Теперь вы можете отслеживать любой адрес кошелька, получать уведомления в реальном времени и даже автоматически копировать сделки китов с полным контролем, фильтрацией и безопасностью.

🚀 Обзор

Hyperliquid Whale Tracker — это новый модуль в MagicTradeBot v3.1, созданный для трейдеров, желающих использовать прозрачность блокчейна. Он постоянно отслеживает выбранные кошельки китов и реагирует, когда они открывают или закрывают позиции. Вы можете использовать его в двух основных режимах:

  • Режим только сигналов — получайте уведомления о сделках китов в реальном времени через Telegram, Discord, WhatsApp или Webhooks.
  • Режим зеркалирования — автоматически выполняйте зеркальные сделки на подключённой бирже с интеллектуальными мерами безопасности.

Конфигурация полностью управляется через файл tradesettings.yaml и может быть включена для каждой копии бота. По умолчанию функция выключена для безопасности.

⚙️ Пример конфигурации

Чтобы активировать трекер, добавьте следующий раздел в файл tradesettings.yaml:

HyperLiquidWhaleTracker:
  is_enabled: true
  tracking_addresses:
    - "0x2aB3...Ff12"
    - "0x1cD4...Aa77"
  place_order: true
  order_amount: 150.0
  leverage: 3
  broadcast_signals: true
  max_open_per_whale: 2
  slippage_tolerance_percent: 0.5
  follow_partial_fills: true
  close_on_whale_close: true
  include_liquidations: false
  only_follow_buy: false
  only_follow_sell: false
  min_whale_order_value: 100.0
  cooldown_seconds: 60

Эта конфигурация отслеживает два кошелька китов, копирует их сделки с плечом 3x и объёмом $150 за сделку, а также автоматически закрывает зеркальные позиции, когда киты закрывают свои.

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

  1. Источник событий — бот подписывается на события блокчейна Hyperliquid для указанных адресов.
  2. Обнаружение событий — когда кит открывает или закрывает позицию, бот проверяет сделку по фильтрам (размер, пауза, направление).
  3. Решение — если place_order = true, создаётся зеркальная сделка через подключённый API биржи; в противном случае отправляется сигнал.
  4. Исполнение — ордера выставляются с учётом ограничений по проскальзыванию, плечу и доступной марже. Частичные исполнения могут быть зеркально повторены пропорционально.
  5. Жизненный цикл — бот отслеживает зеркальные позиции и автоматически закрывает их, если включён параметр close_on_whale_close.
  6. Логирование и уведомления — все события записываются и при необходимости отправляются в ваши каналы уведомлений или мониторинга.

🔒 Безопасность и контроль рисков

  • Никогда не прописывайте API-ключи или приватные ключи в коде — используйте переменные окружения или зашифрованные секреты.
  • Ограничьте разрешения только для торговли; не включайте вывод средств.
  • Используйте DemoMode для тестирования перед запуском в реальной торговле.
  • Настраивайте max_open_per_whale и slippage_tolerance_percent консервативно.
  • Включите мониторинг ошибок (например, Sentry, PagerDuty) для продакшен-развёртываний.

📣 Уведомления и оповещения

Когда broadcast_signals: true, MagicTradeBot отправляет форматированные уведомления для каждого события сделки кита.

Пример (Telegram / Discord):

[Hyperliquid Whale] НОВЫЙ ОРДЕР
Кит: 0x2aB3...Ff12
Действие: ПОКУПКА (Лонг)
Символ: BTCUSDT
Объём: 0.5 BTC (~25,000 USDT)
Плечо: 3x
Зеркалировано: да (ID ордера: M-123456)

Пример (Webhook JSON):

{
  "type": "hyperliquid.whale.event",
  "whale_address": "0x2aB3...Ff12",
  "action": "open",
  "side": "buy",
  "symbol": "BTCUSDT",
  "size": 0.5,
  "notional": 25000,
  "leverage": 3,
  "mirrored": true,
  "timestamp": "2025-10-16T12:34:56Z"
}

🧩 Тестирование и демо-режим

  • Установите place_order: false и DemoMode: true для безопасного тестирования.
  • Проверьте сигналы перед включением зеркальной торговли.
  • Начните с небольшого order_amount и убедитесь в корректности обнаружения событий.
  • Следите за completedorders.yaml для проверки логов зеркальных сделок.

⚡ Лучшие практики эксплуатации

  • Используйте cooldown_seconds, чтобы избежать избыточной торговли при разделении ордеров китами.
  • Оставляйте режим только сигналов во время высокой волатильности.
  • Комбинируйте с модулями управления капиталом для динамического размера позиций и снижения рисков.
  • Используйте Prometheus и Loki для метрик наблюдения и аудита событий.

⚠️ Ограничения и риски

  • Отслеживание китов ≠ гарантированная прибыль — киты тоже могут ошибаться или манипулировать рынком.
  • Задержки исполнения и проскальзывание могут привести к отличиям в результатах зеркальных сделок.
  • Отслеживание большого количества кошельков увеличивает нагрузку на API — настройте лимиты запросов.

💬 Часто задаваемые вопросы

В: Могу ли я отслеживать любой кошелёк?

Да. Добавьте любой публичный адрес в tracking_addresses — бот автоматически определит связанную торговую активность.

В: Соответствует ли размер позиции размеру кита?

Нет. Используется ваш настроенный order_amount или пропорциональный размер, если включён follow_partial_fills.

В: Что, если кит отправляет множество мелких ордеров?

Используйте cooldown_seconds и follow_partial_fills, чтобы избежать дублирования сделок и переэкспозиции.

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

🛠️ Поддержка и устранение неполадок

  • Проверьте completedorders.yaml и логи на наличие ошибок.
  • Проверьте разрешения API и настройки переменных окружения.
  • Свяжитесь с официальной поддержкой MagicTradeBot через панель управления для технической помощи.

Теги

Категории