TradeMemory Protocol

TradeMemory mengingat apa yang telah dikorbankan. Ini adalah memori dan rem open-source yang mengutamakan lokal untuk agen trading AI: ia menarik data eksekusi Anda, menemukan di mana riwayat Anda sendiri kehilangan uang, menempatkan perdagangan yang merugi tersebut di depan agen Anda sebelum pesanan berikutnya, dan dapat menolak pesanan yang melanggar aturan yang Anda tetapkan, sebelum mencapai broker.

Broker kini mengizinkan agen AI untuk bertrading melalui MCP, dengan berbagai pengaman yang berbeda: Webull dan tastytrade menetapkan batas ukuran atau daya beli, Interactive Brokers hanya mengizinkan agen untuk menyusun pesanan agar Anda kirimkan, dan Robinhood serta Public tidak menetapkan batas yang dapat Anda kenakan pada agen eksternal (StockBrokers, 2026-09-30). Batas-batas tersebut adalah angka tetap. Tidak ada satu pun yang melihat bagaimana hasil perdagangan Anda sendiri di masa lalu.

Mulai dengan riwayat Anda sendiri

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

Setiap perdagangan yang ditutup disimpan dalam memori sekali; menjalankannya lagi hanya menyimpan perdagangan baru. Kemudian ia mencetak di mana riwayat Anda kehilangan uang. Formatnya, dengan angka ilustratif:

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.

Ini adalah statistik deskriptif dari perdagangan masa lalu Anda sendiri, bukan saran tentang perdagangan berikutnya. API Hyperliquid hanya menyajikan eksekusi terbaru dari sebuah alamat, bukan seluruh riwayatnya, jadi semakin cepat disinkronkan, semakin banyak riwayat yang disimpan. Tempat lain: skrip sinkronisasi MT5 dan Binance spot ada di scripts/, dan agen mana pun dapat mencatat perdagangan dengan remember_trade.

Sebelum pesanan berikutnya

recall_memories(order="losses_first") menempatkan setiap perdagangan yang merugi di depan yang lainnya, kerugian yang lebih besar dalam kondisi serupa terlebih dahulu, dengan ukuran dan P&L-nya. Selain perdagangan terbaru dari simbol tersebut, ia mencari perdagangan merugi terbaru dari simbol tersebut, sehingga kerugian yang lebih lama tidak terdesak keluar. Server memberi tahu agen yang terhubung untuk memanggilnya sebelum mengusulkan perdagangan. Urutan default memberi peringkat hasil yang lebih baik lebih tinggi (berdasarkan kelipatan R, jika ada yang dicatat) dan menjaga setidaknya 20% kerugian dalam daftar.

Hubungkan agen Anda

pip install tradememory-protocol

Tambahkan ke Claude Desktop (claude_desktop_config.json):

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

Kemudian beri tahu Claude: "Catat posisi long AAPL saya di $195 — earnings beat, pembelian institusional, keyakinan tinggi."

# 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

Panduan lengkap: Memulai (Jalur Trader + Jalur Pengembang)

Pasang rem di depan broker Anda (pratinjau)

Ekstra proxy menjalankan TradeMemory di antara agen Anda dan server MCP broker Anda (Alpaca saat ini). Setiap alat diteruskan tanpa perubahan kecuali yang menempatkan pesanan, yang dievaluasi oleh Mnemox Control terhadap kebijakan yang Anda miliki sebelum mencapai broker. Setiap evaluasi, diizinkan atau ditolak, dicatat dan dirantai ke dalam log audit. Pesanan yang diizinkan kembali dengan perdagangan merugi Anda dari kondisi serupa terlebih dahulu, dan tradememory sync alpaca kemudian mengisi bagaimana setiap perdagangan yang diteruskan berakhir, dalam R ketika entri membawa stop. Agen yang sudah Anda miliki tetap berfungsi; hanya satu baris konfigurasi MCP-nya yang berubah.

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

Ditolak secara default: simbol di luar daftar Anda, pesanan di atas batas nosional dan posisi Anda, entri tanpa bracket stop, pesanan baru apa pun setelah batas kerugian harian atau drawdown Anda, membatalkan stop pelindung dari posisi terbuka, alat apa pun yang belum diklasifikasikan oleh rem, dan semuanya saat Anda menjalankan tradememory proxy halt FULL_HALT. Tidak pernah diblokir: menutup posisi. Pesanan pada atau di atas approval_notional menunggu tradememory proxy approve <intent_id> --terms <fingerprint>, yang menyetujui persis ketentuan yang Anda baca; agen mencoba lagi dengan client_order_id yang sama dan ketentuan yang sama, dan proxy meneruskannya paling banyak sekali. evaluate_order mengembalikan keputusan yang sama tanpa menempatkan apa pun, untuk pemeriksaan awal dan untuk lapisan penasihat di kerangka lain. Apa pun yang tidak dapat dievaluasi oleh rem (umpan kuotasi mati, aset tidak dikenal, jenis pesanan yang tidak dicakup kebijakan) ditolak, tidak diteruskan.

Status: diuji ujung-ke-ujung terhadap tiruan stateful dari server MCP Alpaca (tests/proxy/), dan dijalankan terhadap akun kertas Alpaca nyata pada 2026-10-01: tiga penolakan (simbol tidak ada dalam daftar, entri tanpa stop, nosional di atas batas), satu pesanan bracket satu saham yang diizinkan yang mencapai broker, dan satu percobaan ulang dengan client_order_id yang sama yang dijawab dari catatan tanpa pesanan kedua. Opsi, penggantian pesanan, stop-limit dan trailing order ditolak daripada dievaluasi. Kunci broker Anda hanya pergi ke proses broker yang dimulai oleh proxy; TradeMemory tidak pernah menyimpannya.

Panduan dengan keluaran nyata: docs/recipes/alpaca-brake.md.

Tiga cara penggunaannya

Cara kerjanya

1. Recall — Sebelum bertrading, ambil perdagangan masa lalu yang diberi bobot berdasarkan kualitas hasil, kemiripan konteks, kebaruan, keyakinan, dan keadaan emosional (Kerangka OWM)
2. Record — Setelah bertrading, satu panggilan ke remember_trade menulis ke lima lapisan memori: episodik, semantik, prosedural, afektif, dan catatan perdagangan
3. Reflect — Tinjauan harian/mingguan/bulanan mendeteksi penyimpangan perilaku, penurunan strategi, dan kesalahan trading
4. Audit — Setiap keputusan di-hash SHA-256 saat dibuat dan dirantai ke yang sebelumnya. Ekspor kapan saja untuk tinjauan

Alat MCP

Dapatkan bantuan koneksi

Menjalankan agen terhadap broker, atau ingin riwayat Anda disinkronkan dan dibaca? Buka isu integrasi rem atau pesan 30 menit. Bantuan pengaturan gratis, dan orang-orang yang menggunakannya memutuskan apa yang akan dibangun berikutnya.

Jejak audit

Setiap keputusan trading yang dibuat agen Anda — termasuk keputusan untuk tidak bertrading — dicatat sebagai Catatan Keputusan Trading (TDR). Hash konten SHA-256 per catatan ditautkan ke dalam buku besar audit berantai maju; setiap hari UTC diringkas oleh akar Merkle yang dirantai melintasi hari. Mengubah catatan historis apa pun membatalkan setiap tautan berikutnya.

Aturan yang mewajibkan catatan keputusan mengikat firma investasi, bukan pengguna ritel. Di bawah EU AI Act, kewajiban pencatatan berisiko tinggi Annex III ditunda hingga 2 Desember 2027, dan briefing pengawasan ESMA Februari 2026 tentang trading algoritmik menyatakan bahwa trading algoritmik berbasis AI saat ini dikecualikan dari cakupan berisiko tinggi. Tabel menunjukkan fitur TradeMemory mana yang dipetakan ke teks-teks tersebut jika dan ketika berlaku untuk Anda. Ini bukan klaim kepatuhan.

# 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

Akar harian diberi stempel waktu oleh otoritas RFC 3161 secara default sejak 0.5.3. Tidak dibangun: menandatangani catatan dengan kunci pribadi, menjangkar ke log publik, membuktikan bahwa tidak ada yang dihilangkan. Lihat LIMITATIONS.md.

Keamanan

• Server memori (default). Tidak pernah menempatkan pesanan dan tidak pernah meminta kunci broker. Hanya mencatat dan mengingat, dalam file SQLite lokal.
• Sinkronisasi. tradememory sync hyperliquid membaca data publik tanpa kunci. tradememory sync alpaca membuat panggilan hanya-baca dengan kunci dari file di mesin Anda. Perdagangan yang disinkronkan tetap di database lokal Anda.
• Rem (ekstra proxy). Meneruskan pesanan yang diizinkan kebijakan Anda ke server MCP broker Anda. Kunci broker Anda hanya diteruskan ke proses broker yang dimulai oleh proxy; TradeMemory tidak pernah menyimpannya.
• Panggilan keluar. Stempel waktu RFC 3161 dari akar audit harian, hash 32-byte tanpa data perdagangan (aktif secara default; TRADEMEMORY_TSA=off mematikannya). tradememory sync memanggil venue yang Anda sebutkan. Alat evolusi membaca data pasar publik Binance (api.binance.com) ketika agen memanggilnya, dan evolusi memanggil API Anthropic hanya jika Anda menetapkan ANTHROPIC_API_KEY. Replay memanggil DeepSeek secara default (atau Anthropic), dan hanya dengan kunci penyedia tersebut diatur. Jika Anda menginstal sentence-transformers untuk recall hibrida, ia mengunduh modelnya dari Hugging Face pada penggunaan pertama. Skrip sinkronisasi MT5 dan Binance di scripts/ membaca kredensial mereka dari lingkungan Anda, dan yang MT5 memposting ringkasan perdagangan (simbol, harga, P&L) ke webhook Discord hanya jika Anda menetapkan DISCORD_WEBHOOK_URL.
• Tahan manipulasi, bukan anti-manipulasi. Setiap catatan di-hash dan ditautkan ke yang sebelumnya, dengan akar Merkle harian. Mengubah catatan memutus rantai; seseorang yang dapat menulis ulang seluruh database dapat membangunnya kembali.

Status Penelitian

Kerangka OWM TradeMemory didasarkan pada ilmu kognitif (Tulving 1972) dan pembelajaran penguatan (Schaul et al. 2015). Status saat ini:

• Skor lima faktor OWM: diimplementasikan dan diuji (lihat lencana CI)
• Validasi statistik: DSR, MBL diimplementasikan (Bailey-de Prado 2014)
• Jejak audit: TDR tahan manipulasi SHA-256
• Mesin evolusi: fase penelitian (generasi strategi berfungsi, tingkat kelulusan gerbang statistik di bawah optimasi)
• Recall hibrida: mode hanya-OWM aktif, fusi vektor tersedia saat embeddings dikonfigurasi
• Validasi empiris: berlangsung (n=14 perdagangan, target n>=100 untuk signifikansi statistik; pada n=14 interval kepercayaan terlalu lebar untuk menyimpulkan apa pun - lihat validation/final_verdict.md)

Dokumentasi

Berkontribusi

Lihat Panduan Berkontribusi · Kebijakan Keamanan

MIT, lihat LISENSI. Instalasi tambahan opsional proxy menginstal Mnemox Control, yang mesinnya berlisensi AGPL-3.0-only (lisensi komersial tersedia); TradeMemory sendiri tetap MIT. Hanya untuk tujuan pendidikan dan penelitian. Bukan nasihat keuangan.