get_ui_klines
Fetch candlestick data for Binance trading pairs using specified intervals, timestamps, and time zones to analyze market trends and price movements.
Input 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 |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"endTime": {
"description": "End timestamp (milliseconds)",
"type": "number"
},
"interval": {
"description": "K-line interval, e.g. 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M",
"type": "string"
},
"limit": {
"description": "Number of K-lines to return, default 500, max 1000",
"type": "number"
},
"startTime": {
"description": "Start timestamp (milliseconds)",
"type": "number"
},
"symbol": {
"description": "Trading pair symbol, e.g. BTCUSDT",
"type": "string"
},
"timeZone": {
"description": "Time zone, default UTC",
"type": "string"
}
},
"required": [
"symbol",
"interval"
],
"type": "object"
}
Implementation Reference
- src/index.ts:183-205 (handler)The handler function that executes the get_ui_klines tool logic, fetching UI K-line/candlestick data from Binance API endpoint /api/v3/uiKlines.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 schema defining input parameters for the get_ui_klines tool.{ 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 in the MCP server using server.tool().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 }; } } );