pulse_hidden_gems

Instructions

Implementation Reference

• src/index.ts:367-390 (registration)

  Registration of the 'pulse_hidden_gems' tool with input schema and handler. The tool discovers underrated high-performing traders by filtering on minWinRate, minPnl, minTrades, maxTrades, and limit. It calls the API endpoint /pulse/hidden-gems.

  if (shouldRegister("pulse_hidden_gems")) server.registerTool(
    "pulse_hidden_gems",
    {
      description: "Discover underrated high-performing traders who fly under the radar. Filters by minimum win rate, PnL, and trade count. These are skilled traders that most platforms don't surface.",
      inputSchema: {
        useToonFormat: useToonFormatSchema,
        minWinRate: z.number().default(60).describe("Minimum win rate percentage"),
        minPnl: z.number().default(10000).describe("Minimum total PnL in USD"),
        minTrades: z.number().default(50).describe("Minimum number of trades"),
        maxTrades: z.number().default(500).describe("Maximum number of trades (filters out well-known whales)"),
        limit: z.number().min(1).max(100).default(20).describe("Number of traders to return"),
      },
    },
    async ({ useToonFormat, minWinRate, minPnl, minTrades, maxTrades, limit }) =>
      toolResult(
        await callAPI(useToonFormat, "/pulse/hidden-gems", {
          minWinRate: String(minWinRate),
          minPnl: String(minPnl),
          minTrades: String(minTrades),
          maxTrades: String(maxTrades),
          limit: String(limit),
        })
      )
  );

• src/index.ts:371-378 (schema)

  Input schema for pulse_hidden_gems: useToonFormat (bool), minWinRate (number, default 60), minPnl (number, default 10000), minTrades (number, default 50), maxTrades (number, default 500), limit (number, 1-100, default 20).

  inputSchema: {
    useToonFormat: useToonFormatSchema,
    minWinRate: z.number().default(60).describe("Minimum win rate percentage"),
    minPnl: z.number().default(10000).describe("Minimum total PnL in USD"),
    minTrades: z.number().default(50).describe("Minimum number of trades"),
    maxTrades: z.number().default(500).describe("Maximum number of trades (filters out well-known whales)"),
    limit: z.number().min(1).max(100).default(20).describe("Number of traders to return"),
  },

• src/index.ts:380-390 (handler)

  Handler function for pulse_hidden_gems: validates inputs, then calls the Coinversa API at /pulse/hidden-gems with minWinRate, minPnl, minTrades, maxTrades, and limit as query parameters.

    async ({ useToonFormat, minWinRate, minPnl, minTrades, maxTrades, limit }) =>
      toolResult(
        await callAPI(useToonFormat, "/pulse/hidden-gems", {
          minWinRate: String(minWinRate),
          minPnl: String(minPnl),
          minTrades: String(minTrades),
          maxTrades: String(maxTrades),
          limit: String(limit),
        })
      )
  );