Para traders de criptomoedas que buscam uma vantagem, monitorar as carteiras de grandes detentores — comumente chamados de baleias — pode revelar posicionamentos antecipados antes de grandes movimentos de preço. Construir um bot de trading de criptomoedas com sinais de baleias on-chain em Python permite automatizar a captura e reação a esses pontos de dados de alto valor. Este tutorial percorre uma implementação prática usando o Smart Money API, uma fonte especializada de atividade agregada de baleias do leaderboard da Hyperliquid combinada com dados de derivativos de várias exchanges.
Entendendo os Sinais de Baleias On-Chain
Carteiras de baleias são endereços que detêm ou negociam quantidades significativas de criptomoedas. Quando uma baleia deposita ativos em uma exchange, abre uma grande posição ou retira de uma exchange descentralizada, isso frequentemente sinaliza intenção — e o mercado frequentemente segue. O Smart Money API descobre automaticamente aproximadamente 2.000 carteiras de baleias do leaderboard multiperíodo da Hyperliquid e rastreia seus eventos nas exchanges suportadas (Bybit, Binance e Hyperliquid apenas). Esses eventos incluem grandes entradas, saídas e mudanças de posição.
Ao conectar esses sinais a um bot de trading, você pode programar respostas como colocar ordens limitadas, ajustar stop-losses ou enviar alertas — tudo sem atraso emocional.
Começando com o Smart Money API
Primeiro, cadastre-se em smartmoneyapi.com para obter uma chave de API. O plano gratuito oferece 200 chamadas por dia, limitado a dados de Bitcoin — suficiente para testes. Para funcionalidade completa (todos os símbolos, eventos de baleias, derivativos e métricas on-chain), o plano Trader (1,000 chamadas/dia) ou Pro (5.000 chamadas/dia) é recomendado.
Todas as requisições são autenticadas via o X-API-Key cabeçalho. O endpoint base é https://api.smartmoneyapi.com. Abaixo está um script mínimo em Python para testar sua conexão:
import requests
API_KEY = "your_api_key_here"
BASE_URL = "https://api.smartmoneyapi.com"
headers = {"X-API-Key": API_KEY}
# Check health
resp = requests.get(f"{BASE_URL}/v1/health", headers=headers)
print(resp.json())Obtendo Dados de Carteiras de Baleias
O sinal de baleia mais direto está disponível via /v1/whales/summary, que retorna métricas agregadas para todas as carteiras rastreadas, como fluxo líquido total e o número de carteiras ativas. Para eventos individuais (depósitos, saques, aberturas de posição), use /v1/whales/events.
Exemplo: Recupere os últimos 5 eventos de baleias:
endpoint = f"{BASE_URL}/v1/whales/events"
params = {"limit": 5}
resp = requests.get(endpoint, headers=headers, params=params)
events = resp.json()
for event in events:
print(f"Symbol: {event['symbol']}, Type: {event['event_type']}, "
f"Amount: {event['amount_usd']}, Wallet: {event['wallet_address'][:8]}...")Os eventos incluem campos como event_type (por exemplo, "deposit", "withdrawal", "open_long"), symbol, amount_usd, e um timestamp. Seu bot pode filtrar por símbolos específicos ou limites — por exemplo, agir apenas quando uma baleia depositar mais de US$ 500.000 em uma exchange.
Integrando Dados de Baleias em uma Estratégia de Trading
Uma estratégia simples pode usar um sinal de "momento de baleia": se várias baleias estiverem depositando na mesma exchange para o mesmo símbolo em uma janela curta, isso pode indicar uma pressão de venda iminente. Por outro lado, grandes saques para auto-custódia frequentemente sinalizam acumulação.
Você pode construir um mecanismo de pontuação:
- Acompanhe o fluxo líquido em USD por símbolo na última hora.
- Se o fluxo líquido exceder um limite (em valor absoluto), gere um sinal.
- Combine com dados de derivativos (próxima seção) para confirmação.
Importante: Esta é uma metodologia baseada em dados que não oferece garantias. Faça backtestes rigorosos e nunca confie apenas em um sinal.
Adicionando Dados de Derivativos para Confirmação
O Smart Money API oferece dados de derivativos de várias exchanges da Bybit, Binance e Hyperliquid apenas (sem OKX). Use o /v1/derivatives/screener endpoint para obter métricas como open interest, taxas de funding e razões long/short para qualquer um dos ~229 símbolos descobertos automaticamente.
Exemplo: Obtenha a taxa de funding e o open interest atual para o perpetual BTC-USDT:
screener = f"{BASE_URL}/v1/derivatives/screener"
params = {"symbol": "BTC/USDT:USDT", "exchange": "binance"}
resp = requests.get(screener, headers=headers, params=params)
data = resp.json()
print(f"OI: {data['open_interest']}, Funding Rate: {data['funding_rate']}")Ao combinar eventos de depósito de baleias com open interest crescente e uma taxa de funding negativa (indicando dominância de shorts), você pode gerar ideias de trade mais robustas.
Node Intelligence para Risco de Token (BSC & Avalanche)
Se o seu bot opera na Binance Smart Chain (PancakeSwap) ou Avalanche C-chain (Trader Joe), você pode aproveitar o produto Node Intelligence do Smart Money API. Isso roda no seu próprio nó completo (ou um RPC revendável) e fornece:
- Detecção de novos pares
- Monitoramento de grandes swaps
- Detecção de honeypot (
/v1/node/{bsc|avax}/honeypot/{token}) - Pontuação de risco de token (
/v1/node/{bsc|avax}/token-risk/{token}) - Rastreamento de carteiras
Por exemplo, antes de comprar um token recém-descoberto, chame o endpoint de honeypot para verificar se o contrato tem restrições de venda. A resposta inclui flags como is_honeypot e risk_score (0‑100).
token = "0x123...abc"
resp = requests.get(f"{BASE_URL}/v1/node/bsc/honeypot/{token}", headers=headers)
honeypot_check = resp.json()
if honeypot_check.get("is_honeypot"):
print("Token is a honeypot — skipping.")O Smart Money API oferece planos Node (Starter, Pro, API por chain) para este serviço.
Construindo o Loop do Bot
Monte os componentes em um loop contínuo. Use time.sleep() ou um agendador (por exemplo, a biblioteca schedule ) para respeitar os limites de taxa da API. Um intervalo típico é de 5–15 minutos para eventos de baleias e 1 minuto para dados de derivativos, se o seu plano permitir.
Estrutura de pseudo-código:
while True:
whales = get_whale_events(min_amount_usd=500_000)
for event in whales:
if is_bullish_signal(event):
oi, funding = get_derivatives(event['symbol'])
if oi > threshold and funding < -0.01:
execute_trade(event['symbol'], side="short")
time.sleep(300) # 5 minutesLembre-se de implementar tratamento de erros, logging e modo de teste antes de operar com capital real.
Perguntas Frequentes
Qual é a melhor biblioteca Python para construir um bot de trading de criptomoedas?
Para APIs premium como o Smart Money API, requests é suficiente. Para conectividade com exchanges, ccxt é a biblioteca padrão que suporta muitas exchanges. Para backtesting, backtrader ou vectorbt são populares.
Quantas carteiras de baleias o Smart Money API rastreia?
Aproximadamente 2.000 carteiras descobertas automaticamente do leaderboard multiperíodo da Hyperliquid, nas exchanges Bybit, Binance e Hyperliquid apenas.
Posso usar este bot para tokens na BSC ou Avalanche?
Sim, via o produto Node Intelligence. Você precisa de um nó completo (ou RPC revendável) para a respectiva chain. A API fornece detecção de novos pares, grandes swaps, verificações de honeypot e rastreamento de carteiras para BSC e Avalanche.
Preciso de dados reais de Bitcoin para começar?
Não. O plano gratuito oferece 20 chamadas diárias apenas para Bitcoin, mas você ainda pode testar endpoints para símbolos na whitelist. Para outros símbolos, atualize para Trader ou Pro.
Conclusão Prospectiva
Construir um bot de trading de criptomoedas com sinais de baleias on-chain em Python está cada vez mais acessível graças a agregadores especializados como o Smart Money API. Ao combinar eventos de carteiras, sentimentos de derivativos e verificações de risco on-chain, você cria um motor de decisão multifacetado — que reduz a dependência de ações de preço defasadas. À medida que o ecossistema DeFi se expande, a capacidade de reagir programaticamente ao comportamento de grandes detentores continuará sendo uma ferramenta valiosa para traders sistemáticos. Sempre comece com paper trading e backtesting iterativo antes de implantar capital.