Repolode
Enviar
mnemox-ai

mnemox-ai/tradememory-protocol

Memória local-first e freio pré-ordem para agentes de trading com IA, que registra decisões em uma cadeia de auditoria SHA-256 à prova de adulteração e oferece 20 ferramentas MCP.

Ver no GitHubSite
Estrelas
1,440
Forks
170
Issues abertas
10
Último commit
há 14 dias

Esta página apresenta um projeto de código aberto e não constitui aconselhamento de investimento. Negociar e investir pode gerar perdas: avalie o risco por conta própria e siga as leis do seu país antes de usá-lo.

O que é?

O TradeMemory Protocol dá aos agentes de trading com IA uma memória do próprio histórico de operações. Ele sincroniza operações encerradas da Hyperliquid e da Alpaca (e do MT5 ou da Binance spot por meio de scripts) e aponta situações em que operações anteriores deram prejuízo, como sequências de perdas associadas a posições grandes demais. Antes de uma nova operação, um agente pode chamar recall_memories para ver primeiro as operações perdedoras em condições semelhantes. Tudo fica armazenado em um arquivo SQLite local.

Um extra opcional de proxy fica entre um agente e o servidor MCP da Alpaca. Ele encaminha ferramentas somente de leitura sem alterações e avalia chamadas que enviam ordens de acordo com uma política definida pelo usuário, que abrange listas de símbolos, limites de valor nocional e de posição, stops bracket e limites de perda diária. Decisões recusadas e permitidas são registradas no log de auditoria. Ordens acima de um limite de valor nocional definido aguardam aprovação explícita, e o proxy encaminha cada ordem aprovada no máximo uma vez.

Cada registro de decisão recebe um hash SHA-256 e é vinculado ao anterior, com raízes Merkle diárias que podem receber timestamp via RFC 3161. O projeto usa a licença MIT, e sua própria documentação informa que a amostra empírica é pequena e que o projeto se destina a pesquisa e educação, não a aconselhamento financeiro.

Recursos principais

  • 01Sincroniza operações encerradas da Hyperliquid e da Alpaca para um banco de dados local
  • 02Antes de uma nova ordem, a busca mostra primeiro operações perdedoras em condições semelhantes
  • 03O proxy verifica chamadas MCP que enviam ordens de acordo com uma política definida pelo usuário antes de elas chegarem à corretora
  • 04Decisões recusadas e permitidas são registradas em um log de auditoria encadeado por hashes
  • 05Raízes Merkle diárias com opção de timestamp RFC 3161
  • 06Oferece 20 ferramentas MCP e uma REST API

Casos de uso

  • Analisar seu próprio histórico de operações para descobrir quais condições ou tamanhos de posição antecederam perdas
  • Permitir que um agente conectado via MCP confira, antes de operar, suas operações perdedoras anteriores
  • Inserir uma camada de políticas entre um agente conectado à Alpaca e ordens em conta de simulação ou real
  • Manter um registro à prova de adulteração das decisões do agente, inclusive das decisões de não operar

Início rápido

  1. 1

    Instale o pacote do PyPI

    pip install tradememory-protocol
  2. 2

    Sincronize seu histórico de negociações da Hyperliquid (execuções públicas; não é necessária uma chave)

    tradememory sync hyperliquid --address 0xYourAddress
  3. 3

    Registre o servidor no Claude Code

    claude mcp add tradememory -- uvx tradememory-protocol

Antes de usar

  • O freio da corretora (extra proxy) está em prévia e, atualmente, oferece suporte apenas à Alpaca.
  • O extra proxy requer Python 3.12 ou superior.
  • A API da Hyperliquid retorna apenas execuções recentes; portanto, o histórico mais antigo é perdido se você não sincronizar logo.
  • A cadeia de auditoria permite detectar adulterações, mas não impedi-las, e os registros não são assinados com uma chave privada.

Em coleções

Memória de longo prazo para agentes de IAServidores MCP para Claude CodeFerramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceServidores MCP

Tópicos

#ai-agents#trading#mcp#audit-trail#memory#agentic-trading#python#claude#compliance#crypto

Perguntas frequentes

O que é tradememory-protocol?
Memória local-first e freio pré-ordem para agentes de trading com IA, que registra decisões em uma cadeia de auditoria SHA-256 à prova de adulteração e oferece 20 ferramentas MCP. O TradeMemory Protocol dá aos agentes de trading com IA uma memória do próprio histórico de operações. Ele sincroniza operações encerradas da Hyperliquid e da Alpaca (e do MT5 ou da Binance spot por meio de scripts) e aponta situações em que operações anteriores deram prejuízo, como sequências de perdas associadas a posições grandes demais. Antes de uma nova operação, um agente pode chamar recall_memories para ver primeiro as operações perdedoras em condições semelhantes. Tudo fica armazenado em um arquivo SQLite local.
tradememory-protocol é gratuito? Qual é a licença?
tradememory-protocol é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
tradememory-protocol ainda é mantido?
Manutenção ativa. O último commit de tradememory-protocol foi em 23 de out. de 2026.
Para que posso usar tradememory-protocol?
Analisar seu próprio histórico de operações para descobrir quais condições ou tamanhos de posição antecederam perdas Permitir que um agente conectado via MCP confira, antes de operar, suas operações perdedoras anteriores Inserir uma camada de políticas entre um agente conectado à Alpaca e ordens em conta de simulação ou real Manter um registro à prova de adulteração das decisões do agente, inclusive das decisões de não operar
Como instalar tradememory-protocol?
Instale o pacote do PyPI: pip install tradememory-protocol Sincronize seu histórico de negociações da Hyperliquid (execuções públicas; não é necessária uma chave): tradememory sync hyperliquid --address 0xYourAddress Registre o servidor no Claude Code: claude mcp add tradememory -- uvx tradememory-protocol
Onde consigo tradememory-protocol?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mnemox-ai/tradememory-protocol

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados