BloFin MCP Server

A Model Context Protocol (MCP) server for the BloFin cryptocurrency exchange API. Provides tools for market data, account management, and trading operations.

Features

Public Data (no authentication required)

• get_instruments - Get available trading instruments and contract specs
• get_tickers - Get latest prices, bid/ask, 24h volume
• get_orderbook - Get order book depth
• get_trades - Get recent trades
• get_mark_price - Get mark/index prices
• get_candlesticks - Get OHLCV candlestick data
• get_funding_rate - Get current funding rates
• get_funding_rate_history - Get historical funding rates

Account (authentication required)

• get_balance - Get futures account balance
• get_positions - Get open positions
• get_leverage_info / set_leverage - View/set leverage
• get_margin_mode / set_margin_mode - View/set margin mode
• get_position_mode / set_position_mode - View/set position mode
• get_account_config - Get account configuration

Trading (authentication required)

• place_order - Place a new order (market, limit, post_only, fok, ioc)
• cancel_order - Cancel an order
• batch_orders / cancel_batch_orders - Batch order operations
• close_position - Close a position
• get_open_orders - Get pending orders
• get_order_history - Get order history
• get_order_detail - Get specific order details
• get_fills_history - Get trade fill history
• place_tpsl / cancel_tpsl - Take-profit/stop-loss orders
• get_pending_tpsl / get_tpsl_history - View TP/SL orders
• place_algo_order / cancel_algo_order - Algo/trigger orders
• get_pending_algo_orders / get_algo_order_history - View algo orders

Asset Management (authentication required)

• get_asset_balances - Get balances across account types
• fund_transfer - Transfer funds between accounts
• get_fund_transfer_history - Get transfer history
• get_deposit_history / get_withdrawal_history - Deposit/withdrawal records
• get_apikey_info - Get API key information

Setup

Environment Variables

| Variable | Required | Description | |---|---|---| | BLOFIN_API_KEY | Yes | Your BloFin API key | | BLOFIN_API_SECRET | Yes | Your BloFin API secret | | BLOFIN_PASSPHRASE | Yes | Your BloFin API passphrase | | BLOFIN_BASE_URL | No | API base URL (defaults to demo trading) | | BLOFIN_BROKER_ID | No | Broker ID provided by BloFin (auto-injected into trading requests) |

Base URLs

• Demo Trading: https://demo-trading-openapi.blofin.com (default)
• Production: https://openapi.blofin.com

Install & Build

npm install
npm run build

Claude Desktop

Add to your Claude Desktop config (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "blofin": {
      "command": "npx",
      "args": ["-y", "blofin-mcp"],
      "env": {
        "BLOFIN_API_KEY": "your-api-key",
        "BLOFIN_API_SECRET": "your-api-secret",
        "BLOFIN_PASSPHRASE": "your-passphrase",
        "BLOFIN_BASE_URL": "https://openapi.blofin.com",
        "BLOFIN_BROKER_ID": "your-broker-id"
      }
    }
  }
}

Cursor / Windsurf / Cline

Same configuration format as above. Add to each client's MCP settings.

OpenClaw

Add "mcpServers" to your ~/.openclaw/openclaw.json (top-level field, alongside identity, agent, etc.):

{
  "identity": { "name": "Clawd", "emoji": "🦞" },
  "agent": { "workspace": "~/.openclaw/workspace" },

  // Add this section ↓
  "mcpServers": {
    "blofin": {
      "command": "npx",
      "args": ["-y", "blofin-mcp"],
      "env": {
        "BLOFIN_API_KEY": "your-api-key",
        "BLOFIN_API_SECRET": "your-api-secret",
        "BLOFIN_PASSPHRASE": "your-passphrase",
        "BLOFIN_BASE_URL": "https://openapi.blofin.com",
        "BLOFIN_BROKER_ID": "your-broker-id"
      }
    }
  }
}

If your openclaw.json already has a "mcpServers" section with other servers, just add "blofin": { ... } inside it.

Restart OpenClaw after saving. The agent will automatically discover the 36 BloFin tools.

API Documentation

See BloFin API Docs for full API reference.