TradeMemory Protocol

官方

AI交易記憶層,適用於MT5/外匯,提供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 於 Phase 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 et al. 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
建置