live_cohort_bias_history
Retrieve historical cohort bias data for any coin to see hourly net-bias snapshots across tiers. Answers which smart-money cohorts were accumulating or exiting.
Instructions
Get historical cohort bias data for a specific coin. Use this when a user asks 'were smart-money cohorts accumulating or exiting?' or 'which tier flipped first?'. Returns hourly net-bias snapshots for each tier or for a specific tier over time.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| useToonFormat | No | Return data in compact toon format (default: true). Set to false for standard JSON. | |
| coin | Yes | Coin symbol (e.g. BTC, ETH, SOL) | |
| tierType | No | Tier category: 'pnl' for profit tiers, 'size' for volume tiers | pnl |
| tier | No | Specific tier to track. Omit for all tiers in the category. | |
| hours | No | Number of hours of history (default 168 = 7 days, max 720 = 30 days) |
Implementation Reference
- src/index.ts:1047-1067 (registration)Registration of tool 'live_cohort_bias_history' on the MCP server. It registers the tool name, description, input schema (coin, tierType, tier, hours params), and the async handler that calls the backend API at /live/cohort-bias-history/{coin}.
// ══════════════════════════════════════════════════════════ // TOOL 38: Cohort Bias History // ══════════════════════════════════════════════════════════ if (shouldRegister("live_cohort_bias_history")) server.registerTool( "live_cohort_bias_history", { description: "Get historical cohort bias data for a specific coin. Use this when a user asks 'were smart-money cohorts accumulating or exiting?' or 'which tier flipped first?'. Returns hourly net-bias snapshots for each tier or for a specific tier over time.", inputSchema: { useToonFormat: useToonFormatSchema, coin: z.string().min(1).max(20).describe("Coin symbol (e.g. BTC, ETH, SOL)"), tierType: z.enum(["pnl", "size"]).default("pnl").describe("Tier category: 'pnl' for profit tiers, 'size' for volume tiers"), tier: tierSchema.optional().describe("Specific tier to track. Omit for all tiers in the category."), hours: z.number().min(1).max(720).default(168).describe("Number of hours of history (default 168 = 7 days, max 720 = 30 days)"), }, }, async ({ useToonFormat, coin, tierType, tier, hours }) => { const params: Record<string, string> = { hours: String(hours), tierType }; if (tier) params.tier = tier; return toolResult(await callAPI(useToonFormat, `/live/cohort-bias-history/${coin.toUpperCase()}`, params)); } ); - src/index.ts:1053-1060 (schema)Input schema for live_cohort_bias_history: coin (string 1-20 chars), tierType (enum 'pnl'|'size' with default 'pnl'), tier (optional tierSchema enum), hours (number 1-720, default 168).
description: "Get historical cohort bias data for a specific coin. Use this when a user asks 'were smart-money cohorts accumulating or exiting?' or 'which tier flipped first?'. Returns hourly net-bias snapshots for each tier or for a specific tier over time.", inputSchema: { useToonFormat: useToonFormatSchema, coin: z.string().min(1).max(20).describe("Coin symbol (e.g. BTC, ETH, SOL)"), tierType: z.enum(["pnl", "size"]).default("pnl").describe("Tier category: 'pnl' for profit tiers, 'size' for volume tiers"), tier: tierSchema.optional().describe("Specific tier to track. Omit for all tiers in the category."), hours: z.number().min(1).max(720).default(168).describe("Number of hours of history (default 168 = 7 days, max 720 = 30 days)"), }, - src/index.ts:1062-1066 (handler)Handler function for live_cohort_bias_history. Constructs params with hours and tierType, optionally includes tier, then calls the Coinversa API at /live/cohort-bias-history/{coin} with those query params.
async ({ useToonFormat, coin, tierType, tier, hours }) => { const params: Record<string, string> = { hours: String(hours), tierType }; if (tier) params.tier = tier; return toolResult(await callAPI(useToonFormat, `/live/cohort-bias-history/${coin.toUpperCase()}`, params)); }