finance

Binance▌

by analyticace

Connect to Binance API for real-time market data, trading, and portfolio monitoring with 17 automated tools for efficien

Integrates with Binance cryptocurrency exchange to provide real-time market data, account management, trading operations, and transaction history through 17 specialized tools for automated trading workflows, portfolio monitoring, and financial analysis.

github stars

★ 41

GitHub Website npm

17 specialized toolsWorks with Claude, Cursor AI, ChatGPTReal-time market data

best for

/ Crypto traders wanting AI-assisted trading
/ Portfolio managers monitoring multiple assets
/ Developers building automated trading bots
/ Analysts needing quick market data access

capabilities

/ Check real-time cryptocurrency prices
/ View account balances and portfolio
/ Execute buy and sell orders
/ Retrieve trading history
/ Monitor market data
/ Manage Binance account settings

what it does

Connects AI assistants to Binance cryptocurrency exchange for trading, market data, and account management through natural language commands.

about

Binance is a community-built MCP server published by analyticace that provides AI assistants with tools and capabilities via the Model Context Protocol. Connect to Binance API for real-time market data, trading, and portfolio monitoring with 17 automated tools for efficien It is categorized under finance.

how to install

You can install Binance in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Binance is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

Binance MCP Server 🚀

A powerful Model Context Protocol (MCP) server that enables AI agents to interact seamlessly with the Binance cryptocurrency exchange. This server provides a comprehensive suite of trading tools, market data access, and account management capabilities through the standardized MCP interface.

🌟 What is this?

This tool acts as a bridge between AI Assistants (like Claude, Cursor AI, or ChatGPT) and your Binance Account.

Instead of manually navigating the Binance website or app, you can ask your AI to:

"Check the current price of Bitcoin"
"Show me my account balance"
"Buy 0.1 ETH at the current market price"

The AI sends the request to this server, which securely executes it on Binance and returns the result to your AI.

🚀 Quick Start

1️⃣ Installation

The easiest way to install is using pip or uv:

# using pip
pip install binance-mcp-server
# using uv
uv add binance-mcp-server

2️⃣ Configuration

You need your Binance API Keys to allow this tool to access your account.

Log in to your Binance account and go to API Management.
Create a new API Key.
Set the keys as environment variables in your terminal:

# Required: Your Binance API credentials
export BINANCE_API_KEY="your_api_key_here"
export BINANCE_API_SECRET="your_api_secret_here"

# Recommended: Use testnet for development and safe testing
export BINANCE_TESTNET="true"

3️⃣ Running with your AI

Configure for Claude Desktop / VSCode / Cursor

Add the following to your MCP settings configuration file (e.g., claude_desktop_config.json or mcp_config.json):

{
  "mcpServers": {
    "binance": {
      "command": "binance-mcp-server",
      "args": [
        "--api-key", "your_api_key",
        "--api-secret", "your_secret",
        "--binance-testnet"
      ]
    }
  }
}

🎯 Key Capabilities

Real-time Market Data: Get live prices, order books, and ticker stats.
Account Management: specific Check balances and account status.
Trading Operations: Place buy/sell orders (Market, Limit, etc.).
Portfolio Tracking: Monitor open positions and Profit/Loss (PnL).

📚 Technical Reference

Available Tools

<details> <summary><strong>Click to expand full list of tools</strong></summary>

🏦 Account & Portfolio Management

Tool	Purpose
`get_balance`	Retrieve account balances for all assets
`get_account_snapshot`	Point-in-time account state snapshot
`get_fee_info`	Trading fee rates (maker/taker commissions)
`get_available_assets`	List all tradable cryptocurrencies

📊 Market Data & Analysis

Tool	Purpose
`get_ticker_price`	Current price for a trading symbol
`get_ticker`	24-hour ticker price change statistics
`get_order_book`	Current order book (bids/asks)

💱 Trading Operations

Tool	Purpose
`create_order`	Create buy/sell orders (market, limit, etc.)
`get_orders`	List order history for a specific symbol

📈 Performance & Analytics

Tool	Purpose
`get_pnl`	Calculate profit and loss for futures trading
`get_position_info`	Open futures positions details

🏪 Wallet & Transfers

Tool	Purpose
`get_deposit_address`	Get deposit address for a specific coin
`get_deposit_history`	Deposit history for a specific coin
`get_withdraw_history`	Withdrawal history for a specific coin

🛡️ Risk Management

Tool	Purpose
`get_liquidation_history`	Past liquidation events for futures

</details>

Configuration Variables

Variable	Description	Required	Default
`BINANCE_API_KEY`	Your Binance API key	✅	-
`BINANCE_API_SECRET`	Your Binance API secret	✅	-
`BINANCE_TESTNET`	Use testnet environment	❌	`false`

🛠️ Development & Contributing

We welcome contributions! If you are a developer looking to improve this project:

Clone the repo: git clone https://github.com/AnalyticAce/binance-mcp-server.git
Install dev dependencies: uv install --dev or pip install -e .[dev]
Run tests: pytest

See CONTRIBUTING.md for detailed guidelines.

📄 License & Disclaimer

License: MIT

Disclaimer: This software is for educational purposes. Cryptocurrency trading involves financial risk. Always use the Binance Testnet for testing and development. The developers are not responsible for any financial losses.