order_book
Retrieve live order book for any trading pair. View top 20 bids and asks with spread to assess market depth and liquidity.
Instructions
Get live order book — top 20 bids and asks with spread. Shows market depth and liquidity.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Trading pair (BTC, ETHUSDT, etc.) |
Implementation Reference
- index.js:101-120 (handler)The 'getOrderBook' function that fetches live order book depth (bids/asks) from Binance API and returns formatted data including spread and mid-price.
async function getOrderBook(symbol) { const pair = symbol.toUpperCase().replace('/', ''); const formatted = pair.includes('USDT') ? pair : pair + 'USDT'; try { const data = await fetch( `https://api.binance.us/api/v3/depth?symbol=${formatted}&limit=20` ); return { symbol: formatted, bids: data.bids.map(b => ({ price: parseFloat(b[0]), quantity: parseFloat(b[1]) })), asks: data.asks.map(a => ({ price: parseFloat(a[0]), quantity: parseFloat(a[1]) })), spread: parseFloat(data.asks[0][0]) - parseFloat(data.bids[0][0]), spread_pct: ((parseFloat(data.asks[0][0]) - parseFloat(data.bids[0][0])) / parseFloat(data.bids[0][0]) * 100).toFixed(4) + '%', mid_price: (parseFloat(data.asks[0][0]) + parseFloat(data.bids[0][0])) / 2, }; } catch (e) { return { error: `Could not fetch order book for ${formatted}: ${e.message}` }; } } - index.js:261-271 (schema)Schema definition for the 'order_book' tool, defining the input schema with a required 'symbol' parameter.
{ name: 'order_book', description: 'Get live order book — top 20 bids and asks with spread. Shows market depth and liquidity.', inputSchema: { type: 'object', properties: { symbol: { type: 'string', description: 'Trading pair (BTC, ETHUSDT, etc.)' } }, required: ['symbol'] } }, - index.js:261-274 (registration)The 'order_book' tool is registered as part of the tool definitions list in the getToolDefinitions() method of the MCPMarketServer class.
{ name: 'order_book', description: 'Get live order book — top 20 bids and asks with spread. Shows market depth and liquidity.', inputSchema: { type: 'object', properties: { symbol: { type: 'string', description: 'Trading pair (BTC, ETHUSDT, etc.)' } }, required: ['symbol'] } }, { name: 'market_cap', description: 'Get top cryptocurrencies ranked by market cap with prices, volumes, and 24h changes.', - index.js:326-327 (handler)The dispatch case in handleToolCall that routes 'order_book' to the getOrderBook handler function.
case 'order_book': return await getOrderBook(args.symbol);