📖 Обзор
Hyperliquid Whale Tracker — это продвинутая функция, которая отслеживает действия крупных кошельков ("китов") на бирже Hyperliquid и позволяет осуществлять автоматическую копировальную торговлю. Когда отслеживаемый кит открывает новую позицию, система может автоматически транслировать сигналы в Discord/Telegram и/или размещать зеркальные сделки на вашем счете.
🔍 Обнаружение в реальном времени
Отслеживает позиции китов каждые 5 минут и мгновенно обнаруживает новые позиции.
📢 Оповещения на нескольких платформах
Транслирует сигналы в Discord, Telegram и WhatsApp с богатым форматированием.
🤖 Автоматическая копировальная торговля
Автоматически зеркалирует позиции китов с вашими пользовательскими настройками и параметрами риска.
🎯 Умная система закрытия
Автоматически закрывает вашу позицию, когда кит закрывает свою.
⚙️ Настройка
Основные настройки
Находятся в вашем файле конфигурации под HyperLiquidWhaleTracker:
Настройка платформ обмена сообщениями
Настройки торговли
🔧 Как это работает
Процесс обнаружения
1Начальное сканирование
При первом запуске система регистрирует все существующие позиции китов без трансляции (предотвращает спам).
2Непрерывный мониторинг
Каждые 5 минут система:
- Получает текущие позиции каждого отслеживаемого кита
- Сравнивает с ранее увиденными позициями
- Обнаруживает НОВЫЕ позиции, которых раньше не было
3Идентификация позиции
Позиция считается НОВОЙ, если:
- Монета не была в портфеле кита во время последней проверки
- Система ранее не транслировала эту позицию
4Выполнение действий
Для каждой новой позиции:
- Транслирует сигнал на настроенные платформы (если включено)
- Размещает ордер копирования сделки (если включено)
- Добавляет позицию в мониторинг для автоматического отслеживания закрытия
Отслеживаемые данные позиций китов
| Данные | Описание |
|---|---|
| Монета | Торговая пара (например, BTC, ETH, SOL) |
| Сторона | Длинная или короткая позиция |
| Размер | Размер позиции в контрактах |
| Цена входа | Цена входа кита |
| Кредитное плечо | Кредитное плечо позиции |
| Нереализованная прибыль/убыток | Текущая прибыль/убыток |
| Цена ликвидации | Порог риска |
📢 Трансляция сигналов
Включение трансляции
Установите broadcast_signals: true в конфигурации, чтобы получать уведомления, когда киты открывают позиции.
Уведомления Discord
Формат богатого встраивания
- Цветовое кодирование (зеленый для LONG, красный для SHORT)
- Организованные поля со всеми деталями позиции
- Ссылка на портфель кита, доступная для клика
- Метка времени для отслеживания
Уведомления Telegram
Формат Markdown
- Чистый, читаемый текстовый формат
- Моноширинные блоки кода для данных
- Прямая ссылка для отслеживания
- Мобильный дружественный макет
Выбор платформы
Система транслирует на все настроенные платформы с действительными учетными данными. Платформы без учетных данных автоматически пропускаются:
- Discord: Требуется
discord_webhook_url - Telegram: Требуются оба
telegram_bot_tokenиtelegram_chat_id - WhatsApp: Требуются
whatsapp_tokenиwhatsapp_phone_id
🤖 Автоматическая копировальная торговля
Включение автоматической торговли
Установите place_order: true, чтобы автоматически зеркалировать позиции китов.
Как работает копировальная торговля
- Обнаружение позиции: Система обнаруживает новую позицию кита
- Сопоставление символов: Находит соответствующую торговую пару на вашей бирже
- Проверка ордера: Проверяет лимиты ордеров кита и доступность бота
- Размещение ордера: Размещает рыночный ордер с вашими настроенными параметрами
- Мониторинг: Добавляет позицию в систему мониторинга закрытия
⚠️ Важно: Ваши настройки, а не кита
Ваши копировальные сделки используют ВАШИ настройки, а не кита:
- Ваш размер позиции (не кита)
- Ваше кредитное плечо (не кита)
- Ваши проценты TP/SL
- Ваши правила управления рисками
Пример: Кит открывает 100 BTC LONG с кредитным плечом 20x → Ваша копировальная сделка: $100 BTC LONG с кредитным плечом 10x (ваши настройки)
Совместимость с биржами
Система автоматически адаптирует символы для вашей биржи:
| Биржа | Символ кита | Ваш символ |
|---|---|---|
| Binance | BTC | BTCUSDT |
| OKX | BTC | BTC-USDT-SWAP |
| Bybit | BTC | BTCUSDT |
| Bitget | BTC | BTCUSDT |
| HyperLiquid | BTC | BTC (без изменений) |
Логика размещения ордеров
👁️ Мониторинг позиций и автоматическое закрытие
Автоматическое отслеживание закрытия
Когда вы копируете сделку кита, система непрерывно отслеживает позицию кита. Если кит закрывает свою позицию, ваша копировальная сделка также автоматически закрывается.
Как это работает
- Регистрация позиции: После размещения копировальной сделки позиция добавляется в мониторинг
- Непрерывная проверка: Каждые 5 минут система проверяет текущие позиции кита
- Обнаружение закрытия: Определяет, когда размер позиции кита уменьшается или исчезает
- Выполнение автоматического закрытия: Немедленно закрывает вашу соответствующую позицию
Сценарии закрытия
Полное закрытие (100%)
Кит: Закрывает всю позицию
Ваша сделка: Автоматически закрывает 100% позиции
Результат: Сделка перемещается в завершенные, running_orders очищается
Частичное закрытие
Кит: Уменьшает размер позиции (например, закрытие 50%)
Ваша сделка: Закрывает соответствующий процент
Результат: Сделка обновляется с новыми объемами
Управление состоянием
🛡️ Функции безопасности
Лимиты ордеров
Лимит на одного кита (max_orders_per_whale)
- По умолчанию: 2 одновременных ордера на одного кита
- Настраиваемый: Установите любое число (рекомендуется 1-10)
- Цель: Предотвращает чрезмерную зависимость от одного кита
Пример: Кит #1 имеет 2 активные позиции → Обнаружена новая позиция → Система проверяет: достигнут лимит 2/2 → Ордер пропущен: "Достигнут лимит ордеров кита"
Демо-режим
Тестируйте систему без риска для реального капитала:
В демо-режиме:
- ✅ Обнаруживает позиции китов
- ✅ Транслирует сигналы
- ✅ Регистрирует детали ордеров
- ❌ Не размещает реальные ордера
- ❌ Не вызывает API биржи
Предотвращение конфликтов бота
Перед размещением копировальной сделки:
- Проверяет, есть ли у целевого бота активные ордера
- Пропускает ордер, если бот уже торгует
- Предотвращает одновременные позиции по одному и тому же символу
Проверка позиций
Каждый ордер проверяется на:
- Действительный символ: Должен существовать на вашей бирже
- Текущая цена: Должна быть доступна (> 0)
- Расчет объема: Должен соответствовать минимальным требованиям биржи
- Лимиты кредитного плеча: В пределах допустимого диапазона биржи
🔧 Устранение неполадок
Общие проблемы
❌ "Адреса китов не настроены"
Проблема: Список tracking_addresses пуст
Решение: