get_kline
Retrieve candlestick chart data for cryptocurrency trading analysis on Bybit. Specify symbol, time interval, and category to access historical price patterns for informed trading decisions.
Instructions
Get K-line (candlestick) data
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | Yes | Category (spot, linear, inverse, etc.) | |
| symbol | Yes | Symbol (e.g., BTCUSDT) | |
| interval | Yes | Time interval (1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, W, M) | |
| start | No | Start time in milliseconds | |
| end | No | End time in milliseconds | |
| limit | No | Number of records to retrieve |
Implementation Reference
- src/bybit-service.ts:145-157 (handler)Core handler function that executes the get_kline tool logic by making authenticated API request to Bybit's /v5/market/kline endpoint.
async getKline( category: string, symbol: string, interval: string, start?: number, end?: number, limit: number = 200 ): Promise<BybitResponse<KlineData> | { error: string }> { const params: any = { category, symbol, interval, limit }; if (start) params.start = start; if (end) params.end = end; return this.makeBybitRequest('/v5/market/kline', 'GET', params); } - src/index.ts:87-120 (schema)Input schema and registration for the get_kline tool in the MCP tools list.
name: 'get_kline', description: 'Get K-line (candlestick) data', inputSchema: { type: 'object', properties: { category: { type: 'string', description: 'Category (spot, linear, inverse, etc.)', }, symbol: { type: 'string', description: 'Symbol (e.g., BTCUSDT)', }, interval: { type: 'string', description: 'Time interval (1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, W, M)', }, start: { type: 'number', description: 'Start time in milliseconds', }, end: { type: 'number', description: 'End time in milliseconds', }, limit: { type: 'number', description: 'Number of records to retrieve', default: 200, }, }, required: ['category', 'symbol', 'interval'], }, }, - src/index.ts:738-755 (handler)MCP CallToolRequest handler case that invokes the BybitService.getKline method and formats the response.
case 'get_kline': { const result = await this.bybitService.getKline( typedArgs.category, typedArgs.symbol, typedArgs.interval, typedArgs.start, typedArgs.end, typedArgs.limit ); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; } - src/types.ts:38-42 (schema)TypeScript interface defining the structure of Kline data returned by the Bybit API.
export interface KlineData { symbol: string; category: string; list: [string, string, string, string, string, string, string][]; }