Binance.US MCP Server

Test connectivity to the Binance.US API. Returns empty object if successful.

Get the current server time from Binance.US exchange.

Check if Binance.US system is under maintenance. Status 0 = normal, 1 = system maintenance. Requires API key authentication.

Get current exchange trading rules and trading pair information from Binance.US. Can filter by specific symbol(s) or permissions.

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).

Get recent trades for a trading pair on Binance.US. Returns trade ID, price, quantity, time, and maker/taker info.

Get older historical trades for a trading pair. Requires API key with MARKET_DATA permission.

Get compressed aggregate trades. Trades with same time, order, and price are aggregated.

Get Kline/candlestick data for a trading pair. Returns OHLCV data.

Get current 5-minute rolling weighted average price.

Get 24-hour rolling window price change statistics.

Get latest price for symbol(s).

Get best bid/ask prices and quantities (top of book).

Get rolling window price change statistics with custom window sizes (1m to 7d).

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.

Test a new order on Binance.US without actually placing it. Validates order parameters and signature without executing the trade.

Query the status of a specific order on Binance.US. Either orderId or origClientOrderId must be provided.

Cancel an active order on Binance.US. Either orderId or origClientOrderId must be provided.

Cancel an existing order and place a new order on the same symbol atomically. This is useful for modifying order parameters.

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.

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).

Get all orders (active, canceled, or filled) for a symbol on Binance.US. Returns order history.

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.

Query a specific OCO order on Binance.US. Either orderListId or origClientOrderId must be provided.

Cancel an entire OCO order on Binance.US. Cancelling any individual leg will cancel the entire OCO.

Get all open OCO orders on Binance.US.

Get all OCO orders (history) on Binance.US. Returns up to 1000 orders.

Get details of all crypto assets including fees, withdrawal limits, and network status. Shows deposit/withdrawal enabled status per network.

Submit a crypto withdrawal request. Requires withdrawal permission on API key. ⚠️ This action transfers funds OUT of your account - verify address carefully!

Submit a USD withdrawal request via BITGO. ⚠️ This action transfers USD OUT of your account!

Get crypto withdrawal history. Filter by coin, status, or time range.

Get crypto deposit history. Filter by coin, status, or time range.

Get a deposit address for a specific crypto asset. Use this to receive funds into your Binance.US account.

Get current account information including balances and permissions. Returns all asset balances (free and locked), account permissions, and trading status.

Get trade history for a specific trading pair. Returns executed trades including price, quantity, commission, and timestamps.

Get current trade order count rate limits for all time intervals. Shows how many orders you can place within each interval.

Get your current maker & taker fee rates for spot trading based on your VIP level. BNB fee discount (25% off) is not factored in.

Get total trade volume for the past 30 days. Volume is calculated on a rolling basis every day at 0:00 AM (UTC).

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.

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

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

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

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

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

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.

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

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

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.

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.

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.

Get a list of all sub-accounts. Filter by email or status (enabled/disabled).

Get transfer history between master and sub-accounts.

Execute an asset transfer between master account and a sub-account. ⚠️ This moves funds between accounts!

Get asset balances for a specific sub-account.

Get the total USD value of assets in the master account and all sub-accounts.

Get status list of sub-accounts including activation status and enabled features.

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.

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.

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.

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

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

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

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

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

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

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

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

Get available balance in the custodial sub-account for trading.

⚠️ REQUIRES CUSTODIAL SOLUTION API KEY

Returns the balance available for placing new orders.

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

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.

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

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

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.

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

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

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.

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.

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

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

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

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

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.

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.

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.

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.

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.

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.

Get history of settlements from custodial sub-account to custodial partner.

⚠️ REQUIRES CUSTODIAL SOLUTION API KEY

Returns settlement history with status, amounts, and timestamps.

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)

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

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

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:

1. Your LTV won't exceed marginCallLTV after transfer

2. You have sufficient availableAmountToTransferOut

3. 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

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