Atlas / MCP servers / nirholas / Binance.US

Binance.USSAFE

Name: Binance.US
Author: nirholas

mcp/nirholas/binance-us

MCP server by nirholas · api · binance · claude · Audited 2026-10-09

A Model Context Protocol (MCP) server for Binance.US API. Provides standardized access to market data, spot trading, wallets, accounts, staking, OTC, sub-accounts, and institutional features. Built in TypeScript/Node.js. Handles authentication, rate limiting, and errors automatically. Ideal for AI a

Verdict

SAFE

Grade

Trust score

89 /100

Exposed tools

93 57r · 36w · 0d

Transport

stdio

License

NOASSERTION

Stars

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

A Model Context Protocol (MCP) server for interacting with the Binance.US cryptocurrency exchange API.

Overview

This MCP server provides programmatic access to Binance.US exchange features including:

Market Data: Real-time prices, order books, trade history
Spot Trading: Place, cancel, and manage orders
Wallet Management: Deposits, withdrawals, balances
Account Information: Account details, trade history
Staking: Earn rewards on supported assets
OTC Trading: Over-the-counter trading
Sub-Accounts: Manage sub-accounts
Custodial Solution: For custody partners (requires special API key)
Credit Line: For institutional credit (requires special API key)

Binance.US vs Binance.com

This server is specifically designed for Binance.US, which differs from Binance.com in several important ways:

API Key Types

Binance.US offers three types of API keys:

1. Exchange API Keys

Standard API keys for most users
Access to market data, trading, wallet, and account endpoints
Create at: Binance.US > Profile > API Management

2. Custodial Solution API Keys

For users with a Custody Exchange Network agreement
Access to custodial-specific endpoints only
Requires agreement with a participating custody partner

3. Credit Line API Keys

For institutional users with a credit line agreement
Access to credit line-speci

Read from source at commit 716b8f987d22OBSERVED · 2026-10-09

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code (npm)

claude mcp add binance-us-mcp-server --env BINANCE_US_API_KEY=${BINANCE_US_API_KEY} --env BINANCE_US_SECRET_KEY=${BINANCE_US_SECRET_KEY} -- npx -y @nirholas/[email protected]

Exposed tools (93)

57 read · 36 write · 0 destructive.

Tool	Risk	Description
`binance_us_account_info`	read	Get current account information including balances and permissions. Returns all asset balances (free and locked), account permissions, and trading status.
`binance_us_agg_trades`	write	Get compressed aggregate trades. Trades with same time, order, and price are aggregated.
`binance_us_all_oco_orders`	read	Get all OCO orders (history) on Binance.US. Returns up to 1000 orders.
`binance_us_all_orders`	read	Get all orders (active, canceled, or filled) for a symbol on Binance.US. Returns order history.
`binance_us_asset_config`	read	Get details of all crypto assets including fees, withdrawal limits, and network status. Shows deposit/withdrawal enabled status per network.
`binance_us_avg_price`	read	Get current 5-minute rolling weighted average price.
`binance_us_cancel_all_open_orders`	read	Cancel all active orders on a symbol on Binance.US. This includes OCO orders. Use with caution - this will cancel ALL open orders for the specified symbol.
`binance_us_cancel_oco`	write	Cancel an entire OCO order on Binance.US. Cancelling any individual leg will cancel the entire OCO.
`binance_us_cancel_order`	write	Cancel an active order on Binance.US. Either orderId or origClientOrderId must be provided.
`binance_us_cancel_replace`	write	Cancel an existing order and place a new order on the same symbol atomically. This is useful for modifying order parameters.
`binance_us_cl_account`	read
`binance_us_cl_alert_history`	read
`binance_us_cl_liquidation_history`	read
`binance_us_cl_transfer`	write
`binance_us_cl_transfer_history`	write
`binance_us_close_listen_key`	read	Close a User Data Stream by invalidating the listen key. Use this when you
`binance_us_create_listen_key`	write
`binance_us_cust_available_balance`	read	Get available balance in the custodial sub-account for trading. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY Returns the balance available for placing new orders.
`binance_us_cust_balance`	read
`binance_us_cust_cancel_oco`	write	Cancel an entire OCO (One-Cancels-the-Other) order list. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY This cancels both legs of the OCO order. Response includes orderListId, orders array, and orderReports with canceled order details.
`binance_us_cust_cancel_order`	write	Cancel an active custodial trade order. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY Either orderId or origClientOrderId must be provided. Response includes the canceled order details with status: CANCELED
`binance_us_cust_cancel_orders_symbol`	read	Cancel all active custodial orders for a specific trading pair. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY This includes OCO orders. Use with caution. Response is an array of all canceled orders.
`binance_us_cust_get_order`	write	Get details of a specific custodial trade order. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY Response includes: symbol, orderId, price, origQty, executedQty, cummulativeQuoteQty, status, timeInForce, type, side, stopPrice, icebergQty, time, updateTime, isWorking, expressTradeFlag
`binance_us_cust_new_order`	write
`binance_us_cust_oco_order`	write
`binance_us_cust_open_orders`	read
`binance_us_cust_order_history`	write	Get historical custodial trade orders. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY If symbol is not sent, orders for all symbols will be returned. Response is an array of orders with full details including status, executedQty, and expressTradeFlag.
`binance_us_cust_settlement_history`	read
`binance_us_cust_settlement_settings`	read
`binance_us_cust_supported_assets`	read
`binance_us_cust_trade_history`	read
`binance_us_cust_transfer`	write
`binance_us_cust_transfer_history`	write
`binance_us_cust_undo_transfer`	write	Undo a previous transfer from your custodial partner. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY Use this to reverse a custodian transfer that hasn
`binance_us_cust_wallet_transfer`	write
`binance_us_cust_wallet_transfer_history`	write
`binance_us_custodial_balance`	read
`binance_us_custodial_custodian_transfer`	write
`binance_us_custodial_custodian_transfer_history`	write	Get history of transfers from custodial partner, including ExpressTrade and Undo transfers. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY Returns transfer history with status, amounts, and timestamps.
`binance_us_custodial_settlement`	read	Request settlement of assets from custodial sub-account to custodial partner. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY ⚠️ This sends funds to your custodial partner! This settles (withdraws) assets from your Binance.US custodial sub-account to your custody partner
`binance_us_custodial_settlement_history`	read	Get history of settlements from custodial sub-account to custodial partner. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY Returns settlement history with status, amounts, and timestamps.
`binance_us_custodial_supported_assets`	read
`binance_us_custodial_undo_transfer`	write	Undo a previous transfer from your custodial partner. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY ⚠️ Only certain transfers can be undone - check with your custodial partner. This reverses a previous custodian transfer by its transfer ID.
`binance_us_custodial_wallet_transfer`	write
`binance_us_custodial_wallet_transfer_history`	write	Get history of transfers from Binance.US exchange wallet to custodial sub-account. ⚠️ REQUIRES CUSTODIAL SOLUTION API KEY Returns transfer history with status, amounts, and timestamps.
`binance_us_deposit_address`	read	Get a deposit address for a specific crypto asset. Use this to receive funds into your Binance.US account.
`binance_us_deposit_history`	read	Get crypto deposit history. Filter by coin, status, or time range.
`binance_us_exchange_info`	read	Get current exchange trading rules and trading pair information from Binance.US. Can filter by specific symbol(s) or permissions.
`binance_us_get_oco`	write	Query a specific OCO order on Binance.US. Either orderListId or origClientOrderId must be provided.
`binance_us_get_order`	write	Query the status of a specific order on Binance.US. Either orderId or origClientOrderId must be provided.
`binance_us_historical_trades`	read	Get older historical trades for a trading pair. Requires API key with MARKET_DATA permission.
`binance_us_keepalive_listen_key`	read	Extend the validity of a listen key by 60 minutes. ⚠️ IMPORTANT: - Call this every 30 minutes to prevent the stream from closing - If the key expires, you
`binance_us_klines`	read	Get Kline/candlestick data for a trading pair. Returns OHLCV data.
`binance_us_my_trades`	read	Get trade history for a specific trading pair. Returns executed trades including price, quantity, commission, and timestamps.
`binance_us_new_oco`	write	Place a new OCO (One-Cancels-the-Other) order on Binance.US. OCO orders combine a limit order with a stop-loss order. When one triggers, the other is automatically cancelled. Note: For SELL OCOs, limit price > stop price. For BUY OCOs, limit price < stop price.
`binance_us_new_order`	write	Place a new trade order on Binance.US. Supports LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT, and LIMIT_MAKER order types.
`binance_us_ocbs_orders`	read
`binance_us_open_oco`	read	Get all open OCO orders on Binance.US.
`binance_us_open_orders`	read	Get all open orders on Binance.US. Can be filtered by symbol. Warning: Querying without symbol is heavier on rate limits (weight 40 vs 3).
`binance_us_order_book`	write	Get order book depth (bids and asks) for a trading pair on Binance.US. Returns price levels with quantities. Weight varies based on limit (1-100: weight 1, 101-500: weight 5, 501-1000: weight 10, 1001-5000: weight 50).
`binance_us_otc_all_orders`	read
`binance_us_otc_coin_pairs`	read
`binance_us_otc_get_order`	write
`binance_us_otc_place_order`	write
`binance_us_otc_quote`	read
`binance_us_ping`	read	Test connectivity to the Binance.US API. Returns empty object if successful.
`binance_us_rate_limits`	write	Get current trade order count rate limits for all time intervals. Shows how many orders you can place within each interval.
`binance_us_recent_trades`	read	Get recent trades for a trading pair on Binance.US. Returns trade ID, price, quantity, time, and maker/taker info.
`binance_us_rolling_window`	read	Get rolling window price change statistics with custom window sizes (1m to 7d).
`binance_us_server_time`	read	Get the current server time from Binance.US exchange.
`binance_us_staking_asset_info`	read
`binance_us_staking_balance`	read
`binance_us_staking_history`	read
`binance_us_staking_rewards`	read
`binance_us_staking_stake`	read
`binance_us_staking_unstake`	read
`binance_us_subaccount_assets`	read	Get asset balances for a specific sub-account.
`binance_us_subaccount_list`	read	Get a list of all sub-accounts. Filter by email or status (enabled/disabled).
`binance_us_subaccount_status`	read	Get status list of sub-accounts including activation status and enabled features.
`binance_us_subaccount_summary`	read	Get the total USD value of assets in the master account and all sub-accounts.
`binance_us_subaccount_transfer`	write	Execute an asset transfer between master account and a sub-account. ⚠️ This moves funds between accounts!
`binance_us_subaccount_transfer_history`	write	Get transfer history between master and sub-accounts.
`binance_us_system_status`	read	Check if Binance.US system is under maintenance. Status 0 = normal, 1 = system maintenance. Requires API key authentication.
`binance_us_test_order`	write	Test a new order on Binance.US without actually placing it. Validates order parameters and signature without executing the trade.
`binance_us_ticker_24hr`	read	Get 24-hour rolling window price change statistics.
`binance_us_ticker_book`	read	Get best bid/ask prices and quantities (top of book).
`binance_us_ticker_price`	read	Get latest price for symbol(s).
`binance_us_trade_fee`	read	Get your current maker & taker fee rates for spot trading based on your VIP level. BNB fee discount (25% off) is not factored in.
`binance_us_trade_volume`	read	Get total trade volume for the past 30 days. Volume is calculated on a rolling basis every day at 0:00 AM (UTC).
`binance_us_websocket_info`	read	Get information about available WebSocket streams on Binance.US. Returns details about: - Market data streams (public) - User data streams (requires listen key) - Connection URLs and limits
`binance_us_withdraw_crypto`	write	Submit a crypto withdrawal request. Requires withdrawal permission on API key. ⚠️ This action transfers funds OUT of your account - verify address carefully!
`binance_us_withdraw_fiat`	write	Submit a USD withdrawal request via BITGO. ⚠️ This action transfers USD OUT of your account!
`binance_us_withdraw_history`	read	Get crypto withdrawal history. Filter by coin, status, or time range.

Trust audit

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

Layer	What it checks	Result
L0	Provenance & inventory	PASS
L1	Static analysis of the code	PASS
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	PASS
L4	Behavioural (sandbox)	SKIPPED