TradeMemory Protocol
oficialCamada de memória de IA para negociação MT5/forex com 15 ferramentas MCP — armazenar/recuperar negociações, descoberta de padrões, evolução de estratégia e Memória Ponderada por Resultado.
O que você pode fazer com TradeMemory Protocol MCP?
- Registre uma negociação com contexto completo — use
remember_tradepara registrar uma negociação com condições de mercado, confiança e resultado, de modo que ela persista entre sessões. - Lembre-se de negociações passadas antes de entrar em uma posição — pergunte ao
recall_memorieso que aconteceu em condições de mercado semelhantes, ponderado pela qualidade do resultado e pela recência. - Verifique se uma negociação é legítima agora — execute
check_trade_legitimacypara avaliar uma negociação prospectiva em relação a um portão de pré-negociação de 5 fatores. - Obtenha um retrato comportamental do seu agente de negociação — chame
get_agent_stateouget_behavioral_analysispara revelar tendências de confiança, rebaixamentos e sequências de perdas. - Exporte uma trilha de auditoria à prova de adulteração — use
export_audit_trailpara produzir registros encadeados por SHA-256 para revisão de conformidade e, em seguida, verifique a integridade comverify_audit_hashouverify_audit_chain.
Documentação
Sua IA de trading tem amnésia. E os reguladores estão começando a notar.
Ela comete os mesmos erros a cada sessão. Não consegue explicar por que operou. Esquece tudo quando a janela de contexto termina. Enquanto isso, a MiFID II está elevando o padrão para documentação de decisões algorítmicas (Artigo 17). A Lei de IA da UE exige registro sistemático das ações de IA (Artigo 14). Os agentes dos seus concorrentes estão aprendendo com cada operação.
Falta uma camada na stack de IA de trading. Todo servidor MCP lida com execução — colocando ordens, buscando preços, lendo gráficos. Nenhum lida com memória.
Seu agente pode comprar 100 ações da AAPL, mas não consegue responder: "O que aconteceu da última vez que comprei AAPL nesta condição?"
TradeMemory é a camada de memória. Um pip install, e seu agente de IA lembra de cada operação, cada resultado, cada erro — com uma trilha de auditoria SHA-256 à prova de adulteração.
Usado em produção por traders que executam checklists pré-voo antes de cada posição, e por sistemas EA que registram milhares de decisões diariamente.
O que faz
- Antes de operar: pergunte à sua memória — o que aconteceu da última vez nesta condição de mercado? Como terminou?
- Depois de operar: uma chamada registra tudo — cinco camadas de memória são atualizadas automaticamente
- Trilhos de segurança: acompanhamento de confiança, alertas de drawdown, detecção de sequência de perdas — o sistema avisa quando parar
Funciona com qualquer mercado (ações, forex, cripto, futuros), qualquer corretora, qualquer plataforma de IA. TradeMemory não executa operações nem toca no seu dinheiro — apenas registra e recorda.
Início Rápido
pip install tradememory-protocol
Adicione ao Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"tradememory": {
"command": "uvx",
"args": ["tradememory-protocol"]
}
}
}
Depois diga ao Claude: "Registre minha posição comprada em AAPL a $195 — lucro acima do esperado, compra institucional, alta confiança."
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
Passo a passo completo: Getting Started (Trilha do Trader + Trilha do Desenvolvedor)
Quem usa TradeMemory
| Trader de Ações dos EUA | Sistema EA Forex | Equipe de Compliance | |
|---|---|---|---|
| Mercado | Ações (AAPL, TSLA, ...) | XAUUSD (Ouro) | Multi-ativos |
| Como | Checklist pré-voo antes de cada operação | Sincronização automática do MT5 | Trilha de auditoria completa de decisões |
| Valor-chave | Sistema de disciplina — memória antes de cada decisão | Registra por que sinais foram bloqueados, não apenas executados | Registros SHA-256 à prova de adulteração para reguladores |
| Detalhes | Leia mais → | Leia mais → | Leia mais → |
Como funciona
- Recordar — Antes de operar, recupere operações passadas ponderadas pela qualidade do resultado, similaridade de contexto, recência, confiança e estado emocional (OWM Framework)
- Registrar — Depois de operar, uma chamada ao
remember_tradegrava em cinco camadas de memória: episódica, semântica, procedural, afetiva e registros de operações - Refletir — Revisões diárias/semanais/mensais detectam desvio comportamental, deterioração de estratégia e erros de trading
- Auditar — Cada decisão é hashada com SHA-256 na criação. Exporte a qualquer momento para revisão ou submissão regulatória
Ferramentas MCP
| Categoria | Ferramentas | Descrição |
|---|---|---|
| Memória | remember_trade · recall_memories | Registra e recorda operações com pontuação ponderada por resultado |
| Estado | get_agent_state · get_behavioral_analysis | Confiança, drawdown, sequências, padrões comportamentais |
| Planejamento | create_trading_plan · check_active_plans | Planos prospectivos com gatilhos condicionais |
| Risco | check_trade_legitimacy | Portão pré-operação de 5 fatores (completo / reduzido / pular) |
| Auditoria | export_audit_trail · verify_audit_hash | Detecção de adulteração SHA-256 + exportação em massa |
Todas as 20 ferramentas MCP + API REST
| Categoria | Ferramentas |
|---|---|
| Memória Central | get_strategy_performance · get_trade_reflection |
| Cognitivo OWM | remember_trade · recall_memories · get_behavioral_analysis · get_agent_state · create_trading_plan · check_active_plans |
| Risco e Governança | check_trade_legitimacy · validate_strategy · compute_dqs |
| Evolução | evolution_fetch_market_data · evolution_discover_patterns · evolution_run_backtest · evolution_evolve_strategy · evolution_get_log |
| Auditoria | export_audit_trail · verify_audit_hash · verify_audit_chain · get_daily_root |
API REST: mais de 35 endpoints para registro de operações, reflexões, risco, sincronização MT5, OWM, evolução e auditoria. Referência completa →
Preços
| Comunidade | Pro | Enterprise | |
|---|---|---|---|
| Preço | Grátis | US$ 29/mês (Em breve) | Fale Conosco |
| Ferramentas MCP | 20 ferramentas | 20 ferramentas | 20 ferramentas |
| Armazenamento | SQLite, auto-hospedado | API hospedada | Implantação privada |
| Painel | — | Painel web | Painel personalizado |
| Compliance | Trilha de auditoria incluída | Trilha de auditoria incluída | Relatórios de compliance + SLA |
| Suporte | GitHub Issues | Suporte prioritário | Suporte dedicado |
| Comece agora → | Em breve | dev@mnemox.ai |
Precisa de Ajuda para Integrar?
Construindo um agente de IA de trading e quer uma arquitetura de memória testada em batalha?
Chamada estratégica gratuita de 30 min — vamos mapear as necessidades de memória do seu agente e projetar proteções para seu fluxo de trabalho específico.
dev@mnemox.ai | Agende uma chamada
Ajudamos traders a criar checklists pré-voo, conectar MT5/Binance e projetar proteções personalizadas para forex, ações e cripto.
Enterprise e Compliance
Cada decisão de trading que seu agente toma — incluindo decisões de não operar — é registrada como um Registro de Decisão de Trading (TDR). Hashes de conteúdo SHA-256 por registro são vinculados em um livro-razão de auditoria encadeado para frente; cada dia UTC é resumido por uma raiz Merkle que, por sua vez, encadeia entre dias. Adulterar qualquer registro histórico invalida todos os vínculos subsequentes.
| Regulamentação | Requisito | Cobertura TradeMemory |
|---|---|---|
| MiFID II Artigo 17 | Registrar cada fator de decisão de trading algorítmico | Cadeia de decisão completa: condições, filtros, indicadores, execução |
| Lei de IA da UE Artigo 14 | Supervisão humana de sistemas de IA de alto risco | Raciocínio explicável + contexto de memória para cada decisão |
| Lei de IA da UE Artigo 12 | Registros automáticos e resistentes a adulteração ao longo da vida do sistema | Cadeia SHA-256 vinculada + raízes Merkle diárias (TSA RFC 3161 na Fase 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
Veja LIMITATIONS.md para a declaração completa de maturidade da cadeia de auditoria, incluindo o que ainda não está na v0.5.2 (carimbo de tempo TSA, ancoragem externa, prova zkML de inferência).
Precisa de uma implantação personalizada para seu fundo? → dev@mnemox.ai
Segurança
- Nunca toca em chaves de API. TradeMemory não executa operações, move fundos nem acessa carteiras.
- Somente leitura e registro. Seu agente passa o contexto de decisão para TradeMemory. Ele armazena. Só isso.
- Local primeiro. A única chamada de saída é o carimbo de tempo confiável RFC 3161 das raízes de auditoria diárias — um hash de 32 bytes, sem dados de operações (ativado por padrão; desative com
TRADEMEMORY_TSA=off). Nada mais sai da sua máquina. - Livro-razão de auditoria encadeado SHA-256. Cada registro é hashado na criação e vinculado ao registro anterior. Raízes Merkle diárias ancoram a cadeia. Verifique a integridade no nível de registro, fatia ou dia. A adulteração é detectável em todos os níveis; ancoragem externa (TSA por padrão) está no roadmap.
- Mais de 1.400 testes passando. Suíte de testes completa com CI.
Status da Pesquisa
O framework OWM do TradeMemory é fundamentado na ciência cognitiva (Tulving 1972) e no aprendizado por reforço (Schaul et al. 2015). Status atual:
- Pontuação OWM de cinco fatores: implementada, testada (mais de 1.400 testes)
- Validação estatística: DSR, MBL implementados (Bailey-de Prado 2014)
- Trilha de auditoria: TDR SHA-256 à prova de adulteração
- Mecanismo de evolução: fase de pesquisa (geração de estratégia funciona, taxa de aprovação do portão estatístico sob otimização)
- Recordação híbrida: modo somente OWM ativo, fusão vetorial disponível quando embeddings estão configurados
- Validação empírica: em andamento (n=40 operações, alvo n>=100 para significância estatística)
Documentação
| Documento | Descrição |
|---|---|
| Getting Started | Instalação → primeira operação → checklist pré-voo |
| Use Cases | 3 cenários reais de produção |
| API Reference | Todos os endpoints REST |
| OWM Framework | Teoria da Memória Ponderada por Resultado |
| Architecture | Design do sistema e separação de camadas |
| Tutorial | Passo a passo detalhado |
| MT5 Setup | Integração com MetaTrader 5 |
| Research Log | Experimentos e dados de evolução |
| Failure Taxonomy | 11 modos de falha de IA de trading |
| 中文版 | Chinês tradicional |
Contribuindo
Veja Guia de Contribuição · Política de Segurança
MIT — veja LICENSE. Apenas para fins educacionais/de pesquisa. Não é aconselhamento financeiro.