CoinLobster/agent-skills

Flujo de Ballenas

Operaciones de ballenas ejecutadas (no transferencias de wallets): lado, tamaño, precio, lugar, en el momento exacto en que ocurren, combinadas de 15 exchanges centralizados y swaps DEX en cadena en Ethereum, Base y Arbitrum.

Fuentes de datos (en orden)

1. ¿CoinLobster MCP conectado? Usa sus herramientas, completamente calificadas: coinlobster:whale_trades (operaciones recientes; args: coin, source cex|dex|all, min_usd, limit) y coinlobster:whale_flow (baldes horarios de compra/venta en USD; args: coin, hours). whale_tape es un alias obsoleto de whale_trades que se mantiene funcionando para quienes ya lo usan; prefiere whale_trades, y recurre a whale_tape solo si tools/list muestra únicamente ese nombre.
2. Líneas de wallets nombradas y DEX (MCP). coinlobster:onchain_whales (args: chain, coin, min_usd, limit) devuelve swaps DEX ejecutados en Ethereum, Base y Arbitrum, cada uno con la wallet y el DEX. coinlobster:hl_whales (args: coin, limit) devuelve las operaciones de ballenas en Hyperliquid CON la dirección de la wallet, y coinlobster:hl_wallet (args: address) abre el libro en vivo de esa cuenta (posiciones, apalancamiento, sesgo neto). Hyperliquid es el único lugar cuya fuente pública nombra la cuenta en ambos lados de una operación, por lo que una fila de HL es rastreable de una manera que una fila de CEX no lo es. Indica de qué línea proviene un número.
3. Sin MCP: usa curl a la API sin clave (solo GET, 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"
   

   Sin clave, la ventana de medición de las tres fuentes de operaciones es la que abarcan las filas devueltas; calcúlala a partir de las marcas de tiempo mín/max y nómbrala. whale-flow-history es el gemelo REST de la herramienta whale_flow: filas horarias { t, buyUsd, sellUsd, netUsd, count, price }, flujo en la misma cuadrícula que el cierre horario, 7 días sin clave (maxFreeHours), 30 (proHours) con una suscripción al sitio web coinlobster.com. Una clave API no amplía esta ruta REST; en la superficie de un agente, la ventana de 30 días es la herramienta MCP whale_flow en un plan de desarrollador. available: false significa que aún no hay horas de ballenas registradas para esa moneda; coverage.hoursWithPrice indica cuánto de la ventana tiene realmente un precio detrás.
4. Lectura rápida sin parsear: obtén https://coinlobster.com/crypto-whales.md (tabla markdown de las últimas operaciones).

Más endpoints y significados de campos: consulta references/endpoints.md.

Cómo leer el flujo

• Los umbrales de ballena escalan con la liquidez: $500K+ al contado ($1M+ en futuros) para BTC, $1M+ al contado ($2M+ en futuros) para ETH, $400K+ al contado ($800K+ en futuros) para las principales monedas, $100K+ al contado ($200K+ en futuros) para todo lo demás. Una operación de ballena de $400K en una moneda pequeña es un evento más grande que $2M en BTC. En cadena, los swaps se registran desde $100K en Ethereum y $25K en Base y Arbitrum, pero las vistas sin clave tienen un piso más alto: /api/public/onchain-whales y whale_trades con source: dex muestran solo $250K+, mientras que la herramienta dedicada onchain_whales sirve el piso completo registrado.
• Los grupos son más importantes que las operaciones individuales. Múltiples operaciones grandes en la misma dirección en cuestión de minutos sugieren un posicionamiento coordinado. Una operación es la opinión de un solo operador.
• Las ballenas en contra de la tendencia son la pista más fuerte: compras grandes durante una liquidación indican que alguien con tamaño está entrando en contra de la multitud.
• La divergencia CEX vs DEX es importante: la acumulación en DEX sin compras en CEX a menudo precede al flujo en CEX; anota de qué línea proviene cada operación. En MCP, las filas de whale_trades llevan un campo source (cex|dex). En REST, la línea es el endpoint al que llamaste: /crypto-whales es solo CEX, /onchain-whales es solo DEX.
• Dirección del flujo neto: suma compras USD vs ventas USD en la ventana (whale_flow hace esto por hora). Reporta la división, no solo la dirección ("62% compras en 4h" es mejor que "las ballenas están comprando").
• Condiciones del mercado por operación: las filas REST de ballenas llevan un objeto marketConditions (financiación e interés abierto en todos los lugares EN EL MOMENTO DE LA OPERACIÓN). Ese es el contexto combinado que los agentes normalmente necesitan de un segundo proveedor: una compra de $4M realizada mientras la financiación era negativa es un hecho diferente a la misma compra con financiación extremadamente positiva. Cítalo cuando cambie la interpretación.

Reglas

• Los datos son historia descriptiva. Reporta lo que las ballenas HICIERON, nunca predigas qué hará el precio. Sin consejos.
• Solo BTC/USD se transmite en tiempo real en la vista gratuita. Cualquier otra moneda tiene un retraso de 15 minutos, EXCEPTO cualquier operación de $1M+, que se transmite en vivo para cualquier moneda. Trata las filas retrasadas como retrasadas y dilo. Las filas DEX sin clave tienen un piso de $250K en /api/public/onchain-whales y en el tape combinado whale_trades; indica de qué vista proviene un número.
• Siempre indica la ventana y la moneda que mediste ("últimas 24h, BTC, CEX+DEX").
• Compara la marca de tiempo de la fila más nueva con la hora actual; si la operación más reciente tiene horas de antigüedad, reporta el flujo como tranquilo desde entonces en lugar de presentar operaciones antiguas como "en este momento".
• Pocas filas no es un error: los pisos de la fuente gratuita significan que solo las operaciones del tamaño de ballenas se transmiten sin clave (BTC/USD desde $500K al contado, más cada operación de $1M+ en cualquier moneda en vivo), por lo que 8 filas en 24h significa 8 operaciones de ese tamaño, no un flujo roto. Nombra el piso cuando la cantidad de filas sea la historia. Si cada fila es de un solo lugar, dilo.