mcp-server-cex-bn

This MCP Server provides comprehensive integration with Binance's spot and futures trading operations.

中文说明

Features

Spot Trading Operations

• Execute spot trading operations (LIMIT/MARKET orders)
• Monitor account balances
• Track and manage open orders
• Cancel existing orders

Futures Trading Operations

• Create various types of futures orders (LIMIT, MARKET, STOP, TAKE_PROFIT, etc.)
• Manage leverage settings (1-125x)
• Monitor futures positions and account information
• Track funding rates
• Support for both one-way and hedge mode positions
• Advanced order types including trailing stops and reduce-only orders

Tools

API Configuration

configure_api_keys

Securely store your Binance API credentials:

await configureBinanceApiKeys({
  apiKey: 'your-api-key',
  apiSecret: 'your-api-secret'
});

Spot Trading Tools

create_spot_order

Create LIMIT or MARKET orders:

// LIMIT order
await createSpotOrder({
  symbol: 'BTCUSDT',
  side: 'BUY',
  type: 'LIMIT',
  quantity: '0.001',
  price: '40000'
});

// MARKET order
await createSpotOrder({
  symbol: 'BTCUSDT',
  side: 'BUY',
  type: 'MARKET',
  quantity: '0.001'
});

cancel_order

Cancel an existing order:

await cancelOrder({
  symbol: 'BTCUSDT',
  orderId: '12345678'
});

get_balances

Check your account balances:

const balances = await getBalances();
// Returns: { BTC: '0.1', USDT: '1000', ... }

get_open_orders

List all open orders:

const orders = await getOpenOrders({
  symbol: 'BTCUSDT' // Optional: specify symbol
});

Futures Trading Tools

create_futures_order

Create various types of futures orders:

// LIMIT order
await createFuturesOrder({
  symbol: 'BTCUSDT',
  side: 'BUY',
  type: 'LIMIT',
  quantity: '0.001',
  price: '40000',
  timeInForce: 'GTC'
});

// STOP MARKET order
await createFuturesOrder({
  symbol: 'BTCUSDT',
  side: 'SELL',
  type: 'STOP_MARKET',
  quantity: '0.001',
  stopPrice: '38000'
});

// TRAILING STOP order
await createFuturesOrder({
  symbol: 'BTCUSDT',
  side: 'SELL',
  type: 'TRAILING_STOP_MARKET',
  quantity: '0.001',
  callbackRate: '1.0' // 1% callback rate
});

set_futures_leverage

Adjust leverage for a trading pair:

await setFuturesLeverage({
  symbol: 'BTCUSDT',
  leverage: 10  // 1-125x
});

get_futures_positions

Get all open futures positions:

const positions = await getFuturesPositions();

get_futures_account

Get detailed futures account information:

const account = await getFuturesAccount();

get_funding_rate

Get funding rate for a futures symbol:

const fundingRate = await getFundingRate({
  symbol: 'BTCUSDT'
});

cancel_futures_order

Cancel an existing futures order:

await cancelFuturesOrder({
  symbol: 'BTCUSDT',
  orderId: '12345678'
});

Futures Trading Details

Position Modes

• One-way Mode: Single position per symbol
  • Default mode, simpler position management
  • Total position size is the sum of all orders
• Hedge Mode: Separate long and short positions
  • Allows holding both long and short positions simultaneously
  • Each position has independent margin requirements

Margin Types

• Isolated Margin: Fixed margin per position
  • Risk is limited to the allocated margin
  • Each position has its own leverage setting
• Cross Margin: Shared margin across positions
  • Higher capital efficiency
  • Shared risk across all positions

Funding Rate

Perpetual futures contracts use funding rates to keep futures prices aligned with spot prices:

• Positive rate: Longs pay shorts
• Negative rate: Shorts pay longs
• Payments occur every 8 hours

Security Considerati

... View full README on GitHub