TradeMemory Protocol

TradeMemory จดจำว่ามันเสียค่าใช้จ่ายเท่าไร มันเป็นหน่วยความจำและเบรกแบบโอเพนซอร์สที่ทำงานในเครื่องเป็นหลัก สำหรับเอเจนต์เทรด AI: มันดึงข้อมูลคำสั่งที่คุณทำไว้ ค้นหาจุดที่ประวัติของคุณขาดทุน วางคำสั่งที่ขาดทุนเหล่านั้นไว้ต่อหน้าเอเจนต์ก่อนคำสั่งถัดไป และสามารถปฏิเสธคำสั่งที่ละเมิดกฎที่คุณตั้งไว้ ก่อนที่มันจะไปถึงโบรกเกอร์

โบรกเกอร์ในตอนนี้อนุญาตให้เอเจนต์ AI เทรดผ่าน MCP พร้อมการ์ดป้องกันที่แตกต่างกัน: 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.

สิ่งเหล่านี้เป็นสถิติเชิงพรรณนาของการเทรดในอดีตของคุณ ไม่ใช่คำแนะนำเกี่ยวกับการเทรดถัดไป API ของ Hyperliquid ให้บริการเฉพาะการเติมคำสั่งล่าสุดของที่อยู่หนึ่ง ๆ ไม่ใช่ประวัติทั้งหมด ดังนั้นยิ่งซิงก์เร็วเท่าไร ก็จะเก็บประวัติได้มากขึ้นเท่านั้น เวนิวอื่น ๆ: สคริปต์ซิงก์ MT5 และ Binance spot อยู่ใน scripts/ และเอเจนต์ใด ๆ ก็สามารถบันทึกการเทรดด้วย remember_trade

ก่อนคำสั่งถัดไป

recall_memories(order="losses_first") วางการเทรดที่ขาดทุนทุกรายการไว้ข้างหน้า โดยการขาดทุนที่ใหญ่กว่าในเงื่อนไขคล้ายกันมาก่อน พร้อมขนาดและ P&L นอกจากการเทรดล่าสุดของสัญลักษณ์แล้ว มันยังค้นหาการเทรดที่ขาดทุนล่าสุดของสัญลักษณ์นั้น เพื่อไม่ให้การขาดทุนที่เก่ากว่าถูกเบียดออก เซิร์ฟเวอร์บอกเอเจนต์ที่เชื่อมต่อให้เรียกมันก่อนเสนอการเทรด ลำดับเริ่มต้นจัดอันดับผลลัพธ์ที่ดีกว่าให้สูงกว่า (โดย R multiple เมื่อมีการบันทึก) และรักษาการขาดทุนอย่างน้อย 20% ไว้ในรายการ

เชื่อมต่อเอเจนต์ของคุณ

pip install tradememory-protocol

เพิ่มใน Claude Desktop (claude_desktop_config.json):

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

จากนั้นบอก Claude: "บันทึกการเทรด AAPL long ของฉันที่ $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 ทำงาน TradeMemory ระหว่างเอเจนต์ของคุณและเซิร์ฟเวอร์ MCP ของโบรกเกอร์ (วันนี้คือ Alpaca) ทุกเครื่องมือถูกส่งต่อโดยไม่เปลี่ยนแปลง ยกเว้นเครื่องมือที่วางคำสั่ง ซึ่ง Mnemox Control ประเมินตามนโยบายที่คุณเป็นเจ้าของก่อนที่มันจะถึงโบรกเกอร์ ทุกการประเมิน ไม่ว่าจะอนุญาตหรือปฏิเสธ จะถูกบันทึกและเชื่อมโยงในบันทึกการตรวจสอบ คำสั่งที่อนุญาตจะกลับมาพร้อมการเทรดที่ขาดทุนของคุณจากเงื่อนไขคล้ายกันก่อน และ tradememory sync alpaca จะเติมข้อมูลในภายหลังว่าการเทรดที่ส่งต่อแต่ละรายการจบลงอย่างไร ในหน่วย R เมื่อรายการมีการตั้ง stop เอเจนต์ที่คุณมีอยู่แล้วยังทำงานต่อไป มีเพียงบรรทัดเดียวในการกำหนดค่า MCP ที่เปลี่ยน

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

ปฏิเสธโดยค่าเริ่มต้น: สัญลักษณ์นอกรายการของคุณ, คำสั่งที่สูงกว่าขีดจำกัดมูลค่าและตำแหน่งของคุณ, รายการที่ไม่มี bracket stop, คำสั่งใหม่ใด ๆ หลังจากขีดจำกัดขาดทุนรายวันหรือ drawdown, การยกเลิก stop ป้องกันของตำแหน่งที่เปิดอยู่, เครื่องมือใด ๆ ที่เบรกไม่ได้จำแนก และทุกอย่างในขณะที่คุณรัน tradememory proxy halt FULL_HALT ไม่ถูกบล็อก: การปิดตำแหน่ง คำสั่งที่หรือสูงกว่า approval_notional รอ tradememory proxy approve <intent_id> --terms <fingerprint> ซึ่งอนุมัติเงื่อนไขที่คุณอ่านอย่างแน่นอน เอเจนต์ลองใหม่ด้วย client_order_id เดียวกันและเงื่อนไขเดียวกัน และพร็อกซีส่งต่ออย่างมากที่สุดหนึ่งครั้ง evaluate_order คืนการตัดสินใจเดียวกันโดยไม่วางอะไร สำหรับการตรวจสอบล่วงหน้าและเลเยอร์ที่ปรึกษาในเฟรมเวิร์กอื่น สิ่งใดที่เบรกไม่สามารถประเมินได้ (ฟีดราคาที่ตาย, สินทรัพย์ที่ไม่รู้จัก, ประเภทคำสั่งที่นโยบายไม่ครอบคลุม) จะถูกปฏิเสธ ไม่ส่งผ่าน

สถานะ: ทดสอบแบบ end-to-end กับ fake ที่มีสถานะของเซิร์ฟเวอร์ MCP ของ Alpaca (tests/proxy/) และรันกับบัญชี paper จริงของ Alpaca เมื่อ 2026-10-01: การปฏิเสธสามครั้ง (สัญลักษณ์ไม่อยู่ในรายการ, รายการที่ไม่มี stop, มูลค่าเกินขีดจำกัด), คำสั่ง bracket หนึ่งหุ้นที่อนุญาตและถึงโบรกเกอร์ และการลองใหม่หนึ่งครั้งด้วย client_order_id เดียวกันที่ตอบจากบันทึกโดยไม่มีคำสั่งที่สอง ออปชัน, การแทนที่คำสั่ง, คำสั่ง stop-limit และ trailing ถูกปฏิเสธแทนที่จะประเมิน คีย์โบรกเกอร์ของคุณไปที่กระบวนการโบรกเกอร์ที่พร็อกซีเริ่มต้นเท่านั้น TradeMemory ไม่เคยเก็บมัน

คำแนะนำพร้อมผลลัพธ์จริง: docs/recipes/alpaca-brake.md

สามวิธีที่มันถูกใช้

วิธีการทำงาน

1. Recall (เรียกคืน) — ก่อนเทรด ดึงการเทรดในอดีตที่ถ่วงน้ำหนักด้วยคุณภาพผลลัพธ์, ความคล้ายคลึงของบริบท, ความเร็ว, ความมั่นใจ และสถานะทางอารมณ์ (เฟรมเวิร์ก OWM)
2. Record (บันทึก) — หลังเทรด หนึ่งการเรียก remember_trade เขียนไปยังห้าเลเยอร์หน่วยความจำ: episodic, semantic, procedural, affective และบันทึกการเทรด
3. Reflect (สะท้อน) — การทบทวนรายวัน/รายสัปดาห์/รายเดือนตรวจจับการเบี่ยงเบนพฤติกรรม, การเสื่อมของกลยุทธ์ และความผิดพลาดในการเทรด
4. Audit (ตรวจสอบ) — ทุกการตัดสินใจถูกแฮช SHA-256 ณ เวลาสร้างและเชื่อมโยงกับรายการก่อนหน้า ส่งออกได้ทุกเมื่อเพื่อการทบทวน

เครื่องมือ MCP

ขอความช่วยเหลือในการเชื่อมต่อ

กำลังรันเอเจนต์กับโบรกเกอร์ หรือต้องการให้ประวัติของคุณถูกซิงก์และอ่าน? เปิด issue การรวมเบรก หรือ จอง 30 นาที ความช่วยเหลือในการตั้งค่าฟรี และผู้ที่ใช้มันเป็นผู้ตัดสินใจว่าจะสร้างอะไรต่อไป

บันทึกการตรวจสอบ

ทุกการตัดสินใจเทรดที่เอเจนต์ของคุณทำ — รวมถึงการตัดสินใจ ไม่ เทรด — ถูกบันทึกเป็นบันทึกการตัดสินใจเทรด (TDR) แฮชเนื้อหา SHA-256 ต่อรายการถูกเชื่อมโยงในบัญชีแยกประเภทการตรวจสอบแบบ forward-chained ทุกวัน UTC ถูกสรุปด้วย Merkle root ซึ่งเชื่อมโยงข้ามวัน การแก้ไขบันทึกทางประวัติใด ๆ ทำให้ลิงก์ถัดไปทั้งหมดไม่ถูกต้อง

กฎที่กำหนดให้ต้องมีบันทึกการตัดสินใจผูกพันบริษัทการลงทุน ไม่ใช่ผู้ใช้รายย่อย ภายใต้ EU AI Act ภาระผูกพันการบันทึกความเสี่ยงสูง Annex III ถูกเลื่อนเป็น 2 ธันวาคม 2027 และเอกสารแนะนำการกำกับดูแลของ ESMA เดือนกุมภาพันธ์ 2026 เกี่ยวกับการเทรดแบบอัลกอริทึมระบุว่าการเทรดแบบอัลกอริทึมที่ใช้ 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

รากรายวันถูกประทับเวลาโดยหน่วยงาน RFC 3161 โดยค่าเริ่มต้นตั้งแต่ 0.5.3 ไม่ได้สร้าง: การเซ็นบันทึกด้วยคีย์ส่วนตัว, การยึดกับบันทึกสาธารณะ, การพิสูจน์ว่าไม่มีอะไรถูกเว้น ดู LIMITATIONS.md

ความปลอดภัย

• เซิร์ฟเวอร์หน่วยความจำ (ค่าเริ่มต้น) ไม่วางคำสั่งและไม่ขอคีย์โบรกเกอร์ บันทึกและเรียกคืนเท่านั้น ในไฟล์ SQLite ในเครื่อง
• การซิงก์ tradememory sync hyperliquid อ่านข้อมูลสาธารณะโดยไม่ต้องใช้คีย์ tradememory sync alpaca ทำการเรียกแบบอ่านอย่างเดียวด้วยคีย์จากไฟล์บนเครื่องของคุณ การเทรดที่ซิงก์อยู่ในฐานข้อมูลในเครื่องของคุณ
• เบรก (ส่วนเสริม proxy) ส่งต่อคำสั่งที่นโยบายของคุณอนุญาตไปยังเซิร์ฟเวอร์ MCP ของโบรกเกอร์ คีย์โบรกเกอร์ของคุณถูกส่งไปยังกระบวนการโบรกเกอร์ที่พร็อกซีเริ่มต้นเท่านั้น TradeMemory ไม่เคยเก็บมัน
• การเรียกขาออก การประทับเวลา RFC 3161 ของรากการตรวจสอบรายวัน, แฮช 32 ไบต์ที่ไม่มีข้อมูลการเทรด (เปิดโดยค่าเริ่มต้น; TRADEMEMORY_TSA=off ปิดมัน) tradememory sync เรียกเวนิวที่คุณระบุ เครื่องมือวิวัฒนาการอ่านข้อมูลตลาด Binance สาธารณะ (api.binance.com) เมื่อเอเจนต์เรียกมัน และวิวัฒนาการเรียก API ของ Anthropic เฉพาะเมื่อคุณตั้ง ANTHROPIC_API_KEY Replay เรียก DeepSeek โดยค่าเริ่มต้น (หรือ Anthropic) และเฉพาะเมื่อตั้งคีย์ของผู้ให้บริการนั้น หากคุณติดตั้ง sentence-transformers สำหรับการเรียกคืนแบบไฮบริด มันดาวน์โหลดโมเดลจาก Hugging Face ในการใช้ครั้งแรก สคริปต์ซิงก์ MT5 และ Binance ใน scripts/ อ่านข้อมูลประจำตัวจากสภาพแวดล้อมของคุณ และสคริปต์ MT5 โพสต์สรุปการเทรด (สัญลักษณ์, ราคา, P&L) ไปยัง Discord webhook เฉพาะเมื่อคุณตั้ง DISCORD_WEBHOOK_URL
• หลักฐานการแก้ไข ไม่ใช่การป้องกันการแก้ไข ทุกรายการถูกแฮชและเชื่อมโยงกับรายการก่อนหน้า พร้อม Merkle roots รายวัน การเปลี่ยนบันทึกทำลายห่วงโซ่ ผู้ที่สามารถเขียนฐานข้อมูลทั้งหมดใหม่ได้สามารถสร้างมันขึ้นมาใหม่ได้

สถานะการวิจัย

เฟรมเวิร์ก OWM ของ TradeMemory มีพื้นฐานจากวิทยาศาสตร์ความรู้ความเข้าใจ (Tulving 1972) และการเรียนรู้แบบเสริมกำลัง (Schaul et al. 2015) สถานะปัจจุบัน:

• การให้คะแนนห้าปัจจัย OWM: นำไปใช้และทดสอบแล้ว (ดูป้าย CI)
• การตรวจสอบทางสถิติ: DSR, MBL นำไปใช้แล้ว (Bailey-de Prado 2014)
• บันทึกการตรวจสอบ: TDR ที่ทนทานต่อการแก้ไข SHA-256
• เอนจินวิวัฒนาการ: ระยะวิจัย (การสร้างกลยุทธ์ทำงาน, อัตราการผ่านเกณฑ์สถิติอยู่ระหว่างการปรับให้เหมาะสม)
• การเรียกคืนแบบไฮบริด: โหมด OWM เท่านั้นทำงาน, การรวมเวกเตอร์พร้อมใช้งานเมื่อกำหนดค่า embeddings
• การตรวจสอบเชิงประจักษ์: กำลังดำเนินการ (n=14 การเทรด, เป้าหมาย n>=100 เพื่อนัยสำคัญทางสถิติ; ที่ n=14 ช่วงความเชื่อมั่นกว้างเกินไปที่จะสรุปอะไร — ดู validation/final_verdict.md)

เอกสารประกอบ

การมีส่วนร่วม

ดู คู่มือการมีส่วนร่วม · นโยบายความปลอดภัย

MIT ดู สัญญาอนุญาต การติดตั้งเพิ่มเติมแบบไม่บังคับ proxy ติดตั้ง Mnemox Control ซึ่งเครื่องยนต์เป็น AGPL-3.0-only (มีสัญญาอนุญาตเชิงพาณิชย์ให้เลือก); TradeMemory ยังคงเป็น MIT สำหรับวัตถุประสงค์ทางการศึกษาและการวิจัยเท่านั้น ไม่ใช่คำแนะนำทางการเงิน