TradeMemory Protocol

官方

面向MT5/外汇的AI交易记忆层,包含15个MCP工具——支持交易存储与召回、模式发现、策略演化以及结果加权记忆。

你可以用 TradeMemory Protocol MCP 做什么?

  • 按上下文回忆过往交易 — 在建立新仓位前,让助手根据结果质量、市场相似度、时间远近、置信度和情绪状态,检索之前的交易记录。

  • 记录完整上下文的交易 — 让助手记录一笔已完成的交易,包括其理由、市场条件和置信度,并自动更新五层记忆。

  • 执行交易前安全检查 — 让助手根据五因素风险门控评估一笔潜在交易,返回完整、缩减或跳过建议。

  • 检测行为偏差和连败趋势 — 请求分析你的交易模式,从记忆中揭示置信度趋势、回撤警报和重复犯下的错误。

  • 验证审计追踪完整性 — 让助手使用 SHA-256 哈希验证,确认某条特定交易记录或一整天的链条未被篡改。

  • 导出合规就绪记录 — 让助手批量导出交易决策记录,用于监管审查或内部审计提交。

文档

TradeMemory Protocol


项目状态(2026 年 8 月): 功能完备,处于维护模式——仍会审阅错误和安全报告;不计划新增功能或托管服务。如需付费服务,请参阅交易记录分析。

你的交易 AI 患有失忆症。而监管机构开始注意到了。

它每个会话都会犯同样的错误。它无法解释自己为何交易。当上下文窗口结束时,它会忘记一切。与此同时,MiFID II 正在提高算法决策文档记录的门槛(第 17 条)。欧盟 AI 法案要求对 AI 行为进行系统性日志记录(第 14 条)。你竞争对手的智能体正在从每一笔交易中学习。

AI 交易技术栈缺少一层。每个 MCP 服务器都处理执行——下单、获取价格、读取图表。没有服务器处理记忆。

你的智能体可以买入 100 股 AAPL,但无法回答:“上次我在这种条件下买入 AAPL 时发生了什么?”

TradeMemory 就是记忆层。 一个 pip install,你的 AI 智能体就能记住每一笔交易、每一个结果、每一个错误——并带有 SHA-256 防篡改审计追踪。

被一位独立交易者使用,在每次建仓前运行预检清单;也被用于 MT5 账户的第一方集成,记录被阻止的信号以及已执行的信号。请参阅 USE_CASES.md 了解具体对应关系。

功能概述

  • 交易前: 询问你的记忆——上次在这种市场条件下发生了什么?结果如何?
  • 交易后: 一次调用记录一切——五个记忆层自动更新
  • 安全护栏: 置信度跟踪、回撤警报、连败检测——系统会告诉你何时该停止

适用于任何市场(股票、外汇、加密货币、期货)、任何经纪商、任何 AI 平台。TradeMemory 不执行交易,也不接触你的资金——它只负责记录和回忆。

查看界面

tradememory-dashboard.onrender.com —— 运行在演示数据集上的仪表盘。无需安装。

这是界面预览,而非业绩记录:交易是合成的,每个数字都标注为合成数据。要了解记忆层在终端中的实际作用,pip install tradememory-protocol && tradememory demo --fast 会回放 30 笔交易,并展示从中推导出的回忆和参数调整。

快速开始

pip install tradememory-protocol

添加到 Claude Desktop(claude_desktop_config.json):

{
  "mcpServers": {
    "tradememory": {
      "command": "uvx",
      "args": ["tradememory-protocol"]
    }
  }
}

然后告诉 Claude:“记录我的 AAPL 多头,价格 195 美元——财报超预期,机构买入,高置信度。”

Claude Code / Cursor / Docker
# Claude Code
claude mcp add tradememory -- uvx tradememory-protocol

# From source
git clone https://github.com/mnemox-ai/tradememory-protocol.git
cd tradememory-protocol && pip install -e . && python -m tradememory

# Docker
docker compose up -d

完整教程: 快速开始(交易者路径 + 开发者路径)

谁在使用 TradeMemory

美股交易者外汇 EA 系统合规团队
市场股票(AAPL、TSLA 等)XAUUSD(黄金)多资产
方式每笔交易前的预检清单从 MT5 自动同步完整决策审计追踪
核心价值纪律系统——每次决策前都有记忆记录信号被阻止的原因,而不仅仅是已执行的信号面向监管机构的 SHA-256 防篡改记录
详情了解更多 →了解更多 →了解更多 →

工作原理

OWM 5 Factors

  1. 回忆 —— 交易前,按结果质量、上下文相似度、时效性、置信度和情绪状态加权检索过往交易(OWM 框架)
  2. 记录 —— 交易后,一次调用 remember_trade 写入五个记忆层:情景记忆、语义记忆、程序记忆、情感记忆和交易记录
  3. 反思 —— 每日/每周/每月回顾检测行为漂移、策略退化和交易错误
  4. 审计 —— 每项决策在创建时即进行 SHA-256 哈希。可随时导出供审查或提交监管

MCP 工具

类别工具描述
记忆remember_trade · recall_memories以结果加权评分记录和回忆交易
状态get_agent_state · get_behavioral_analysis置信度、回撤、连败、行为模式
规划create_trading_plan · check_active_plans带条件触发器的前瞻性计划
风险check_trade_legitimacy5 因素交易前门控(完整 / 缩减 / 跳过)
审计export_audit_trail · verify_audit_hashSHA-256 篡改检测 + 批量导出
全部 20 个 MCP 工具 + REST API
类别工具
核心记忆get_strategy_performance · get_trade_reflection
OWM 认知remember_trade · recall_memories · get_behavioral_analysis · get_agent_state · create_trading_plan · check_active_plans
风险与治理check_trade_legitimacy · validate_strategy · compute_dqs
进化evolution_fetch_market_data · evolution_discover_patterns · evolution_run_backtest · evolution_evolve_strategy · evolution_get_log
审计export_audit_trail · verify_audit_hash · verify_audit_chain · get_daily_root

REST API: 35 个以上端点,用于交易记录、反思、风险、MT5 同步、OWM、进化和审计。完整参考 →

交易记录分析

TradeMemory 本身是免费且自托管的。维护者提供的付费服务是对你自己的交易记录进行统计分析:导出你的 MT4/MT5 历史记录,获得一份描述性统计报告——你的亏损集中在何处、亏损后仓位规模如何变化、强制平仓结构,以及你每笔交易实际承担的风险——随后进行一次讲解通话。

仅对过往交易进行描述性统计:不提供交易信号、不构成投资建议、不承诺业绩。交付后你的文件将被删除。

dev@mnemox.ai | 预约通话

企业版与合规

你的智能体做出的每一个交易决策——包括不交易的决策——都会记录为交易决策记录(TDR)。每条记录的 SHA-256 内容哈希被链接到前向链式审计账本中;每个 UTC 日由 Merkle 根汇总,而 Merkle 根本身又跨日链接。篡改任何历史记录都会使所有后续链接失效。

法规要求TradeMemory 覆盖范围
MiFID II 第 17 条记录每个算法交易决策因素完整决策链:条件、过滤器、指标、执行
欧盟 AI 法案第 14 条高风险 AI 系统的人工监督每项决策的可解释推理 + 记忆上下文
欧盟 AI 法案第 12 条系统生命周期内自动、防篡改的日志链接的 SHA-256 链 + 每日 Merkle 根(RFC 3161 TSA 在 1.5 阶段)
# Verify a single record hasn't been tampered with
verify_audit_hash(trade_id="MT5-7047640363")
# → {"verified": true, "chain_entry": {"sequence_num": 42, ...}}

# Walk the entire chain (or a slice) end-to-end
verify_audit_chain(from_seq=1, to_seq=None)
# → {"verified": true, "checked_count": 1284, "first_break_at": null}

# Daily Merkle root — single 32-byte anchor over every TDR for that day
get_daily_root(date="2026-05-14")
# → {"verified": true, "root_hash": "a05544...", "record_count": 18}

# Bulk export for regulatory submission
GET /audit/export?strategy=VolBreakout&start=2026-03-01&format=jsonl

请参阅 LIMITATIONS.md 了解完整的审计链成熟度声明,包括 v0.5.2 中尚未包含的内容(TSA 时间戳、外部锚定、zkML 推理证明)。

需要为你的基金定制部署? → dev@mnemox.ai

安全性

  • 绝不接触 API 密钥。 TradeMemory 不执行交易、不转移资金、不访问钱包。
  • 只读只记。 你的智能体将决策上下文传递给 TradeMemory。它负责存储。仅此而已。
  • 本地优先。 唯一的外呼是每日审计根的 RFC 3161 可信时间戳——一个 32 字节的哈希,不包含交易数据(默认开启;可通过 TRADEMEMORY_TSA=off 禁用)。其他任何数据都不会离开你的机器。
  • SHA-256 链式审计账本。 每条记录在创建时即被哈希并链接到上一条记录。每日 Merkle 根锚定链条。可在记录、切片或日级别验证完整性。每一层都能检测到篡改;外部锚定(默认使用 TSA)已在路线图上。
  • 1,400+ 项测试通过。 完整的测试套件,带 CI。

研究状态

TradeMemory 的 OWM 框架基于认知科学(Tulving 1972)和强化学习(Schaul 等人 2015)。当前状态:

  • OWM 五因素评分: 已实现,已测试(1,400+ 项测试)
  • 统计验证: DSR、MBL 已实现(Bailey-de Prado 2014)
  • 审计追踪: SHA-256 防篡改 TDR
  • 进化引擎: 研究阶段(策略生成可用,统计门控通过率正在优化中)
  • 混合回忆: 仅 OWM 模式已激活,配置嵌入后可使用向量融合
  • 实证验证: 进行中(n=14 笔交易,目标 n>=100 以达到统计显著性;在 n=14 时置信区间过宽,无法得出任何结论——请参阅 validation/final_verdict.md)

文档

文档描述
快速开始安装 → 首笔交易 → 预检清单
使用场景3 种使用场景,每种标注为第一方或独立
API 参考所有 REST 端点
OWM 框架结果加权记忆理论
架构系统设计与层分离
教程详细演练
MT5 设置MetaTrader 5 集成
研究日志进化实验与数据
失败分类11 种交易 AI 失败模式
中文版繁体中文

贡献

请参阅贡献指南 · 安全政策

Star History

MIT——请参阅 LICENSE。仅供教育/研究用途。不构成财务建议。

由 Mnemox构建