nirholas Binance.US MCP Server Guide
A Model Context Protocol (MCP) server for the Binance.US API. Designed for US-based users and AI agents that need compliant access to crypto trading, market data, and account management.
Key Differences from Binance.com MCP
| Feature | Binance.com | Binance.US |
|---|---|---|
| Jurisdiction | Global (not US) | United States |
| Regulatory | Varies by region | US SEC/FinCEN compliant |
| Trading pairs | 600+ | 150+ |
| Features | Full suite | Core trading + staking |
| Fiat | Multiple currencies | USD only |
Features
| Category | What It Does |
|---|---|
| Market Data | Prices, order books, trades, candlesticks (no auth) |
| Spot Trading | Market/limit orders, order management |
| Wallets | Balances, deposit/withdraw crypto |
| Accounts | Account info, trade history, permissions |
| Staking | View staking products, stake/unstake |
| OTC | Over-the-counter block trading |
| Sub-Accounts | Manage sub-accounts (institutional) |
Quick Start
npx @nirholas/binance-us-mcp
Claude Desktop Config
{
"mcpServers": {
"binance-us": {
"command": "npx",
"args": ["@nirholas/binance-us-mcp"],
"env": {
"BINANCE_US_API_KEY": "your-key",
"BINANCE_US_API_SECRET": "your-secret"
}
}
}
}
Authentication & Security
- HMAC-SHA256 request signing
- Automatic timestamp synchronization
- Built-in rate limiting (respects Binance.US limits)
- IP allowlisting support
- WebSocket connections for real-time data
Market Data Tools (Public)
| Tool | Description |
|---|---|
getPrice |
Current price for a symbol |
get24hrStats |
24-hour price statistics |
getOrderBook |
Order book depth |
getKlines |
Candlestick data (OHLCV) |
getTrades |
Recent trades |
Trading Tools (Authenticated)
| Tool | Description |
|---|---|
placeOrder |
New market/limit order |
cancelOrder |
Cancel open order |
getOpenOrders |
List open orders |
getAccount |
Account balances & info |
getTradeHistory |
Order execution history |
Agent Patterns
Market Monitor
Agent: Watch BTC/USD. Alert if price drops below $58,000.
→ Uses getPrice on interval, sends notification when triggered
Dollar-Cost Averaging
Agent: Buy $100 of ETH every Monday at market price.
→ Uses placeOrder with market type on schedule
Portfolio Report
Agent: Generate weekly portfolio summary with P&L.
→ Uses getAccount + get24hrStats for all held assets
Combining with DeFi
Once assets are on Binance.US, agents can recommend moving to DeFi for better yields:
- Withdraw USDT/USDC to Arbitrum wallet
- Mint Sperax USDs for automatic 8-25% APY
- Or deploy to Sperax Farms for LP yield
Links
- GitHub: https://github.com/nirholas/Binance-US-MCP
- Binance.US API Docs: https://docs.binance.us/
- Sperax (DeFi yield): https://app.sperax.io