live_liquidation_heatmap

Instructions

Implementation Reference

• src/index.ts:544-565 (registration)

  Registration of the live_liquidation_heatmap tool with the MCP server, including its input schema (coin, buckets, range) and handler that calls the API at /live/liquidation-heatmap/{coin}

  // ══════════════════════════════════════════════════════════
  // TOOL 14: Liquidation Heatmap
  // ══════════════════════════════════════════════════════════
  if (shouldRegister("live_liquidation_heatmap")) server.registerTool(
    "live_liquidation_heatmap",
    {
      description: "Get a liquidation heatmap for any coin. Shows where liquidation clusters are across price levels — essential for identifying support/resistance and potential squeeze zones. Unique data nobody else exposes.",
      inputSchema: {
        useToonFormat: useToonFormatSchema,
        coin: z.string().min(1).max(20).describe("Coin symbol (e.g. BTC, ETH, SOL). For builder dex markets use prefix:COIN (e.g. xyz:SILVER, km:OIL, cash:TSLA)"),
        buckets: z.number().min(10).max(100).default(50).describe("Number of price buckets in the heatmap"),
        range: z.number().min(1).max(50).default(30).describe("Price range percentage around current price"),
      },
    },
    async ({ useToonFormat, coin, buckets, range }) =>
      toolResult(
        await callAPI(useToonFormat, `/live/liquidation-heatmap/${normalizeCoin(coin)}`, {
          buckets: String(buckets),
          range: String(range),
        })
      )
  );

• src/index.ts:549-556 (schema)

  Input schema defining the tool's parameters: coin (required string), buckets (10-100, default 50), range (1-50%, default 30), and optional useToonFormat

  {
    description: "Get a liquidation heatmap for any coin. Shows where liquidation clusters are across price levels — essential for identifying support/resistance and potential squeeze zones. Unique data nobody else exposes.",
    inputSchema: {
      useToonFormat: useToonFormatSchema,
      coin: z.string().min(1).max(20).describe("Coin symbol (e.g. BTC, ETH, SOL). For builder dex markets use prefix:COIN (e.g. xyz:SILVER, km:OIL, cash:TSLA)"),
      buckets: z.number().min(10).max(100).default(50).describe("Number of price buckets in the heatmap"),
      range: z.number().min(1).max(50).default(30).describe("Price range percentage around current price"),
    },

• src/index.ts:558-565 (handler)

  Handler function that calls the Coinversa public API at /live/liquidation-heatmap/{coin} with buckets and range as query parameters, returning the result formatted as tool content

    async ({ useToonFormat, coin, buckets, range }) =>
      toolResult(
        await callAPI(useToonFormat, `/live/liquidation-heatmap/${normalizeCoin(coin)}`, {
          buckets: String(buckets),
          range: String(range),
        })
      )
  );