MCP Bitget Trading Server

Instructions

Implementation Reference

• src/server.ts:340-351 (handler)

  MCP tool handler for getOrderBook: parses input with schema, calls BitgetRestClient.getOrderBook, returns JSON response

  case 'getOrderBook': {
    const { symbol, depth = 20 } = GetOrderBookSchema.parse(args);
    const orderBook = await this.bitgetClient.getOrderBook(symbol, depth);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(orderBook, null, 2),
        },
      ],
    } as CallToolResult;
  }

• src/server.ts:126-136 (registration)

  Tool registration in ListTools handler: defines name, description, and input schema for getOrderBook

    name: 'getOrderBook',
    description: 'Get order book (market depth) for a trading pair',
    inputSchema: {
      type: 'object',
      properties: {
        symbol: { type: 'string', description: 'Trading pair symbol' },
        depth: { type: 'number', description: 'Order book depth (default: 20)' }
      },
      required: ['symbol']
    },
  },

• src/types/mcp.ts:17-20 (schema)

  Zod schema for validating getOrderBook tool input parameters

  export const GetOrderBookSchema = z.object({
    symbol: z.string().describe('Trading pair symbol (BTCUSDT for spot, BTCUSDT_UMCBL for futures)'),
    depth: z.number().optional().describe('Order book depth (default: 20)')
  });

• src/api/rest-client.ts:411-460 (helper)

  Core implementation of getOrderBook in BitgetRestClient: handles spot/futures detection, caching, API requests to Bitget endpoints, parses order book data

  async getOrderBook(symbol: string, depth: number = 20): Promise<OrderBook> {
    const cacheKey = `orderbook:${symbol}:${depth}`;
    
    // Try cache first
    const cachedOrderBook = orderbookCache.get(cacheKey);
    if (cachedOrderBook) {
      return cachedOrderBook;
    }
  
    let orderBook: OrderBook = {
      symbol: '',
      bids: [],
      asks: [],
      timestamp: 0
    };
    
    if (this.isFuturesSymbol(symbol)) {
      // Futures orderbook
      const futuresSymbol = symbol.includes('_UMCBL') ? symbol : `${symbol}_UMCBL`;
      const response = await this.request<any>('GET', '/api/mix/v1/market/depth', { 
        symbol: futuresSymbol,
        limit: depth.toString()
      });
      
      orderBook = {
        symbol: futuresSymbol,
        bids: response.data?.bids || [],
        asks: response.data?.asks || [],
        timestamp: response.data?.timestamp || Date.now()
      };
    } else {
      // Spot orderbook
      const response = await this.request<any>('GET', '/api/v2/spot/market/orderbook', { 
        symbol, 
        type: 'step0',
        limit: depth.toString()
      });
      
      orderBook = {
        symbol,
        bids: response.data?.bids || [],
        asks: response.data?.asks || [],
        timestamp: response.data?.ts || Date.now()
      };
    }
    
    // Cache the result
    orderbookCache.set(cacheKey, orderBook);
    return orderBook;
  }