whale_movements
Track large cryptocurrency wallet movements to identify significant inflows, outflows, and transfers that may signal market trends. Filter by blockchain, token, and time period for actionable insights.
Instructions
Get large balance changes across whale wallets. Shows significant inflows, outflows, and transfers that may signal market moves. Cost: $0.04 per query. Source: On-chain analytics.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Filter by blockchain network | |
| min_usd | No | Minimum movement size in USD | |
| token | No | Filter by token symbol | |
| hours | No | Lookback period in hours (default 24, max 168) | |
| limit | No | Maximum results (default 25) |
Implementation Reference
- src/tools/whales.ts:178-208 (handler)The handler implementation for the `whale_movements` tool, which fetches data from the API endpoint `/api/v1/whales/movements`.
async ({ chain, min_usd, token, hours, limit }) => { const res = await apiGet<WhaleQueryResponse>("/api/v1/whales/movements", { chain, min_usd, token, hours: hours ?? 24, limit: limit ?? 25, }); if (!res.ok) { return { content: [ { type: "text" as const, text: `API error (${res.status}): ${JSON.stringify(res.data)}`, }, ], isError: true, }; } const { count, data } = res.data; const warn = stalenessWarning(res); const summary = `${warn}Found ${count} whale movement(s).`; const json = JSON.stringify(data, null, 2); return { content: [{ type: "text" as const, text: `${summary}\n\n${json}` }], }; }, ); - src/tools/whales.ts:141-177 (schema)The schema and tool definition for `whale_movements`.
server.registerTool( "whale_movements", { title: "Whale Movements", description: "Get large balance changes across whale wallets. Shows significant inflows, " + "outflows, and transfers that may signal market moves. " + "Cost: $0.04 per query. Source: On-chain analytics.", inputSchema: { chain: z .enum(["ethereum", "arbitrum", "polygon", "base", "bsc"]) .optional() .describe("Filter by blockchain network"), min_usd: z .number() .optional() .describe("Minimum movement size in USD"), token: z .string() .optional() .describe("Filter by token symbol"), hours: z .number() .int() .min(1) .max(168) .optional() .describe("Lookback period in hours (default 24, max 168)"), limit: z .number() .int() .min(1) .max(100) .optional() .describe("Maximum results (default 25)"), }, }, - src/tools/whales.ts:141-208 (registration)Registration of the `whale_movements` tool within the MCP server.
server.registerTool( "whale_movements", { title: "Whale Movements", description: "Get large balance changes across whale wallets. Shows significant inflows, " + "outflows, and transfers that may signal market moves. " + "Cost: $0.04 per query. Source: On-chain analytics.", inputSchema: { chain: z .enum(["ethereum", "arbitrum", "polygon", "base", "bsc"]) .optional() .describe("Filter by blockchain network"), min_usd: z .number() .optional() .describe("Minimum movement size in USD"), token: z .string() .optional() .describe("Filter by token symbol"), hours: z .number() .int() .min(1) .max(168) .optional() .describe("Lookback period in hours (default 24, max 168)"), limit: z .number() .int() .min(1) .max(100) .optional() .describe("Maximum results (default 25)"), }, }, async ({ chain, min_usd, token, hours, limit }) => { const res = await apiGet<WhaleQueryResponse>("/api/v1/whales/movements", { chain, min_usd, token, hours: hours ?? 24, limit: limit ?? 25, }); if (!res.ok) { return { content: [ { type: "text" as const, text: `API error (${res.status}): ${JSON.stringify(res.data)}`, }, ], isError: true, }; } const { count, data } = res.data; const warn = stalenessWarning(res); const summary = `${warn}Found ${count} whale movement(s).`; const json = JSON.stringify(data, null, 2); return { content: [{ type: "text" as const, text: `${summary}\n\n${json}` }], }; }, );