get_klines
Fetch historical candlestick (K-line) data for Binance trading pairs by specifying symbol, interval, and optional start/end times. Retrieve up to 1000 K-lines for analysis.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endTime | No | End timestamp (milliseconds) | |
| interval | Yes | K-line interval, e.g. 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M | |
| limit | No | Number of K-lines to return, default 500, max 1000 | |
| startTime | No | Start timestamp (milliseconds) | |
| symbol | Yes | Trading pair symbol, e.g. BTCUSDT | |
| timeZone | No | Time zone, default UTC |
Implementation Reference
- src/index.ts:147-169 (handler)Handler function that fetches K-line/candlestick data from Binance API endpoint /api/v3/klines, handles parameters, makes axios request with proxy, and returns JSON response or error.async (args: { symbol: string; interval: string; startTime?: number; endTime?: number; timeZone?: string; limit?: number }) => { try { const response = await axios.get(`${BASE_URL}/api/v3/klines`, { 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 K-line data: ${error.message}` }], isError: true }; } }
- src/index.ts:139-146 (schema)Zod input schema defining parameters for the get_klines tool: symbol (required), interval (required), and optional startTime, endTime, timeZone, 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:137-170 (registration)Registration of the get_klines tool in the registerTools function using McpServer.tool method, including schema and handler.server.tool( "get_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/klines`, { 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 K-line data: ${error.message}` }], isError: true }; } } );