MagicTradeBot v3.1 — Presentación de la función de Copy Trading de ballenas Hyperliquid

Publicado: 17 octubre, 2025

El nuevo Hyperliquid Whale Tracker de MagicTradeBot te permite seguir la actividad de trading a nivel de billetera en Hyperliquid y en otros exchanges descentralizados basados en billetera. Ahora puedes rastrear cualquier dirección de billetera, recibir notificaciones en tiempo real e incluso replicar automáticamente (copiar) las operaciones de las ballenas con opciones completas de seguridad, filtrado y control.

🚀 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

  1. Fuente de eventos — El bot se suscribe a los eventos on-chain de Hyperliquid para las direcciones especificadas.
  2. 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).
  3. 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.
  4. Ejecución — Las órdenes se colocan respetando los límites de deslizamiento, el apalancamiento y el margen disponible. Las ejecuciones parciales pueden reflejarse proporcionalmente.
  5. Ciclo de vida — El bot supervisa las posiciones reflejadas y las cierra automáticamente si close_on_whale_close está habilitado.
  6. 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 DemoMode para 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: false y DemoMode: true para pruebas seguras.
  • Verifica los mensajes de señal antes de habilitar el trading reflejado.
  • Comienza con un order_amount pequeño y confirma la detección precisa de eventos.
  • Supervisa completedorders.yaml para 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.

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.yaml y 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.