Binance TH MCP Server

MCP (Model Context Protocol) server for Binance Thailand (Gulf Binance) API. Market data, trading, orders, wallet, and account management through 27 tools.

Works with Claude Desktop, Cursor, VS Code, and any MCP client.

WARNING: This package interacts with a real cryptocurrency exchange. There is no testnet. All trading and withdrawal operations use real money. Use with caution.

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "binance-th": {
      "command": "npx",
      "args": ["-y", "@node2flow/binance-th-mcp"],
      "env": {
        "BINANCE_TH_API_KEY": "your-api-key",
        "BINANCE_TH_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Cursor / VS Code

Add to MCP settings:

{
  "mcpServers": {
    "binance-th": {
      "command": "npx",
      "args": ["-y", "@node2flow/binance-th-mcp"],
      "env": {
        "BINANCE_TH_API_KEY": "your-api-key",
        "BINANCE_TH_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Market Data Only (No API Key)

Market data tools (10 tools) work without API keys:

{
  "mcpServers": {
    "binance-th": {
      "command": "npx",
      "args": ["-y", "@node2flow/binance-th-mcp"]
    }
  }
}

HTTP Mode (Streamable HTTP)

BINANCE_TH_API_KEY=xxx BINANCE_TH_SECRET_KEY=xxx npx @node2flow/binance-th-mcp --http

Server starts on port 3000 (configurable via PORT env var). MCP endpoint: http://localhost:3000/mcp

Configuration

| Environment Variable | Required | Description | |---|---|---| | BINANCE_TH_API_KEY | For trading | API key from Binance TH | | BINANCE_TH_SECRET_KEY | For trading | Secret key for HMAC signing | | PORT | No | Port for HTTP server (default: 3000, only with --http) |

All Tools (27 tools)

General (3 tools)

| Tool | Description | |---|---| | bth_server_time | Get server time (for timestamp sync) | | bth_exchange_info | Get trading rules, symbols, and filters | | bth_symbol_type | Check GLOBAL vs SITE (Thailand) symbols |

Market Data (7 tools) — No API key needed

| Tool | Description | |---|---| | bth_order_book | Get order book (bids/asks) depth | | bth_recent_trades | Get recent trades for a symbol | | bth_aggregate_trades | Get compressed aggregate trades | | bth_klines | Get candlestick/OHLCV data | | bth_ticker_24hr | Get 24-hour price statistics | | bth_ticker_price | Get latest price (single or all) | | bth_book_ticker | Get best bid/ask price |

Account (3 tools)

| Tool | Description | |---|---| | bth_account_info | Get balances and account permissions | | bth_trade_list | Get trade history for a symbol | | bth_trade_fee | Get maker/taker fee rates |

Orders (6 tools)

| Tool | Description | |---|---| | bth_new_order | Place a new order (LIMIT, MARKET, etc.) | | bth_query_order | Query order status by ID | | bth_cancel_order | Cancel a specific order | | bth_open_orders | Get all open/pending orders | | bth_all_orders | Get full order history | | bth_cancel_all_orders | Cancel all open orders for a symbol |

Wallet (4 tools)

| Tool | Description | |---|---| | bth_withdraw | Withdraw crypto (IRREVERSIBLE) | | bth_deposit_address | Get deposit address for a coin | | bth_deposit_history | Get deposit history | | bth_withdraw_history | Get withdrawal history |

SubAccount (1 tool)

| Tool | Description | |---|---| | bth_sub_account_transfer | Transfer assets between sub-accounts |

User Data Stream (3 tools)

| Tool | Description | |---|---| | bth_create_listen_key | Create WebSocket listen key | | bth_keepalive_listen_key | Extend listen key (every 60 min) | | bth_close_listen_key | Close/invalidate listen key |

Requirements

• Node.js 18+
• Binance TH account with API keys (for trading operations)

How to Get API Keys

1. Go to binance.th and log in
2. Navigate to API Management in account settings
3. Create a new API key
4. Copy both the API Key and Secret Key
5. Restrict permissions as needed (read-only for market data, enable trading for orders)

Security Best Practices

• Never share API keys or secret keys
• Use IP whitelist in API key settings
• Restrict permissions to only what you need
• Read-only keys for market data monitoring
• Store secrets in environment variables, never in code
• Rotate keys regularly

Risk Warning

• No testnet — All operations execute on the real exchange
• Real money — Orders and withdrawals use actual funds
• Withdrawals are irreversible — Double-check addresses and amounts
• Rate limits — 1200 weight per minute, violations result in 2-minute to 3-day bans
• Market risk — Cryptocurrency prices are highly volatile

For Developers

git clone https://github.com/node2flow-th/binance-th-mcp-community.git
cd binance-th-mcp-community
npm install
npm run build

# Run in stdio mode (market data only)
npm start

# Run with full access
BINANCE_TH_API_KEY=xxx BINANCE_TH_SECRET_KEY=xxx npm start

# Run in HTTP mode
BINANCE_TH_API_KEY=xxx BINANCE_TH_SECRET_KEY=xxx npm start -- --http

License

MIT License - see LICENSE

Copyright (c) 2026 Node2Flow

Links

• npm Package
• Binance TH API Docs
• MCP Protocol
• Node2Flow