🚀 Descripción general
El Hyperliquid Whale Tracker es un nuevo módulo en MagicTradeBot v3.1 diseñado para traders que desean aprovechar la transparencia on-chain. Supervisa continuamente las billeteras de ballenas seleccionadas y reacciona cuando estas abren o cierran posiciones. Puedes usarlo en dos modos principales:
- Modo solo señal — recibe alertas en tiempo real de las operaciones de ballenas a través de Telegram, Discord, WhatsApp o Webhooks.
- Modo espejo — ejecuta automáticamente operaciones reflejadas en tu cuenta de exchange conectada, con protecciones inteligentes.
La configuración se gestiona completamente a través de tu archivo tradesettings.yaml y puede habilitarse por instancia del bot. De forma predeterminada, está desactivado por motivos de seguridad.
⚙️ Ejemplo de configuración
Para activar el rastreador, añade la siguiente sección en tu archivo 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
Esta configuración rastrea dos billeteras de ballenas, replica sus operaciones con un apalancamiento de 3x y $150 por operación, y cierra automáticamente las posiciones reflejadas cuando las ballenas cierran las suyas.
🧠 Cómo funciona
- Fuente de eventos — El bot se suscribe a los eventos on-chain de Hyperliquid para las direcciones especificadas.
- Detección de eventos — Cuando una ballena abre o cierra una posición, el bot valida la operación según filtros (tamaño, enfriamiento, dirección).
- Decisión — Si
place_order = true, se crea una operación reflejada usando tu API de exchange conectada; de lo contrario, se transmite una señal. - Ejecución — Las órdenes se colocan respetando los límites de deslizamiento, el apalancamiento y el margen disponible. Las ejecuciones parciales pueden reflejarse proporcionalmente.
- Ciclo de vida — El bot supervisa las posiciones reflejadas y las cierra automáticamente si
close_on_whale_closeestá habilitado. - Registros y alertas — Todos los eventos se registran y pueden enviarse opcionalmente a tus canales de notificación o monitoreo.
🔒 Seguridad y control de riesgos
- Nunca codifiques directamente claves API o privadas — usa variables de entorno o secretos cifrados.
- Limita los permisos solo a operaciones de trading; nunca habilites retiros.
- Usa
DemoModepara pruebas iniciales antes de operar en vivo. - Configura max_open_per_whale y slippage_tolerance_percent de manera conservadora.
- Habilita la monitorización de errores (por ejemplo, Sentry, PagerDuty) para implementaciones en producción.
📣 Notificaciones y alertas
Cuando broadcast_signals: true, MagicTradeBot envía alertas formateadas por cada evento de operación de ballenas.
Ejemplo (Telegram / Discord):
[Hyperliquid Whale] NUEVA ORDEN
Ballena: 0x2aB3...Ff12
Acción: COMPRA (Largo)
Símbolo: BTCUSDT
Tamaño: 0.5 BTC (~25,000 USDT)
Apalancamiento: 3x
Reflejado: sí (ID de orden: M-123456)
Ejemplo (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"
}
🧩 Pruebas y modo demo
- Configura
place_order: falseyDemoMode: truepara pruebas seguras. - Verifica los mensajes de señal antes de habilitar el trading reflejado.
- Comienza con un
order_amountpequeño y confirma la detección precisa de eventos. - Supervisa
completedorders.yamlpara ver los registros de operaciones reflejadas.
⚡ Mejores prácticas operativas
- Usa cooldown_seconds para evitar sobreoperar cuando las ballenas dividen sus órdenes.
- Mantén el modo solo señal durante mercados volátiles.
- Combínalo con los módulos de gestión de capital para ajustar tamaños dinámicos y mitigar riesgos.
- Usa Prometheus y Loki para métricas de observabilidad y auditoría de eventos.
⚠️ Limitaciones y riesgos
- Seguir ballenas ≠ ganancia garantizada — las ballenas también pueden perder o manipular.
- La latencia y el deslizamiento en la ejecución pueden causar desviaciones en los resultados reflejados.
- Rastrear muchas billeteras aumenta la carga de la API — ajusta los límites de tasa en consecuencia.
💬 Preguntas frecuentes
P: ¿Puedo rastrear cualquier billetera?
Sí. Añade cualquier dirección pública de billetera en tracking_addresses — el bot detectará automáticamente la actividad comercial relacionada.
P: ¿Coincide con el tamaño exacto de la posición de la ballena?
No. Utiliza tu order_amount configurado o un tamaño proporcional si follow_partial_fills está habilitado.
P: ¿Qué pasa si una ballena envía múltiples microórdenes?
Usa cooldown_seconds y follow_partial_fills para evitar operaciones duplicadas y controlar la sobreexposición.
⚖️ Aviso legal y ético
Aunque seguir la actividad pública de las billeteras es transparente en la cadena, asegúrate de cumplir con los términos del exchange y las regulaciones locales. MagicTradeBot proporciona las herramientas — tú eres responsable del uso legal y ético.
🛠️ Soporte y resolución de problemas
- Revisa
completedorders.yamly los registros para detectar errores. - Verifica los permisos de la API y las configuraciones de las variables de entorno.
- Contacta con el soporte oficial de MagicTradeBot a través de tu panel de control para obtener asistencia técnica.