pulse_cohort_positions
Retrieve real-time positions held by a specific trader cohort, such as top PnL or size tiers, for instant whale intelligence.
Instructions
See what a specific trader cohort is holding RIGHT NOW. For example, get all live positions held by 'money_printer' tier traders or 'leviathan' size wallets. This is real-time whale intelligence.
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 | |
| limit | No | Number of positions to return |
Implementation Reference
- src/index.ts:404-420 (registration)Registration of the pulse_cohort_positions tool. It registers a tool that fetches live positions held by a specific trader cohort (by PnL or size tier).
// ══════════════════════════════════════════════════════════ // TOOL 6: Cohort Positions (What whales are doing NOW) // ══════════════════════════════════════════════════════════ if (shouldRegister("pulse_cohort_positions")) server.registerTool( "pulse_cohort_positions", { description: "See what a specific trader cohort is holding RIGHT NOW. For example, get all live positions held by 'money_printer' tier traders or 'leviathan' size wallets. This is real-time whale intelligence.", inputSchema: { useToonFormat: useToonFormatSchema, tierType: z.enum(["pnl", "size"]).describe("Tier category: 'pnl' for profit tiers, 'size' for volume tiers"), tier: tierSchema, limit: z.number().min(1).max(200).default(50).describe("Number of positions to return"), }, }, async ({ useToonFormat, tierType, tier, limit }) => toolResult(await callAPI(useToonFormat, `/pulse/cohorts/${tierType}/${tier}/positions`, { limit: String(limit) })) ); - src/index.ts:418-419 (handler)Handler for pulse_cohort_positions. Calls the external API at /pulse/cohorts/{tierType}/{tier}/positions with a limit parameter, passing useToonFormat to optionally encode the result in toon format.
async ({ useToonFormat, tierType, tier, limit }) => toolResult(await callAPI(useToonFormat, `/pulse/cohorts/${tierType}/${tier}/positions`, { limit: String(limit) })) - src/index.ts:411-416 (schema)Input schema for pulse_cohort_positions: accepts useToonFormat (boolean), tierType (enum 'pnl'|'size'), tier (enum from tierSchema), and limit (number 1-200, default 50).
inputSchema: { useToonFormat: useToonFormatSchema, tierType: z.enum(["pnl", "size"]).describe("Tier category: 'pnl' for profit tiers, 'size' for volume tiers"), tier: tierSchema, limit: z.number().min(1).max(200).default(50).describe("Number of positions to return"), },