This project provides an autonomous AI-driven cryptocurrency trading system, integrating large language models (LLMs) with quantitative trading strategies. It targets traders and power users seeking to leverage AI for market analysis and automated trade execution with minimal human intervention, moving beyond traditional rule-based systems.

How It Works

The system is built on the VoltAgent framework, featuring a Trading Agent powered by LLMs (e.g., DeepSeek V3.2, Grok4, Claude) responsible for autonomous market data analysis, position management, and trade execution decisions. This agent interacts with the VoltAgent Core for orchestration and tool routing. Trading tools provide access to market data, account information, and trade execution capabilities, interfacing with a Gate.io API client for order management and position queries. Local data persistence is handled by LibSQL (SQLite). This approach allows AI models to learn and decide based on raw market data, offering a novel alternative to hardcoded trading rules.

Quick Start & Requirements

• Primary install/run command: Clone the repository, run npm install, npm run db:init, then npm run dev for development or npm run trading:start for production.
• Non-default prerequisites: Node.js version >= 20.19.0, npm or pnpm package manager, Git. Requires Gate.io API credentials (testnet recommended), an OpenAI-compatible API key (e.g., from OpenRouter, DeepSeek), and LibSQL (local SQLite database).
• Configuration: A .env file is required for server settings, trading parameters (interval, leverage, max positions, holding hours, initial balance), API keys, AI model selection, and account drawdown risk controls.
• Links: Gate.io (official and testnet), OpenRouter, OpenAI, DeepSeek. Full documentation is available in English, Chinese, and Japanese.

Highlighted Details

• AI Decision Models: Supports advanced LLMs including DeepSeek V3.2, Grok4, Claude 4.5, and Gemini Pro 2.5 for autonomous market analysis without pre-configured trading signals.
• Risk Management: Features AI-controlled leverage and position sizing, with configurable drawdown thresholds for risk warnings, halting new positions, and forcing closure of all positions.
• Trading Capabilities: Supports trading for BTC, ETH, SOL, BNB, XRP, DOGE, GT, TRUMP, ADA, WLFI on USDT-settled perpetual futures, with leverage configurable from 1x to 10x.
• Monitoring: Includes a real-time Web dashboard for account metrics and positions, transparent AI decision logs, and a comprehensive trade history.

Maintenance & Community

The project provides comprehensive documentation and contribution guidelines. While specific community channels like Discord or Slack are not explicitly mentioned in the README, the project encourages contributions. Gate.io referral links are provided as a way to support ongoing development.

Licensing & Compatibility

• License type: AGPL-3.0 (GNU Affero General Public License v3.0).
• Compatibility notes: This license is copyleft; any modifications or derivative works offered as a service must also be made publicly available under the AGPL-3.0 license. Commercial use is permitted under the terms of the license.

Limitations & Caveats

This system is intended for educational and research purposes only, and cryptocurrency trading involves significant financial risk, potentially leading to total capital loss. Users are strongly advised to test strategies thoroughly on the testnet before engaging in live trading and should only invest funds they can afford to lose. The system provides no performance guarantees or warranties.