Verilex Data

Instructions

Implementation Reference

• src/tools/whales.ts:114-136 (handler)

  The handler for the lookup_whale tool, which fetches details for a specific whale address from the API.

  async ({ address }) => {
    const res = await apiGet<{ dataset: string; data: Record<string, unknown> }>(
      `/api/v1/whales/${encodeURIComponent(address)}`,
    );
  
    if (!res.ok) {
      const msg =
        res.status === 404
          ? `Whale wallet ${address} not found.`
          : `API error (${res.status}): ${JSON.stringify(res.data)}`;
      return {
        content: [{ type: "text" as const, text: msg }],
        isError: res.status !== 404,
      };
    }
  
    const warn = stalenessWarning(res);
    return {
      content: [
        { type: "text" as const, text: `${warn}${JSON.stringify(res.data.data, null, 2)}` },
      ],
    };
  },

• src/tools/whales.ts:102-113 (schema)

  The input schema and tool definition for lookup_whale.

  {
    title: "Lookup Whale Wallet",
    description:
      "Get full detail for a single whale wallet by address. Returns balance history, " +
      "token holdings, recent transactions, and PnL metrics. " +
      "Cost: $0.02 per query. Source: On-chain analytics.",
    inputSchema: {
      address: z
        .string()
        .describe("Wallet address (e.g. 0x...)"),
    },
  },

• src/tools/whales.ts:100-101 (registration)

  The registration of the lookup_whale tool within the server.

  server.registerTool(
    "lookup_whale",