bitget-wallet-mcp

Bitget Wallet MCP Server

An MCP (Model Context Protocol) server that exposes Bitget Wallet on-chain API as tools for AI agents.

Features

📊 Market Data (21 tools)

• Token Search — v3 keyword search with ordering + v2 broader DEX search
• Token Info — price, market cap, holders, social links (single + batch)
• Market Info — price, MC, FDV, liquidity, holders, narratives, pool list
• K-line — candlestick data + simplified K-line with smart money/KOL overlays
• Transaction Stats — buy/sell volume, trader counts (single + batch)
• Trading Dynamics — buy/sell pressure across time windows
• Transaction List — recent trades with tag filtering (KOL, smart money)
• Holder Analysis — distribution, top holders, special holder filters
• Profit Analysis — profitable vs losing addresses, top earners per token
• Developer Analysis — dev history, rug rate, project migration status
• Rankings — top gainers, top losers, hot picks
• Liquidity Pools — LP pool information per token
• Launchpad Scanning — new tokens on pump.fun etc. with filters
• Historical Tokens — discover tokens by creation timestamp
• Security Audit — honeypot detection, permission checks, tax analysis

🔍 Smart Money (1 tool)

• Address Discovery — find KOL and smart money wallets with PnL, win rate, trade count filters

📈 RWA Stock Trading (6 tools)

• Ticker List — available RWA stocks (NVDA, TSLA, AAPL, etc.) on BNB/ETH
• Stock Info — market status, trading limits, description
• Order Price — pre-trade buy/sell price display
• K-line — stock price charts
• Trading Config — stablecoins, slippage, amount limits, gas info
• Portfolio — user's RWA holdings

💱 Swap (7 tools)

• Quote — multi-market quotes with requestId
• Confirm — second quote with MEV protection, gas features
• Make Order — create order, get unsigned txs
• Send — submit signed transactions
• Order Details — track order status (init → processing → success/failed)
• Check Token — pre-trade risk check
• Token List — popular tokens per chain

🔁 Token Transfer (3 tools)

• Make Transfer Order — create transfer order, get unsigned tx data (supports gasless)
• Submit Transfer — submit signed transfer transaction
• Get Transfer Order — poll transfer order status (PENDING → PROCESSING → SUCCESS/FAILED)

💰 Balance (1 tool)

• Batch Balance — multi-chain token balances with USD values

Supported Chains

Ethereum · Solana · BNB Chain · Base · Arbitrum · Tron · TON · Sui · Optimism · Polygon · Morph

Quick Start

Install

pip install -e .

Run

python server.py

Or via MCP CLI:

mcp run server.py

Configure in Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "bitget-wallet": {
      "command": "python",
      "args": ["/path/to/bitget-wallet-mcp/server.py"]
    }
  }
}

Configure in Cursor / Windsurf

Add to your MCP settings:

{
  "bitget-wallet": {
    "command": "python",
    "args": ["/path/to/bitget-wallet-mcp/server.py"]
  }
}

Tools (39)

Market Data

Tool	Description
token_info	Detailed token info (price, market cap, supply, holders)
token_price	Quick price lookup
batch_token_info	Multi-token info in one call
search_tokens	v3 token search with ordering
search_tokens_v2	v2 broader search (DEX tokens)
coin_market_info	Market info + pool list + narratives
coin_dev	Developer history and rug rate
kline	Candlestick data (1s to 1w periods)
simple_kline	K-line with smart money/KOL/developer overlays
tx_info	Transaction volume and trader stats
batch_tx_info	Batch transaction stats
trading_dynamics	Buy/sell pressure across time windows
transaction_list	Recent trades with tag filtering
holders_info	Holder distribution and top holders
profit_address_analysis	Profitable vs losing address stats
top_profit	Top profitable addresses per token
rankings	Top gainers / losers / hot picks
liquidity	Liquidity pool info
launchpad_tokens	Launchpad scanning with filters
historical_coins	Discover tokens by creation time
security_audit	Contract security checks

Smart Money

Tool	Description
smart_money_addresses	KOL/smart money address discovery with filters

RWA Stock Trading

Tool	Description
rwa_ticker_list	Available RWA stocks
rwa_config	Trading config (stablecoins, limits)
rwa_stock_info	Stock info and market status
rwa_order_price	Pre-trade buy/sell price
rwa_kline	Stock K-line charts
rwa_my_holdings	User's RWA portfolio

Swap

Tool	Description
swap_quote	Multi-market swap quotes
swap_confirm	Confirm with MEV protection
swap_make_order	Create order (unsigned txs)
swap_send	Submit signed transactions
swap_get_order_details	Track order status
check_swap_token	Pre-trade risk check
get_token_list	Popular tokens per chain

Token Transfer

Tool	Description
transfer_make_order	Create transfer order (unsigned tx data, supports gasless)
transfer_submit	Submit signed transfer transaction
transfer_get_order	Poll transfer order status

Balance

Tool	Description
balance	Batch balance + USD values

⚠️ Amounts are human-readable — pass "0.1" for 0.1 USDT, NOT wei/lamports.

Environment Variables

Variable	Default	Description
BGW_WALLET_ID	(empty)	Wallet ID for Social Login Wallet users (optional)

No API key required — uses SHA256 hash signing (BKHmacAuth).

Security

• Only communicates with https://copenapi.bgwapi.io — no other external endpoints
• No API keys or secrets — SHA256 hash signing with zero credentials
• No eval() / exec() or dynamic code execution
• No file system access outside the project directory
• No data collection, telemetry, or analytics
• No access to sensitive files (SSH keys, credentials, wallet files, etc.)
• Dependencies: requests, mcp only
• SlowMist security review: 🟢 LOW risk
• We recommend auditing the source yourself before installation

Related Projects

• bitget-wallet-skill — OpenClaw AI Agent skill
• bitget-wallet-cli — CLI tool for terminal users

License

MIT