get_24hr_ticker

Implementation Reference

• src/index.ts:242-263 (handler)

  Handler function that fetches 24-hour price change statistics from Binance API endpoint /api/v3/ticker/24hr for a given symbol or multiple symbols, returns formatted JSON response or error message.

      try {
          let params = {};
          if (args.symbol) {
              params = { symbol: args.symbol };
          } else if (args.symbols) {
              params = { symbols: JSON.stringify(args.symbols) };
          }
  
          const response = await axios.get(`${BASE_URL}/api/v3/ticker/24hr`, {
              params,
              proxy: getProxy(),
          });
          return {
              content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }]
          };
      } catch (error: any) {
          return {
              content: [{ type: "text", text: `Failed to get 24hr price statistics: ${error.message}` }],
              isError: true
          };
      }
  }

• src/index.ts:238-241 (schema)

  Input schema for get_24hr_ticker tool using Zod, allowing optional single symbol or array of symbols.

      symbol: z.string().optional().describe("Trading pair symbol, e.g. BTCUSDT"),
      symbols: z.array(z.string()).optional().describe("Array of multiple trading pair symbols")
  },
  async (args: { symbol?: string; symbols?: string[] }) => {

• src/index.ts:236-264 (registration)

  Registration of the get_24hr_ticker tool in the registerTools function using McpServer.tool method.

      "get_24hr_ticker",
      {
          symbol: z.string().optional().describe("Trading pair symbol, e.g. BTCUSDT"),
          symbols: z.array(z.string()).optional().describe("Array of multiple trading pair symbols")
      },
      async (args: { symbol?: string; symbols?: string[] }) => {
          try {
              let params = {};
              if (args.symbol) {
                  params = { symbol: args.symbol };
              } else if (args.symbols) {
                  params = { symbols: JSON.stringify(args.symbols) };
              }
  
              const response = await axios.get(`${BASE_URL}/api/v3/ticker/24hr`, {
                  params,
                  proxy: getProxy(),
              });
              return {
                  content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }]
              };
          } catch (error: any) {
              return {
                  content: [{ type: "text", text: `Failed to get 24hr price statistics: ${error.message}` }],
                  isError: true
              };
          }
      }
  );