Ritmex Ai Trader

ritmex-ai-trader

项目简介 · Project Overview

`ritmex-ai-trader` 是一个多智能体（Multi-Agent）自动交易实验平台，聚焦于加密资产高频/中频策略。整套系统把行情采集、特征工程、信号生成、风险控制、执行路由以及合规审计拆分成独立 Agent，通过 JSON 消息总线和共享状态存储协同工作。 `ritmex-ai-trader` is a multi-agent trading research platform for crypto markets. Market data ingestion, feature engineering, signal generation, portfolio & risk control, execution, and compliance reporting live in separate agents that communicate via an internal JSON message bus and shared state stores.

方案灵感来自 [https://nof1.ai/](https://nof1.ai/) 的 Agent 架构，我们在其思路基础上补充量化交易需要的指标计算、风控和审计流程。 The architecture is influenced by [https://nof1.ai/](https://nof1.ai/), extended with quantitative analytics, risk management, and audit features required for live trading.

使用的主要库 · Key Libraries

• Bun v1.2.20：统一运行时与打包工具，直接执行 TypeScript。
  Bun v1.2.20 for runtime and bundling with native TypeScript support.
• pinets：拉取 Binance K 线并复用 PineScript 指标库。
  pinets to source Binance market data and PineScript-compatible TA functions.
• ai / @ai-sdk/google：通过 Gemini/GPT 等模型生成交易决策说明。
  ai and @ai-sdk/google for LLM-backed narrative and signal validation.
• zod：定义并校验 Agent 间的消息结构。
  zod for schema validation across agent boundaries.
• dotenv：加载运行时配置。
  dotenv to manage environment configuration.

模块划分 · Module Breakdown

1. 行情采集（Market Data Ingestion） 连接交易所 API / WebSocket，规整为统一的 K 线/逐笔格式并写入快照库。

2. 特征工程（Feature Engineering） 计算 EMA、RSI、ATR 等技术指标以及自定义统计特征，输出给信号模块。

3. 信号生成（Signal Generation） 调用模型或启发式逻辑，生成 `signal.long` / `signal.short` / `signal.flat` 等事件。

4. 组合与风控（Portfolio & Risk） 将信号映射为目标仓位、杠杆和资金分配，并执行回撤/风险限额检查。

5. 执行路由（Execution） 按照 TWAP/VWAP 或智能路由策略把目标仓位拆单下到场内。

6. 监督与健康监控（Supervisor） 统一监控 Agent 心跳、延迟与 SLA，触发熔断或恢复动作。

7. 合规与报表（Compliance & Reporting） 汇总交易日志、风控豁免、配置差异，生成可留存的审计报表。

Each responsibility is encapsulated in a dedicated agent so teams can iterate independently without breaking data contracts.

系统工作流 · High-Level Wor