CoinLobster/agent-skills

Fluxo de Baleias

Negociações executadas de baleias (não transferências de carteira): lado, tamanho, preço, local, no momento em que acontecem, mescladas em 15 exchanges centralizadas e swaps DEX on-chain na Ethereum, Base e Arbitrum.

Fontes de dados (em ordem)

1. CoinLobster MCP conectado? Use suas ferramentas, totalmente qualificadas: coinlobster:whale_trades (negociações recentes; argumentos: coin, source cex|dex|all, min_usd, limit) e coinlobster:whale_flow (cestas horárias de compra/venda em USD; argumentos: coin, hours). whale_tape é um alias obsoleto de whale_trades mantido funcionando para chamadas existentes; prefira whale_trades e recorra a whale_tape apenas se tools/list mostrar apenas esse nome.
2. Lanes de carteiras nomeadas e DEX (MCP). coinlobster:onchain_whales (argumentos: chain, coin, min_usd, limit) retorna swaps DEX executados na Ethereum, Base e Arbitrum, cada um carregando a carteira e o DEX. coinlobster:hl_whales (argumentos: coin, limit) retorna preenchimentos de baleias da Hyperliquid COM o endereço da carteira, e coinlobster:hl_wallet (argumentos: address) abre o livro ao vivo dessa conta (posições, alavancagem, viés líquido). Hyperliquid é o único local cujo feed público nomeia a conta em ambos os lados de um preenchimento, então uma linha HL é rastreável de uma forma que uma linha CEX não é. Diga de qual lane veio um número.
3. Sem MCP: use curl na API sem chave (GET apenas, JSON):

   curl -s "https://coinlobster.com/api/public/crypto-whales?coin=BTC&limit=50"
   curl -s "https://coinlobster.com/api/public/onchain-whales?chain=ethereum&limit=50"
   curl -s "https://coinlobster.com/api/public/hyperliquid/whales?coin=ETH&limit=50"
   curl -s "https://coinlobster.com/api/public/whale-flow-history?coin=BTC&hours=168"
   

   Sem chave, a janela de medição nos três feeds de negociação é o que as linhas retornadas cobrem; calcule-a a partir dos timestamps mín/máx e informe. whale-flow-history é o equivalente REST da ferramenta whale_flow: linhas horárias { t, buyUsd, sellUsd, netUsd, count, price }, fluxo na mesma grade que o fechamento horário, 7 dias sem chave (maxFreeHours), 30 (proHours) com uma assinatura do site coinlobster.com. Uma chave de API não amplia esta rota REST; em uma superfície de agente, a janela de 30 dias é a ferramenta MCP whale_flow em um plano de desenvolvedor. available: false significa que não há horas de baleia registradas para aquela moeda ainda; coverage.hoursWithPrice indica quanto da janela realmente tem um preço por trás.
4. Leitura rápida sem parsing: acesse https://coinlobster.com/crypto-whales.md (tabela markdown das últimas negociações).

Mais endpoints e significados de campos: veja references/endpoints.md.

Como ler o feed

• Limiares de baleia escalam com a liquidez: $500K+ à vista ($1M+ futuros) em BTC, $1M+ à vista ($2M+ futuros) em ETH, $400K+ à vista ($800K+ futuros) em principais moedas, $100K+ à vista ($200K+ futuros) em todo o resto. Uma negociação de baleia de $400K em uma small cap é um evento maior do que $2M em BTC. On-chain, swaps são registrados a partir de $100K na Ethereum e $25K na Base e Arbitrum, mas as visualizações sem chave têm piso mais alto: /api/public/onchain-whales e whale_trades com source: dex mostram apenas $250K+, enquanto a ferramenta dedicada onchain_whales serve o piso completo registrado.
• Clusters superam negociações individuais. Várias negociações grandes na mesma direção em minutos sugerem posicionamento coordenado. Uma negociação é a opinião de um trader.
• Baleias de contra-tendência são o sinal mais forte: grandes compras durante uma liquidação significam que alguém com tamanho está entrando contra a multidão.
• Divergência CEX vs DEX importa: acumulação em DEX sem compras em CEX geralmente precede fluxo para CEX; note de qual lane veio cada negociação. No MCP, as linhas de whale_trades carregam um campo source (cex|dex). Na REST, a lane é o endpoint que você chamou: /crypto-whales é apenas CEX, /onchain-whales é apenas DEX.
• Direção do fluxo líquido: some compras USD vs vendas USD na janela (whale_flow faz isso por hora). Reporte a divisão, não apenas a direção ("62% compras em 4h" é melhor do que "baleias estão comprando").
• Condições de mercado por negociação: as linhas de negociação de baleias no REST carregam um objeto marketConditions (financiamento e juros abertos em todos os locais NO MOMENTO DA NEGOCIAÇÃO). Esse é o contexto unido que os agentes geralmente precisam de um segundo provedor para obter: uma compra de $4M negociada enquanto o financiamento estava negativo é um fato diferente da mesma compra com financiamento extremamente positivo. Cite-o quando ele mudar a leitura.

Regras

• Os dados são históricos descritivos. Reporte o que as baleias FIZERAM, nunca preveja o que o preço fará. Sem conselhos.
• Apenas BTC/USD transmite em tempo real na visualização gratuita. Todas as outras moedas têm atraso de 15 minutos, EXCETO qualquer negociação de $1M+, que transmite ao vivo em qualquer moeda. Trate linhas atrasadas como atrasadas e diga isso. Linhas DEX sem chave têm piso de $250K no /api/public/onchain-whales e no tape mesclado whale_trades; diga de qual visualização veio um número.
• Sempre informe a janela e a moeda que você mediu ("últimas 24h, BTC, CEX+DEX").
• Verifique o timestamp da linha mais nova em relação à hora atual; se a negociação mais recente tiver horas de idade, reporte o feed como quieto desde então, em vez de apresentar negociações antigas como "agora".
• Poucas linhas não é um erro: os pisos do feed gratuito significam que apenas negociações de tamanho de baleia são transmitidas sem chave (BTC/USD a partir de $500K à vista, além de cada negociação de $1M+ em qualquer moeda ao vivo), então 8 linhas em 24h significam 8 negociações desse tamanho, não um feed quebrado. Nomeie o piso quando a contagem de linhas for a história. Se cada linha for de um único local, diga isso.