Bybit MCP Server

Instructions

Implementation Reference

• src/index.ts:722-736 (handler)

  Handler for the 'get_orderbook' tool. Extracts parameters from request and calls BybitService.getOrderbook, then returns the result as JSON text content.
  case 'get_orderbook': { const result = await this.bybitService.getOrderbook( typedArgs.category, typedArgs.symbol, typedArgs.limit ); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; }
• src/index.ts:63-85 (registration)

  Registration of the 'get_orderbook' tool including name, description, and input schema definition in the tools array passed to MCP server.
  { name: 'get_orderbook', description: 'Get orderbook data for a specific symbol', inputSchema: { type: 'object', properties: { category: { type: 'string', description: 'Category (spot, linear, inverse, etc.)', }, symbol: { type: 'string', description: 'Symbol (e.g., BTCUSDT)', }, limit: { type: 'number', description: 'Number of orderbook entries to retrieve', default: 50, }, }, required: ['category', 'symbol'], }, },
• src/bybit-service.ts:141-143 (helper)

  Core implementation of getOrderbook in BybitService class, which makes the HTTP request to Bybit's /v5/market/orderbook endpoint.
  async getOrderbook(category: string, symbol: string, limit: number = 50): Promise<BybitResponse<OrderbookData> | { error: string }> { return this.makeBybitRequest('/v5/market/orderbook', 'GET', { category, symbol, limit }); }
• src/types.ts:30-36 (schema)

  TypeScript interface defining the structure of the orderbook response data (output schema).
  export interface OrderbookData { symbol: string; bids: [string, string][]; asks: [string, string][]; ts: number; u: number; }
• src/index.ts:66-84 (schema)

  JSON Schema for input validation of the 'get_orderbook' tool parameters.
  inputSchema: { type: 'object', properties: { category: { type: 'string', description: 'Category (spot, linear, inverse, etc.)', }, symbol: { type: 'string', description: 'Symbol (e.g., BTCUSDT)', }, limit: { type: 'number', description: 'Number of orderbook entries to retrieve', default: 50, }, }, required: ['category', 'symbol'], },