quant-trade: A Full-Stack Cryptocurrency Quantitative Trading Agent System Based on Hermes-Agent

quant-trade is a full-stack cryptocurrency quantitative trading agent system based on the Hermes-Agent framework. It integrates 40 tools, 14 skills, and 19 FRED macro indicators, supporting multi-exchange access, multi-channel interaction (CLI, HTTP API, Feishu Bot, etc.), and manual confirmation workflows. It builds an end-to-end trading system that balances automation and risk control.

The cryptocurrency market features 24/7 trading, high volatility, and global liquidity, which provides opportunities for quantitative trading but imposes high requirements on systems. Traditional quantitative systems have high barriers (requiring professional programming and infrastructure setup). quant-trade redefines cryptocurrency quantitative trading with the AI Agent paradigm, introducing manual confirmation workflows to strike a balance between automation and risk control.

quant-trade adopts a layered architecture: The access layer supports CLI, HTTP API, Feishu Bot, MCP Server, and scheduled tasks; the core layer is the Hermes Agent decision-making center; the skill layer includes 14 skills responsible for strategy formulation and other tasks; the tool layer has 40 tools covering multiple modules; the execution layer connects to more than 10 mainstream exchanges (Binance, OKX, etc.) via ccxt, balancing flexibility and responsibility boundaries.

The quant-trade tool system includes 15 modules: market data (K-lines, real-time prices, etc.) and technical indicators (MA, RSI, etc.); transaction execution (order placement, cancellation, etc.) and derivatives (funding rates, etc.); sentiment (fear and greed index, news sentiment); on-chain (TVL, whale transactions); macro (19 FRED indicators: interest rates, inflation, employment, etc.). Data sources include ccxt, Alternative.me, CoinGecko, DeFiLlama, FRED, etc.

The 14 skills are divided into four categories: data acquisition (market-data, news-filter with two-level filtering); signal generation (signal-generator with multi-dimensional fusion, 5 professional analyst agents); execution and risk control (risk-manager with hard-coded rules, trade-executor with 6-step process, confirm-tools for manual confirmation); review and optimization (strategy-review for log analysis, backtest guidance, alert-notifier for warnings).

Workflow: Agent generates a signal → creates a trading proposal → pushes to Feishu (including currency, direction, reasons, etc.) → user confirms/rejects; if confirmed, automatic order placement, stop-loss setting, and log recording are performed; if rejected, the reason is recorded to optimize the strategy. Feishu supports natural language interaction, lowering the operation threshold and balancing automation and human decision-making rights.

Supports CLI (terminal), HTTP API (FastAPI port 8899), Feishu Bot (group chat interaction), MCP Server (client call), and scheduled tasks (periodic scanning/review); the web visualization dashboard (ECharts) displays indicators such as net worth curves, K-lines (buy/sell points), profit and loss distribution, and real-time balances.

The system includes 81 unit tests and a 6-stage end-to-end joint debugging pipeline (covering market data acquisition, macro integration, etc.) to ensure reliability; quant-trade is a deep case of vertical application of AI Agents, not a simple ChatGPT wrapper, but a full-life-cycle trading system. The macro module and manual confirmation are worth attention, providing a reference implementation for developers/traders.