Binance Cryptocurrency MCP

Implementation Reference

• src/index.ts:183-205 (handler)

  Handler function for the 'get_ui_klines' tool. Fetches UI K-line (candlestick) data from the Binance API endpoint '/api/v3/uiKlines' using axios, with parameters passed from input args, and returns the JSON response or error message.

  async (args: { symbol: string; interval: string; startTime?: number; endTime?: number; timeZone?: string; limit?: number }) => {
      try {
          const response = await axios.get(`${BASE_URL}/api/v3/uiKlines`, {
              params: {
                  symbol: args.symbol,
                  interval: args.interval,
                  startTime: args.startTime,
                  endTime: args.endTime,
                  timeZone: args.timeZone,
                  limit: args.limit
              },
              proxy: getProxy(),
          });
          return {
              content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }]
          };
      } catch (error: any) {
          return {
              content: [{ type: "text", text: `Failed to get UI K-line data: ${error.message}` }],
              isError: true
          };
      }
  }

• src/index.ts:175-182 (schema)

  Zod input schema defining parameters for the 'get_ui_klines' tool: symbol, interval, optional startTime, endTime, timeZone, and limit.

  {
      symbol: z.string().describe("Trading pair symbol, e.g. BTCUSDT"),
      interval: z.string().describe("K-line interval, e.g. 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M"),
      startTime: z.number().optional().describe("Start timestamp (milliseconds)"),
      endTime: z.number().optional().describe("End timestamp (milliseconds)"),
      timeZone: z.string().optional().describe("Time zone, default UTC"),
      limit: z.number().optional().describe("Number of K-lines to return, default 500, max 1000")
  },

• src/index.ts:173-206 (registration)

  Registration of the 'get_ui_klines' tool on the MCP server using server.tool(name, schema, handler), within the registerTools function.

  server.tool(
      "get_ui_klines",
      {
          symbol: z.string().describe("Trading pair symbol, e.g. BTCUSDT"),
          interval: z.string().describe("K-line interval, e.g. 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M"),
          startTime: z.number().optional().describe("Start timestamp (milliseconds)"),
          endTime: z.number().optional().describe("End timestamp (milliseconds)"),
          timeZone: z.string().optional().describe("Time zone, default UTC"),
          limit: z.number().optional().describe("Number of K-lines to return, default 500, max 1000")
      },
      async (args: { symbol: string; interval: string; startTime?: number; endTime?: number; timeZone?: string; limit?: number }) => {
          try {
              const response = await axios.get(`${BASE_URL}/api/v3/uiKlines`, {
                  params: {
                      symbol: args.symbol,
                      interval: args.interval,
                      startTime: args.startTime,
                      endTime: args.endTime,
                      timeZone: args.timeZone,
                      limit: args.limit
                  },
                  proxy: getProxy(),
              });
              return {
                  content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }]
              };
          } catch (error: any) {
              return {
                  content: [{ type: "text", text: `Failed to get UI K-line data: ${error.message}` }],
                  isError: true
              };
          }
      }
  );

• src/index.ts:403-412 (helper)

  Utility function getProxy() that configures proxy settings from proxyURL environment variable, used in the axios requests for all tools including get_ui_klines.

  function getProxy():any {
      const proxy: any = {}
      if (proxyURL) {
          const urlInfo = new URL(proxyURL);
          proxy.host = urlInfo.hostname;
          proxy.port = urlInfo.port;
          proxy.protocol = urlInfo.protocol.replace(":", "");
      }
      return proxy
  }