Guia do usuário do Hyperliquid Whale Tracker

📑 Sumário

📖 Visão Geral

O Hyperliquid Whale Tracker é um recurso avançado que monitora as atividades de carteiras de baleias na exchange Hyperliquid e permite copy trading automático. Quando uma baleia rastreada abre uma nova posição, o sistema pode transmitir automaticamente sinais para Discord/Telegram e/ou realizar operações espelhadas em sua conta.

🔍 Detecção em Tempo Real

Monitora as posições das baleias a cada 5 minutos e detecta novas posições instantaneamente.

📢 Alertas Multiplataforma

Transmite sinais para Discord, Telegram e WhatsApp com formatação rica.

🤖 Copy Trading Automático

Espelha automaticamente as posições das baleias com suas configurações personalizadas e parâmetros de risco.

🎯 Rastreamento Inteligente de Fechamento

Fecha automaticamente sua posição quando a baleia fecha a dela.

⚙️ Configuração

Configurações Básicas

Localizadas no seu arquivo de configuração sob HyperLiquidWhaleTracker:

HyperLiquidWhaleTracker: is_enabled: true # Ativar/desativar rastreamento de baleias tracking_addresses: # Lista de endereços de carteiras de baleias - "0x2ea18c23f72a4b6172c55b411823cdc5335923f4" - "0xb317d2bc2d3d2df5fa441b5bae0ab9d8b07283ae" - "0x9458f423df6569f053358ee9906613cd69c1ec04" # Adicionar mais endereços... place_order: false # Colocar ordens espelhadas automaticamente broadcast_signals: true # Transmitir para plataformas de mensagens max_orders_per_whale: 2 # Máximo de ordens simultâneas por baleia

Configuração de Plataformas de Mensagens

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"

Configurações de Trading

general: initial_trade_amount: 100 # Valor em USD por operação leverage: 10 # Multiplicador de alavancagem demo_mode: false # Testar sem operações reais sltp_settings: take_profit_percent: 5.0 # Percentual de take profit stop_loss_percent: 2.0 # Percentual de stop loss

🔧 Como Funciona

Processo de Detecção

1Escaneamento Inicial

Na primeira execução, o sistema registra todas as posições existentes das baleias sem transmitir (evita spam).

2Monitoramento Contínuo

A cada 5 minutos, o sistema:

  • Obtém as posições atuais de cada baleia rastreada
  • Compara com as posições vistas anteriormente
  • Detecta NOVAS posições que não estavam presentes antes

3Identificação de Posição

Uma posição é considerada NOVA quando:

  • A moeda não estava no portfólio da baleia no último check
  • O sistema não transmitiu essa posição anteriormente

4Execução de Ação

Para cada nova posição:

  • Transmite sinal para as plataformas configuradas (se habilitado)
  • Coloca ordem de copy trading (se habilitado)
  • Adiciona a posição ao monitoramento para rastreamento de fechamento automático

Dados de Posições das Baleias Rastreados

Ponto de Dados Descrição
Moeda Par de trading (ex.: BTC, ETH, SOL)
Lado Posição comprada ou vendida
Tamanho Tamanho da posição em contratos
Preço de Entrada Preço de entrada da baleia
Alavancagem Alavancagem da posição
PnL Não Realizado Lucro/prejuízo atual
Preço de Liquidação Limiar de risco

📢 Transmissão de Sinais

Habilitando Transmissões

Defina broadcast_signals: true na sua configuração para receber notificações quando baleias abrirem posições.

Notificações do Discord

Formato Rich Embed

  • Codificado por cores (Verde para COMPRADA, Vermelho para VENDIDA)
  • Campos organizados com todos os detalhes da posição
  • Link clicável para o portfólio da baleia
  • Timestamp para rastreamento
🐋 Alerta de Baleia: Baleia #1 Baleia #1 abriu uma posição COMPRADA em BTC 📊 Detalhes da Posição Moeda: BTC Lado: COMPRADA 📈 Tamanho: 50.5 Alavancagem: 20x 💰 Informações de Preço Preço de Entrada: $65.432,10 PnL Não Realizado: $-125,50 ⏰ Tempo Posição Aberta: 2025-01-15 14:30:00 UTC Detectada: 14:35:00

Notificações do Telegram

Formato Markdown

  • Formato de texto claro e legível
  • Blocos de código monospace para dados
  • Link direto para rastreamento
  • Layout amigável para dispositivos móveis
🐋 *ALERTA DE BALEIA* 🟢 *Baleia #1* abriu posição *COMPRADA* *Detalhes da Posição:* Moeda : BTC Lado : COMPRADA Tamanho : 50.5 Preço de Entrada : $65.432,10 Alavancagem : 20x PnL Não Real. : $-125,50 Liquidação : $60.123,45 text*Tempo:* Aberta : 2025-01-15 14:30:00 UTC Detectada : 2025-01-15 14:35:00 text🔗 [Rastrear no CoinGlass] _Baleia: 0x2ea18c23..._

Seleção de Plataforma

O sistema transmite para todas as plataformas configuradas com credenciais válidas. Plataformas sem credenciais são automaticamente ignoradas:

  • Discord: Requer discord_webhook_url
  • Telegram: Requer tanto telegram_bot_token quanto telegram_chat_id
  • WhatsApp: Requer whatsapp_token e whatsapp_phone_id

🤖 Copy Trading Automático

Habilitando o Trading Automático

Defina place_order: true para espelhar automaticamente as posições das baleias.

Como Funciona o Copy Trading

  1. Detecção de Posição: O sistema detecta uma nova posição da baleia
  2. Correspondência de Símbolos: Encontra o par de trading correspondente na sua exchange
  3. Validação de Ordem: Verifica os limites de ordem da baleia e a disponibilidade do bot
  4. Colocação de Ordem: Coloca uma ordem de mercado com suas configurações
  5. Monitoramento: Adiciona a posição ao sistema de monitoramento de fechamento

⚠️ Importante: Suas Configurações, Não as da Baleia

Seus trades de cópia usam SUAS configurações, não as da baleia:

  • Seu tamanho de posição (não o da baleia)
  • Sua alavancagem (não a da baleia)
  • Suas porcentagens de TP/SL
  • Suas regras de gerenciamento de risco

Exemplo: Baleia abre 100 BTC COMPRADA com alavancagem 20x → Seu trade de cópia: $100 BTC COMPRADA com alavancagem 10x (suas configurações)

Compatibilidade com Exchanges

O sistema adapta automaticamente os símbolos para sua exchange:

Exchange Símbolo da Baleia Seu Símbolo
Binance BTC BTCUSDT
OKX BTC BTC-USDT-SWAP
Bybit BTC BTCUSDT
Bitget BTC BTCUSDT
HyperLiquid BTC BTC (sem alteração)

Lógica de Colocação de Ordens

SE nova posição de baleia detectada: → Verifica se broadcast_signals está habilitado → Envia notificações → Verifica se place_order está habilitado: → Verifica se o limite de ordens da baleia não foi excedido → Encontra o par de trading ativo correspondente → Verifica se o bot não tem ordens em execução (evita conflitos) → Calcula o tamanho da ordem com base nas SUAS configurações → Coloca ordem de mercado com SEU TP/SL → Salva em opentrades.yaml → Adiciona ao monitoramento para fechamento automático

👁️ Monitoramento de Posições & Fechamento Automático

Rastreamento de Fechamento Automático

Quando você copia um trade de uma baleia, o sistema monitora continuamente a posição da baleia. Se a baleia fechar sua posição, seu trade de cópia também será fechado automaticamente.

Como Funciona

  1. Registro de Posição: Após colocar o trade de cópia, a posição é adicionada ao monitoramento
  2. Verificação Contínua: A cada 5 minutos, o sistema verifica as posições atuais da baleia
  3. Detecção de Fechamento: Identifica quando o tamanho da posição da baleia diminui ou desaparece
  4. Execução de Fechamento Automático: Fecha imediatamente sua posição correspondente

Cenários de Fechamento

Fechamento Total (100%)

Baleia: Fecha a posição inteira

Seu Trade: Fecha automaticamente 100% da posição

Resultado: Trade movido para concluído, running_orders limpo

Fechamento Parcial

Baleia: Reduz o tamanho da posição (ex.: fechamento de 50%)

Seu Trade: Fecha a porcentagem correspondente

Resultado: Trade atualizado com novas quantidades

Gerenciamento de Estado

# Antes do Fechamento running_orders: - order_id: "12345" symbol: "BTCUSDT" status: "Active" whale_address: "0x2ea..." # Após o Fechamento running_orders: null # Limpo, pronto para o próximo trade completed_trades: - order_id: "12345" status: "Closed" realized_pnl: 45.30 close_reason: "Baleia #1 fechou a posição BTC"

🛡️ Recursos de Segurança

Limites de Ordens

Limite por Baleia (max_orders_per_whale)

  • Padrão: 2 ordens simultâneas por baleia
  • Configurável: Defina qualquer número (1-10 recomendado)
  • Objetivo: Evita superexposição a uma única baleia

Exemplo: Baleia #1 tem 2 posições ativas → Nova posição detectada → Sistema verifica: limite de 2/2 atingido → Ordem ignorada: "Limite de ordens da baleia atingido"

Modo Demo

Teste o sistema sem arriscar capital real:

general: demo_mode: true # Simula ordens sem execução

No Modo Demo:

  • ✅ Detecta posições de baleias
  • ✅ Transmite sinais
  • ✅ Registra detalhes das ordens
  • ❌ Não coloca ordens reais
  • ❌ Não faz chamadas de API à exchange

Prevenção de Conflitos do Bot

Antes de colocar um trade de cópia:

  • Verifica se o bot alvo tem ordens em execução
  • Ignora a ordem se o bot já está operando
  • Evita múltiplas posições simultâneas no mesmo símbolo

Validação de Posição

Cada ordem é validada para:

  • Símbolo Válido: Deve existir na sua exchange
  • Preço Atual: Deve ser recuperável (> 0)
  • Cálculo de Quantidade: Deve atender aos mínimos da exchange
  • Limites de Alavancagem: Dentro do intervalo permitido pela exchange

🔧 Solução de Problemas

Problemas Comuns

❌ "Nenhum endereço de baleia configurado"

Problema: A lista tracking_addresses está vazia

Solução:

HyperLiquidWhaleTracker: tracking_addresses: - "0xSEU_ENDEREÇO_DE_BALEIA_AQUI"

📎 Related Topics