Skip to content

qeinfinity/binance-mcp-server

Repository files navigation

Binance MCP Server

A Model Context Protocol (MCP) server implementation for Binance market data with WebSocket support.

Features

  • Real-time market data streaming via WebSocket
  • Support for both spot and futures markets
  • Automatic reconnection with exponential backoff
  • Type-safe message handling
  • Comprehensive error handling

Installation

npm install

Usage

Starting the Server

npm start

WebSocket Stream Types

The following stream types are supported:

  • trade: Real-time trade data
  • ticker: 24-hour rolling window price change statistics
  • bookTicker: Best bid/ask price and quantity
  • kline: Candlestick data
  • markPrice: Mark price and funding rate (futures only)
  • fundingRate: Funding rate data (futures only)

Example Usage in Claude Desktop

// Subscribe to trade and ticker streams for BTC/USDT
await server.subscribe('BTCUSDT', 'spot', ['trade', 'ticker']);

// Handle incoming data
server.onStreamData('BTCUSDT', 'trade', (data) => {
  console.log('New trade:', data);
});

Development

Running Tests

npm test

Building

npm run build

License

Private

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published