Wallex MCP Server

A Model Context Protocol (MCP) server for interacting with the Wallex Cryptocurrency Exchange API.

Features

This MCP server provides the following tools:

1. get_account_balances - Get account balances for all assets
2. get_historical_data_ohlc - Get historical OHLC (Open, High, Low, Close) data for trading pairs

Prerequisites

• Go 1.21 or higher
• Wallex API key

Installation

1. Clone the repository:

git clone <repository-url>
cd wallex-mcp-server

2. Install dependencies:

go mod tidy

3. Build the application:

go build -o wallex_mcp_server .

4. Add your MCP server to Claude Code

"mcpServers": {
  "wallex_mcp": {
    "command": "/Users/johnsmith//wallex_mcp_server",
    "args": [],
    "env": {
      "WALLEX_API_KEY": "YOUR_API_KEY_HERE"
    }
  }
}

• command: Path to the Wallex MCP server executable.
• WALLEX_API_KEY: Add your Wallex API key.

Place this block in your Claude MCP configuration file (e.g., ~/.claude.json).

Available Tools

The server communicates via stdio (standard input/output) and implements the MCP protocol. Here's how to use each tool:

get_account_balances

Retrieves all asset balances in your wallet.

{
  "tool": "get_account_balances",
  "arguments": {}
}

Returns a map of assets with:

• Asset symbol and name
• Whether it's a fiat currency
• Current balance

get_historical_data_ohlc

Retrieves OHLC candlestick data for a specific trading pair and time range.

{
  "tool": "get_historical_data_ohlc",
  "arguments": {
    "symbol": "BTCUSD",
    "resolution": "60",
    "from": 1640995200,
    "to": 1641081600
  }
}

Parameters:

• symbol (string, required): Trading pair symbol (e.g., "BTCUSD")
• resolution (string, required): Candle interval
  • "1" for 1-minute candles
  • "60" for hourly candles
  • "180" for 3-hour candles
  • "360" for 6-hour candles
  • "720" for 12-hour candles
  • "1D" for daily candles
• from (integer, required): Start timestamp (Unix timestamp)
• to (integer, required): End timestamp (Unix timestamp)

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

This project is licensed under the MIT License.