Binance_US

You run a Binance.US MCP Server to access market data, trading actions, wallet management, and account information through a programmatic MCP interface. This server lets you connect your MCP-enabled client to Binance.US, perform real-time market queries, place and manage orders, handle wallets and accounts, and access specialized features for custodial or credit-line use.

How to use

Set up your MCP client to connect to the Binance.US MCP Server via a local stdio-based runtime. You will launch the server locally and point your client to its API capabilities. Use the exposed tools to retrieve market data, place orders, manage wallets and accounts, and access advanced features if you have the required keys.

Typical workflows you can perform include: retrieving real-time prices and order books, placing and canceling spot orders, checking balances and deposit history, viewing trade history and account information, and using custodial or credit-line endpoints if you possess special API keys.

How to install

# Clone the repository
git clone https://github.com/nirholas/universal-crypto-mcp.git
cd universal-crypto-mcp/binance-us-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuration and usage notes

Environment variables control access to Binance.US services. Create a configuration file or export these values in your environment before starting the server.

BINANCE_US_API_KEY=your_api_key_here
BINANCE_US_API_SECRET=your_api_secret_here

Runtime and starting the server

You will run the server as a local process. Use the provided runtime command to start the MCP server and keep it running so your MCP client can connect.

node /path/to/binance-us-mcp-server/build/index.js

Additional sections

Security best practices include keeping API keys secret, applying IP restrictions, limiting permissions to the minimum necessary, using separate keys for different applications, rotating keys periodically, and monitoring for unauthorized activity.

Rate limits for Binance.US endpoints are enforced by the MCP layer. Be mindful of request volume to avoid throttling during peak usage.

Error handling follows standardized responses from the MCP server. You will receive structured error codes and messages to diagnose issues with requests or permissions.

Troubleshooting tips

If the server fails to start, verify that npm install completed successfully, that the build ran without errors, and that the runtime path to index.js is correct. Check environment variables to ensure your API keys are present and correctly named.

Notes on features and access levels

Binance.US MCP Server supports Market Data, Spot Trading, Wallet, and Account information. Custodial Solution and Credit Line endpoints require special API keys and partner agreements. The server exposes dedicated endpoints for these capabilities when authorized.

Available tools

getTickerPrices

Fetch real-time ticker prices for selected trading pairs.

getOrderBook

Retrieve depth of the order book for a symbol.

getRecentTrades

Obtain the most recent trades for a symbol.

getKline

Get candlestick (Kline) data for a symbol over a time interval.

get24hrStats

Fetch 24-hour statistics for a symbol or the exchange.

getExchangeInfo

Retrieve general exchange information and symbol details.

placeOrder

Place a new spot order (limit, market, or stop-limit).

cancelOrder

Cancel an existing order.

getOpenOrders

List currently open orders for an account.

getOrderStatus

Check the status of a specific order.

getTradeHistory

Access historical trades for an account.

getBalances

Retrieve current balances across assets in the wallet.

getDepositAddress

Fetch deposit address for a specific asset.

getDepositHistory

View deposit history events.

getWithdrawalHistory

View withdrawal history events.

withdrawFunds

Withdraw funds to a specified address.

getAccountInfo

Retrieve account-level information.

getAPIPermissions

Check API key permissions.

getStakingProducts

List staking products available for supported assets.

subscribeStaking

Subscribe to staking for eligible assets.

redeemStaking

Redeem staked assets.

getStakingHistory

View staking activity history.

getOTCQuotes

Request OTC quotes for large trades.

executeOTCTrade

Execute OTC trades against quotes.

createSubAccount

Create a new sub-account under your main account.

getSubAccountList

List sub-accounts under your main account.

transferBetweenAccounts

Transfer funds between sub-accounts.

custodialOperations

Custody-specific operations for custodial partners (special API key).

creditLineManagement

Manage credit lines for institutional access (special API key).