Binance.US MCP Server
This server lets you access Binance.US market data and authenticated exchange operations via MCP tools.
Test connectivity, check server time/system status, and get exchange trading rules.
Retrieve market data: order books, recent/historical/aggregate trades, klines, average price, tickers, and rolling-window stats.
Trade spot markets: place/test/cancel/replace orders, manage OCO orders, query open/all orders and order status, and view trade history, fees, volume, and rate limits.
Manage wallets: get asset config, deposit addresses/history, withdrawal history, crypto/fiat withdrawals, account balances/permissions, and personal trades.
Use OTC trading: list coin pairs, request quotes, place/query/list OTC orders, and query OCBS fiat orders.
Manage staking: view asset info, stake/unstake, check balances, history, and rewards.
Manage sub-accounts: list accounts, transfer funds/history, view assets, summary, and status.
Work with user data streams: create, keepalive, and close listen keys; get WebSocket info.
Use custodial solution endpoints: balances, supported assets, transfers, transfer history, undo, orders/OCOs/cancellations, settlements, and settlement history.
Use institutional credit line endpoints: account info, alert history, transfers/history, and liquidation history.
Provides programmatic access to the Binance.US cryptocurrency exchange, allowing users to access real-time market data, perform spot and OTC trading, manage wallets and sub-accounts, and handle staking.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Binance.US MCP Server Show my account balances and the current price of BTC"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Binance.US MCP Server
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)
Related MCP server: Binance TH MCP Server
Binance.US vs Binance.com
This server is specifically designed for Binance.US, which differs from Binance.com in several important ways:
Feature | Binance.US | Binance.com |
Base URL |
|
|
WebSocket |
|
|
Regulation | US SEC/FinCEN compliant | International |
Futures Trading | ❌ Not available | ✅ Available |
Margin Trading | ❌ Not available | ✅ Available |
Lending | ❌ Not available | ✅ Available |
Custodial Solution API | ✅ Available | ❌ Not available |
Credit Line API | ✅ Available | ❌ Not available |
Available Pairs | ~150 pairs | ~1,500+ pairs |
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-specific endpoints only
Requires signed credit line agreement with Binance.US
Installation
# Clone the repository
git clone https://github.com/nirholas/Binance-US-MCP.git
cd Binance-US-MCP
# Install dependencies
npm install
# Build the project
npm run buildConfiguration
Environment Variables
Create a .env file or set these environment variables:
BINANCE_US_API_KEY=your_api_key_here
BINANCE_US_API_SECRET=your_api_secret_hereClaude Desktop Configuration
Add to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"binance-us-mcp": {
"command": "node",
"args": ["/path/to/binance-us-mcp-server/build/index.js"],
"env": {
"BINANCE_US_API_KEY": "your_api_key",
"BINANCE_US_API_SECRET": "your_api_secret"
}
}
}
}Usage
Development
# Run in development mode with hot reload
npm run dev
# Test with MCP Inspector
npm testProduction
# Build the project
npm run build
# Start the server
npm startAvailable Tool Categories
Market Data (Public)
Get ticker prices
Get order book depth
Get recent trades
Get kline/candlestick data
Get 24hr statistics
Get exchange info
Spot Trading (Requires API Key)
Place new orders (limit, market, stop-limit)
Cancel orders
Get open orders
Get order status
Get trade history
Wallet (Requires API Key)
Get balances
Get deposit address
Get deposit history
Get withdrawal history
Withdraw funds
Account (Requires API Key)
Get account information
Get trade history
Get API key permissions
Staking
Get staking products
Subscribe to staking
Redeem staking
Get staking history
OTC Trading
Get OTC quotes
Execute OTC trades
Sub-Account
Create sub-account
Get sub-account list
Transfer between accounts
Custodial Solution (Special API Key)
Custody-specific operations
Partner integrations
Credit Line (Special API Key)
Credit line management
Institutional features
Security Best Practices
Never share your API keys - Treat them like passwords
Use IP restrictions - Whitelist only trusted IPs in your API settings
Limit permissions - Only enable the permissions you need
Use separate keys - Create different keys for different applications
Rotate keys regularly - Generate new keys periodically
Monitor activity - Check your account for unauthorized access
Rate Limits
Binance.US has the following rate limits:
Request Weight: 1200 per minute
Orders: 10 per second, 100,000 per day
Raw Requests: 5000 per 5 minutes
The server handles rate limiting automatically, but be mindful of these limits when making many requests.
Error Handling
The server returns standardized error responses:
{
"success": false,
"error": {
"code": -1121,
"msg": "Invalid symbol."
}
}Common error codes:
-1000: Unknown error-1002: Unauthorized-1021: Timestamp outside recvWindow-1022: Invalid signature-2010: New order rejected-2011: Cancel rejected
Contributing
Contributions are welcome! Please read the contributing guidelines before submitting pull requests.
Documentation
Detailed documentation is available in the docs/ folder:
TOOLS.md - Complete tools reference with parameters, examples, and responses
API_CLIENT.md - API client architecture, types, and error handling
QUICK_REFERENCE.md - Fast lookup guide for all tools
TRADING.md - Trading tools and order management (all 13 tools)
TRADING_QUICK_REF.md - Trading tools cheat sheet
ERROR_CODES.md - Complete error code reference with solutions
License
All rights reserved. See LICENSE.
Resources
Documentation
Tools Reference - Complete documentation for all 93 tools
Quick Reference - Concise tool lookup card
Prompt Examples - Example prompts for Claude
Changelog - Version history and changes
🌐 Live HTTP Deployment
Binance US MCP is deployed and accessible over HTTP via MCP Streamable HTTP transport — no local installation required.
Endpoint:
https://modelcontextprotocol.name/mcp/binance-us-mcpConnect from any MCP Client
Add to your MCP client configuration (Claude Desktop, Cursor, SperaxOS, etc.):
{
"mcpServers": {
"binance-us-mcp": {
"type": "http",
"url": "https://modelcontextprotocol.name/mcp/binance-us-mcp"
}
}
}Available Tools (3)
Tool | Description |
| Get price on Binance.US |
| 24h statistics |
| Order book |
Example Requests
Get price on Binance.US:
curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_ticker_price","arguments":{"symbol":"BTCUSD"}}}'24h statistics:
curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_24h_stats","arguments":{"symbol":"ETHUSD"}}}'Order book:
curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_order_book","arguments":{"symbol":"BTCUSD","limit":5}}}'List All Tools
curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Also Available On
This repository: github.com/nirholas/Binance-US-MCP. The SperaxOS marketplace listing is offline while its hosting is being migrated.
The full MCP catalog: see modelcontextprotocol.name
Powered by modelcontextprotocol.name — the open MCP HTTP gateway
Star History
Available Tools
93 toolsbinance_us_account_infoB
Get current account information including balances and permissions. Returns all asset balances (free and locked), account permissions, and trading status.
Inputs: recvWindow.
binance_us_agg_tradesB
Get compressed aggregate trades. Trades with same time, order, and price are aggregated.
Inputs: symbol (required), limit, fromId, endTime, +1 more.
binance_us_all_oco_ordersC
Get all OCO orders (history) on Binance.US. Returns up to 1000 orders.
Inputs: limit, fromId, endTime, startTime, +1 more.
binance_us_all_ordersB
Get all orders (active, canceled, or filled) for a symbol on Binance.US. Returns order history.
Inputs: symbol (required), limit, endTime, orderId, +2 more.
binance_us_asset_configA
Get details of all crypto assets including fees, withdrawal limits, and network status. Shows deposit/withdrawal enabled status per network.
Inputs: recvWindow.
binance_us_avg_priceC
Get current 5-minute rolling weighted average price.
Inputs: symbol (required).
binance_us_cancel_all_open_ordersA
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.
Inputs: symbol (required), recvWindow.
binance_us_cancel_ocoA
Cancel an entire OCO order on Binance.US. Cancelling any individual leg will cancel the entire OCO.
Inputs: symbol (required), recvWindow, orderListId, newClientOrderId, +1 more.
binance_us_cancel_orderB
Cancel an active order on Binance.US. Either orderId or origClientOrderId must be provided.
Inputs: symbol (required), orderId, recvWindow, newClientOrderId, +2 more.
binance_us_cancel_replaceB
Cancel an existing order and place a new order on the same symbol atomically. This is useful for modifying order parameters.
Inputs: side (required), type (required), symbol (required), cancelReplaceMode (required), +15 more.
binance_us_cl_accountA
Get comprehensive credit line account information.
⚠️ REQUIRES INSTITUTIONAL CREDIT LINE AGREEMENT This API is only available to institutional users with approved credit facilities.
Response includes:
clAccountId: Credit line account ID
masterAccountId: Associated master account ID
notificationMailAddr: Email for notifications
LTV (Loan-to-Value) Ratios:
currentLTV: Current loan-to-value ratio
initialLTV: Initial LTV threshold
marginCallLTV: LTV that triggers margin call
liquidationLTV: LTV that triggers liquidation
Interest & Fees:
interestRate: Annual interest rate on loans
liquidationFeeRate: Fee charged on liquidation
Contract Details:
contractStartTime/contractEndTime: Credit facility dates
isActive: Whether credit line is active
Permissions:
canTrade: Trading permission
canTransferIn/canTransferOut: Transfer permissions
Loan Information:
loanAssets: Array of loaned assets with quantities
requiredDepositAmount: Additional collateral needed
availableAmountToTransferOut: Funds available to withdraw
Balances:
balances: Array of asset balances (free, locked)
Inputs: recvWindow.
binance_us_cl_alert_historyA
Get margin call and liquidation alert history for credit line account.
⚠️ REQUIRES INSTITUTIONAL CREDIT LINE AGREEMENT
Alert Types:
MARGIN_CALL: Warning that LTV is approaching liquidation threshold
LIQUIDATION_CALL: Critical alert that liquidation is imminent/occurring
Each alert record includes:
alertTime: When the alert was triggered
alertType: MARGIN_CALL or LIQUIDATION_CALL
currentLTV: LTV ratio at alert time
initialLTV, marginCallLTV, liquidationLTV: Threshold values
totalBalance: Total account balance at alert time
loanAssets: Loan details at alert time
balances: Asset balances with free, locked, freeze amounts
Use this to:
Review past risk events
Understand account risk patterns
Audit margin call history
Inputs: limit, endTime, alertType, startTime, +1 more.
binance_us_cl_liquidation_historyA
Get liquidation history for credit line account.
⚠️ REQUIRES INSTITUTIONAL CREDIT LINE AGREEMENT
Liquidations occur when LTV exceeds liquidationLTV threshold. This endpoint shows historical liquidation events.
Each liquidation record may include:
Liquidated assets and amounts
Liquidation timestamp
LTV at time of liquidation
Fees charged
Use this to:
Review past liquidation events
Understand liquidation patterns
Audit risk management effectiveness
Inputs: limit, endTime, startTime, recvWindow.
binance_us_close_listen_keyA
Close a User Data Stream by invalidating the listen key.
Use this when you're done receiving real-time updates. After closing, the WebSocket connection will be terminated.
This endpoint requires API key but does NOT require signature.
Inputs: listenKey (required).
binance_us_cl_transferA
Execute a transfer in or out of the credit line account.
⚠️ REQUIRES INSTITUTIONAL CREDIT LINE AGREEMENT
⚠️ WARNING: Transfers affect your LTV ratio!
TRANSFER_OUT increases LTV (more risk)
TRANSFER_IN decreases LTV (less risk)
Before transferring out, ensure:
Your LTV won't exceed marginCallLTV after transfer
You have sufficient availableAmountToTransferOut
You understand the impact on your credit position
Transfer Types:
TRANSFER_IN: Add collateral to credit line account
TRANSFER_OUT: Withdraw from credit line account
Response includes:
transferId: Unique transfer identifier
status: SUCCESS, PENDING, or FAILED
Inputs: quantity (required), transferType (required), transferAssetType (required), recvWindow.
binance_us_cl_transfer_historyA
Get transfer history for credit line account.
⚠️ REQUIRES INSTITUTIONAL CREDIT LINE AGREEMENT
Transfer Types:
TRANSFER_IN: Deposits into credit line account
TRANSFER_OUT: Withdrawals from credit line account
Each transfer record includes:
transferId: Unique transfer identifier
transferType: TRANSFER_IN or TRANSFER_OUT
asset: Transferred asset symbol
amount: Transfer amount
status: Transfer status (SUCCESS, PENDING, FAILED)
transferTime: When the transfer occurred
Use this to:
Track collateral movements
Audit deposit/withdrawal history
Reconcile account activity
Inputs: asset, limit, endTime, startTime, +2 more.
binance_us_create_listen_keyA
Create a new listen key for User Data Stream WebSocket connection.
The listen key is used to subscribe to real-time account updates via WebSocket. Connect to: wss://stream.binance.us:9443/ws/
⚠️ IMPORTANT:
Listen keys are valid for 60 minutes
Use binance_us_keepalive_listen_key every 30 minutes to extend validity
A stream will close when the listen key expires
You can only have ONE active listen key per account
The stream sends updates for:
outboundAccountPosition: Account balance updates
balanceUpdate: Deposit/withdrawal updates
executionReport: Order/trade updates
This endpoint requires API key but does NOT require signature.
Inputs: no named parameters.
binance_us_cust_available_balanceA
Get available balance in the custodial sub-account for trading.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Returns the balance available for placing new orders.
Inputs: rail (required), asset.
binance_us_cust_balanceA
Get balance information for Binance.US exchange wallet and custodial sub-account.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY - Standard API keys will not work.
This endpoint is for institutional custody partners (e.g., Anchorage, BitGo).
Response includes:
exchangeWalletBalance: Balances in your Binance.US exchange wallet
custodialAcctBalance: Balances in your custodial sub-account
Each balance entry contains:
asset: Asset symbol
free: Available balance
locked: Locked balance
inSettlement: Amount in settlement (custodial only)
lastUpdatedTime: Last update timestamp
Inputs: rail (required).
binance_us_cust_cancel_ocoA
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.
Inputs: rail (required), symbol (required), orderListId (required), newClientOrderId, +1 more.
binance_us_cust_cancel_orderA
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
Inputs: rail (required), symbol (required), orderId, newClientOrderId, +1 more.
binance_us_cust_cancel_orders_symbolA
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.
Inputs: rail (required), symbol (required).
binance_us_cust_get_orderA
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
Inputs: rail (required), symbol (required), orderId (required).
binance_us_cust_new_orderA
Place a new trade order through the custodial solution.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Supported order types:
LIMIT: Requires timeInForce, quantity, price
MARKET: Requires quantity OR quoteOrderQty
STOP_LOSS: Requires quantity, stopPrice (executes as MARKET when triggered)
STOP_LOSS_LIMIT: Requires timeInForce, quantity, price, stopPrice
TAKE_PROFIT: Requires quantity, stopPrice (executes as MARKET when triggered)
TAKE_PROFIT_LIMIT: Requires timeInForce, quantity, price, stopPrice
LIMIT_MAKER: Requires quantity, price (POST-ONLY order)
ExpressTrade Feature: When allowExpressTrade=true and custodial sub-account balance is insufficient, the full amount will be automatically transferred from the custodial partner.
Response includes: symbol, orderId, status, type, side, price, quantity, executedQty, and expressTradeFlag
Inputs: rail (required), side (required), type (required), symbol (required), +8 more.
binance_us_cust_oco_orderA
Place a new OCO (One-Cancels-the-Other) order through the custodial solution.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
OCO orders combine a limit order with a stop-loss order. When one executes, the other is automatically canceled.
Price Restrictions:
SELL: Limit Price > Last Price > Stop Price
BUY: Limit Price < Last Price < Stop Price
Quantity: Both legs must have the same quantity (iceberg qty can differ).
Note: OCO counts as 2 orders against rate limits.
Response includes orderListId, orders array, and orderReports with details.
Inputs: rail (required), side (required), price (required), symbol (required), +10 more.
binance_us_custodial_balanceA
Get balance information for Binance.US exchange wallet and custodial sub-account.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY - Regular API keys will not work.
Returns two balance arrays:
exchangeWalletBalance: Balances in your Binance.US exchange wallet
custodialAcctBalance: Balances in your Binance.US custodial sub-account
Each balance includes:
asset: Asset symbol (e.g., BTC, ETH)
free: Available balance
locked: Locked balance (in orders, etc.)
inSettlement: Amount in settlement process (custodial only)
lastUpdatedTime: Last update timestamp
Inputs: rail (required).
binance_us_custodial_custodian_transferA
Request asset transfer from a custodial partner account to Binance.US custodial sub-account.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY ⚠️ This initiates a transfer request to your custody partner!
This requests your custodial partner to transfer assets to your Binance.US account. The actual transfer is executed by the custody partner.
Inputs: rail (required), asset (required), amount (required), clientOrderId.
binance_us_custodial_custodian_transfer_historyB
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.
Inputs: rail (required), page, asset, limit, +5 more.
binance_us_custodial_settlementA
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's vault.
Inputs: rail (required), asset (required), amount (required), clientOrderId.
binance_us_custodial_settlement_historyB
Get history of settlements from custodial sub-account to custodial partner.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Returns settlement history with status, amounts, and timestamps.
Inputs: rail (required), page, asset, limit, +4 more.
binance_us_custodial_supported_assetsA
Get list of assets supported for custodial transfers and settlements.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Returns two lists:
transferEligible: Assets that can be transferred FROM custodial partner
settlementEligible: Assets that can be settled TO custodial partner
Each asset includes:
asset: Asset symbol
precision: Decimal precision
network: Supported networks for the asset
Inputs: rail (required).
binance_us_custodial_undo_transferA
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.
Inputs: rail (required), originTransferId (required).
binance_us_custodial_wallet_transferA
Transfer assets from your Binance.US exchange wallet to your custodial sub-account.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY ⚠️ This moves funds - verify details carefully!
This transfers from your main Binance.US account to your custodial sub-account, which can then be traded or settled to your custodial partner.
Inputs: rail (required), asset (required), amount (required), clientOrderId.
binance_us_custodial_wallet_transfer_historyA
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.
Inputs: rail (required), page, asset, limit, +4 more.
binance_us_cust_open_ordersA
Get all open custodial trade orders.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
⚠️ Do not call without a symbol parameter as it returns all pairs and can be slow.
Response is an array of open orders with: symbol, orderId, price, origQty, executedQty, status, type, side, stopPrice, time, updateTime, isWorking, expressTradeFlag
Inputs: rail (required), symbol.
binance_us_cust_order_historyA
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.
Inputs: rail (required), limit, fromId, symbol, +2 more.
binance_us_cust_settlement_historyA
Get historical settlement records for custodial solution.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Shows past automatic settlements to custodial partner.
Response includes:
records: Array of settlement records
total: Total number of settlements
Each record contains:
status: PROCESS, SUCCESS, or FAILURE
triggerTime: When settlement was triggered
settlementId: Unique settlement identifier
settlementAssets: Array of assets settled with amounts and addresses
Inputs: rail (required), page, limit, endTime, +1 more.
binance_us_cust_settlement_settingsA
Get current settlement settings for custodial solution.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Shows automatic settlement configuration and schedule.
Response includes:
settlementActive: Whether auto-settlement is enabled
frequencyInHours: Settlement frequency (e.g., 24 hours)
nextTriggerTime: Timestamp of next scheduled settlement
Inputs: rail (required).
binance_us_cust_supported_assetsA
Get list of assets supported for custodial solution transfers and settlements.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Response includes:
transferEligible: Assets that can be transferred
settlementEligible: Assets that can be settled
Each asset entry contains:
asset: Asset symbol
precision: Decimal precision
network: Supported blockchain networks
Inputs: rail (required).
binance_us_cust_trade_historyA
Get historical custodial trades (filled orders).
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Returns actual executed trades with price, quantity, and commission details.
Response includes for each trade: symbol, price, qty, quoteQty, time, isBuyer, isMaker, isBestMatch, orderId, commission, commissionAsset
Inputs: rail (required), limit, fromId, symbol, +3 more.
binance_us_cust_transferB
Transfer assets from custodial partner account to Binance.US custodial sub-account.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Use this to move assets from your custodial partner (e.g., Anchorage) to your Binance.US custodial sub-account for trading.
Response includes:
asset: Transferred asset
amount: Transfer amount
transferId: Unique transfer identifier
custodyAccountId/custodyAccountName: Custodian account details
status: Transfer status
createTime: Transfer creation timestamp
Inputs: rail (required), asset (required), amount (required), clientOrderId.
binance_us_cust_transfer_historyA
Get history of transfers from custodial partner to Binance.US custodial sub-account.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Includes ExpressTrade transfers, Custodian transfers, and Undo transfers.
Response includes:
data: Array of transfer records
total: Total number of transfers
Each record contains: transferId, clientOrderId, asset, amount, status, expressTrade flag, createTime, updateTime
Inputs: rail (required), page, asset, limit, +5 more.
binance_us_cust_undo_transferA
Undo a previous transfer from your custodial partner.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Use this to reverse a custodian transfer that hasn't been fully processed.
Response includes:
transferId: New transfer ID for the undo operation
asset: Asset being returned
amount: Amount being returned
Inputs: rail (required), originTransferId (required).
binance_us_cust_wallet_transferA
Transfer assets from Binance.US exchange wallet to custodial sub-account.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Use this to move assets from your Binance.US exchange wallet to your custodial sub-account for trading.
Response includes:
asset: Transferred asset
amount: Transfer amount
clientOrderId: Your reference ID (or auto-generated)
transferId: Unique transfer identifier
status: Transfer status (SUCCESS, PENDING, etc.)
createTime: Transfer creation timestamp
Inputs: rail (required), asset (required), amount (required), clientOrderId.
binance_us_cust_wallet_transfer_historyB
Get history of transfers from Binance.US exchange wallet to custodial sub-account.
⚠️ REQUIRES CUSTODIAL SOLUTION API KEY
Response includes:
data: Array of transfer records
total: Total number of transfers
Each transfer record contains: transferId, clientOrderId, asset, amount, status, createTime, updateTime
Inputs: rail (required), page, asset, limit, +4 more.
binance_us_deposit_addressB
Get a deposit address for a specific crypto asset. Use this to receive funds into your Binance.US account.
Inputs: coin (required), network, recvWindow.
binance_us_deposit_historyB
Get crypto deposit history. Filter by coin, status, or time range.
Inputs: coin, limit, offset, status, +3 more.
binance_us_exchange_infoB
Get current exchange trading rules and trading pair information from Binance.US. Can filter by specific symbol(s) or permissions.
Inputs: symbol, symbols, permissions.
binance_us_get_ocoB
Query a specific OCO order on Binance.US. Either orderListId or origClientOrderId must be provided.
Inputs: recvWindow, orderListId, origClientOrderId.
binance_us_get_orderB
Query the status of a specific order on Binance.US. Either orderId or origClientOrderId must be provided.
Inputs: symbol (required), orderId, recvWindow, origClientOrderId.
binance_us_historical_tradesA
Get older historical trades for a trading pair. Requires API key with MARKET_DATA permission.
Inputs: symbol (required), limit, fromId.
binance_us_keepalive_listen_keyA
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'll need to create a new one
This resets the 60-minute expiration timer
This endpoint requires API key but does NOT require signature.
Inputs: listenKey (required).
binance_us_klinesB
Get Kline/candlestick data for a trading pair. Returns OHLCV data.
Inputs: symbol (required), interval (required), limit, endTime, +1 more.
binance_us_my_tradesC
Get trade history for a specific trading pair. Returns executed trades including price, quantity, commission, and timestamps.
Inputs: symbol (required), limit, fromId, endTime, +3 more.
binance_us_new_ocoA
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.
Inputs: side (required), price (required), symbol (required), quantity (required), +12 more.
binance_us_new_orderC
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.
Inputs: side (required), type (required), symbol (required), price, +10 more.
binance_us_ocbs_ordersB
Query all OCBS (One-Click-Buy-Sell) fiat orders on Binance.US.
OCBS allows direct fiat-to-crypto conversions. This endpoint retrieves your OCBS order history for fiat transactions (e.g., USD to BTC).
Response includes:
total: Total number of OCBS orders
dataList: Array of orders with details
Each order contains:
quoteId, orderId, orderStatus (SUCCESS/FAIL)
fromCoin/fromAmount: Source currency and amount
toCoin/toAmount: Destination currency and amount
feeCoin/feeAmount: Fee details
ratio: Exchange rate
createTime: Order timestamp
Inputs: page, limit, endTime, orderId, +1 more.
binance_us_open_ocoC
Get all open OCO orders on Binance.US.
Inputs: recvWindow.
binance_us_open_ordersA
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).
Inputs: symbol, recvWindow.
binance_us_order_bookB
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).
Inputs: symbol (required), limit.
binance_us_otc_all_ordersA
Query all OTC (Over-The-Counter) trade orders with optional filters.
Use this to retrieve your OTC trading history with various filtering options.
Response includes:
total: Total number of orders matching filters
rows: Array of order objects with full details
Each order contains: quoteId, orderId, orderStatus, fromCoin, fromAmount, toCoin, toAmount, ratio, inverseRatio, createTime
Inputs: page, limit, toCoin, endTime, +3 more.
binance_us_otc_coin_pairsA
Get a list of supported OTC (Over-The-Counter) trading pairs on Binance.US.
OTC trading allows large block trades to be executed outside the regular order book, minimizing market impact. This endpoint returns available coin pairs with their minimum and maximum trading limits.
Response includes:
fromCoin/toCoin: The trading pair
fromCoinMinAmount/fromCoinMaxAmount: Min/max amounts for the sell coin
toCoinMinAmount/toCoinMaxAmount: Min/max amounts for the buy coin
Example: Convert large amounts of BTC to USDT without affecting market price.
Inputs: toCoin, fromCoin.
binance_us_otc_get_orderA
Get detailed information about a specific OTC (Over-The-Counter) trade order.
Use this to check the status and details of a previously placed OTC order.
Response includes:
quoteId: Original quote ID used
orderId: Order identifier
orderStatus: SUCCESS, PROCESS, ACCEPT_SUCCESS, or FAIL
fromCoin/fromAmount: Sold coin and amount
toCoin/toAmount: Bought coin and amount
ratio/inverseRatio: Exchange rates
createTime: Order creation timestamp
Inputs: orderId (required).
binance_us_otc_place_orderA
Place an OTC (Over-The-Counter) trade order using a previously acquired quote.
⚠️ IMPORTANT: You must first call binance_us_otc_quote to get a quoteId before placing an order. The quote expires quickly, so place the order immediately after receiving the quote.
Order Status values:
PROCESS: Order is being processed
ACCEPT_SUCCESS: Order accepted, awaiting completion
SUCCESS: Order completed successfully
FAIL: Order failed
Response includes:
orderId: Unique order identifier
createTime: Order creation timestamp
orderStatus: Current status of the order
Inputs: quoteId (required).
binance_us_otc_quoteB
Request a quote for an OTC (Over-The-Counter) trade on Binance.US.
This endpoint requests a price quote for converting one coin to another via OTC. The quote is valid for a limited time (check validTimestamp in response).
⚠️ IMPORTANT: The quote must be used quickly as it expires based on validTimestamp.
Parameters:
fromCoin: The coin you want to sell (e.g., BTC, SHIB)
toCoin: The coin you want to buy (e.g., USDT, KSHIB)
requestCoin: Which coin's amount you're specifying (must be fromCoin or toCoin)
requestAmount: The amount of the requestCoin
Response includes:
symbol: Trading pair symbol
ratio: Conversion ratio (e.g., 50550.26 for BTC/USDT)
inverseRatio: Inverse conversion ratio
validTimestamp: Unix timestamp when quote expires
toAmount/fromAmount: Calculated amounts for the trade
Inputs: toCoin (required), fromCoin (required), requestCoin (required), requestAmount (required).
binance_us_pingA
Test connectivity to the Binance.US API. Returns empty object if successful.
Inputs: no named parameters.
binance_us_rate_limitsB
Get current trade order count rate limits for all time intervals. Shows how many orders you can place within each interval.
Inputs: recvWindow.
binance_us_recent_tradesB
Get recent trades for a trading pair on Binance.US. Returns trade ID, price, quantity, time, and maker/taker info.
Inputs: symbol (required), limit.
binance_us_rolling_windowC
Get rolling window price change statistics with custom window sizes (1m to 7d).
Inputs: type, symbol, symbols, windowSize.
binance_us_server_timeA
Get the current server time from Binance.US exchange.
Inputs: no named parameters.
binance_us_staking_asset_infoB
Get staking information for supported assets on Binance.US.
Returns details about staking options including APR, APY, and staking limits.
Response includes for each asset:
stakingAsset: Asset being staked (e.g., BNB, ETH)
rewardAsset: Asset received as staking reward
apr: Annual Percentage Rate (without compounding)
apy: Annual Percentage Yield (with compounding/restaking)
unstakingPeriod: Time to unstake in hours (e.g., 168 = 7 days)
minStakingLimit: Minimum amount allowed for staking
maxStakingLimit: Maximum amount allowed for staking
autoRestake: Whether rewards are automatically restaked
If no asset is specified, returns information for all staking assets.
Inputs: stakingAsset.
binance_us_staking_balanceA
Get current staking balance for assets on Binance.US.
Returns your current staking positions and their details.
Response includes for each staked asset:
asset: The staked asset symbol
stakingAmount: Total amount currently staked
rewardAsset: Asset received as rewards
apr: Current APR for the asset
apy: Current APY (with compounding)
autoRestake: Whether auto-restaking is enabled
If no asset is specified, returns balances for all staked assets.
Inputs: asset.
binance_us_staking_historyB
Get staking transaction history for assets on Binance.US.
Returns a history of staking and unstaking transactions.
Response includes for each transaction:
asset: The asset involved
amount: Transaction amount
type: Transaction type (staked, unstaked, etc.)
initiatedTime: Transaction initiation timestamp
status: Transaction status (SUCCESS, PENDING, etc.)
If no asset is specified, returns history for all assets.
Inputs: page, asset, limit, endTime, +1 more.
binance_us_staking_rewardsA
Get staking rewards history for assets on Binance.US.
Returns a history of staking rewards earned over time.
Response includes:
total: Total number of reward records
data: Array of reward records
Each reward record contains:
asset: The reward asset
amount: Reward amount
usdValue: USD value at time of reward
time: Reward timestamp
tranId: Transaction ID
autoRestaked: Whether the reward was automatically restaked
If no asset is specified, returns rewards for all staked assets.
Inputs: page, asset, limit, endTime, +1 more.
binance_us_staking_stakeA
Stake a supported asset on Binance.US to earn staking rewards.
⚠️ IMPORTANT:
Staking locks your assets for a period of time
Check unstakingPeriod using binance_us_staking_asset_info before staking
Ensure you have sufficient balance before staking
Verify min/max staking limits for the asset
Parameters:
stakingAsset: The asset to stake (e.g., BNB, ETH)
amount: Amount to stake
autoRestake: Whether to automatically restake rewards (default: true)
Response includes:
result: SUCCESS or failure status
purchaseRecordId: Record ID for the staking transaction
Inputs: amount (required), stakingAsset (required), autoRestake.
binance_us_staking_unstakeA
Unstake a previously staked asset on Binance.US.
⚠️ IMPORTANT:
Unstaking may take time (check unstakingPeriod in asset info)
You will stop earning rewards once unstaking begins
Some assets may have early unstaking penalties
Parameters:
stakingAsset: The asset to unstake (e.g., BNB, ETH)
amount: Amount to unstake
Response includes:
result: SUCCESS or failure status
Inputs: amount (required), stakingAsset (required).
binance_us_subaccount_assetsC
Get asset balances for a specific sub-account.
Inputs: email (required), recvWindow.
binance_us_subaccount_listB
Get a list of all sub-accounts. Filter by email or status (enabled/disabled).
Inputs: page, email, limit, status, +1 more.
binance_us_subaccount_statusB
Get status list of sub-accounts including activation status and enabled features.
Inputs: email, recvWindow.
binance_us_subaccount_summaryC
Get the total USD value of assets in the master account and all sub-accounts.
Inputs: page, size, email, recvWindow.
binance_us_subaccount_transferC
Execute an asset transfer between master account and a sub-account. ⚠️ This moves funds between accounts!
Inputs: asset (required), amount (required), toEmail (required), fromEmail (required), +1 more.
binance_us_subaccount_transfer_historyC
Get transfer history between master and sub-accounts.
Inputs: page, email, limit, endTime, +2 more.
binance_us_system_statusA
Check if Binance.US system is under maintenance. Status 0 = normal, 1 = system maintenance. Requires API key authentication.
Inputs: no named parameters.
binance_us_test_orderB
Test a new order on Binance.US without actually placing it. Validates order parameters and signature without executing the trade.
Inputs: side (required), type (required), symbol (required), price, +10 more.
binance_us_ticker_24hrC
Get 24-hour rolling window price change statistics.
Inputs: type, symbol, symbols.
binance_us_ticker_bookA
Get best bid/ask prices and quantities (top of book).
Inputs: symbol, symbols.
binance_us_ticker_priceC
Get latest price for symbol(s).
Inputs: symbol, symbols.
binance_us_trade_feeA
Get your current maker & taker fee rates for spot trading based on your VIP level. BNB fee discount (25% off) is not factored in.
Inputs: symbol, recvWindow.
binance_us_trade_volumeA
Get total trade volume for the past 30 days. Volume is calculated on a rolling basis every day at 0:00 AM (UTC).
Inputs: recvWindow.
binance_us_websocket_infoA
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
Inputs: no named parameters.
binance_us_withdraw_cryptoA
Submit a crypto withdrawal request. Requires withdrawal permission on API key. ⚠️ This action transfers funds OUT of your account - verify address carefully!
Inputs: coin (required), amount (required), address (required), network (required), +3 more.
binance_us_withdraw_fiatB
Submit a USD withdrawal request via BITGO. ⚠️ This action transfers USD OUT of your account!
Inputs: amount (required), paymentAccount (required), recvWindow, fiatCurrency, +1 more.
binance_us_withdraw_historyB
Get crypto withdrawal history. Filter by coin, status, or time range.
Inputs: coin, limit, offset, status, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 93 tools
Several tool pairs appear to be near-identical duplicates distinguished only by a 'cust_' vs 'custodial_' prefix (e.g., binance_us_cust_balance vs binance_us_custodial_balance, cust_wallet_transfer vs custodial_wallet_transfer, cust_settlement_history vs custodial_settlement_history). An agent would struggle to pick between these, and the custodial vs standard order tools (cancel_order vs cust_cancel_order) add further confusion.
Names generally follow snake_case with a binance_us_ prefix, which is readable. However the 'cust_' and 'custodial_' variants for what look like the same operations is a significant inconsistency that breaks any predictable pattern.
93 tools is far beyond a reasonable scope and is inflated by apparent duplicates. While Binance.US has many endpoints, this surface is heavy enough to overwhelm tool selection.
The surface is remarkably broad, covering market data, spot orders, OCO, OTC, OCBS, staking, sub-accounts, custodial solutions, credit line, and websocket management. Minor gaps exist but the domain is well covered.
Maintenance
Related MCP Connectors
Binance - 340 tools for market data, order books, and trading pairs
Agentic brokerage access to a US brokerage account: quotes, orders, positions, cash and documents.
Financial intelligence for AI: manage balances, transactions, payments, and more
Live crypto + IDX stock market intelligence for AI agents — 19 tools, no API key.
Related MCP Servers
- AlicenseCqualityBmaintenanceProvides over 156 tools to interact with the Binance.com global exchange API for spot trading, wallet management, and staking operations. It enables users to execute orders, retrieve market data, and manage crypto assets through natural language interfaces like Claude and ChatGPT.195134 npm40MIT
- AlicenseNot gradedqualityDmaintenanceProvides 27 tools for interacting with the Binance Thailand (Gulf Binance) API, enabling market data, trading, order management, wallet operations, and account management through natural language.22 npmMIT
- AlicenseAqualityCmaintenanceEnables Claude to query Binance Spot market data, account balances, and execute trades via natural language, with withdrawals disabled by default for security.11MIT
- FlicenseNot gradedqualityDmaintenanceEnables natural language management of Binance USDS-margin futures trading, including balance checks, order placement, stop-loss/take-profit, and strategy backtesting.-