TradeMemory Protocol

TradeMemory ghi nhớ cái giá phải trả. Đây là một bộ nhớ và hệ thống phanh mã nguồn mở, ưu tiên cục bộ dành cho các tác nhân giao dịch AI: nó kéo dữ liệu khớp lệnh của bạn, tìm ra nơi lịch sử của chính bạn thua lỗ, đưa những giao dịch thua lỗ đó ra trước tác nhân của bạn trước lệnh tiếp theo, và có thể từ chối một lệnh vi phạm các quy tắc bạn đặt ra, trước khi lệnh đến được sàn môi giới.

Các sàn môi giới hiện cho phép tác nhân AI giao dịch qua MCP, với các rào cản khác nhau: Webull và tastytrade đặt giới hạn kích thước hoặc sức mua, Interactive Brokers chỉ cho tác nhân soạn lệnh để bạn tự gửi, còn Robinhood và Public không đặt giới hạn nào mà bạn có thể áp đặt lên tác nhân bên ngoài (StockBrokers, 2026-09-30). Các giới hạn này là những con số cố định. Không ai trong số chúng nhìn vào cách các giao dịch trong quá khứ của chính bạn diễn ra.

Bắt đầu với lịch sử của chính bạn

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

Mỗi giao dịch đã đóng được lưu vào bộ nhớ một lần; chạy lại chỉ lưu các giao dịch mới. Sau đó, nó in ra nơi lịch sử của bạn thua lỗ. Định dạng, với các con số minh họa:

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.

Đây là các thống kê mô tả về các giao dịch trong quá khứ của chính bạn, không phải lời khuyên về giao dịch tiếp theo. API của Hyperliquid chỉ phục vụ các khớp lệnh gần đây của một địa chỉ, không phải toàn bộ lịch sử, vì vậy đồng bộ càng sớm thì càng giữ được nhiều lịch sử. Các nền tảng khác: các tập lệnh đồng bộ MT5 và Binance spot nằm trong scripts/, và bất kỳ tác nhân nào cũng có thể ghi lại một giao dịch bằng remember_trade.

Trước lệnh tiếp theo

recall_memories(order="losses_first") đặt mọi giao dịch thua lỗ lên trước phần còn lại, các khoản lỗ lớn hơn trong điều kiện tương tự được xếp trước, kèm theo quy mô và P&L của chúng. Bên cạnh các giao dịch gần nhất của mã chứng khoán, nó còn tìm kiếm các giao dịch thua lỗ gần đây của mã đó, để một khoản lỗ cũ hơn không bị lấn át. Máy chủ yêu cầu các tác nhân đã kết nối gọi nó trước khi đề xuất một giao dịch. Thứ tự mặc định xếp hạng các kết quả tốt hơn cao hơn (theo bội số R, khi có ghi nhận) và giữ ít nhất 20% các khoản lỗ trong danh sách.

Kết nối tác nhân của bạn

pip install tradememory-protocol

Thêm vào Claude Desktop (claude_desktop_config.json):

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

Sau đó nói với Claude: "Ghi lại lệnh mua AAPL của tôi ở mức $195 — earnings vượt kỳ vọng, mua từ tổ chức, độ tin cậy cao."

# 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

Hướng dẫn đầy đủ: Bắt đầu (Lộ trình Nhà giao dịch + Lộ trình Nhà phát triển)

Đặt một hệ thống phanh trước sàn môi giới của bạn (bản xem trước)

Phần bổ trợ proxy chạy TradeMemory giữa tác nhân của bạn và máy chủ MCP của sàn môi giới (hiện là Alpaca). Mọi công cụ được chuyển tiếp nguyên vẹn ngoại trừ các công cụ đặt lệnh, được Mnemox Control đánh giá theo một chính sách bạn sở hữu trước khi chúng đến sàn môi giới. Mọi đánh giá, được phép hay bị từ chối, đều được ghi lại và liên kết vào nhật ký kiểm toán. Một lệnh được phép quay lại kèm theo các giao dịch thua lỗ của bạn trong điều kiện tương tự được xếp trước, và tradememory sync alpaca sau đó điền kết quả của từng giao dịch được chuyển tiếp, tính theo R khi lệnh vào có kèm lệnh cắt lỗ. Tác nhân bạn đang có vẫn hoạt động bình thường; chỉ một dòng trong cấu hình MCP của nó thay đổi.

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

Bị từ chối theo mặc định: các mã chứng khoán ngoài danh sách của bạn, lệnh vượt quá giới hạn danh nghĩa và vị thế của bạn, lệnh vào không có lệnh cắt lỗ đi kèm, bất kỳ lệnh mới nào sau khi bạn đạt giới hạn thua lỗ hàng ngày hoặc giới hạn sụt giảm, hủy lệnh cắt lỗ bảo vệ của một vị thế đang mở, bất kỳ công cụ nào hệ thống phanh chưa phân loại, và mọi thứ trong khi bạn đang chạy tradememory proxy halt FULL_HALT. Không bao giờ bị chặn: đóng một vị thế. Các lệnh ở mức hoặc trên approval_notional chờ tradememory proxy approve <intent_id> --terms <fingerprint>, cái này phê duyệt chính xác các điều khoản bạn đã đọc; tác nhân thử lại với cùng client_order_id và cùng các điều khoản, và proxy chuyển tiếp nó tối đa một lần. evaluate_order trả về cùng một quyết định mà không đặt bất cứ thứ gì, dành cho kiểm tra trước và cho các lớp tư vấn trong các khung khác. Bất cứ thứ gì hệ thống phanh không thể đánh giá (nguồn dữ liệu giá chết, tài sản không xác định, loại lệnh chính sách không bao phủ) đều bị từ chối, không được chuyển tiếp.

Trạng thái: đã được kiểm thử end-to-end với một bản giả lập có trạng thái của máy chủ MCP Alpaca (tests/proxy/), và đã chạy với tài khoản giấy Alpaca thật vào 2026-10-01: ba lần từ chối (mã chứng khoán không có trong danh sách, lệnh vào không có lệnh cắt lỗ, danh nghĩa vượt giới hạn), một lệnh một cổ phiếu có khung được phép đến được sàn môi giới, và một lần thử lại với cùng client_order_id được trả lời từ bản ghi mà không có lệnh thứ hai. Quyền chọn, thay thế lệnh, lệnh stop-limit và lệnh trailing bị từ chối thay vì được đánh giá. Khóa sàn môi giới của bạn chỉ được chuyển đến tiến trình sàn môi giới mà proxy khởi động; TradeMemory không bao giờ lưu trữ chúng.

Hướng dẫn với các đầu ra thực tế: docs/recipes/alpaca-brake.md.

Ba cách sử dụng

Cách hoạt động

1. Nhớ lại — Trước khi giao dịch, truy xuất các giao dịch trong quá khứ được trọng số theo chất lượng kết quả, độ tương đồng bối cảnh, độ gần đây, độ tin cậy và trạng thái cảm xúc (Khung OWM)
2. Ghi lại — Sau khi giao dịch, một lần gọi remember_trade ghi vào năm lớp bộ nhớ: tình huống, ngữ nghĩa, thủ tục, cảm xúc và hồ sơ giao dịch
3. Suy ngẫm — Các đánh giá hàng ngày/hàng tuần/hàng tháng phát hiện sự trôi dạt hành vi, suy giảm chiến lược và sai lầm giao dịch
4. Kiểm toán — Mọi quyết định được băm SHA-256 tại thời điểm tạo và liên kết với quyết định trước đó. Xuất bất cứ lúc nào để xem xét

Công cụ MCP

Nhận trợ giúp kết nối

Đang chạy một tác nhân với sàn môi giới, hoặc muốn lịch sử của bạn được đồng bộ và đọc? Mở một vấn đề tích hợp phanh hoặc đặt lịch 30 phút. Hỗ trợ thiết lập miễn phí, và những người sử dụng nó quyết định những gì được xây dựng tiếp theo.

Dấu vết kiểm toán

Mọi quyết định giao dịch mà tác nhân của bạn đưa ra — bao gồm cả các quyết định không giao dịch — đều được ghi lại dưới dạng Hồ sơ Quyết định Giao dịch (TDR). Các băm nội dung SHA-256 cho từng bản ghi được liên kết thành một sổ cái kiểm toán chuỗi tiến; mỗi ngày UTC được tóm tắt bằng một gốc Merkle, chính nó liên kết qua các ngày. Giả mạo bất kỳ bản ghi lịch sử nào sẽ làm mất hiệu lực mọi liên kết tiếp theo.

Các quy tắc yêu cầu hồ sơ quyết định ràng buộc các công ty đầu tư, không phải người dùng bán lẻ. Theo Đạo luật AI của EU, các nghĩa vụ ghi nhật ký rủi ro cao trong Phụ lục III đã bị hoãn đến ngày 2 tháng 12 năm 2027, và bản tóm tắt giám sát tháng 2 năm 2026 của ESMA về giao dịch thuật toán nêu rõ rằng giao dịch thuật toán dựa trên AI hiện bị loại khỏi phạm vi rủi ro cao. Bảng cho thấy các tính năng TradeMemory nào ánh xạ đến các văn bản đó nếu và khi chúng áp dụng cho bạn. Đây không phải là một tuyên bố tuân thủ.

# 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

Các gốc hàng ngày được đóng dấu thời gian bởi một cơ quan RFC 3161 theo mặc định từ 0.5.3. Chưa xây dựng: ký các bản ghi bằng khóa riêng, neo vào nhật ký công khai, chứng minh rằng không có gì bị bỏ sót. Xem LIMITATIONS.md.

Bảo mật

• Máy chủ bộ nhớ (mặc định). Không bao giờ đặt lệnh và không bao giờ yêu cầu khóa sàn môi giới. Chỉ ghi lại và nhớ lại, trong một tệp SQLite cục bộ.
• Đồng bộ. tradememory sync hyperliquid đọc dữ liệu công khai mà không cần khóa. tradememory sync alpaca thực hiện các cuộc gọi chỉ đọc với khóa từ một tệp trên máy của bạn. Các giao dịch được đồng bộ vẫn nằm trong cơ sở dữ liệu cục bộ của bạn.
• Phanh (phần bổ trợ proxy). Chuyển tiếp các lệnh mà chính sách của bạn cho phép đến máy chủ MCP của sàn môi giới. Khóa sàn môi giới của bạn chỉ được chuyển đến tiến trình sàn môi giới mà proxy khởi động; TradeMemory không bao giờ lưu trữ chúng.
• Cuộc gọi đi. Đóng dấu thời gian RFC 3161 cho các gốc kiểm toán hàng ngày, một băm 32 byte không chứa dữ liệu giao dịch (bật theo mặc định; TRADEMEMORY_TSA=off tắt nó). tradememory sync gọi đến sàn giao dịch bạn chỉ định. Các công cụ tiến hóa đọc dữ liệu thị trường công khai của Binance (api.binance.com) khi một tác nhân gọi chúng, và tiến hóa gọi API Anthropic chỉ khi bạn đặt ANTHROPIC_API_KEY. Replay gọi DeepSeek theo mặc định (hoặc Anthropic), và chỉ với khóa của nhà cung cấp đó được đặt. Nếu bạn cài đặt sentence-transformers để nhớ lại kết hợp, nó tải mô hình từ Hugging Face khi sử dụng lần đầu. Các tập lệnh đồng bộ MT5 và Binance trong scripts/ đọc thông tin xác thực từ môi trường của bạn, và tập lệnh MT5 đăng tóm tắt giao dịch (mã chứng khoán, giá, P&L) lên một webhook Discord chỉ khi bạn đặt DISCORD_WEBHOOK_URL.
• Chống giả mạo, không phải chống phá. Mọi bản ghi được băm và liên kết với bản trước đó, với các gốc Merkle hàng ngày. Thay đổi một bản ghi làm gãy chuỗi; ai đó có thể viết lại toàn bộ cơ sở dữ liệu có thể xây dựng lại nó.

Trạng thái nghiên cứu

Khung OWM của TradeMemory được nền tảng trong khoa học nhận thức (Tulving 1972) và học tăng cường (Schaul et al. 2015). Trạng thái hiện tại:

• Chấm điểm năm yếu tố OWM: đã triển khai và kiểm thử (xem huy hiệu CI)
• Xác thực thống kê: DSR, MBL đã triển khai (Bailey-de Prado 2014)
• Dấu vết kiểm toán: TDR chống giả mạo SHA-256
• Công cụ tiến hóa: giai đoạn nghiên cứu (tạo chiến lược hoạt động, tỷ lệ vượt qua cổng thống kê dưới mức tối ưu hóa)
• Nhớ lại kết hợp: chế độ chỉ-OWM hoạt động, kết hợp vector khả dụng khi cấu hình embeddings
• Xác thực thực nghiệm: đang tiến hành (n=14 giao dịch, mục tiêu n>=100 để có ý nghĩa thống kê; ở n=14 các khoảng tin cậy quá rộng để kết luận bất cứ điều gì - xem validation/final_verdict.md)

Tài liệu

Đóng góp

Xem Hướng dẫn đóng góp · Chính sách bảo mật

MIT, xem GIẤY PHÉP. Bản cài đặt bổ sung tùy chọn proxy cài đặt Mnemox Control, có engine được cấp phép AGPL-3.0-only (có sẵn giấy phép thương mại); bản thân TradeMemory vẫn giữ MIT. Chỉ dành cho mục đích giáo dục và nghiên cứu. Không phải là lời khuyên tài chính.