Binance

Provides access to Binance Futures endpoints for trading, accounts, and market data with authentication, caching, and robust error handling.
  • python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "mcp-mirror-alexcandrabersiva_bin-mcp": {
      "command": "uvx",
      "args": [
        "binance_futures_mcp",
        "--binance-api-key",
        "your_key",
        "--binance-secret-key",
        "your_secret"
      ],
      "env": {
        "BINANCE_API_KEY": "your_key",
        "BINANCE_SECRET_KEY": "your_secret"
      }
    }
  }
}

This MCP server provides programmatic access to Binance Futures endpoints, enabling you to perform trading actions, manage accounts, and fetch market data from your own environment. It handles authentication, caches ticker data for quick responses, and exposes a suite of tools that cover common trading and market information tasks.

How to use

Connect to the Binance MCP server from your MCP client by starting the server locally and pointing your client at the local endpoint. You will authenticate with your Binance API credentials and then request the 17 trading and market data tools to perform actions such as placing orders, obtaining account details, and retrieving market data like candles, order books, and price tickers. Expect secure handling of API keys, automatic rate-limit respect, and real-time market data access through the client.

How to install

Prerequisites: ensure you have Python and pip installed on your machine. You will run the MCP server locally and connect to it from your MCP client.

pip install binance_futures_mcp

Additional configuration and usage notes

Configure your MCP client to connect to the local server. The server runs with your Binance API credentials and provides tools for account information and market data. You can start the server using the command shown in the example below and then configure your client with the same credentials.

To run the server using the standard CLI, use the following command structure with your own keys.

Security and credentials

Your Binance API key and secret remain local to your computer. The MCP server is designed to avoid transmitting credentials externally. Store credentials in environment variables or local configuration files and never commit them to version control.

Troubleshooting tips

If you encounter rate limit errors, the server automatically respects Binance weight-based limits and applies safeguards to prevent excessive request strains. Ensure your API key has the minimal required permissions and that you are using a valid endpoint for futures trading and data access.

Example usage overview

Once connected, you can issue 17 trading and market data tools to perform actions such as placing orders, checking balances, querying market data, and viewing position information. Each tool corresponds to a specific Binance Futures capability and is designed to be called from your MCP client.

Available tools

get_account_info

Retrieve comprehensive account information including balances, margin, and account status.

get_balance

Fetch the current account balances across assets.

get_position_info

Retrieve details about open positions and their risk exposure.

get_position_mode

Query the current position mode (Hedge vs. One-way) for the account.

get_commission_rate

Obtain the commission rate applicable to the account and trading pairs.

get_exchange_info

Get exchange trading rules and supported symbols.

get_book_ticker

Obtain best bid/ask information from the order book for a symbol.

get_price_ticker

Fetch the latest price for a symbol.

get_24hr_ticker

Get 24-hour price change statistics for a symbol.

get_top_gainers_losers

Retrieve top gainers and losers in the market.

get_market_overview

Get overall market statistics and trends.

get_order_book

Retrieve the full depth of the order book for a symbol.

get_klines

Fetch candlestick data for a symbol and interval.

get_mark_price

Get the current mark price and funding rate for a symbol.

get_aggregate_trades

Retrieve aggregated trade data for a symbol.

get_funding_rate_history

Obtain historical funding rates for a symbol.

get_taker_buy_sell_volume

Get the taker buy/sell volume ratio for a symbol.

Built by
VeilStrat
AI signals for GTM teams
© 2026 VeilStrat. All rights reserved.All systems operational