pulse_cohort_history
Track daily aggregate PnL, trade count, and activity for a trader cohort. Identify trends like increasing bearishness over time.
Instructions
Get historical performance data for a specific trader cohort over time. Shows how a tier's aggregate PnL, trade count, and activity have changed day-by-day. Use to spot trends like 'smart_money has been increasingly bearish over the last month.'
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| useToonFormat | No | Return data in compact toon format (default: true). Set to false for standard JSON. | |
| tierType | Yes | Tier category: 'pnl' for profit tiers, 'size' for volume tiers | |
| tier | Yes | Tier name. PnL tiers: money_printer, smart_money, grinder, humble_earner, exit_liquidity, semi_rekt, full_rekt, giga_rekt. Size tiers: leviathan, tidal_whale, whale, small_whale, apex_predator, dolphin, fish, shrimp | |
| days | No | Number of days of history to return |
Implementation Reference
- src/index.ts:835-850 (handler)The tool registration and handler for 'pulse_cohort_history'. It takes useToonFormat, tierType (pnl|size), tier, and days parameters, then calls the API at /pulse/cohorts/{tierType}/{tier}/history with the days parameter.
if (shouldRegister("pulse_cohort_history")) server.registerTool( "pulse_cohort_history", { description: "Get historical performance data for a specific trader cohort over time. Shows how a tier's aggregate PnL, trade count, and activity have changed day-by-day. Use to spot trends like 'smart_money has been increasingly bearish over the last month.'", inputSchema: { useToonFormat: useToonFormatSchema, tierType: z.enum(["pnl", "size"]).describe("Tier category: 'pnl' for profit tiers, 'size' for volume tiers"), tier: tierSchema, days: z.number().min(1).max(365).default(30).describe("Number of days of history to return"), }, }, async ({ useToonFormat, tierType, tier, days }) => toolResult( await callAPI(useToonFormat, `/pulse/cohorts/${tierType}/${tier}/history`, { days: String(days) }) ) ); - src/index.ts:839-844 (schema)Input schema for pulse_cohort_history: useToonFormat (boolean), tierType (enum pnl|size), tier (enum of all tier names), days (number 1-365, default 30).
inputSchema: { useToonFormat: useToonFormatSchema, tierType: z.enum(["pnl", "size"]).describe("Tier category: 'pnl' for profit tiers, 'size' for volume tiers"), tier: tierSchema, days: z.number().min(1).max(365).default(30).describe("Number of days of history to return"), },