Holder Dataset Statistics
holder_statsGet statistics on token holder datasets: total tokens tracked, holder records, chains covered, last update. Free endpoint.
Instructions
Get statistics about the token holder dataset: total tokens tracked, total holder records, chains covered, last updated. Free endpoint.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/holders.ts:186-218 (handler)The 'holder_stats' tool handler — calls the free /api/v1/holders/stats endpoint and returns the JSON response with dataset statistics.
// ── Dataset stats ───────────────────────────────────────────────────── server.registerTool( "holder_stats", { title: "Holder Dataset Statistics", description: "Get statistics about the token holder dataset: total tokens tracked, " + "total holder records, chains covered, last updated. Free endpoint.", inputSchema: {}, }, async () => { const res = await apiGet<HolderStatsResponse>("/api/v1/holders/stats"); if (!res.ok) { return { content: [ { type: "text" as const, text: `API error (${res.status}): ${JSON.stringify(res.data)}`, }, ], isError: true, }; } return { content: [ { type: "text" as const, text: JSON.stringify(res.data, null, 2) }, ], }; }, ); - src/tools/holders.ts:21-26 (schema)TypeScript interface HolderStatsResponse defining the shape of the stats response (dataset, source, update_frequency, stats).
interface HolderStatsResponse { dataset: string; source: string; update_frequency: string; stats: Record<string, unknown>; } - src/tools/holders.ts:188-195 (registration)Registration of 'holder_stats' tool via server.registerTool(...) with title, description, empty inputSchema.
server.registerTool( "holder_stats", { title: "Holder Dataset Statistics", description: "Get statistics about the token holder dataset: total tokens tracked, " + "total holder records, chains covered, last updated. Free endpoint.", inputSchema: {}, - src/index.ts:51-51 (registration)Registration call to registerHolderTools(server) which wires all holder tools including holder_stats into the MCP server.
registerHolderTools(server);