TradeMemory Protocol

Status do projeto (agosto de 2026): Funcionalidades completas, em modo de manutenção — relatórios de bugs e segurança ainda são revisados; nenhum novo recurso ou serviço hospedado está planejado. Para trabalho pago, veja Trading Record Analysis.

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 — colocar ordens, buscar preços, ler 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 um trilha de auditoria à prova de adulteração SHA-256.

Usado por um trader independente que executa uma checklist pré-voo antes de cada posição, e em primeira mão contra uma conta MT5 que registra sinais bloqueados além dos executados. Veja USE_CASES.md para saber qual é qual.

O que faz

• Antes de operar: consulte 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: rastreamento 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.

Veja a interface

tradememory-dashboard.onrender.com — o dashboard rodando em um conjunto de dados de demonstração ilustrativo. Nada para instalar.

É uma prévia da interface, não um histórico de resultados: as operações são sintéticas e cada número é rotulado como tal. Para ver o que a camada de memória realmente faz em um terminal, pip install tradememory-protocol && tradememory demo --fast reproduz 30 operações e mostra a recordação e o ajuste de parâmetros que deriva delas.

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, compras institucionais, alta confiança."

# 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

Como funciona

1. Recordar — Antes de operar, recupere operações passadas ponderadas por qualidade de resultado, similaridade de contexto, recência, confiança e estado emocional (OWM Framework)
2. Registrar — Depois de operar, uma chamada para remember_trade grava em cinco camadas de memória: episódica, semântica, procedural, afetiva e registros de operações
3. Refletir — Revisões diárias/semanais/mensais detectam desvio comportamental, deterioração de estratégia e erros de trading
4. 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

Análise de Registros de Trading

O TradeMemory em si é gratuito e auto-hospedado. O que o mantenedor oferece como serviço pago é análise estatística dos seus próprios registros de trading: exporte seu histórico MT4/MT5 e receba um relatório de estatísticas descritivas — onde suas perdas se concentram, como seu dimensionamento de posição muda após perdas, estrutura de liquidação forçada e o risco real que você assumiu por operação — seguido de uma chamada de orientação.

Estatísticas descritivas apenas de operações passadas: sem sinais de trading, sem aconselhamento de investimento, sem promessas de desempenho. Seus arquivos são excluídos após a entrega.

dev@mnemox.ai | Agende uma chamada

Empresas 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 SHA-256 por registro são vinculados em um livro-razão de auditoria encadeado; cada dia UTC é resumido por uma raiz Merkle que também se encadeia entre dias. Adulterar qualquer registro histórico invalida todos os links subsequentes.

# 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 ou acessa carteiras.
• Somente leitura e registro. Seu agente passa o contexto de decisão para o TradeMemory. Ele armazena. Só isso.
• Local-first. 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.
• 1.400+ testes passando. Suíte de testes completa com CI.

Status da Pesquisa

O framework OWM do TradeMemory é fundamentado em ciência cognitiva (Tulving 1972) e aprendizado por reforço (Schaul et al. 2015). Status atual:

• Pontuação de cinco fatores OWM: implementada, testada (1.400+ testes)
• Validação estatística: DSR, MBL implementados (Bailey-de Prado 2014)
• Trilha de auditoria: TDR à prova de adulteração SHA-256
• Motor 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 são configurados
• Validação empírica: em andamento (n=14 operações, alvo n>=100 para significância estatística; em n=14 os intervalos de confiança são largos demais para concluir qualquer coisa — veja validation/final_verdict.md)

Documentação

Contribuindo

Veja Contributing Guide · Security Policy

MIT — veja LICENSE. Apenas para fins educacionais/de pesquisa. Não é aconselhamento financeiro.