Binance MCP

🚀 Binance MCP Server

Binance MCP Server is a toolset for interacting with the Binance API, supporting both REST API and WebSocket connections. It provides a series of commands that allow users to obtain market data, subscribe to real - time updates, and manage WebSocket streams.

🚀 Quick Start

The Binance MCP Server offers seamless interaction with the Binance API. It supports both REST API and WebSocket connections, enabling users to access market data, subscribe to real - time updates, and manage WebSocket streams efficiently.

✨ Features

Market Data

• Get the current price.
• Query historical data.
• Subscribe to K - line chart updates.

24 - hour Trading Statistics

• Price change percentage.
• Trading volume.
• Highest and lowest prices.

Real - time WebSocket Updates

• Subscribe to real - time trade information.
• Receive order book depth updates.
• Get the best bid and ask prices.

💻 Usage Examples

Basic Connectivity Check

# Check if the Binance API is reachable
is_connected = ping_binance()

# Get the current server time (epoch time in milliseconds)
server_time = get_server_time()

Get Current Market Data

# Get the current price of Bitcoin
btc_price = get_price(symbol="BTCUSDT")

# Query detailed 24 - hour trading statistics
btc_stats = get_24hr_ticker(symbol="BTCUSDT")
print(f"Bitcoin price change percentage: {btc_stats['priceChangePercent']}%")
print(f"Bitcoin 24 - hour trading volume: {btc_stats['volume']} BTC")

# Get rolling window statistics for a 4 - hour time window
btc_4h_stats = get_rolling_window_ticker(symbol="BTCUSDT", window_size="4h")
print(f"Bitcoin 4 - hour price change percentage: {btc_4h_stats['priceChangePercent']}%")

Manage WebSocket Streams

# Subscribe to real - time trade updates
trade_sub = subscribe_to_trade_stream(symbol="BTCUSDT")

# Get the latest trade data after some time
latest_trade = get_latest_stream_data(stream_name="btcusdt@trade")
print(f"Latest trade price: {latest_trade['data']['p']}")

# Subscribe to 5 - minute K - line chart updates
kline_sub = subscribe_to_kline_stream(symbol="ETHUSDT", interval="5m")

# Unsubscribe from all streams
unsubscribe_from_stream(stream_name="btcusdt@trade")
unsubscribe_from_stream(stream_name="ethusdt@kline_5m")

📚 Documentation

Project Structure

binance_mcp_server/  
├── binance_api.py       # Core REST API interaction module
├── binance_ws_api.py    # WebSocket connection management module
├── commands/            # MCP command definitions  
│   ├── __init__.py  
│   ├── market_data.py   # Commands for current price, historical data, and order book  
│   ├── market_info.py   # Commands for exchange information and metadata
│   └── websocket_streams.py  # Commands for WebSocket streams
└── server.py            # Main MCP server setup and initialization

Adding New Tools

To add new functionality, create corresponding functions in binance_api.py and register them as MCP tools in one of the command modules.

Supporting Private API Endpoints

To support authenticated API calls:

1. Modify binance_api.py to include authentication.
2. Create additional command modules for trading operations.
3. Register new commands in server.py.

🔧 Troubleshooting

• Connection issues: Ensure the server is running before attempting to connect the client.
• Rate limits: Binance may throttle excessive API calls, so handle them carefully.
• WebSocket connections: Check network status and proxy settings to ensure no interference.

📚 Glossary

• MCP: Machine Control Protocol
• REST API: HTTP - based programming interface
• WebSocket: Real - time full - duplex communication protocol

With the above introduction, users can comprehensively understand how to use the Binance MCP Server for market data interaction and management.