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.

ये आपके अपने पिछले ट्रेडों के वर्णनात्मक आँकड़े हैं, अगले ट्रेड के बारे में सलाह नहीं। Hyperliquid का API केवल एक पते के हालिया फिल्स प्रदान करता है, उसका पूरा इतिहास नहीं, इसलिए जितनी जल्दी इसे सिंक किया जाए, उतना अधिक इतिहास रखा जाता है। अन्य स्थान: MT5 और Binance स्पॉट सिंक स्क्रिप्ट scripts/ में हैं, और कोई भी एजेंट remember_trade के साथ एक ट्रेड रिकॉर्ड कर सकता है।

अगले ऑर्डर से पहले

recall_memories(order="losses_first") हर घाटे वाले ट्रेड को बाकी से आगे रखता है, समान परिस्थितियों में बड़े नुकसान पहले, उनके आकार और P&L के साथ। प्रतीक के सबसे हालिया ट्रेडों के अलावा, यह प्रतीक के हालिया घाटे वाले ट्रेडों की खोज करता है, ताकि एक पुराना नुकसान बाहर न हो जाए। सर्वर कनेक्टेड एजेंटों को एक ट्रेड प्रस्तावित करने से पहले इसे कॉल करने के लिए कहता है। डिफ़ॉल्ट क्रम बेहतर परिणामों को उच्च रैंक करता है (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 एक्स्ट्रा TradeMemory को आपके एजेंट और आपके ब्रोकर के MCP सर्वर (आज Alpaca) के बीच चलाता है। हर टूल को अपरिवर्तित अग्रेषित किया जाता है, सिवाय ऑर्डर-प्लेसिंग वाले के, जिनका Mnemox Control एक नीति के खिलाफ मूल्यांकन करता है जिसे आप ब्रोकर तक पहुँचने से पहले रखते हैं। हर मूल्यांकन, अनुमत या अस्वीकृत, दर्ज किया जाता है और ऑडिट लॉग में जोड़ा जाता है। एक अनुमत ऑर्डर समान परिस्थितियों से आपके घाटे वाले ट्रेडों के साथ पहले वापस आता है, और tradememory sync alpaca बाद में भरता है कि प्रत्येक अग्रेषित ट्रेड कैसे समाप्त हुआ, R में जब प्रवेश में एक स्टॉप था। आपके पास पहले से मौजूद एजेंट काम करता रहता है; इसके 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

डिफ़ॉल्ट रूप से अस्वीकृत: आपकी सूची से बाहर के प्रतीक, आपकी नोशनल और पोज़िशन सीमाओं से ऊपर के ऑर्डर, ब्रैकेट स्टॉप के बिना प्रविष्टियाँ, आपकी दैनिक-हानि या ड्रॉडाउन सीमा के बाद कोई भी नया ऑर्डर, एक खुली पोज़िशन के सुरक्षात्मक स्टॉप को रद्द करना, कोई भी टूल जिसे ब्रेक ने वर्गीकृत नहीं किया है, और सब कुछ जब आप tradememory proxy halt FULL_HALT चला रहे हैं। कभी अवरुद्ध नहीं: एक पोज़िशन बंद करना। approval_notional पर या उससे ऊपर के ऑर्डर tradememory proxy approve <intent_id> --terms <fingerprint> की प्रतीक्षा करते हैं, जो ठीक उन्हीं शर्तों को मंजूरी देता है जिन्हें आपने पढ़ा है; एजेंट उसी client_order_id और उन्हीं शर्तों के साथ पुनः प्रयास करता है, और प्रॉक्सी इसे अधिकतम एक बार अग्रेषित करता है। evaluate_order बिना कुछ रखे वही निर्णय लौटाता है, प्री-चेक और अन्य फ्रेमवर्क में सलाहकार परतों के लिए। ब्रेक जिस भी चीज़ का मूल्यांकन नहीं कर सकता (एक मृत कोट फ़ीड, एक अज्ञात परिसंपत्ति, एक ऑर्डर प्रकार जो नीति कवर नहीं करती) उसे अस्वीकार कर दिया जाता है, पास-थ्रू नहीं किया जाता।

स्थिति: Alpaca के MCP सर्वर के एक स्टेटफुल फेक के खिलाफ एंड-टू-एंड परीक्षण किया गया (tests/proxy/), और 2026-10-01 को एक वास्तविक Alpaca पेपर खाते के खिलाफ चलाया गया: तीन अस्वीकृतियाँ (सूची में नहीं प्रतीक, बिना स्टॉप के प्रवेश, सीमा से ऊपर नोशनल), एक अनुमत एक-शेयर ब्रैकेट ऑर्डर जो ब्रोकर तक पहुँचा, और एक रीट्राई उसी client_order_id के साथ जो दूसरे ऑर्डर के बिना रिकॉर्ड से उत्तर दिया गया। विकल्प, ऑर्डर प्रतिस्थापन, स्टॉप-लिमिट और ट्रेलिंग ऑर्डर मूल्यांकन के बजाय अस्वीकार कर दिए जाते हैं। आपकी ब्रोकर कुंजियाँ केवल ब्रोकर प्रक्रिया के पास जाती हैं जो प्रॉक्सी शुरू करता है; TradeMemory उन्हें कभी संग्रहीत नहीं करता।

वास्तविक आउटपुट के साथ वॉकथ्रू: docs/recipes/alpaca-brake.md।

तीन तरीके जिनसे इसका उपयोग किया जाता है

यह कैसे काम करता है

1. रिकॉल — ट्रेडिंग से पहले, परिणाम गुणवत्ता, संदर्भ समानता, हालियत, विश्वास और भावनात्मक स्थिति द्वारा भारित पिछले ट्रेडों को पुनः प्राप्त करें (OWM फ्रेमवर्क)
2. रिकॉर्ड — ट्रेडिंग के बाद, remember_trade के लिए एक कॉल पाँच मेमोरी परतों में लिखता है: एपिसोडिक, सिमेंटिक, प्रोसीजरल, अफेक्टिव और ट्रेड रिकॉर्ड
3. रिफ्लेक्ट — दैनिक/साप्ताहिक/मासिक समीक्षाएँ व्यवहारिक बहाव, रणनीति क्षय और ट्रेडिंग गलतियों का पता लगाती हैं
4. ऑडिट — हर निर्णय निर्माण के समय SHA-256 हैश किया जाता है और पिछले एक से जोड़ा जाता है। किसी भी समय समीक्षा के लिए निर्यात करें

MCP टूल्स

कनेक्ट करने में सहायता प्राप्त करें

किसी ब्रोकर के खिलाफ एजेंट चला रहे हैं, या अपने इतिहास को सिंक और पढ़ना चाहते हैं? ब्रेक-इंटीग्रेशन मुद्दा खोलें या 30 मिनट बुक करें। सेटअप सहायता मुफ्त है, और जो लोग इसका उपयोग करते हैं वे तय करते हैं कि आगे क्या बनाया जाए।

ऑडिट ट्रेल

आपके एजेंट द्वारा लिया गया हर ट्रेडिंग निर्णय — जिसमें ट्रेड नहीं करने के निर्णय भी शामिल हैं — एक ट्रेडिंग डिसीजन रिकॉर्ड (TDR) के रूप में दर्ज किया जाता है। प्रति-रिकॉर्ड SHA-256 सामग्री हैश एक फॉरवर्ड-चेन्ड ऑडिट लेजर में जुड़े होते हैं; प्रत्येक UTC दिन एक मर्कल रूट द्वारा सारांशित किया जाता है जो स्वयं दिनों में चेन करता है। किसी भी ऐतिहासिक रिकॉर्ड के साथ छेड़छाड़ हर बाद के लिंक को अमान्य कर देती है।

नियम जिन्हें निर्णय रिकॉर्ड की आवश्यकता होती है, वे निवेश फर्मों को बांधते हैं, खुदरा उपयोगकर्ताओं को नहीं। EU AI अधिनियम के तहत, अनुबंध 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

दैनिक रूट 0.5.3 से डिफ़ॉल्ट रूप से एक RFC 3161 प्राधिकरण द्वारा टाइमस्टैम्प किए जाते हैं। निर्मित नहीं: एक निजी कुंजी के साथ रिकॉर्ड पर हस्ताक्षर करना, एक सार्वजनिक लॉग में एंकरिंग, यह साबित करना कि कुछ भी बाहर नहीं छोड़ा गया था। देखें LIMITATIONS.md।

सुरक्षा

• मेमोरी सर्वर (डिफ़ॉल्ट)। कभी ऑर्डर नहीं रखता और कभी ब्रोकर कुंजियाँ नहीं माँगता। केवल एक स्थानीय SQLite फ़ाइल में रिकॉर्ड और रिकॉल करता है।
• सिंक। tradememory sync hyperliquid बिना कुंजी के सार्वजनिक डेटा पढ़ता है। tradememory sync alpaca आपकी मशीन पर एक फ़ाइल से कुंजियों के साथ केवल-पढ़ने वाले कॉल करता है। सिंक किए गए ट्रेड आपके स्थानीय डेटाबेस में रहते हैं।
• ब्रेक (proxy एक्स्ट्रा)। आपकी नीति द्वारा अनुमत ऑर्डर को आपके ब्रोकर के MCP सर्वर पर अग्रेषित करता है। आपकी ब्रोकर कुंजियाँ केवल ब्रोकर प्रक्रिया को दी जाती हैं जो प्रॉक्सी शुरू करता है; TradeMemory उन्हें कभी संग्रहीत नहीं करता।
• आउटबाउंड कॉल। दैनिक ऑडिट रूट का RFC 3161 टाइमस्टैम्पिंग, बिना किसी ट्रेड डेटा के 32-बाइट हैश (डिफ़ॉल्ट रूप से चालू; TRADEMEMORY_TSA=off इसे बंद कर देता है)। tradememory sync आपके नामित स्थान को कॉल करता है। विकास टूल सार्वजनिक Binance बाजार डेटा पढ़ते हैं (api.binance.com) जब कोई एजेंट उन्हें कॉल करता है, और विकास Anthropic API को केवल तभी कॉल करता है यदि आप ANTHROPIC_API_KEY सेट करते हैं। रीप्ले डिफ़ॉल्ट रूप से DeepSeek (या Anthropic) को कॉल करता है, और केवल उस प्रदाता की कुंजी सेट होने पर। यदि आप हाइब्रिड रिकॉल के लिए sentence-transformers स्थापित करते हैं, तो यह पहले उपयोग पर Hugging Face से अपना मॉडल डाउनलोड करता है। scripts/ में MT5 और Binance सिंक स्क्रिप्ट आपके वातावरण से अपनी क्रेडेंशियल्स पढ़ती हैं, और MT5 वाला ट्रेड सारांश (प्रतीक, मूल्य, P&L) केवल तभी Discord वेबहुक पर पोस्ट करता है यदि आप DISCORD_WEBHOOK_URL सेट करते हैं।
• छेड़छाड़-स्पष्ट, छेड़छाड़-प्रूफ नहीं। हर रिकॉर्ड हैश किया जाता है और पिछले एक से जोड़ा जाता है, दैनिक मर्कल रूट के साथ। एक रिकॉर्ड बदलने से श्रृंखला टूट जाती है; जो कोई पूरे डेटाबेस को फिर से लिख सकता है वह इसे फिर से बना सकता है।

अनुसंधान स्थिति

TradeMemory का OWM फ्रेमवर्क संज्ञानात्मक विज्ञान (Tulving 1972) और सुदृढीकरण सीखने (Schaul et al. 2015) पर आधारित है। वर्तमान स्थिति:

• OWM पांच-कारक स्कोरिंग: लागू और परीक्षण किया गया (CI बैज देखें)
• सांख्यिकीय सत्यापन: DSR, MBL लागू (Bailey-de Prado 2014)
• ऑडिट ट्रेल: SHA-256 छेड़छाड़-स्पष्ट TDR
• विकास इंजन: अनुसंधान चरण (रणनीति निर्माण काम करता है, अनुकूलन के तहत सांख्यिकीय गेट पास दर)
• हाइब्रिड रिकॉल: OWM-केवल मोड सक्रिय, एम्बेडिंग कॉन्फ़िगर होने पर वेक्टर फ्यूजन उपलब्ध
• अनुभवजन्य सत्यापन: जारी (n=14 ट्रेड, सांख्यिकीय महत्व के लिए लक्ष्य n>=100; n=14 पर विश्वास अंतराल कुछ भी निष्कर्ष निकालने के लिए बहुत चौड़े हैं - देखें validation/final_verdict.md)

दस्तावेज़ीकरण

योगदान

देखें योगदान गाइड · सुरक्षा नीति

MIT, देखें लाइसेंस। वैकल्पिक proxy अतिरिक्त इंस्टॉल Mnemox Control, जिसका इंजन AGPL-3.0-only है (वाणिज्यिक लाइसेंस उपलब्ध है); TradeMemory स्वयं MIT रहता है। केवल शैक्षिक और अनुसंधान उद्देश्यों के लिए। वित्तीय सलाह नहीं।