Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BINANCE_API_KEY | Yes | Binance API key with Futures trading enabled. | |
| BINANCE_API_SECRET | Yes | Binance API secret. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ping | Test connectivity to the Binance Futures API. Returns {} on success. |
| get_ticker | Get latest price, 24 h stats, and mark/index prices for a symbol. Returns a merged dict with:
|
| get_order_book | Get order book bids and asks for a symbol. Returns top |
| get_recent_trades | Get the most recent public trades for a symbol. |
| get_klines | Get OHLCV candlestick data for a symbol. Returns list of dicts with: openTime, open, high, low, close, volume, closeTime, quoteVolume, trades, takerBuyVolume, takerBuyQuoteVolume. |
| get_symbol_info | Get trading rules for a symbol: tick size, lot size, min notional, max leverage, etc. |
| get_balance | Get futures wallet balances for all assets with non-zero balance. Returns list of: asset, balance, availableBalance, crossWalletBalance, unrealizedProfit. |
| get_positions | Get current open positions (non-zero size). Per position: symbol, side, size, entryPrice, markPrice, unrealizedPnl, percentage, leverage, marginType, isolatedMargin, liquidationPrice. |
| get_account_summary | Get account-level summary: total balance, unrealized PnL, margin ratio, positions count. |
| get_open_orders | Get open orders for a symbol. Returns list of: orderId, clientOrderId, symbol, status, type, side, positionSide, price, origQty, executedQty, avgPrice, stopPrice, timeInForce, reduceOnly, closePosition, updateTime. Algo (conditional) orders also include '_isAlgo': True. |
| get_order | Get details of a specific order by orderId or clientOrderId. |
| get_order_history | Get recent order history for a symbol (all statuses). |
| place_order | Place a new futures order. ORDER TYPE GROUPS — choose the right one: Immediate orders (fill now or queue at price): MARKET: side=BUY, quantity=0.01 LIMIT: side=SELL, quantity=0.01, price=50000, time_in_force=GTC Conditional orders (wait for stop_price trigger, then execute): Stop-loss full close: side=SELL, type=STOP_MARKET, stop_price=45000, close_position=True Take-profit full close: side=SELL, type=TAKE_PROFIT_MARKET, stop_price=60000, close_position=True Stop-loss partial: side=SELL, type=STOP_MARKET, stop_price=45000, quantity=0.01, reduce_only=True Trailing stop: side=SELL, type=TRAILING_STOP_MARKET, stop_price=45000, quantity=0.01, callback_rate=1.0 IMPORTANT — close_position=True vs quantity+reduce_only: close_position=True → closes the ENTIRE position, no quantity needed, max 1 SL + 1 TP active at a time. reduce_only=True → closes a PARTIAL quantity, multiple allowed simultaneously. Never mix both on the same order. |
| modify_order | Modify price or quantity of an existing open LIMIT order (PUT /fapi/v1/order). |
| cancel_order | Cancel a single open order by orderId or clientOrderId. For algo (conditional) orders returned by get_open_orders with '_isAlgo': True, set is_algo=True — this routes to the Algo API using algoId. |
| cancel_all_orders | Cancel all open orders for a symbol. With source='all' (default), cancels both regular and algo (conditional) orders in parallel. |
| get_trade_history | Get your personal trade execution history for a symbol (fills). |
| set_leverage | Set leverage for a symbol. Returns the new leverage and max notional value. |
| set_margin_type | Switch margin type for a symbol between ISOLATED and CROSSED. Note: Cannot change margin type while a position or open order exists. |
| adjust_isolated_margin | Add or remove margin from an isolated position. Only valid when the symbol is in ISOLATED margin mode with an open position. |
| set_position_mode | Switch between One-way Mode and Hedge Mode for the account. Note: Cannot change while any positions or open orders exist. |
| get_position_mode | Get current position mode: Hedge Mode or One-way Mode. |
| get_leverage_brackets | Get leverage brackets for a symbol: max leverage per notional tier with maintenance margin rates. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |