🚀 Visão geral
O Hyperliquid Whale Tracker é um novo módulo do MagicTradeBot v3.1 projetado para traders que desejam aproveitar a transparência on-chain. Ele monitora continuamente carteiras de baleias selecionadas e reage quando essas carteiras abrem ou fecham posições. Você pode usá-lo em dois modos principais:
- Modo apenas sinal — receba alertas de negociação de baleias em tempo real via Telegram, Discord, WhatsApp ou Webhooks.
- Modo espelho — execute automaticamente negociações espelhadas em sua conta de exchange conectada, com proteções inteligentes.
A configuração é totalmente gerenciada através do seu arquivo tradesettings.yaml e pode ser habilitada por instância do bot. Por padrão, ela está desativada por segurança.
⚙️ Exemplo de configuração
Para ativar o rastreador, adicione a seguinte seção no seu arquivo 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
Essa configuração rastreia duas carteiras de baleias, espelha suas negociações com alavancagem de 3x e US$150 por operação, e fecha automaticamente as posições espelhadas quando as baleias fecham as suas.
🧠 Como funciona
- Fonte de eventos — O bot se inscreve nos eventos on-chain da Hyperliquid para os endereços especificados.
- Detecção de eventos — Quando uma baleia abre ou fecha uma posição, o bot valida a negociação com base nos filtros (tamanho, cooldown, direção).
- Decisão — Se
place_order = true, uma negociação espelhada é criada usando sua API de exchange conectada; caso contrário, um sinal é transmitido. - Execução — As ordens são executadas respeitando os limites de slippage, alavancagem e margem disponível. Ordens parciais podem ser espelhadas proporcionalmente.
- Ciclo de vida — O bot monitora as posições espelhadas e as fecha automaticamente se
close_on_whale_closeestiver ativado. - Registro e alertas — Todos os eventos são registrados e, opcionalmente, enviados para seus canais de notificação ou monitoramento.
🔒 Segurança e controle de riscos
- Nunca codifique chaves de API ou chaves privadas diretamente — use variáveis de ambiente ou segredos criptografados.
- Limite as permissões para apenas negociação; nunca habilite saques.
- Use o
DemoModepara testes iniciais antes de operar ao vivo. - Defina max_open_per_whale e slippage_tolerance_percent de forma conservadora.
- Ative o monitoramento de erros (por exemplo, Sentry, PagerDuty) para implantações em produção.
📣 Notificações e transmissões
Quando broadcast_signals: true está ativado, o MagicTradeBot envia alertas formatados para cada evento de negociação de baleia.
Exemplo (Telegram / Discord):
[Hyperliquid Whale] NOVA ORDEM
Baleia: 0x2aB3...Ff12
Ação: COMPRA (Long)
Símbolo: BTCUSDT
Tamanho: 0.5 BTC (~25.000 USDT)
Alavancagem: 3x
Espelhado: sim (ID da ordem: M-123456)
Exemplo (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"
}
🧩 Testes e modo de demonstração
- Defina
place_order: falseeDemoMode: truepara testes seguros. - Verifique as mensagens de sinal antes de ativar o trading espelhado.
- Comece com um pequeno
order_amounte confirme a detecção precisa de eventos. - Monitore o arquivo
completedorders.yamlpara logs de negociações espelhadas.
⚡ Boas práticas operacionais
- Use cooldown_seconds para evitar excesso de negociações quando as baleias dividirem ordens.
- Mantenha o modo apenas sinal durante mercados voláteis.
- Combine com módulos de gerenciamento de capital para dimensionamento dinâmico e mitigação de riscos.
- Use Prometheus e Loki para métricas de observabilidade e auditoria de eventos.
⚠️ Limitações e riscos
- Rastrear baleias ≠ lucro garantido — baleias também podem perder ou manipular.
- A latência de execução e o slippage podem causar diferenças nos resultados das negociações espelhadas.
- Rastrear muitas carteiras aumenta a carga na API — ajuste os limites de taxa conforme necessário.
💬 FAQ
P: Posso rastrear qualquer carteira?
Sim. Adicione qualquer endereço público de carteira em tracking_addresses — o bot detectará automaticamente a atividade de negociação relacionada.
P: Ele corresponde exatamente ao tamanho da posição da baleia?
Não. Ele usa o order_amount configurado ou um tamanho proporcional se follow_partial_fills estiver ativado.
P: E se uma baleia enviar vários micro-ordens?
Use cooldown_seconds e follow_partial_fills para evitar negociações duplicadas e controlar a superexposição.
⚖️ Aviso legal e ético
Embora o acompanhamento da atividade pública de carteiras seja transparente na blockchain, certifique-se de cumprir os termos das exchanges e as regulamentações locais. O MagicTradeBot fornece as ferramentas — você é responsável pelo uso legal e ético delas.
🛠️ Suporte e solução de problemas
- Verifique o arquivo
completedorders.yamle os logs em busca de erros. - Confirme as permissões da API e as configurações das variáveis de ambiente.
- Entre em contato com o Suporte oficial do MagicTradeBot através do seu painel para obter assistência técnica.