Test connectivity to the Binance Futures API. Returns {} on success.

Get latest price, 24 h stats, and mark/index prices for a symbol.

Returns a merged dict with:

• price, priceChange, priceChangePct, high, low, volume, quoteVolume

• markPrice, indexPrice, fundingRate, nextFundingTime

Get order book bids and asks for a symbol.

Returns top limit bids and asks as [[price, qty], ...] lists.

Get the most recent public trades for a symbol.

Get OHLCV candlestick data for a symbol.

Returns list of dicts with: openTime, open, high, low, close, volume, closeTime, quoteVolume, trades, takerBuyVolume, takerBuyQuoteVolume.

Get trading rules for a symbol: tick size, lot size, min notional, max leverage, etc.

Get futures wallet balances for all assets with non-zero balance.

Returns list of: asset, balance, availableBalance, crossWalletBalance, unrealizedProfit.

Get current open positions (non-zero size).

Per position: symbol, side, size, entryPrice, markPrice, unrealizedPnl, percentage, leverage, marginType, isolatedMargin, liquidationPrice.

Get account-level summary: total balance, unrealized PnL, margin ratio, positions count.

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 details of a specific order by orderId or clientOrderId.

Get recent order history for a symbol (all statuses).

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 price or quantity of an existing open LIMIT order (PUT /fapi/v1/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 open orders for a symbol.

With source='all' (default), cancels both regular and algo (conditional) orders in parallel.

Get your personal trade execution history for a symbol (fills).

Set leverage for a symbol. Returns the new leverage and max notional value.

Switch margin type for a symbol between ISOLATED and CROSSED.

Note: Cannot change margin type while a position or open order exists.

Add or remove margin from an isolated position.

Only valid when the symbol is in ISOLATED margin mode with an open position.

Switch between One-way Mode and Hedge Mode for the account.

Note: Cannot change while any positions or open orders exist.

Get current position mode: Hedge Mode or One-way Mode.

Get leverage brackets for a symbol: max leverage per notional tier with maintenance margin rates.