고래 흐름 (Whale Flow)
실행된 고래 거래(지갑 전송이 아닌 체결 거래): 매수/매도 방향, 크기, 가격, 거래소, 발생 시점 — 15개 중앙화 거래소와 이더리움, 베이스, 아비트럼의 온체인 DEX 스왑을 병합한 데이터입니다.
데이터 소스 (순서대로)
- CoinLobster MCP가 연결되었는가? 해당 도구 사용 (정규화된 이름):
coinlobster:whale_trades(최근 거래; 인자:coin,sourcecex|dex|all,min_usd,limit) 및coinlobster:whale_flow(시간별 매수/매도 USD 버킷; 인자:coin,hours).whale_tape은whale_trades의 더 이상 사용되지 않는 별칭이며 기존 호출자를 위해 유지됩니다.whale_trades를 우선 사용하고,tools/list에 해당 이름만 표시되는 경우에만whale_tape으로 대체하세요. - 명명된 지갑 및 DEX 레인 (MCP):
coinlobster:onchain_whales(인자:chain,coin,min_usd,limit)는 이더리움, 베이스, 아비트럼에서 실행된 DEX 스왑을 반환하며 각각 지갑과 DEX 정보를 포함합니다.coinlobster:hl_whales(인자:coin,limit)는 지갑 주소를 포함한 하이퍼리퀴드 고래 체결 정보를 반환하고,coinlobster:hl_wallet(인자:address)은 해당 계정의 실시간 북(포지션, 레버리지, 순 방향)을 엽니다. 하이퍼리퀴드는 공개 피드가 체결의 양쪽 계정을 모두 명명하는 유일한 거래소이므로 HL 행은 CEX 행과 달리 추적 가능합니다. 숫자가 어떤 레인에서 왔는지 명시하세요. - MCP 없음: 키 없는 API 호출 (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"whale-flow-history는whale_flow도구의 REST 쌍둥이입니다. 시간별{ t, buyUsd, sellUsd, netUsd, count, price }행, 시간별 종가와 동일한 그리드의 흐름. 키 없이 7일(maxFreeHours), coinlobster.com 웹사이트 구독 시 30일(proHours)을 제공합니다. API 키는 이 REST 경로를 확장하지 않습니다. 에이전트 표면에서 30일 창은 개발자 플랜의whale_flowMCP 도구입니다.available: false는 해당 코인에 대해 기록된 고래 시간이 아직 없음을 의미합니다.coverage.hoursWithPrice는 창의 실제 가격이 있는 시간을 나타냅니다. - 파싱 없이 빠르게 읽기: https://coinlobster.com/crypto-whales.md 에서 가져오기 (최신 거래의 마크다운 테이블).
더 많은 엔드포인트와 필드 의미: references/endpoints.md 참조.
피드 읽는 방법
- 고래 임계값은 유동성에 따라 달라집니다: BTC 현물 $500K+(선물 $1M+), ETH 현물 $1M+(선물 $2M+), 주요 코인 현물 $400K+(선물 $800K+), 기타 모든 코인 현물 $100K+(선물 $200K+). 소형株에서 $400K 고래 거래는 BTC에서 $2M보다 더 큰 이벤트입니다. 온체인에서는 이더리움 $100K, 베이스 및 아비트럼 $25K부터 스왑이 기록되지만, 키 없는 뷰는 더 높은 기준으로 제한됩니다:
/api/public/onchain-whales및source: dex인whale_trades는 $250K+만 표시하는 반면, 전용onchain_whales도구는 전체 기록된 기준을 제공합니다. - 클러스터가 단일 거래보다 중요합니다. 몇 분 내에 여러 개의 대규모 동일 방향 거래는 조정된 포지셔닝을 시사합니다. 한 건의 거래는 한 트레이더의 의견입니다.
- 반대 추세 고래가 가장 강력한 신호입니다: 매도세 중 대규모 매수는 누군가가 규모를 가지고 군중에 맞서 개입하고 있음을 의미합니다.
- CEX vs DEX 차이는 중요합니다: CEX 구매 없이 DEX 축적은 종종 CEX 흐름보다 먼저 발생합니다. 각 거래가 어느 레인에서 왔는지 명시하세요. MCP에서
whale_trades행은source필드(cex|dex)를 전달합니다. REST에서는 레인이 호출한 엔드포인트입니다:/crypto-whales는 CEX 전용,/onchain-whales는 DEX 전용입니다. - 순 흐름 방향: 창 전체에 걸쳐 매수 USD와 매도 USD를 합산합니다(
whale_flow가 시간별로 이를 수행합니다). 방향만 말하지 않고 비율을 보고하세요 ("고래가 사고 있다"보다 "4시간 동안 62% 매수"가 낫습니다). - 거래별 시장 조건: REST 고래 거래 행은
marketConditions객체(거래 당시 각 거래소의 펀딩과 미결제약정)를 전달합니다. 이는 일반적으로 에이전트가 두 번째 공급자가 필요한 결합된 컨텍스트입니다: 펀딩이 마이너스일 때 체결된 $4M 매수는 극단적인 양의 펀딩에서 동일한 매수와 다른 사실입니다. 해석을 바꿀 때 이를 인용하세요.
규칙
- 데이터는 과거에 대한 설명입니다. 고래가 한 일을 보고하고, 가격이 어떻게 될지 절대 예측하지 마세요. 조언 금지.
- 무료 뷰에서는 BTC/USD만 실시간으로 제공됩니다. 다른 모든 코인은 15분 지연되며, 단 $1M+ 거래는 모든 코인에서 실시간으로 스트리밍됩니다. 지연된 행은 지연되었다고 말하고 그렇게 명시하세요. 키 없는 DEX 행은
/api/public/onchain-whales와 병합된whale_trades테이프에서 $250K 이상으로 제한됩니다. 숫자가 어떤 뷰에서 왔는지 명시하세요. - 항상 측정한 창과 코인을 명시하세요 ("최근 24시간, BTC, CEX+DEX").
- 최신 행의 타임스탬프를 현재 시간과 확인하세요. 가장 최근 거래가 몇 시간 전이라면, 오래된 거래를 "지금"으로 제시하지 말고 피드가 그 이후로 조용하다고 보고하세요.
- 적은 행 수는 오류가 아닙니다: 무료 피드 기준선으로 인해 키 없이는 고래 규모 거래만 스트리밍되므로 (BTC/USD는 현물 $500K부터, 모든 코인의 $1M+ 거래는 실시간), 24시간에 8행은 그 크기의 거래 8건을 의미하며, 깨진 피드가 아닙니다. 행 수가 스토리일 때 기준선을 명시하세요. 모든 행이 하나의 거래소에서 나온 경우 그렇게 말하세요.