Hyperliquid Whale Copy Trading — Espelhe as negociações profissionais instantaneamente

O Hyperliquid Whale Tracker do MagicTradeBot permite acompanhar a atividade de carteiras na Hyperliquid e em outras exchanges baseadas em carteira. Acompanhe qualquer endereço de carteira, receba notificações e, opcionalmente, replique (abrir/fechar) trades automaticamente com controles flexíveis de segurança e filtragem.

Visão Geral

O Hyperliquid Whale Tracker observa endereços de carteiras (whales) e reage quando essas carteiras abrem ou fecham posições. Suporta dois modos principais:

  • Modo apenas sinal — transmite eventos de whales para os seus canais de notificação (Telegram, Discord, WhatsApp, etc.).
  • Modo espelhamento — coloca automaticamente ordens espelhadas e fecha-as quando a whale fecha sua posição.

O recurso é totalmente configurável a partir do tradesettings.yaml e pode ser ativado por instância de bot. Por padrão, está desativado.

Configuração

Adicione ou atualize a seção HyperLiquidWhaleTracker no seu tradesettings.yaml (ou variante appsettings.yaml se centralizar configurações). Exemplo: 

HyperLiquidWhaleTracker:
  is_enabled: false
  tracking_addresses:
    - "0x2aB3...Ff12"            # Adicione um ou mais endereços de carteiras whales
    - "0x1cD4...Aa77"
  place_order: false             # true = colocar ordens espelhadas automaticamente, false = apenas sinal
  order_amount: 100.0            # Quantidade na BaseCurrency por trade espelhado
  leverage: 3                    # Alavancagem a usar para trades espelhados (se aplicável)
  broadcast_signals: true        # true = enviar notificações quando a whale abrir/fechar trades
  max_open_per_whale: 2          # Máximo de trades espelhados abertos por whale rastreada (segurança)
  slippage_tolerance_percent: 0.5 # Slippage máximo aceitável ao colocar ordens espelhadas
  follow_partial_fills: true     # Se true, o bot espelha preenchimentos parciais proporcionalmente
  close_on_whale_close: true     # Fecha ordem espelhada quando a whale fecha sua posição
  include_liquidations: false    # Se true, espelha liquidações (não recomendado)
  only_follow_buy: false         # Se true, apenas segue compras
  only_follow_sell: false        # Se true, apenas segue vendas
  min_whale_order_value: 50.0    # Valor mínimo de ordem (BaseCurrency) para rastrear/espelhar
  cooldown_seconds: 30           # Segundos de espera entre eventos para a mesma whale

Descrição dos Campos

  • is_enabled — Ativa/desativa o rastreador de whales (padrão: false).
  • tracking_addresses — Lista de endereços de carteiras a seguir. Sem limite rígido; adicione quantos quiser, mas considere o uso de recursos.
  • place_order — Quando true, o bot tentará colocar ordens espelhadas automaticamente. Quando false, apenas transmite sinais.
  • order_amount — Tamanho da ordem espelhada na moeda base (ex.: USDT) por trade. Considere usar gerenciamento de risco para produção.
  • leverage — Alavancagem para abrir posições espelhadas em futuros (apenas se a exchange suportar).
  • broadcast_signals — Envia mensagens formatadas para os canais de notificação configurados.
  • max_open_per_whale — Limite de segurança para evitar exposição excessiva a uma única whale.
  • slippage_tolerance_percent — Slippage máximo aceitável ao colocar ordens.
  • follow_partial_fills — Se a ordem da whale for parcialmente preenchida, o bot espelha a mesma proporção.
  • close_on_whale_close — Fecha ordens espelhadas quando a whale fecha sua posição.
  • include_liquidations — Espelha liquidações apenas se compreender os riscos extremos.
  • only_follow_buy / only_follow_sell — Filtra para seguir apenas compras ou apenas vendas.
  • min_whale_order_value — Ignora ordens pequenas abaixo desse valor.
  • cooldown_seconds — Evita spam de eventos espaçando o processamento por whale.

Como funciona (fluxo técnico)

  1. Fonte de Eventos: O bot se inscreve em eventos de carteiras Hyperliquid (ou consulta blockchain/API) para os endereços configurados.
  2. Detecção de Evento: Ao detectar um evento de abertura/fechamento, o bot valida filtros (valor mínimo, tipo de ação, cooldown).
  3. Decisão: Se place_order = true, o bot cria uma ordem espelhada usando suas credenciais de exchange, incluindo regras de tamanho e alavancagem. Caso contrário, apenas cria a mensagem de broadcast.
  4. Execução: Tenta colocar a ordem, considerando tolerância a slippage e saldo disponível. Se follow_partial_fills = true, ajusta as quantidades proporcionalmente.
  5. Ciclo de Vida: O bot monitora a ordem espelhada e, se close_on_whale_close = true, fecha-a quando a whale fechar a sua.
  6. Logs & Alertas: Todos os eventos e ações são registrados. Notificações são enviadas se configuradas.

Pré-requisitos & Permissões

  • Instância funcional do MagicTradeBot com licença válida e tradesettings.yaml configurado.
  • Chaves de API da exchange com permissão de trading (se place_order estiver habilitado). Para ações baseadas em carteiras Hyperliquid, pode ser necessário uma chave privada — nunca armazene chaves privadas em texto simples (use variáveis de ambiente).
  • Conexão de internet estável e configuração adequada de limites de taxa em appsettings.yaml para evitar bloqueios da API.

Considerações de Segurança

  • Nunca codifique chaves privadas ou segredos da API em arquivos do repositório. Use variáveis de ambiente ou gerenciadores de segredos do sistema operacional.
  • Limite permissões da API apenas ao necessário (idealmente trading, sem saques).
  • Teste exaustivamente no DemoMode antes de ativar ordens espelhadas ao vivo.
  • Defina padrões conservadores: max_open_per_whale, slippage_tolerance_percent, e min_whale_order_value.
  • Ative logs e alertas de incidentes (Sentry, PagerDuty) para ser notificado de erros ou comportamento inesperado.

Exemplos de Notificação & Broadcast

Quando broadcast_signals é true, o bot envia uma mensagem formatada. Exemplos:

Telegram / Discord (texto)


[Hyperliquid Whale] NOVA ORDEM
Whale: 0x2aB3...Ff12
Ação: BUY (Long)
Símbolo: BTCUSDT
Quantidade: 0.5 BTC (~25000 USDT)
Alavancagem: 3x
Hora: 2025-10-16T12:34:56Z
Espelhada: sim (id da ordem: M-123456)   # ou "Espelhada: não" se place_order=false

WhatsApp / Webhook (JSON payload)

{
  "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"
}

Testes & Modo Demo

  • Teste sempre com DemoMode: true ou em testnets da exchange.
  • Defina place_order: false para verificar detecção de eventos e formato de broadcast sem executar trades.
  • Use pequenas order_amount durante testes ao vivo e monitore logs em completedorders.yaml e terminal.

Boas Práticas Operacionais

  • Use max_open_per_whale para evitar sobre-exposição a uma sequência de trades de uma whale.
  • Ative cooldown_seconds para reduzir processamento duplicado se whales dividirem ordens em micro-ordens.
  • Prefira modo apenas sinal em mercados voláteis ou quando não puder garantir execução rápida/slippage control.
  • Se espelhar com alavancagem, garanta margem e fail-safes (fechamento forçado global).
  • Registre todos os eventos e ações espelhadas para auditoria e backtesting.

Logs & Monitoramento

Logs/monitoramento recomendados em appsettings.yaml ou configuração do bot:

  • Logs no terminal para troubleshooting em tempo real.
  • completedorders.yaml — trades espelhados concluídos persistidos para backtest e PnL.
  • Logs remotos opcionais: Sentry, Loki, LogDNA, DataDog para alertas e histórico de auditoria.
  • Métricas Prometheus para contagem de posições abertas, ordens espelhadas e taxas de erro.

Tratamento de Erros & Retentativas

  • Em falha de colocação de ordem, o bot tenta até 3 vezes com backoff exponencial (configurável).
  • Se slippage exceder slippage_tolerance_percent, a ordem é cancelada e um aviso emitido.
  • Se ordem espelhada não puder ser colocada por saldo insuficiente, o bot envia alerta e pula o espelhamento.

Limitações & Riscos

  • Seguir carteiras não garante lucro — whales podem ser market makers, insiders ou realizar manipulações de curto prazo.
  • Espelhar liquidações ou movimentos de alta alavancagem pode amplificar perdas.
  • Latência e slippage podem gerar resultados diferentes das whales.
  • Respeite limites de API da exchange — rastrear muitas whales aumenta chamadas e uso de recursos.

FAQ

P: Posso rastrear qualquer endereço de carteira?

R: Sim — adicione qualquer endereço público em tracking_addresses. O bot tentará detectar eventos de abertura/fechamento associados.

P: O bot replicará exatamente o tamanho das posições?

R: Nem sempre. O bot usa order_amount como tamanho do trade espelhado (ou espelha proporcionalmente preenchimentos parciais se habilitado). Você pode implementar dimensionamento percentual em configuração avançada de gestão de risco.

P: E se uma whale dividir uma ordem em várias micro-ordens?

R: Use cooldown_seconds e follow_partial_fills para controlar como ordens divididas são espelhadas e evitar sobre-exposição.

Checklist de Início

  1. Ative o rastreador: defina is_enabled: true em tradesettings.yaml.
  2. Adicione endereços de whales em tracking_addresses.
  3. Defina place_order = false inicialmente para verificar eventos e notificações.
  4. Verifique se broadcasts chegam no Telegram/Discord/WhatsApp.
  5. Mude para place_order: true quando estiver confortável, mantendo DemoMode = true até a verificação ao vivo.
  6. Monitore logs e configure alertas para erros de execução, slippage e saldo insuficiente.

Exemplo completo (copiar para 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

Rastrear e espelhar atividade de carteiras públicas é tecnicamente viável, mas você deve garantir conformidade com leis locais, termos das exchanges e práticas éticas de trading. O MagicTradeBot fornece as ferramentas — é sua responsabilidade usá-las legal e responsavelmente.

Suporte & Solução de Problemas

Se encontrar problemas:

  • Verifique logs no terminal e completedorders.yaml para erros.
  • Confirme chaves API e permissões (trading permitido, saques desativados).
  • Confirme se variáveis de ambiente sobrescrevem configurações de arquivo, se usadas para segredos.
  • Contate suporte via painel do MagicTradeBot ou consulte a documentação completa de Configuração.

📎 Related Topics