TradeMemory Protocol

TradeMemory neye mal olduğunu hatırlar. Yapay zeka trading ajanları için açık kaynaklı, yerel-öncelikli bir bellek ve frendir: emirlerinizi çeker, kendi geçmişinizin nerede para kaybettiğini bulur, bu kaybeden işlemleri bir sonraki emirden önce ajanınızın önüne koyar ve belirlediğiniz kuralları ihlal eden bir emri, komisyoncuya ulaşmadan reddedebilir.

Komisyoncular artık yapay zeka ajanlarının MCP üzerinden işlem yapmasına farklı güvenlik önlemleriyle izin veriyor: Webull ve tastytrade boyut veya satın alma gücü limitleri belirler, Interactive Brokers ajanın yalnızca sizin göndereceğiniz bir emir taslağı hazırlamasına izin verir ve Robinhood ile Public harici bir ajana uygulayabileceğiniz bir üst sınır koymaz (StockBrokers, 2026-09-30). Sınırlar sabit sayılardır. Hiçbiri kendi geçmiş işlemlerinizin nasıl gittiğine bakmaz.

Kendi geçmişinizle başlayı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

Kapatılan her işlem belleğe bir kez kaydedilir; tekrar çalıştırmak yalnızca yeni işlemleri kaydeder. Ardından geçmişinizin nerede para kaybettiğini yazdırır. Açıklayıcı sayılarla format:

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.

Bunlar kendi geçmiş işlemlerinizin tanımlayıcı istatistikleridir, bir sonraki işlem hakkında tavsiye değildir. Hyperliquid'in API'si yalnızca bir adresin son emirlerini sunar, tüm geçmişini değil; bu nedenle ne kadar erken senkronize edilirse, o kadar fazla geçmiş korunur. Diğer platformlar: MT5 ve Binance spot senkronizasyon betikleri scripts/ içindedir ve herhangi bir ajan remember_trade ile bir işlemi kaydedebilir.

Bir sonraki emirden önce

recall_memories(order="losses_first") her kaybeden işlemi diğerlerinin önüne koyar, benzer koşullardaki daha büyük kayıplar önce gelir, boyutları ve P&L'leriyle birlikte. Sembolün en son işlemlerinin yanı sıra, sembolün yakın tarihli kaybeden işlemlerini de arar, böylece daha eski bir kayıp göz ardı edilmez. Sunucu, bağlı ajanlara bir işlem önermeden önce bunu çağırmalarını söyler. Varsayılan sıralama daha iyi sonuçları daha üstte tutar (R katına göre, kaydedildiği yerde) ve listede en az %20 kaybı korur.

Ajanınızı bağlayın

pip install tradememory-protocol

Claude Desktop'a ekleyin (claude_desktop_config.json):

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

Ardından Claude'a söyleyin: "AAPL uzun pozisyonumu 195$'dan kaydet — kazanç beklentisini aştı, kurumsal alım, yüksek güven."

# 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

Tam yol gösterimi: Başlarken (Trader Parkuru + Geliştirici Parkuru)

Komisyoncunuzun önüne bir fren koyun (önizleme)

proxy eklentisi, TradeMemory'yi ajanınız ile komisyoncunuzun MCP sunucusu (bugün Alpaca) arasında çalıştırır. Emir yerleştirenler dışındaki tüm araçlar değiştirilmeden iletilir; emir yerleştirenler, komisyoncuya ulaşmadan önce Mnemox Control tarafından size ait bir politikaya göre değerlendirilir. İzin verilen veya reddedilen her değerlendirme kaydedilir ve denetim günlüğüne zincirlenir. İzin verilen bir emir, benzer koşullardaki kaybeden işlemlerinizle birlikte geri gelir ve tradememory sync alpaca daha sonra iletilen her işlemin nasıl bittiğini, girişte bir stop varsa R cinsinden doldurur. Sahip olduğunuz ajan çalışmaya devam eder; yalnızca MCP yapılandırmasının bir satırı değişir.

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

Varsayılan olarak reddedilir: listeniz dışındaki semboller, nominal ve pozisyon limitlerinizin üzerindeki emirler, bracket stop olmadan girişler, günlük kayıp veya düşüş limitinizden sonraki herhangi bir yeni emir, açık bir pozisyonun koruyucu stopunun iptali, frenin sınıflandırmadığı herhangi bir araç ve tradememory proxy halt FULL_HALT çalıştırdığınız sürece her şey. Asla engellenmez: bir pozisyonu kapatmak. approval_notional seviyesindeki veya üzerindeki emirler, okuduğunuz koşulların aynısını onaylayan tradememory proxy approve <intent_id> --terms <fingerprint>'yi bekler; ajan aynı client_order_id ve aynı koşullarla yeniden dener ve proxy en fazla bir kez iletir. evaluate_order hiçbir şey yerleştirmeden aynı kararı döndürür; ön kontroller ve diğer çerçevelerdeki danışma katmanları için. Frenin değerlendiremediği herhangi bir şey (ölü bir fiyat akışı, bilinmeyen bir varlık, politikanın kapsamadığı bir emir türü) geçirilmek yerine reddedilir.

Durum: Alpaca'nın MCP sunucusunun durum bilgisi olan bir sahtesine karşı uçtan uca test edildi (tests/proxy/) ve 2026-10-01'de gerçek bir Alpaca kağıt hesabına karşı çalıştırıldı: üç ret (listede olmayan sembol, stopsuz giriş, limitin üzerinde nominal), komisyoncuya ulaşan bir izinli tek hisselik bracket emri ve kayıttan ikinci bir emir olmadan yanıtlanan aynı client_order_id ile bir yeniden deneme. Opsiyonlar, emir değiştirme, stop-limit ve trailing emirler değerlendirilmek yerine reddedilir. Komisyoncu anahtarlarınız yalnızca proxy'nin başlattığı komisyoncu sürecine gider; TradeMemory bunları asla saklamaz.

Gerçek çıktılarla yol gösterimi: docs/recipes/alpaca-brake.md.

Kullanıldığı üç yol

Nasıl çalışır

1. Hatırla — İşlem yapmadan önce, sonuç kalitesi, bağlam benzerliği, güncellik, güven ve duygusal duruma göre ağırlıklandırılmış geçmiş işlemleri al (OWM Çerçevesi)
2. Kaydet — İşlem yaptıktan sonra, remember_trade'ye yapılan tek bir çağrı beş bellek katmanına yazar: epizodik, anlamsal, prosedürel, duygusal ve işlem kayıtları
3. Yansıt — Günlük/haftalık/aylık incelemeler davranışsal sapmayı, strateji bozulmasını ve işlem hatalarını tespit eder
4. Denetle — Her karar, oluşturulduğunda SHA-256 ile hash'lenir ve bir öncekine zincirlenir. İnceleme için istediğiniz zaman dışa aktarın

MCP Araçları

Bağlanmak için yardım alın

Bir komisyoncuya karşı bir ajan mı çalıştırıyorsunuz veya geçmişinizin senkronize edilip okunmasını mı istiyorsunuz? Bir fren entegrasyonu sorunu açın veya 30 dakika ayırtın. Kurulum yardımı ücretsizdir ve kullanan kişiler sırada neyin oluşturulacağına karar verir.

Denetim izi

Ajanınızın yaptığı her işlem kararı — işlem yapmama kararları dahil — bir İşlem Kararı Kaydı (TDR) olarak kaydedilir. Kayıt başına SHA-256 içerik hash'leri, ileri zincirli bir denetim defterine bağlanır; her UTC günü, günler arasında zincirlenen bir Merkle köküyle özetlenir. Herhangi bir tarihsel kaydın kurcalanması, sonraki her bağlantıyı geçersiz kılar.

Karar kaydı gerektiren kurallar, perakende kullanıcıları değil yatırım firmalarını bağlar. AB Yapay Zeka Yasası kapsamında, Ek III yüksek riskli kayıt yükümlülükleri 2 Aralık 2027'ye ertelendi ve ESMA'nın Şubat 2026 algoritmik ticaret denetim brifingi, yapay zeka tabanlı algoritmik ticaretin şu anda yüksek riskli kapsam dışında olduğunu belirtmektedir. Tablo, TradeMemory özelliklerinden hangilerinin size uygulandığında bu metinlere karşılık geldiğini gösterir. Bu bir uyumluluk iddiası değildir.

# 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

Günlük kökler, 0.5.3'ten beri varsayılan olarak bir RFC 3161 yetkilisi tarafından zaman damgalanır. Oluşturulmadı: kayıtları özel bir anahtarla imzalama, genel bir günlüğe sabitleme, hiçbir şeyin dışarıda bırakılmadığını kanıtlama. Bkz. LIMITATIONS.md.

Güvenlik

• Bellek sunucusu (varsayılan). Asla emir vermez ve asla komisyoncu anahtarı istemez. Yalnızca yerel bir SQLite dosyasında kaydeder ve hatırlar.
• Senkronizasyon. tradememory sync hyperliquid anahtarsız genel verileri okur. tradememory sync alpaca, makinenizdeki bir dosyadan anahtarlarla salt okunur çağrılar yapar. Senkronize edilen işlemler yerel veritabanınızda kalır.
• Fren (proxy eklentisi). Politikanızın izin verdiği emirleri komisyoncunuzun MCP sunucusuna iletir. Komisyoncu anahtarlarınız yalnızca proxy'nin başlattığı komisyoncu sürecine iletilir; TradeMemory bunları asla saklamaz.
• Giden çağrılar. Günlük denetim köklerinin RFC 3161 zaman damgası, işlem verisi olmayan 32 baytlık bir hash (varsayılan olarak açık; TRADEMEMORY_TSA=off kapatır). tradememory sync adını verdiğiniz platformu çağırır. Evrim araçları, bir ajan çağırdığında genel Binance piyasa verilerini okur (api.binance.com) ve evrim, yalnızca ANTHROPIC_API_KEY ayarlarsanız Anthropic API'sini çağırır. Replay varsayılan olarak DeepSeek'i (veya Anthropic'i) çağırır ve yalnızca bu sağlayıcının anahtarı ayarlanmışsa. Hibrit hatırlama için sentence-transformers kurarsanız, modelini ilk kullanımda Hugging Face'ten indirir. scripts/ içindeki MT5 ve Binance senkronizasyon betikleri kimlik bilgilerini ortamınızdan okur ve MT5 betiği, yalnızca DISCORD_WEBHOOK_URL ayarlarsanız işlem özetlerini (sembol, fiyatlar, P&L) bir Discord webhook'una gönderir.
• Kurcalamaya karşı belirgin, kurcalamaya karşı dayanıklı değil. Her kayıt hash'lenir ve bir öncekine bağlanır, günlük Merkle kökleriyle. Bir kaydı değiştirmek zinciri kırar; tüm veritabanını yeniden yazabilen biri onu yeniden oluşturabilir.

Araştırma Durumu

TradeMemory'nin OWM çerçevesi bilişsel bilime (Tulving 1972) ve pekiştirmeli öğrenmeye (Schaul ve diğerleri 2015) dayanır. Güncel durum:

• OWM beş faktörlü puanlama: uygulandı ve test edildi (CI rozetine bakın)
• İstatistiksel doğrulama: DSR, MBL uygulandı (Bailey-de Prado 2014)
• Denetim izi: SHA-256 kurcalamaya karşı belirgin TDR
• Evrim motoru: araştırma aşaması (strateji üretimi çalışıyor, istatistiksel kapı geçiş oranı optimizasyon altında)
• Hibrit hatırlama: yalnızca OWM modu etkin, gömme yapılandırıldığında vektör füzyonu mevcut
• Ampirik doğrulama: devam ediyor (n=14 işlem, istatistiksel anlamlılık için hedef n>=100; n=14'te güven aralıkları herhangi bir sonuca varmak için çok geniş - validation/final_verdict.md dosyasına bakın)

Dokümantasyon

Katkıda Bulunma

Katkıda Bulunma Rehberi · Güvenlik Politikası bölümüne bakın

MIT, bkz. LİSANS. İsteğe bağlı proxy ekstra kurulumu, motoru AGPL-3.0-only (ticari lisans mevcuttur) olan Mnemox Kontrol öğesini yükler; TradeMemory'nin kendisi MIT olarak kalır. Yalnızca eğitim ve araştırma amaçlıdır. Finansal tavsiye değildir.