Tradememory Protocol

TradeMemory は、損失がいくらだったかを記憶します。 AI トレーディングエージェント向けの、オープンソースでローカル優先のメモリー兼ブレーキです。約定データを取り込み、自分の取引履歴のどこで損失が出ているかを見つけ、次の注文の前にその損失取引をエージェントに提示します。また、設定したルールに違反する注文を、ブローカーに届く前に拒否できます。

現在、ブローカーは MCP 経由で AI エージェントが取引できるようにしていますが、ガードレールはそれぞれ異なります。Webull と tastytrade は注文サイズや購買余力に上限を設け、Interactive Brokers ではエージェントが注文を下書きし、ユーザーが送信します。一方、Robinhood と Public には、外部エージェントに課せる上限がありません（StockBrokers、2026-09-30）。上限は固定値です。いずれも、あなた自身の過去の取引結果は考慮しません。

まず自分の取引履歴から始めましょう

pip install tradememory-protocol

# Hyperliquid: public fills, no key needed
tradememory sync hyperliquid --address 0xYourAddress

# Alpaca: read-only calls with your own keys, kept in a local file
tradememory sync alpaca --env-file ~/.secrets/alpaca.env

決済済みの取引は一度だけメモリーに保存され、再実行しても新しい取引だけが保存されます。その後、取引履歴のどこで損失が出ているかが表示されます。以下は、その形式の例です。

After 2 losses in a row (20 trades):
  5 of them (25%) were 1.5x your usual size or more.
  All 20 won 60% and made -$1,500.
  The 5 sized-up trades won 20% and made -$1,700.

Median hold: winners 1.5h, losers 9.0h.

これはあなた自身の過去の取引に関する記述統計であり、次の取引についての助言ではありません。Hyperliquid の API が提供するのはアドレスの最近の約定データのみで、全履歴ではありません。そのため、早めに同期するほど多くの履歴を保持できます。その他の取引所については、MT5 と Binance spot の同期スクリプトが scripts/ にあります。また、どのエージェントでも remember_trade を使って取引を記録できます。

次の注文の前に

recall_memories(order="losses_first") は、すべての損失取引を残りの取引より前に並べ、似た条件での損失額が大きいものほど先に、取引サイズと損益とともに表示します。銘柄の最新の取引に加えて、銘柄の最近の損失取引も検索するため、古い損失が押し出されることはありません。サーバーは、接続されたエージェントに、取引を提案する前にこれを呼び出すよう指示します。デフォルトの順序では、より良い結果（記録されている場合は R 倍率によるもの）を上位に並べ、リスト内に少なくとも 20% の損失取引を残します。

エージェントを接続する

pip install tradememory-protocol

Claude Desktop に追加します（claude_desktop_config.json）。

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

次に Claude にこう伝えます。「AAPL のロングを 195 ドルで記録して。決算が予想を上回り、機関投資家の買いがあり、確信度は高い。」

# 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

詳しい手順： はじめに（トレーダー向けトラック＋開発者向けトラック）

ブローカーの前にブレーキを設置（プレビュー）

proxy エクストラは、エージェントとブローカーの MCP サーバー（現在は Alpaca）の間で TradeMemory を実行します。注文を出すツール以外はすべて変更せずに転送され、注文を出すツールは Mnemox Control が、ブローカーに届く前にユーザー自身が管理するポリシーに照らして評価します。許可・拒否を問わず、評価はすべて記録され、監査ログにチェーンとして追加されます。注文が許可されると、類似した状況での損失トレードが優先して返されます。また、エントリーにストップが設定されている場合は、後から tradememory sync alpaca を実行して、転送した各トレードの結果を反映できます。すでにお使いのエージェントはそのまま動作し、MCP 設定の行を1つ変更するだけです。

pip install "tradememory-protocol[proxy]"   # Python 3.12+
tradememory proxy init --account-id <your Alpaca account id> --symbols AAPL,MSFT
tradememory proxy doctor --env-file ~/.secrets/alpaca-paper.env   # checks the live tool names and the account id
tradememory proxy config                                           # prints the MCP client entry that replaces the direct Alpaca one

デフォルトでは拒否されます。許可リストにないシンボル、想定元本やポジションの上限を超える注文、ブラケットストップのないエントリー、日次損失またはドローダウンの上限に達した後の新規注文、オープンポジションの保護ストップのキャンセル、ブレーキが分類していないツール、そして tradememory proxy halt FULL_HALT を実行した後のすべての操作が対象です。ポジションの決済がブロックされることはありません。approval_notional 以上の注文は tradememory proxy approve <intent_id> --terms <fingerprint> を実行するまで保留されます。これにより、確認した注文条件だけが承認されます。エージェントが同じ client_order_id と同じ条件で再試行すると、プロキシは最大1回だけブローカーに転送します。evaluate_order は注文を出さずに同じ判定を返すため、事前チェックや他のフレームワークのアドバイザリレイヤーで使用できます。ブレーキが評価できない注文（価格配信の停止、未知の資産、ポリシーの対象外の注文タイプなど）は、そのまま通過させず拒否します。

状況：Alpaca の MCP サーバーを状態管理するフェイクサーバーでエンドツーエンドのテストを実施済み（tests/proxy/）。また、2026-10-01 に実際の Alpaca ペーパーアカウントで実行しました。拒否3件（許可リストにないシンボル、ストップのないエントリー、上限を超える想定元本）、ブローカーに届いた許可済みの1株のブラケット注文1件、そして同じ client_order_id による再試行1件（2回目の注文を出さず、記録に基づいて応答）が確認されています。オプション、注文の置き換え、ストップリミット注文、トレーリング注文は評価せず、拒否されます。ブローカーのキーはプロキシが起動するブローカープロセスにのみ渡され、TradeMemory が保存することはありません。

実際の出力を使った手順：docs/recipes/alpaca-brake.md。

利用方法は3通り

仕組み

1. 想起 — トレードの前に、結果の質、状況の類似性、経過時間、確信度、感情の状態を重み付けして、過去のトレードを取得します（OWM Framework）
2. 記録 — トレードの後に、remember_trade を1回呼び出すだけで、エピソード記憶、意味記憶、手続き記憶、感情記憶、トレード記録の5つのメモリレイヤーに書き込みます
3. 振り返り — 日次・週次・月次のレビューで、行動の変化、戦略の劣化、トレードのミスを検出します
4. 監査 — 各判断は作成時に SHA-256 でハッシュ化され、直前の判断とチェーンで結ばれます。いつでもエクスポートして確認できます

MCP ツール

接続について問い合わせる

ブローカーでエージェントを実行している場合や、取引履歴の同期・読み取りをご希望の場合は、ブローカー連携の課題を作成するか、30分の相談を予約してください。セットアップのサポートは無料です。また、次に何を開発するかは、利用者の声をもとに決定します。

監査証跡

エージェントが行うすべての取引判断（取引を行わない判断も含みます）は、取引判断記録（TDR）として記録されます。各記録の SHA-256 コンテンツハッシュは、前方につながる監査台帳に連結されます。また、UTC の日ごとに Merkle ルートで要約され、そのルートも日をまたいで連鎖します。過去の記録がひとつでも改ざんされると、それ以降のリンクはすべて無効になります。

判断記録を義務付ける規則の対象は投資会社であり、個人投資家ではありません。EU AI Act のもとでは、附属書 III に定める高リスク AI のログ記録義務は2027年12月2日まで延期されています。また、アルゴリズム取引に関する ESMA の2026年2月の監督説明では、AI ベースのアルゴリズム取引は現在、高リスクの対象範囲から除外されているとされています。以下の表は、これらの規則がご自身に適用される場合に、TradeMemory の各機能がどのように対応するかを示しています。これはコンプライアンスへの適合を主張するものではありません。

# 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
GET /audit/export?strategy=VolBreakout&start=2026-03-01&format=jsonl

0.5.3 以降、日次ルートにはデフォルトで RFC 3161 認証局によるタイムスタンプが付与されます。秘密鍵による記録への署名、公開ログへのアンカリング、記録の漏れがないことの証明には対応していません。詳しくは LIMITATIONS.md をご覧ください。

セキュリティ

• メモリーサーバー（デフォルト）。 注文を発注することはなく、ブローカーのキーを求めることもありません。ローカルの SQLite ファイルに記録し、そこから呼び出すだけです。
• 同期。 tradememory sync hyperliquid はキーを使わずに公開データを読み取ります。tradememory sync alpaca は、お使いのマシン上のファイルに保存されたキーを使って、読み取り専用の呼び出しを行います。同期した取引はローカルデータベースに保存されます。
• ブレーキ（proxy extra）。 ポリシーで許可された注文をブローカーの MCP サーバーに転送します。ブローカーのキーはプロキシが起動するブローカープロセスにのみ渡され、TradeMemory が保存することはありません。
• 外部への呼び出し。 日次監査ルートを RFC 3161 でタイムスタンプし、取引データを含まない 32 バイトのハッシュを送信します（デフォルトで有効。TRADEMEMORY_TSA=off で無効にできます）。tradememory sync は指定した取引所を呼び出します。進化ツールは、エージェントが呼び出したときに公開 Binance 市場データ（api.binance.com）を読み取り、ANTHROPIC_API_KEY を設定した場合にのみ Anthropic API を呼び出します。リプレイはデフォルトで DeepSeek（または Anthropic）を呼び出し、設定されたプロバイダーのキーがある場合に限って利用します。ハイブリッドリコール用に sentence-transformers をインストールすると、初回使用時に Hugging Face からモデルをダウンロードします。scripts/ 内の MT5 および Binance 同期スクリプトは環境変数から認証情報を読み取ります。MT5 スクリプトは、DISCORD_WEBHOOK_URL を設定した場合に限り、取引の概要（シンボル、価格、損益）を Discord Webhook に送信します。
• 改ざんを検知できますが、改ざんを防止するものではありません。 すべての記録はハッシュ化され、前の記録と連結されます。また、日次の Merkle ルートも作成されます。記録を変更するとチェーンが破損しますが、データベース全体を書き換えられる人であれば、チェーンを再構築できます。

研究の状況

TradeMemory の OWM フレームワークは、認知科学（Tulving 1972） および強化学習（Schaul et al. 2015）に基づいています。現在の状況は次のとおりです。

• OWM の5要素スコアリング： 実装済み、テスト済み（CI バッジを参照）
• 統計的検証： DSR、MBL を実装済み（Bailey-de Prado 2014）
• 監査証跡： SHA-256 による改ざん検知可能な TDR
• 進化エンジン： 研究段階（戦略の生成は可能。最適化における統計ゲートの通過率を検証中）
• ハイブリッドリコール： OWM のみのモードが有効。エンベディングを設定するとベクトル融合を利用可能
• 実証的検証： 継続中（n=14 件の取引。統計的有意性を得るための目標は n>=100。n=14 では信頼区間の幅が広すぎるため、結論を出せません。validation/final_verdict.md を参照）

ドキュメント

コントリビューション

コントリビューションガイド · セキュリティポリシー を参照してください。

MIT ライセンスです。LICENSE を参照してください。オプションの proxy extra は Mnemox Control をインストールします。そのエンジンは AGPL-3.0-only です（商用ライセンスも利用できます）。TradeMemory 自体は MIT ライセンスのままです。教育および研究目的に限ります。金融上の助言ではありません。