Ccxt MCP

🚀 CCXT Trading Robot Protocol Server (MCP)

CCXT is a powerful cryptocurrency exchange interface library that supports multiple exchanges such as Binance, Coinbase, and OKEx. This project builds an MCP (Machine Learning Protocol) server based on CCXT, aiming to interact with cryptocurrency exchanges through AI models.

🚀 Quick Start

How to Run

# Clone the repository
git clone https://github.com/lazy-dinosaur/ccxt-mcp.git

# Navigate to the project directory
cd ccxt-mcp

# Install dependencies
npm install

# Build the project
npm run build

✨ Features

• Market Information Retrieval

  • List all available exchanges.
  • Retrieve market information for a specific exchange.
  • View price data for specific trading pairs.
  • Obtain order book information.
  • Query historical OHLCV (Open, High, Low, Close, Volume) data.

• Trading Functions

  • Create market and limit orders.
  • Cancel orders and check order status.
  • View account balance.
  • Query trading records.

• Trading Analysis

  • Daily/weekly/monthly performance analysis.
  • Win rate calculation (past 7 days, 30 days, all time).
  • Average profit/loss ratio (R multiple).
  • Analysis of the maximum consecutive loss/profit series.
  • Asset volatility tracking.
  • Comprehensive performance indicators.
  • Trading pattern recognition.
  • Calculate returns by time period.

• Position Management

  • Trade with a capital ratio (e.g., open a position with 5% of the account capital).
  • Set leverage in the futures market (1 - 100x).
  • Adjust position size based on volatility.
  • Implement a batch buying/selling strategy.

• Risk Management

  • Set stop-loss based on technical indicators (e.g., set stop-loss at the lowest point in the last 12 five-minute candlesticks).
  • Volatility-based stop-loss/take-profit (based on multiples of ATR).
  • Set daily/weekly maximum allowable loss limits.
  • Dynamic take-profit setting (trailing take-profit).

💻 Usage Examples

Basic Usage

View and compare the current Bitcoin prices on Binance and Coinbase.

Advanced Usage

Position Management

Open a long position in the BTC/USDT futures market on the Bybit account (bybit_futures), using 5% of the capital and setting 10x leverage. Enter the market based on the Moving Average Convergence Divergence strategy and set the stop-loss at the lowest point in the last 12 five-minute candlesticks.

Performance Analysis

Analyze my trading records on the Binance account (bybit_main) in the past 7 days, showing the win rate, average profit, and maximum consecutive loss.

📚 Documentation

Development Guide

Build from Source

# Clone the repository
git clone https://github.com/lazy-dinosaur/ccxt-mcp.git

# Install dependencies
npm install

# Build the project
npm run build

API Documentation

All API endpoints are implemented based on the Express framework. Please refer to the api-docs.md file for specific details.

📄 License

This project is licensed under the MIT license. Please check the LICENSE file for specific license details.

📋 Important Note

When using the AI model, please consider the following points:

• Before trading, ensure to accurately distinguish between the futures market and the spot market.
• If there is no clear indication regarding the capital ratio or amount to use, the entire available capital should be used for calculations by default.