Whale Flow / 鯨の流れ

鯨の流れ は何をしますか？

執行されたクジラのトレード（ウォレット送金ではありません）：売買方向、サイズ、価格、取引所、発生した瞬間を、15の中央集権取引所（CEX）とEthereum・Base・Arbitrum上のオンチェーンDEXスワップにまたがって統合して表示します。

データソース（優先順）

1. CoinLobster MCPが接続されている場合？ そのツールを完全修飾名で使用します：coinlobster:whale_trades（最近のトレード；引数：coin、source cex|dex|all、min_usd、limit）、およびcoinlobster:whale_flow（1時間ごとの買い/売りUSDバケット；引数：coin、hours）。whale_tapeはwhale_tradesの非推奨エイリアスであり、既存の呼び出し元のために動作し続けています。whale_tradesを推奨し、tools/listがその名前のみを表示する場合にのみwhale_tapeにフォールバックします。
2. 名前付きウォレットおよびDEXレーン（MCP）。 coinlobster:onchain_whales（引数：chain、coin、min_usd、limit）は、Ethereum、Base、Arbitrum上で執行されたDEXスワップを返し、各行にはウォレットとDEXが含まれます。coinlobster:hl_whales（引数：coin、limit）は、ウォレットアドレス付きのHyperliquidクジラ約定を返し、coinlobster:hl_wallet（引数：address）はそのアカウントのライブブック（ポジション、レバレッジ、ネットバイアス）を開きます。Hyperliquidは、公開フィードが約定の両側のアカウントを名前で示す唯一の取引所であるため、HLの行はCEXの行とは異なり追跡可能です。数値がどのレーンから来たかを明示してください。
3. MCPなし：キー不要のAPIをcurlで呼び出す（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"
   

   キー不要の場合、3つのトレードフィードの測定ウィンドウは返された行の範囲になります。最小/最大タイムスタンプから計算して明示してください。whale-flow-historyはwhale_flowツールのREST版です：1時間ごとの{ t, buyUsd, sellUsd, netUsd, count, price }行、時間足の終値と同じグリッド上のフロー。無料（maxFreeHours）で7日間、coinlobster.comウェブサイトのサブスクリプションで30日間（proHours）取得可能。APIキーはこのRESTルートを拡張しません。エージェント画面では30日間ウィンドウは開発者プランのwhale_flow MCPツールです。available: falseは、そのコインに記録されたクジラの時間がないことを意味します。coverage.hoursWithPriceは、ウィンドウのうち実際に価格が存在する割合を示します。
4. 解析せずにクイックリード： https://coinlobster.com/crypto-whales.md を取得（最新トレードのマークダウンテーブル）。

その他のエンドポイントとフィールドの意味については、references/endpoints.mdを参照してください。

フィードの読み方

• クジラの閾値は流動性に応じて変化します： BTCで50万ドル以上のスポット（100万ドル以上の先物）、ETHで100万ドル以上のスポット（200万ドル以上の先物）、主要通貨で40万ドル以上のスポット（80万ドル以上の先物）、その他すべてで10万ドル以上のスポット（20万ドル以上の先物）。小型株での40万ドルのクジラトレードは、BTCでの200万ドルよりも大きなイベントです。オンチェーンでは、スワップはEthereumで10万ドル、BaseとArbitrumで2万5千ドルから記録されますが、キー不要ビューはより高いフロアで切り捨てられます：/api/public/onchain-whalesおよびwhale_trades（source: dex）は25万ドル以上のみ表示しますが、専用のonchain_whalesツールは記録された完全なフロアを提供します。
• クラスターは単一トレードよりも重要です。 数分以内に複数の大規模な同一方向のトレードは、協調的なポジショニングを示唆します。1回のトレードは1人のトレーダーの意見です。
• カウンタートレンドのクジラが最も強いシグナルです： 売り浴びせの中での大口買いは、誰かが群衆に逆らって参入していることを意味します。
• CEX対DEXの乖離に注目： CEXの買いを伴わないDEXの蓄積は、しばしばCEXフローに先行します。各トレードがどのレーンから来たかを注記してください。MCPでは、whale_trades行にはsourceフィールド（cex|dex）が含まれます。RESTでは、レーンは呼び出したエンドポイントで決まります：/crypto-whalesはCEXのみ、/onchain-whalesはDEXのみです。
• ネットフローの方向： ウィンドウ全体の買いUSDと売りUSDを合計します（whale_flowはこれを1時間ごとに行います）。単なる方向だけでなく、内訳を報告してください（「クジラが買っている」よりも「4時間で62%が買い」の方が優れています）。
• トレードごとの市場状況： RESTのクジラトレード行にはmarketConditionsオブジェクト（トレード時の各取引所の資金調達レートと建玉）が含まれます。これは、エージェントが通常別のプロバイダーを必要とする結合コンテキストです：資金調達レートがマイナスのときに取引された400万ドルの買いは、同じ買いが極端なプラスの資金調達レートで行われた場合とは異なる事実です。それが読み解き方を変える場合には引用してください。

ルール

• データは記述的な履歴です。クジラが何をしたかを報告し、価格がどうなるかを予測してはいけません。助言は一切行いません。
• 無料ビューでリアルタイムにストリーミングされるのはBTC/USDのみです。他のすべてのコインは15分遅延です。ただし、100万ドル以上のトレードはどのコインでもリアルタイムでストリーミングされます。遅延行は遅延しているものとして扱い、その旨を明示してください。キー不要のDEX行は、/api/public/onchain-whalesおよび統合されたwhale_tradesテープでは25万ドルで切り捨てられます。数値がどのビューから来たかを明示してください。
• 常に測定したウィンドウとコインを明示してください（「過去24時間、BTC、CEX+DEX」）。
• 最新行のタイムスタンプを現在時刻と比較し、最新のトレードが数時間前であれば、古いトレードを「今」として提示するのではなく、それ以降フィードが静かであると報告してください。
• 行数が少ないことはエラーではありません：無料フィードのフロアにより、キー不要でストリーミングされるのはクジラサイズのトレードのみ（BTC/USDはスポット50万ドルから、さらにすべてのコインで100万ドル以上のトレードはリアルタイム）であるため、24時間で8行はそのサイズのトレードが8回あったことを意味し、フィードの故障ではありません。行数がストーリーの中心である場合は、そのフロアを明示してください。すべての行が1つの取引所からのものであれば、その旨を明示してください。