Hyperliquid Whale Copy Trading — Reproduce las operaciones de los profesionales al instante

Descripción general

El Seguidor de Ballenas de Hyperliquid monitorea direcciones de billeteras (ballenas) y reacciona cuando estas billeteras abren o cierran posiciones. Soporta dos modos principales:

Modo solo de señales — transmite eventos de ballenas a tus canales de notificación (Telegram, Discord, WhatsApp, etc.).
Modo de réplica — coloca automáticamente órdenes replicadas y las cierra cuando la ballena cierra su posición.

Esta función es completamente configurable desde tradesettings.yaml y puede habilitarse por instancia de bot. Por defecto, está desactivada.

Configuración

Agrega o actualiza la sección HyperLiquidWhaleTracker dentro de tu tradesettings.yaml (o la variante appsettings.yaml si centralizas las configuraciones). Ejemplo:

HyperLiquidWhaleTracker:
  is_enabled: false
  tracking_addresses:
    - "0x2aB3...Ff12"            # Agrega una o más direcciones de billeteras de ballenas
    - "0x1cD4...Aa77"
  place_order: false             # true = coloca órdenes replicadas automáticamente, false = solo señales
  order_amount: 100.0            # Cantidad en moneda base por operación replicada
  leverage: 3                    # Apalancamiento a usar para operaciones replicadas (si aplica)
  broadcast_signals: true        # true = envía notificaciones cuando la ballena abre/cierra operaciones
  max_open_per_whale: 2          # Máximo de operaciones replicadas abiertas por ballena rastreada (seguridad)
  slippage_tolerance_percent: 0.5 # Máximo deslizamiento aceptable al colocar órdenes replicadas
  follow_partial_fills: true     # Si es true, el bot replica los llenados parciales proporcionalmente
  close_on_whale_close: true     # Cierra la orden replicada cuando la ballena cierra su posición
  include_liquidations: false    # Si es true, replicará liquidaciones (no recomendado)
  only_follow_buy: false         # Si es true, sigue solo compras
  only_follow_sell: false        # Si es true, sigue solo ventas
  min_whale_order_value: 50.0    # Valor mínimo de la orden (moneda base) para rastreo/réplica
  cooldown_seconds: 30           # Segundos de espera entre el procesamiento de eventos para la misma ballena

Descripción de los campos

is_enabled — Habilita/deshabilita el seguidor de ballenas (predeterminado: false).
tracking_addresses — Lista de direcciones de billeteras a seguir. Sin límite fijo; agrega tantas como desees, pero ten en cuenta el uso de recursos.
place_order — Cuando es true, el bot intentará colocar órdenes replicadas automáticamente. Cuando es false, solo transmite señales.
order_amount — Tamaño de la orden replicada en tu moneda base (por ejemplo, USDT) por operación. Considera usar un dimensionamiento basado en la gestión de fondos para producción.
leverage — Apalancamiento para abrir posiciones de futuros replicadas (solo si el intercambio soporta apalancamiento).
broadcast_signals — Envía mensajes formateados a los canales de difusión configurados.
max_open_per_whale — Límite de seguridad para evitar una exposición excesiva a una sola ballena.
slippage_tolerance_percent — Máximo deslizamiento aceptable al colocar órdenes.
follow_partial_fills — Si una orden de una ballena se llena parcialmente, el bot replica la misma proporción llenada.
close_on_whale_close — Cierra las órdenes replicadas cuando la ballena cierra su posición.
include_liquidations — Replica liquidaciones solo si comprendes los riesgos extremos.
only_follow_buy / only_follow_sell — Filtros para seguir solo compras o solo ventas.
min_whale_order_value — Ignora órdenes pequeñas de ballenas por debajo de este umbral.
cooldown_seconds — Evita el spam de eventos al espaciar el procesamiento por ballena.

Cómo funciona (flujo técnico)

Fuente de eventos: El bot se suscribe a eventos de billeteras de Hyperliquid (o sondea la blockchain/API) para las direcciones configuradas.
Detección de eventos: Al detectar un nuevo evento de apertura/cierre de orden, el bot lo valida contra filtros (valor mínimo, tipo de acción, enfriamiento).
Decisión: Si place_order = true, el bot crea una solicitud de orden replicada usando tus credenciales de intercambio configuradas, incluyendo reglas de apalancamiento y tamaño. Si es false, solo construye un mensaje de difusión.
Ejecución: Intenta colocar la orden, teniendo en cuenta la tolerancia al deslizamiento y el saldo disponible. Si follow_partial_fills = true, el bot ajusta las cantidades de la orden replicada en consecuencia.
Ciclo de vida: El bot monitorea el estado de la orden replicada y, si close_on_whale_close = true, cerrará la orden replicada cuando la ballena cierre la suya.
Registro y alertas: Todos los eventos y acciones se registran (ver Registro y Monitoreo). Las notificaciones se difunden si están configuradas.

Requisitos previos y permisos

Instancia funcional de MagicTradeBot con una licencia válida y tradesettings.yaml configurado.
Claves API de intercambio con permisos de trading (si place_order está habilitado). Para acciones basadas en billeteras de Hyperliquid, también podrías necesitar una clave privada — nunca almacenes claves privadas en texto plano (usa variables de entorno).
Conexión a internet estable y configuraciones adecuadas de límites de tasa en appsettings.yaml para evitar bloqueos de API.

Consideraciones de seguridad

Nunca codifiques claves privadas o secretos de API en archivos de repositorio. Usa variables de entorno o gestión de secretos a nivel de sistema operativo.
Limita los permisos de la clave API a lo estrictamente necesario (idealmente solo trading, sin retiros).
Prueba exhaustivamente en DemoMode antes de habilitar órdenes replicadas en vivo.
Establece valores predeterminados conservadores: max_open_per_whale, slippage_tolerance_percent y min_whale_order_value.
Habilita el registro y las alertas de incidentes (Sentry, PagerDuty) para recibir notificaciones sobre errores de ejecución o comportamientos inesperados.

Ejemplos de notificaciones y difusión

Cuando broadcast_signals es true, el bot envía un mensaje formateado. Ejemplos de plantillas a continuación:

Telegram / Discord (texto)


[Ballena de Hyperliquid] NUEVA ORDEN
Ballena: 0x2aB3...Ff12
Acción: COMPRA (Largo)
Símbolo: BTCUSDT
Tamaño: 0.5 BTC (~25000 USDT)
Apalancamiento: 3x
Hora: 2025-10-16T12:34:56Z
Replicado: sí (ID de orden: M-123456)   # o "Replicado: no" si place_order=false

WhatsApp / Webhook (carga JSON)

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

Pruebas y modo de demostración

Siempre prueba con DemoMode: true o usando testnets de intercambio primero.
Configura place_order: false para verificar la detección de eventos y el formato de difusión sin ejecutar operaciones.
Usa un order_amount pequeño durante las pruebas en vivo y monitorea los registros en completedorders.yaml y la salida del terminal.

Mejores prácticas operativas

Usa max_open_per_whale para evitar una exposición excesiva a la secuencia de operaciones de una sola ballena.
Habilita cooldown_seconds para reducir el procesamiento duplicado si las ballenas dividen las órdenes en muchas microórdenes.
Prefiere el modo solo señales durante condiciones de mercado volátiles o cuando no puedas garantizar una ejecución rápida/control de deslizamiento.
Si replicas con apalancamiento, asegúrate de tener margen y medidas de seguridad (umbrales de cierre forzado global).
Registra cada evento entrante y acción replicada para auditoría y pruebas retrospectivas.

Registro y monitoreo

Registro/monitoreo recomendado para habilitar en appsettings.yaml o en la configuración de tu bot:

Registros de terminal para resolución de problemas en tiempo real.
completedorders.yaml — operaciones replicadas completadas persistidas para pruebas retrospectivas y ganancias/pérdidas.
Registro remoto opcional: Sentry, Loki, LogDNA, DataDog para alertas y registros de auditoría históricos.
Métricas de Prometheus para el conteo de posiciones abiertas, conteo de órdenes replicadas y tasas de error.

Manejo de errores y reintentos

En caso de fallo en la colocación de órdenes, el bot reintenta hasta 3 veces con retroceso exponencial (configurable).
Si el deslizamiento excede slippage_tolerance_percent, la orden se cancela y se emite una advertencia.
Si no se puede colocar una orden replicada debido a un saldo insuficiente, el bot difunde una advertencia y omite la réplica.

Limitaciones y riesgos

Seguir billeteras no garantiza ganancias — las ballenas pueden ser creadores de mercado, insiders o realizar manipulaciones a corto plazo.
Replicar liquidaciones o movimientos de ballenas con alto apalancamiento puede amplificar las pérdidas.
La latencia de ejecución y el deslizamiento pueden causar resultados de trading diferentes a los de la ballena.
Respeta los límites de tasa de la API del intercambio — rastrear muchas ballenas aumenta las llamadas a la API y el uso de recursos.

Preguntas frecuentes

P: ¿Puedo rastrear cualquier dirección de billetera?

R: Sí — agrega cualquier dirección de billetera pública a tracking_addresses. El bot intentará detectar eventos de apertura/cierre asociados con esa dirección.

P: ¿El bot replicará los tamaños de posición exactamente?

R: No necesariamente. El bot usa order_amount como el tamaño de la operación replicada (o replica proporcionalmente los llenados parciales si está habilitado). Puedes implementar un dimensionamiento basado en porcentajes en la configuración avanzada de gestión de fondos.

P: ¿Qué pasa si una ballena divide una orden en muchas microórdenes?

R: Usa cooldown_seconds y follow_partial_fills para controlar cómo se replican las órdenes divididas y evitar una exposición excesiva.

Lista de verificación para comenzar

Habilita el seguidor: configura is_enabled: true en tradesettings.yaml.
Agrega direcciones de ballenas a tracking_addresses.
Configura place_order: false inicialmente para verificar eventos y notificaciones.
Verifica que las difusiones se entreguen a Telegram/Discord/WhatsApp.
Cambia a place_order: true una vez que estés cómodo, mantén DemoMode: true hasta que se complete la verificación en vivo.
Monitorea los registros y configura alertas para errores de colocación, deslizamiento y eventos de saldo insuficiente.

Ejemplo completo de fragmento (copia en `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

Aviso legal y ético

Rastrear y replicar la actividad de billeteras públicas es técnicamente factible, pero debes asegurarte de cumplir con las leyes locales, los términos del intercambio y las prácticas comerciales éticas. MagicTradeBot proporciona las herramientas — es tu responsabilidad usarlas de manera legal y responsable.

Soporte y resolución de problemas

Si encuentras problemas:

Revisa los registros del terminal y completedorders.yaml para detectar errores.
Verifica las claves API y los permisos (trading permitido, retiros desactivados).
Confirma que las variables de entorno sobrescriben las configuraciones de archivo si se usan para secretos.
Contacta al soporte a través de tu panel de MagicTradeBot o consulta la documentación completa de configuración.