# Binance

MCP server for Binance Global — the world's largest cryptocurrency exchange. 23 tools for market data, trading,

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add node2flow/binance

# Browse available tools
npx -y @smithery/cli@latest tool list node2flow/binance

# Get full schema for a tool
npx -y @smithery/cli@latest tool get node2flow/binance bn_ping

# Call a tool
npx -y @smithery/cli@latest tool call node2flow/binance bn_ping '{}'
```

## Direct MCP Connection

Endpoint: `https://binance--node2flow.run.tools`

**Optional config:**
- `BINANCE_API_KEY` (query) — inance API key (from binance.com/en/my/settings/api-management).
- `BINANCE_SECRET_KEY` (query) — Binance Secret key. Required together with API key for trading, account, and user stream operations.

## Tools (23)

- `bn_ping` — Test connectivity to Binance API. Returns empty object if successful. Use to verify API is reachable.
- `bn_server_time` — Get Binance server time (millisecond timestamp). Use to check connectivity and sync timestamps for signed requests.
- `bn_exchange_info` — Get exchange information including trading rules, symbol list, filters (PRICE_FILTER, LOT_SIZE, MIN_NOTIONAL), and rate…
- `bn_order_book` — Get order book (bids and asks) for a symbol. Weight varies by limit: 5 (1-100), 25 (101-500), 50 (501-1000), 250 (1001-…
- `bn_recent_trades` — Get recent trades for a symbol. Returns up to 1000 most recent trades with price, quantity, and time.
- `bn_aggregate_trades` — Get compressed/aggregate trades for a symbol. Trades that fill at the same time, price, and side are aggregated into a …
- `bn_klines` — Get candlestick/kline data (OHLCV) for a symbol. Returns arrays of [openTime, open, high, low, close, volume, closeTime…
- `bn_avg_price` — Get current average price for a symbol. Returns the weighted average price over the last 5 minutes.
- `bn_ticker_24hr` — Get 24-hour price change statistics. Weight: 2 (single symbol), 80 (all symbols). Includes price change, volume, high/l…
- `bn_ticker_price` — Get latest price for a symbol or all symbols. Lightweight endpoint for quick price checks.
- `bn_book_ticker` — Get best bid/ask price and quantity for a symbol or all symbols. Useful for spread analysis.
- `bn_new_order` — Place a new order. WARNING: This uses REAL MONEY on Binance Global. Supports LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT,…
- `bn_test_order` — Test new order creation (dry run). Validates all parameters without actually placing the order. No funds are used. Alwa…
- `bn_query_order` — Query a specific order by orderId or origClientOrderId. Returns order status, filled quantity, and execution details.
- `bn_cancel_order` — Cancel an active order by orderId or origClientOrderId.
- `bn_cancel_all_orders` — Cancel all open orders for a symbol. WARNING: This cancels ALL pending orders at once. Cannot be undone.
- `bn_open_orders` — Get all open orders for a symbol or all symbols. Weight: 3 (with symbol), 40 (without symbol).
- `bn_all_orders` — Get all orders (active, canceled, filled) for a symbol. Supports time range and pagination via orderId.
- `bn_account_info` — Get account information including balances, commission rates, and trading permissions. Returns all asset balances (free…
- `bn_my_trades` — Get trade execution history for a specific symbol. Returns price, quantity, commission, and whether you were buyer/make…
- `bn_create_listen_key` — Create a listen key for user data stream (WebSocket). The key is valid for 60 minutes. Use keepalive to extend. Connect…
- `bn_keepalive_listen_key` — Keepalive a listen key to extend its validity by 60 minutes. Should be called periodically to prevent expiration.
- `bn_close_listen_key` — Close/invalidate a listen key. The associated user data stream will be terminated.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get node2flow/binance <tool-name>
```

## Resources

- `binance://server-info` — Connection status and available tools for this Binance MCP server

## Prompts (2)

- `market-data-analysis` — Guide for fetching and analyzing Binance market data
- `trading-guide` — Guide for placing and managing orders on Binance

---

License: MIT