TradeMemory Protocol
officielCouche mémoire IA pour le trading MT5/forex avec 15 outils MCP — stockage/rappel des transactions, découverte de motifs, évolution de stratégie et mémoire pondérée par les résultats.
Que pouvez-vous faire avec TradeMemory Protocol MCP ?
-
Rappeler les transactions passées selon le contexte — Demandez à votre assistant de récupérer les transactions antérieures pondérées par la qualité des résultats, la similarité du marché, la récence, la confiance et l'état émotionnel avant d'entrer dans une nouvelle position.
-
Enregistrer les transactions avec un contexte complet — Demandez à votre assistant de consigner une transaction terminée avec sa justification, les conditions du marché et le niveau de confiance, en mettant automatiquement à jour cinq couches de mémoire.
-
Exécuter des vérifications de sécurité avant transaction — Demandez à votre assistant d'évaluer une transaction potentielle selon un filtre de risque à cinq facteurs qui renvoie des recommandations complètes, réduites ou d'abstention.
-
Détecter les dérives comportementales et les séries de pertes — Demandez une analyse de vos schémas de trading pour faire ressortir les tendances de confiance, les alertes de drawdown et les erreurs répétées issues de votre mémoire.
-
Vérifier l'intégrité de la piste d'audit — Demandez à votre assistant de confirmer qu'un enregistrement de transaction spécifique ou la chaîne d'une journée entière n'a pas été altéré, en utilisant la vérification de hachage SHA-256.
-
Exporter des enregistrements conformes à la réglementation — Demandez à votre assistant de générer une exportation en masse des enregistrements de décisions de trading pour un examen réglementaire ou une soumission à un audit interne.
Documentation
Statut du projet (août 2026) : Fonctionnalités complètes, en mode maintenance — les rapports de bugs et de sécurité sont toujours examinés ; aucune nouvelle fonctionnalité ni service hébergé n'est prévu. Pour du travail rémunéré, voir Trading Record Analysis.
Votre IA de trading souffre d'amnésie. Et les régulateurs commencent à le remarquer.
Elle commet les mêmes erreurs à chaque session. Elle ne peut pas expliquer pourquoi elle a tradé. Elle oublie tout quand la fenêtre de contexte se termine. Pendant ce temps, MiFID II relève le niveau d'exigence pour la documentation des décisions algorithmiques (Article 17). L'EU AI Act exige une journalisation systématique des actions de l'IA (Article 14). Les agents de vos concurrents apprennent de chaque transaction.
La pile technologique du trading IA manque d'une couche. Chaque serveur MCP gère l'exécution — passer des ordres, récupérer les prix, lire les graphiques. Aucun ne gère la mémoire.
Votre agent peut acheter 100 actions AAPL mais ne peut pas répondre : « Que s'est-il passé la dernière fois que j'ai acheté AAPL dans ces conditions ? »
TradeMemory est la couche mémoire. Un pip install, et votre agent IA se souvient de chaque transaction, de chaque résultat, de chaque erreur — avec une piste d'audit infalsifiable SHA-256.
Utilisé par un trader indépendant qui exécute une checklist pré-vol avant chaque position, et en première partie contre un compte MT5 qui journalise les signaux bloqués ainsi que ceux exécutés. Voir USE_CASES.md pour savoir lequel est lequel.
Ce qu'il fait
- Avant de trader : interrogez votre mémoire — que s'est-il passé la dernière fois dans ces conditions de marché ? Comment cela s'est-il terminé ?
- Après avoir tradé : un seul appel enregistre tout — cinq couches mémoire se mettent à jour automatiquement
- Garde-fous : suivi de confiance, alertes de drawdown, détection de séries de pertes — le système vous dit quand vous arrêter
Fonctionne avec n'importe quel marché (actions, forex, crypto, futures), n'importe quel courtier, n'importe quelle plateforme IA. TradeMemory n'exécute pas de transactions et ne touche pas à votre argent — il ne fait qu'enregistrer et rappeler.
Voir l'interface
tradememory-dashboard.onrender.com — le tableau de bord fonctionnant sur un jeu de données de démonstration illustratif. Rien à installer.
Il s'agit d'un aperçu de l'interface, pas d'un historique de performance : les transactions sont synthétiques et chaque chiffre y est étiqueté comme tel. Pour voir ce que la couche mémoire fait réellement dans un terminal, pip install tradememory-protocol && tradememory demo --fast rejoue 30 transactions et montre le rappel et l'ajustement de paramètres qu'il en dérive.
Démarrage rapide
pip install tradememory-protocol
Ajoutez à Claude Desktop (claude_desktop_config.json) :
{
"mcpServers": {
"tradememory": {
"command": "uvx",
"args": ["tradememory-protocol"]
}
}
}
Puis dites à Claude : « Enregistre mon long AAPL à 195 $ — bénéfices supérieurs aux attentes, achats institutionnels, confiance élevée. »
Claude Code / Cursor / Docker
# 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
Procédure complète : Getting Started (Parcours Trader + Parcours Développeur)
Qui utilise TradeMemory
| Trader d'actions US | Système EA Forex | Équipe conformité | |
|---|---|---|---|
| Marché | Actions (AAPL, TSLA, ...) | XAUUSD (Or) | Multi-actifs |
| Méthode | Checklist pré-vol avant chaque transaction | Synchronisation automatique depuis MT5 | Piste d'audit complète des décisions |
| Valeur clé | Système de discipline — mémoire avant chaque décision | Enregistrer pourquoi les signaux ont été bloqués, pas seulement exécutés | Enregistrements infalsifiables SHA-256 pour les régulateurs |
| Détails | En savoir plus → | En savoir plus → | En savoir plus → |
Comment ça fonctionne
- Rappel — Avant de trader, récupérez les transactions passées pondérées par la qualité du résultat, la similarité du contexte, la récence, la confiance et l'état émotionnel (OWM Framework)
- Enregistrement — Après avoir tradé, un appel à
remember_tradeécrit dans cinq couches mémoire : épisodique, sémantique, procédurale, affective et enregistrements de transactions - Réflexion — Les revues quotidiennes/hebdomadaires/mensuelles détectent la dérive comportementale, la dégradation de la stratégie et les erreurs de trading
- Audit — Chaque décision est hachée en SHA-256 à sa création. Exportez à tout moment pour revue ou soumission réglementaire
Outils MCP
| Catégorie | Outils | Description |
|---|---|---|
| Mémoire | remember_trade · recall_memories | Enregistrer et rappeler les transactions avec un score pondéré par le résultat |
| État | get_agent_state · get_behavioral_analysis | Confiance, drawdown, séries, schémas comportementaux |
| Planification | create_trading_plan · check_active_plans | Plans prospectifs avec déclencheurs conditionnels |
| Risque | check_trade_legitimacy | Porte pré-transaction à 5 facteurs (complète / réduite / sautée) |
| Audit | export_audit_trail · verify_audit_hash | Détection d'altération SHA-256 + export en masse |
Les 20 outils MCP + API REST
| Catégorie | Outils |
|---|---|
| Mémoire centrale | get_strategy_performance · get_trade_reflection |
| Cognitif OWM | remember_trade · recall_memories · get_behavioral_analysis · get_agent_state · create_trading_plan · check_active_plans |
| Risque et gouvernance | check_trade_legitimacy · validate_strategy · compute_dqs |
| Évolution | evolution_fetch_market_data · evolution_discover_patterns · evolution_run_backtest · evolution_evolve_strategy · evolution_get_log |
| Audit | export_audit_trail · verify_audit_hash · verify_audit_chain · get_daily_root |
API REST : plus de 35 points de terminaison pour l'enregistrement des transactions, les réflexions, le risque, la synchronisation MT5, OWM, l'évolution et l'audit. Référence complète →
Analyse des enregistrements de trading
TradeMemory lui-même est gratuit et auto-hébergé. Ce que le mainteneur propose comme service payant est l'analyse statistique de vos propres enregistrements de trading : exportez votre historique MT4/MT5 et recevez un rapport de statistiques descriptives — où se concentrent vos pertes, comment votre taille de position change après des pertes, la structure des liquidations forcées, et le risque réel pris par transaction — suivi d'un appel de présentation.
Statistiques descriptives des transactions passées uniquement : pas de signaux de trading, pas de conseils en investissement, pas de promesses de performance. Vos fichiers sont supprimés après la livraison.
dev@mnemox.ai | Réserver un appel
Entreprise et conformité
Chaque décision de trading prise par votre agent — y compris les décisions de ne pas trader — est enregistrée comme un enregistrement de décision de trading (TDR). Les hachages de contenu SHA-256 par enregistrement sont liés dans un registre d'audit chaîné vers l'avant ; chaque jour UTC est résumé par une racine de Merkle qui s'enchaîne elle-même entre les jours. Toute altération d'un enregistrement historique invalide chaque lien suivant.
| Réglementation | Exigence | Couverture TradeMemory |
|---|---|---|
| MiFID II Article 17 | Enregistrer chaque facteur de décision de trading algorithmique | Chaîne de décision complète : conditions, filtres, indicateurs, exécution |
| EU AI Act Article 14 | Supervision humaine des systèmes d'IA à haut risque | Raisonnement explicable + contexte mémoire pour chaque décision |
| EU AI Act Article 12 | Journaux automatiques et résistants à l'altération sur la durée de vie du système | Chaîne SHA-256 liée + racines de Merkle quotidiennes (TSA RFC 3161 en Phase 1.5) |
# 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 for regulatory submission
GET /audit/export?strategy=VolBreakout&start=2026-03-01&format=jsonl
Voir LIMITATIONS.md pour la déclaration complète de maturité de la chaîne d'audit, y compris ce qui n'est pas encore dans v0.5.2 (horodatage TSA, ancrage externe, preuve d'inférence zkML).
Besoin d'un déploiement personnalisé pour votre fonds ? → dev@mnemox.ai
Sécurité
- Ne touche jamais aux clés API. TradeMemory n'exécute pas de transactions, ne déplace pas de fonds et n'accède pas aux portefeuilles.
- Lecture et enregistrement uniquement. Votre agent transmet le contexte de décision à TradeMemory. Il le stocke. C'est tout.
- Local d'abord. Le seul appel sortant est l'horodatage de confiance RFC 3161 des racines d'audit quotidiennes — un hachage de 32 octets, aucune donnée de transaction (activé par défaut ; désactivable avec
TRADEMEMORY_TSA=off). Rien d'autre ne quitte votre machine. - Registre d'audit chaîné SHA-256. Chaque enregistrement est haché à sa création et lié à l'enregistrement précédent. Les racines de Merkle quotidiennes ancrent la chaîne. Vérifiez l'intégrité au niveau de l'enregistrement, de la tranche ou du jour. Toute altération est détectable à chaque niveau ; l'ancrage externe (TSA par défaut) est sur la feuille de route.
- Plus de 1 400 tests réussis. Suite de tests complète avec CI.
Statut de la recherche
Le framework OWM de TradeMemory est fondé sur les sciences cognitives (Tulving 1972) et l'apprentissage par renforcement (Schaul et al. 2015). Statut actuel :
- Score OWM à cinq facteurs : implémenté, testé (plus de 1 400 tests)
- Validation statistique : DSR, MBL implémentés (Bailey-de Prado 2014)
- Piste d'audit : TDR infalsifiable SHA-256
- Moteur d'évolution : phase de recherche (la génération de stratégies fonctionne, taux de réussite du portail statistique en cours d'optimisation)
- Rappel hybride : mode OWM seul actif, fusion vectorielle disponible lorsque les embeddings sont configurés
- Validation empirique : en cours (n=14 transactions, cible n>=100 pour la significativité statistique ; à n=14, les intervalles de confiance sont trop larges pour conclure quoi que ce soit — voir validation/final_verdict.md)
Documentation
| Doc | Description |
|---|---|
| Getting Started | Installation → première transaction → checklist pré-vol |
| Use Cases | 3 scénarios d'utilisation, chacun étiqueté première partie ou indépendant |
| API Reference | Tous les points de terminaison REST |
| OWM Framework | Théorie de la mémoire pondérée par le résultat |
| Architecture | Conception du système et séparation des couches |
| Tutorial | Procédure détaillée |
| MT5 Setup | Intégration MetaTrader 5 |
| Research Log | Expériences d'évolution et données |
| Failure Taxonomy | 11 modes de défaillance de l'IA de trading |
| 中文版 | Chinois traditionnel |
Contribution
Voir Contributing Guide · Security Policy
MIT — voir LICENSE. À des fins éducatives et de recherche uniquement. Pas un conseil financier.