CoinLobster/agent-skills

Flux des Baleines

Transactions exécutées par les baleines (pas de transferts de portefeuilles) : sens, taille, prix, plateforme, au moment où elles se produisent, fusionnées sur 15 exchanges centralisés et les swaps DEX on-chain sur Ethereum, Base et Arbitrum.

Sources de données (par ordre)

1. CoinLobster MCP connecté ? Utilisez ses outils, qualifiés complètement : coinlobster:whale_trades (transactions récentes ; arguments : coin, source cex|dex|all, min_usd, limit) et coinlobster:whale_flow (tranches horaires d'achat/vente en USD ; arguments : coin, hours). whale_tape est un alias obsolète de whale_trades maintenu pour les appelants existants ; préférez whale_trades, et ne revenez à whale_tape que si tools/list affiche uniquement ce nom.
2. Portefeuilles nommés et voies DEX (MCP). coinlobster:onchain_whales (arguments : chain, coin, min_usd, limit) retourne les swaps DEX exécutés sur Ethereum, Base et Arbitrum, chacun portant le portefeuille et le DEX. coinlobster:hl_whales (arguments : coin, limit) retourne les transactions des baleines sur Hyperliquid AVEC l'adresse du portefeuille, et coinlobster:hl_wallet (arguments : address) ouvre le carnet d'ordres vivant de ce compte (positions, effet de levier, biais net). Hyperliquid est la seule plateforme dont le flux public nomme le compte des deux côtés d'une transaction, donc une ligne HL est traçable comme une ligne CEX ne l'est pas. Indiquez de quelle voie provient un nombre.
3. Pas de MCP : utilisez l'API sans clé (GET uniquement, 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"
   

   Sans clé, la fenêtre de mesure des trois flux de transactions est celle couverte par les lignes retournées ; calculez-la à partir des timestamps min/max et indiquez-la. whale-flow-history est le jumeau REST de l'outil whale_flow : lignes horaires { t, buyUsd, sellUsd, netUsd, count, price }, flux sur la même grille que la clôture horaire, 7 jours sans clé (maxFreeHours), 30 (proHours) avec un abonnement au site coinlobster.com. Une clé API n'élargit pas cette route REST ; sur une surface d'agent, la fenêtre de 30 jours est l'outil MCP whale_flow d'un plan développeur. available: false signifie qu'il n'y a pas encore d'heures de baleine enregistrées pour cette pièce ; coverage.hoursWithPrice indique combien de la fenêtre a réellement un prix derrière.
4. Lecture rapide sans parsing : récupérez https://coinlobster.com/crypto-whales.md (tableau markdown des dernières transactions).

Plus de points d'accès et significations des champs : voir references/endpoints.md.

Comment lire le flux

• Les seuils des baleines s'adaptent à la liquidité : 500K$+ au comptant (1M$+ à terme) sur BTC, 1M$+ au comptant (2M$+ à terme) sur ETH, 400K$+ au comptant (800K$+ à terme) sur les majeures, 100K$+ au comptant (200K$+ à terme) sur tout le reste. Une transaction de baleine de 400K$ sur une petite capitalisation est un événement plus important qu'un 2M$ sur BTC. En on-chain, les swaps sont enregistrés à partir de 100K$ sur Ethereum et 25K$ sur Base et Arbitrum, mais les vues sans clé sont plafonnées plus haut : /api/public/onchain-whales et whale_trades avec source: dex ne montrent que 250K$+, tandis que l'outil dédié onchain_whales sert le plancher complet enregistré.
• Les clusters priment sur les transactions isolées. Plusieurs grosses transactions dans la même direction en quelques minutes suggèrent un positionnement coordonné. Une transaction est l'opinion d'un trader.
• Les baleines contra-tendance sont le signal le plus fort : de gros achats pendant une vente massive signifient que quelqu'un avec du volume intervient contre la foule.
• La divergence CEX vs DEX est importante : une accumulation sur DEX sans achat sur CEX précède souvent un flux CEX ; notez de quelle voie provient chaque transaction. Sur MCP, les lignes whale_trades portent un champ source (cex|dex). Via REST, la voie est le point d'accès que vous avez appelé : /crypto-whales est CEX uniquement, /onchain-whales est DEX uniquement.
• Direction nette du flux : somme des achats en USD vs ventes en USD sur la fenêtre (whale_flow le fait toutes les heures). Rapportez la répartition, pas seulement la direction ("62% d'achats sur 4h" bat "les baleines achètent").
• Conditions de marché par transaction : les lignes de transactions REST portent un objet marketConditions (financement et intérêt ouvert sur les plateformes AU MOMENT de la transaction). C'est le contexte combiné dont les agents ont généralement besoin d'un second fournisseur : un achat de 4M$ effectué alors que le financement était négatif est un fait différent du même achat avec un financement extrêmement positif. Citez-le lorsqu'il modifie la lecture.

Règles

• Les données sont historiques et descriptives. Rapportez ce que les baleines ONT FAIT, ne prédisez jamais ce que le prix va faire. Pas de conseil.
• Seul BTC/USD est en temps réel sur la vue gratuite. Chaque autre pièce a un délai de 15 minutes, SAUF les transactions de 1M$+, qui sont diffusées en direct sur n'importe quelle pièce. Traitez les lignes différées comme différées et dites-le. Les lignes DEX sans clé ont un plancher à 250K$ sur /api/public/onchain-whales et sur le flux fusionné whale_trades ; dites de quelle vue provient un nombre.
• Indiquez toujours la fenêtre et la pièce que vous avez mesurées ("dernières 24h, BTC, CEX+DEX").
• Vérifiez le timestamp de la ligne la plus récente par rapport à l'heure actuelle ; si la transaction la plus récente a plusieurs heures, rapportez que le flux est silencieux depuis ce moment plutôt que de présenter des transactions obsolètes comme "maintenant".
• Un petit nombre de lignes n'est pas une erreur : le plancher du flux gratuit signifie que seules les transactions de taille baleine passent sans clé (BTC/USD à partir de 500K$ au comptant, plus toutes les transactions de 1M$+ en direct), donc 8 lignes en 24h signifient 8 transactions de cette taille, pas un flux cassé. Nommez le plancher lorsque le nombre de lignes est l'histoire pertinente. Si chaque ligne provient d'une seule plateforme, dites-le.