crypto-orderbook-mcp

Integrations

  • Analyzes order book depth and imbalance for cryptocurrency trading pairs on Binance, providing real-time market structure insights.

  • Retrieves and analyzes order book metrics for cryptocurrency trading pairs on Coinbase, enabling cross-exchange comparison of market depth.

  • Formats order book comparison data across multiple exchanges as Markdown tables for clear visualization and analysis.

Crypto Orderbook MCP

An MCP server that analyzes order book depth and imbalance across major crypto exchanges, empowering AI agents and trading systems with real-time market structure insights.

Features

  • Order Book Metrics: Calculate bid/ask depth and imbalance for a specified trading pair on a given exchange.
  • Cross-Exchange Comparison: Compare order book depth and imbalance across multiple exchanges in a unified Markdown table.
  • Supported Exchanges: Binance, Kraken, Coinbase, Bitfinex, Okx, Bybit

Installation

Prerequisites

  • Python 3.10 or higher
  • uv (Python package and project manager)

Setup

  1. Clone the Repository
    git clone https://github.com/kukapay/crypto-orderbook-mcp.git cd crypto-orderbook-mcp
  2. Install DependenciesUse uv to install the required packages:
    uv sync
  3. Configure the MCP Client(Claude Desktop)
    "mcpServers": { "crypto-orderbook-mcp": { "command": "uv", "args": [ "--directory", "/absolute/path/to/crypto-orderbook-mcp", "run", "main.py" ] } }

Usage

The server provides two main tools:

  1. calculate_orderbook: Computes bid depth, ask depth, and imbalance for a trading pair on a specified exchange.
  2. compare_orderbook: Compares bid depth, ask depth, and imbalance across multiple exchanges, returning a Markdown table.

Example: Calculate Order Book Metrics

Prompt: "Calculate the order book metrics for BTC/USDT on Binance with a 1% depth range."

Expected Output (JSON object):

{ "exchange": "binance", "symbol": "BTC/USDT", "bid_depth": 123.45, "ask_depth": 234.56, "imbalance": 0.1234, "mid_price": 50000.0, "timestamp": 1698765432000 }

Example: Compare Order Book Across Exchanges

Prompt: "Compare the order book metrics for BTC/USDT across Binance, Kraken, and OKX with a 1% depth range."

Expected Output (Markdown table):

| exchange | bid_depth | ask_depth | imbalance | |----------|-----------|-----------|-----------| | binance | 123.45 | 234.56 | 0.1234 | | kraken | 89.12 | 178.34 | 0.0987 | | okx | 145.67 | 256.78 | 0.1345 |

License

This project is licensed under the MIT License. See the LICENSE file for details.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

crypto-orderbook-mcp

  1. Features
    1. Installation
      1. Prerequisites
      2. Setup
    2. Usage
      1. Example: Calculate Order Book Metrics
      2. Example: Compare Order Book Across Exchanges
    3. License

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        An MCP server implementation that integrates with Hyperliquid exchange, providing access to crypto market data including mid prices, historical candles, and L2 order books.
        Last updated -
        3
        14
        5
        TypeScript
        MIT License

      View all related MCP servers

      ID: n8tp7eniu9