# Bitkub

MCP server for Bitkub — Thailand's leading cryptocurrency exchange.

## Quick Start

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

# Browse available tools
npx -y @smithery/cli@latest tool list node2flow/bitkub

# Get full schema for a tool
npx -y @smithery/cli@latest tool get node2flow/bitkub btk_server_time

# Call a tool
npx -y @smithery/cli@latest tool call node2flow/bitkub btk_server_time '{}'
```

## Direct MCP Connection

Endpoint: `https://bitkub--node2flow.run.tools`

**Optional config:**
- `BITKUB_API_KEY` (query) — API key from Bitkub (required for trading/account operations)
- `BITKUB_SECRET_KEY` (query) — Secret key for HMAC SHA-256 signing (required for trading/account operations)

## Tools (28)

- `btk_server_time` — Get Bitkub server time (millisecond timestamp). Use to check connectivity and sync timestamps for signed requests.
- `btk_server_status` — Get Bitkub API server status. Returns status for both non-secure and secure endpoints.
- `btk_symbols` — List all trading symbols on Bitkub with details: base/quote asset, price scale, min order size, status, market segment.…
- `btk_ticker` — Get 24-hour ticker data: last price, bid/ask, percent change, volume, high/low. Returns all symbols if no sym specified.
- `btk_recent_trades` — Get recent trades for a symbol. Each trade includes timestamp, price, amount, and side (BUY/SELL).
- `btk_bids` — Get buy-side order book (bids) for a symbol. Each entry: [price, volume, timestamp].
- `btk_asks` — Get sell-side order book (asks) for a symbol. Each entry: [price, volume, timestamp].
- `btk_books` — Get complete order book (both bids and asks) for a symbol.
- `btk_depth` — Get market depth for a symbol. Similar to order book but without timestamps — just [price, volume] pairs.
- `btk_tradingview_history` — Get TradingView-compatible OHLCV candlestick data. Returns arrays of open, high, low, close, volume for charting.
- `btk_wallet` — Get available balances for all currencies. Shows only available balance (not reserved). For full balance info, use btk_…
- `btk_balances` — Get complete balances for all currencies including both available and reserved amounts.
- `btk_trading_credits` — Get trading credit balance. Trading credits can be used to offset trading fees.
- `btk_user_limits` — Get user deposit/withdrawal limits and current usage for both crypto and fiat currencies.
- `btk_place_bid` — Place a buy order. For limit orders specify rate. For market orders, rate is ignored. WARNING: Uses real money.
- `btk_place_ask` — Place a sell order. For limit orders specify rate. For market orders, rate is ignored. WARNING: Uses real money.
- `btk_place_bid_test` — Test (dry run) a buy order. Validates parameters without placing an actual order. Safe to use — no real money involved.
- `btk_place_ask_test` — Test (dry run) a sell order. Validates parameters without placing an actual order. Safe to use — no real money involved.
- `btk_cancel_order` — Cancel an open order. Requires symbol, order ID, and side (buy/sell).
- `btk_my_open_orders` — Get all open (pending) orders for a symbol.
- `btk_my_order_history` — Get order history for a symbol. Supports pagination and date range filtering. History older than 90 days is archived.
- `btk_order_info` — Get detailed information about a specific order including fill history, status, and remaining amount.
- `btk_crypto_addresses` — List all crypto deposit addresses for your account. Shows currency, address, tag/memo, and network.
- `btk_crypto_withdraw` — Withdraw crypto to an external address. WARNING: IRREVERSIBLE — double-check address, network, and amount before execut…
- `btk_crypto_internal_withdraw` — Transfer crypto to another Bitkub user by email or phone number. Faster and cheaper than blockchain withdrawal. WARNING…
- `btk_crypto_deposit_history` — Get crypto deposit history with status, confirmations, and transaction details.
- `btk_crypto_withdraw_history` — Get crypto withdrawal history with status, fees, and transaction details.
- `btk_crypto_generate_address` — Generate a new crypto deposit address for a specific currency.

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

## Resources

- `bitkub://server-info` — Connection status and available tools for this Bitkub MCP server

## Prompts (2)

- `market-data-analysis` — Guide for fetching and analyzing Bitkub market data
- `trading-guide` — Guide for placing and managing orders on Bitkub safely

---

License: MIT