# Binance TH

MCP server for Binance Thailand (Gulf Binance) API — trade crypto, monitor markets, and manage your account.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add node2flow/binance-th-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list node2flow/binance-th-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get node2flow/binance-th-mcp bth_server_time

# Call a tool
npx -y @smithery/cli@latest tool call node2flow/binance-th-mcp bth_server_time '{}'
```

## Direct MCP Connection

Endpoint: `https://binance-th-mcp--node2flow.run.tools`

**Optional config:**
- `BINANCE_TH_API_KEY` (query) — Binance TH API key. Get one at https://www.binance.th → API Management.
- `BINANCE_TH_SECRET_KEY` (query) — Binance TH secret key for HMAC SHA256 signing. Required for trading, account, and wallet operations.

## Tools (27)

- `bth_server_time` — Get Binance TH server time (millisecond timestamp). Use to check connectivity and sync timestamps for signed requests.
- `bth_exchange_info` — Get exchange information including trading rules, symbol list, filters (PRICE_FILTER, LOT_SIZE, MIN_NOTIONAL), and rate…
- `bth_symbol_type` — Check if symbols are GLOBAL (international) or SITE (Thailand-specific). Returns type classification for all trading pa…
- `bth_order_book` — Get order book (bids and asks) for a symbol. Limit controls depth: 1-100 (weight 1), 101-500 (weight 5), 501-1000 (weig…
- `bth_recent_trades` — Get recent trades for a symbol. Returns up to 1000 most recent trades.
- `bth_aggregate_trades` — Get compressed/aggregate trades for a symbol. Trades that fill at the same time, price, and side are aggregated.
- `bth_klines` — Get candlestick/kline data for a symbol. Returns OHLCV data (open, high, low, close, volume) for the specified interval.
- `bth_ticker_24hr` — Get 24-hour price change statistics for a symbol. Includes price change, high/low, volume, and trade count.
- `bth_ticker_price` — Get latest price for a symbol or all symbols. If symbol is omitted, returns prices for all trading pairs.
- `bth_book_ticker` — Get best bid/ask price and quantity for a symbol.
- `bth_account_info` — Get account information including balances, commission rates, and trading permissions. Requires API key with SIGNED sec…
- `bth_trade_list` — Get trade history for a specific symbol. Returns executed trades with price, quantity, commission, and timestamps.
- `bth_trade_fee` — Get trading fee rates (maker and taker commission) for one or all symbols.
- `bth_query_order` — Query a specific order by orderId or origClientOrderId. Returns order status, filled quantity, and execution details.
- `bth_new_order` — Place a new order. WARNING: This uses REAL MONEY. Supports LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE…
- `bth_cancel_order` — Cancel an active order by orderId or origClientOrderId.
- `bth_open_orders` — Get all open orders for a symbol or all symbols. Without symbol: weight 40, with symbol: weight 3.
- `bth_all_orders` — Get all orders (active, canceled, filled) for a symbol. Supports time range and pagination.
- `bth_cancel_all_orders` — Cancel all open orders for a symbol. WARNING: This cancels ALL pending orders at once.
- `bth_withdraw` — Withdraw cryptocurrency to an external address. WARNING: Withdrawals are IRREVERSIBLE. Double-check address and amount …
- `bth_deposit_address` — Get deposit address for a specific coin and network.
- `bth_deposit_history` — Get deposit history with optional filters by coin, status (0=pending, 1=success), and time range.
- `bth_withdraw_history` — Get withdrawal history. Status codes: 0=email sent, 1=cancelled, 2=awaiting approval, 3=rejected, 4=processing, 5=failu…
- `bth_sub_account_transfer` — Transfer assets between sub-accounts. WARNING: Transfers real funds between accounts.
- `bth_create_listen_key` — Create a listen key for user data stream (WebSocket). The key is valid for 60 minutes and must be kept alive with keepa…
- `bth_keepalive_listen_key` — Keepalive a listen key to extend its validity. Should be called every 60 minutes to prevent expiration.
- `bth_close_listen_key` — Close/invalidate a listen key. The associated user data stream will be terminated.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get node2flow/binance-th-mcp <tool-name>
```

## Resources

- `binance-th://server-info` — Connection status and available tools for this Binance TH MCP server

## Prompts (2)

- `market-data-analysis` — Guide for fetching and analyzing Binance TH market data
- `trading-and-orders` — Guide for placing and managing orders on Binance TH

---

License: MIT