Guía del usuario de Hyperliquid Whale Tracker

📑 Tabla de Contenidos

📖 Resumen

El Hyperliquid Whale Tracker es una función avanzada que monitorea las actividades de las billeteras de grandes inversores ("ballenas") en el intercambio Hyperliquid y permite el trading de copia automático. Cuando una ballena rastreada abre una nueva posición, el sistema puede transmitir automáticamente señales a Discord/Telegram y/o realizar operaciones espejo en su cuenta.

🔍 Detección en Tiempo Real

Monitorea las posiciones de las ballenas cada 5 minutos y detecta nuevas posiciones al instante.

📢 Alertas Multiplataforma

Transmite señales a Discord, Telegram y WhatsApp con un formato enriquecido.

🤖 Trading de Copia Automático

Refleja automáticamente las posiciones de las ballenas con sus configuraciones personalizadas y parámetros de riesgo.

🎯 Seguimiento Inteligente de Cierre

Cierra automáticamente su posición cuando la ballena cierra la suya.

⚙️ Configuración

Configuraciones Básicas

Ubicadas en su archivo de configuración bajo HyperLiquidWhaleTracker:

HyperLiquidWhaleTracker: is_enabled: true # Habilitar/deshabilitar el seguimiento de ballenas tracking_addresses: # Lista de direcciones de billeteras de ballenas - "0x2ea18c23f72a4b6172c55b411823cdc5335923f4" - "0xb317d2bc2d3d2df5fa441b5bae0ab9d8b07283ae" - "0x9458f423df6569f053358ee9906613cd69c1ec04" # Agregar más direcciones... place_order: false # Colocar órdenes espejo automáticamente broadcast_signals: true # Transmitir a plataformas de mensajería max_orders_per_whale: 2 # Máximo de órdenes concurrentes por ballena

Configuración de Plataformas de Mensajería

broadcast: # Discord discord_webhook_url: "https://discord.com/api/webhooks/YOUR_WEBHOOK" # Telegram telegram_bot_token: "YOUR_BOT_TOKEN" telegram_chat_id: "YOUR_CHAT_ID" # WhatsApp (opcional) whatsapp_token: "YOUR_TOKEN" whatsapp_phone_id: "YOUR_PHONE_ID"

Configuraciones de Trading

general: initial_trade_amount: 100 # Monto en USD por operación leverage: 10 # Multiplicador de apalancamiento demo_mode: false # Probar sin operaciones reales sltp_settings: take_profit_percent: 5.0 # Porcentaje de toma de ganancias stop_loss_percent: 2.0 # Porcentaje de stop loss

🔧 Cómo Funciona

Proceso de Detección

1Escaneo Inicial

En la primera ejecución, el sistema registra todas las posiciones existentes de las ballenas sin transmitir (evita spam).

2Monitoreo Continuo

Cada 5 minutos, el sistema:

  • Obtiene las posiciones actuales de cada ballena rastreada
  • Compara con las posiciones vistas anteriormente
  • Detecta NUEVAS posiciones que no estaban antes

3Identificación de Posiciones

Una posición se considera NUEVA cuando:

  • La moneda no estaba en el portafolio de la ballena en la última verificación
  • El sistema no ha transmitido esta posición antes

4Ejecución de Acciones

Para cada nueva posición:

  • Transmite la señal a las plataformas configuradas (si está habilitado)
  • Coloca una orden de trading de copia (si está habilitado)
  • Agrega la posición al monitoreo para seguimiento de cierre automático

Datos de Posiciones de Ballenas Rastreados

Punto de Datos Descripción
Moneda Par de trading (por ejemplo, BTC, ETH, SOL)
Lado Posición larga o corta
Tamaño Tamaño de la posición en contratos
Precio de Entrada Precio de entrada de la ballena
Apalancamiento Apalancamiento de la posición
Ganancia/Pérdida No Realizada Ganancia/pérdida actual
Precio de Liquidación Umbral de riesgo

📢 Transmisión de Señales

Habilitar Transmisiones

Configure broadcast_signals: true en su configuración para recibir notificaciones cuando las ballenas abran posiciones.

Notificaciones de Discord

Formato de Incrustación Enriquecida

  • Codificado por colores (Verde para LARGO, Rojo para CORTO)
  • Campos organizados con todos los detalles de la posición
  • Enlace clicable al portafolio de la ballena
  • Marca de tiempo para seguimiento
🐋 Alerta de Ballena: Ballena #1 Ballena #1 abrió una posición LARGA en BTC 📊 Detalles de la Posición Moneda: BTC Lado: LARGO 📈 Tamaño: 50.5 Apalancamiento: 20x 💰 Información de Precio Precio de Entrada: $65,432.10 Ganancia/Pérdida No Realizada: $-125.50 ⏰ Tiempo Posición Abierta: 2025-01-15 14:30:00 UTC Detectada: 14:35:00

Notificaciones de Telegram

Formato Markdown

  • Formato de texto limpio y legible
  • Bloques de código monoespaciados para datos
  • Enlace directo de seguimiento
  • Diseño amigable para móviles
🐋 *ALERTA DE BALLENA* 🟢 *Ballena #1* abrió una posición *LARGA* *Detalles de la Posición:* Moneda : BTC Lado : LARGO Tamaño : 50.5 Precio de Entrada : $65,432.10 Apalancamiento : 20x Ganancia/Pérdida No Realizada : $-125.50 Liquidación : $60,123.45 text*Tiempo:* Abierta : 2025-01-15 14:30:00 UTC Detectada : 2025-01-15 14:35:00 text🔗 [Seguir en CoinGlass] _Ballena: 0x2ea18c23..._

Selección de Plataforma

El sistema transmite a todas las plataformas configuradas con credenciales válidas. Las plataformas sin credenciales se omiten automáticamente:

  • Discord: Requiere discord_webhook_url
  • Telegram: Requiere ambos telegram_bot_token y telegram_chat_id
  • WhatsApp: Requiere whatsapp_token y whatsapp_phone_id

🤖 Trading de Copia Automático

Habilitar Trading Automático

Configure place_order: true para reflejar automáticamente las posiciones de las ballenas.

Cómo Funciona el Trading de Copia

  1. Detección de Posición: El sistema detecta una nueva posición de ballena
  2. Coincidencia de Símbolos: Encuentra el par de trading correspondiente en su intercambio
  3. Validación de Órdenes: Verifica los límites de órdenes de la ballena y la disponibilidad del bot
  4. Colocación de Órdenes: Coloca una orden de mercado con sus configuraciones establecidas
  5. Monitoreo: Agrega la posición al sistema de monitoreo de cierre

⚠️ Importante: Sus Configuraciones, No las de la Ballena

Sus operaciones de copia usan SUS configuraciones, no las de la ballena:

  • Su tamaño de posición (no el de la ballena)
  • Su apalancamiento (no el de la ballena)
  • Sus porcentajes de TP/SL
  • Sus reglas de gestión de riesgos

Ejemplo: La ballena abre 100 BTC LARGO con apalancamiento de 20x → Su operación de copia: $100 BTC LARGO con apalancamiento de 10x (sus configuraciones)

Compatibilidad con Intercambios

El sistema adapta automáticamente los símbolos para su intercambio:

Intercambio Símbolo de la Ballena Su Símbolo
Binance BTC BTCUSDT
OKX BTC BTC-USDT-SWAP
Bybit BTC BTCUSDT
Bitget BTC BTCUSDT
HyperLiquid BTC BTC (sin cambios)

Lógica de Colocación de Órdenes

SI se detecta una nueva posición de ballena: → Verificar si broadcast_signals está habilitado → Enviar notificaciones → Verificar si place_order está habilitado: → Comprobar que no se haya excedido el límite de órdenes de la ballena → Encontrar el par de trading activo correspondiente → Verificar que el bot no tenga órdenes en ejecución (evitar conflictos) → Calcular el tamaño de la orden según SUS configuraciones → Colocar una orden de mercado con SU TP/SL → Guardar en opentrades.yaml → Agregar al monitoreo para cierre automático

👁️ Monitoreo de Posiciones y Cierre Automático

Seguimiento de Cierre Automático

Cuando copia una operación de una ballena, el sistema monitorea continuamente la posición de la ballena. Si la ballena cierra su posición, su operación de copia también se cierra automáticamente.

Cómo Funciona

  1. Registro de Posición: Después de colocar una operación de copia, la posición se agrega al monitoreo
  2. Verificación Continua: Cada 5 minutos, el sistema verifica las posiciones actuales de la ballena
  3. Detección de Cierre: Identifica cuando el tamaño de la posición de la ballena disminuye o desaparece
  4. Ejecución de Cierre Automático: Cierra inmediatamente su posición correspondiente

Escenarios de Cierre

Cierre Completo (100%)

Ballena: Cierra toda la posición

Su Operación: Cierra automáticamente el 100% de la posición

Resultado: La operación se mueve a completada, running_orders se limpia

Cierre Parcial

Ballena: Reduce el tamaño de la posición (por ejemplo, cierre del 50%)

Su Operación: Cierra el porcentaje correspondiente

Resultado: La operación se actualiza con nuevas cantidades

Gestión de Estado

# Antes del Cierre running_orders: - order_id: "12345" symbol: "BTCUSDT" status: "Active" whale_address: "0x2ea..." # Después del Cierre running_orders: null # Limpiado, listo para la próxima operación completed_trades: - order_id: "12345" status: "Closed" realized_pnl: 45.30 close_reason: "Ballena #1 cerró la posición en BTC"

🛡️ Funciones de Seguridad

Límites de Órdenes

Límite por Ballena (max_orders_per_whale)

  • Predeterminado: 2 órdenes concurrentes por ballena
  • Configurable: Establezca cualquier número (se recomienda 1-10)
  • Propósito: Evita la sobreexposición a una sola ballena

Ejemplo: Ballena #1 tiene 2 posiciones activas → Se detecta una nueva posición → El sistema verifica: límite de 2/2 alcanzado → Orden omitida: "Límite de órdenes de ballena alcanzado"

Modo Demo

Pruebe el sistema sin arriesgar capital real:

general: demo_mode: true # Simula órdenes sin ejecución

En Modo Demo:

  • ✅ Detecta posiciones de ballenas
  • ✅ Transmite señales
  • ✅ Registra detalles de órdenes
  • ❌ No coloca órdenes reales
  • ❌ No realiza llamadas a la API del intercambio

Prevención de Conflictos de Bots

Antes de colocar una operación de copia:

  • Verifica si el bot objetivo tiene órdenes en ejecución
  • Omite la orden si el bot ya está operando
  • Evita múltiples posiciones simultáneas en el mismo símbolo

Validación de Posiciones

Cada orden se valida para:

  • Símbolo Válido: Debe existir en su intercambio
  • Precio Actual: Debe ser recuperable (> 0)
  • Cálculo de Cantidad: Debe cumplir con los mínimos del intercambio
  • Límites de Apalancamiento: Dentro del rango permitido por el intercambio

🔧 Solución de Problemas

Problemas Comunes

❌ "No se configuraron direcciones de ballenas"

Problema: La lista tracking_addresses está vacía

Solución:

HyperLiquidWhaleTracker: tracking_addresses: - "0xYOUR_WHALE_ADDRESS_HERE"

📎 Related Topics