Repolode
mnemox-ai

mnemox-ai/tradememory-protocol

Memoria local y freno previo a las órdenes para agentes de trading con IA: registra decisiones en una cadena de auditoría SHA-256 a prueba de manipulaciones y ofrece 20 herramientas MCP.

Estrellas
1,440
Forks
170
Issues abiertos
10
Último commit
hace 15 días

Esta página presenta un proyecto de código abierto y no constituye asesoramiento de inversión. Operar e invertir puede generar pérdidas: evalúa el riesgo por tu cuenta y cumple las leyes de tu país antes de usarlo.

¿Qué es?

TradeMemory Protocol proporciona a los agentes de trading con IA una memoria de su propio historial de operaciones. Sincroniza operaciones cerradas desde Hyperliquid y Alpaca (y desde MT5 o Binance spot mediante scripts) y señala en qué casos las operaciones anteriores generaron pérdidas, como las rachas de pérdidas relacionadas con posiciones demasiado grandes. Antes de abrir una nueva operación, un agente puede llamar a recall_memories para consultar primero las operaciones con pérdidas en condiciones similares. Todo se almacena en un archivo SQLite local.

Un complemento opcional de proxy se interpone entre un agente y el servidor MCP de Alpaca. Reenvía sin cambios las herramientas de solo lectura y evalúa las llamadas que colocan órdenes según una política definida por el usuario, que contempla listas de símbolos, límites de valor nominal y de posición, stops bracket y límites de pérdida diaria. Tanto las decisiones rechazadas como las aprobadas se registran en el log de auditoría. Las órdenes que superan un umbral de valor nominal establecido esperan una aprobación explícita, y el proxy reenvía cada orden aprobada como máximo una vez.

Cada registro de decisión se somete a un hash SHA-256 y se vincula al anterior; además, se generan raíces de Merkle diarias que pueden sellarse temporalmente mediante RFC 3161. El proyecto tiene licencia MIT, y su propia documentación indica que la muestra empírica es pequeña y que está destinado a la investigación y la educación, no a ofrecer asesoramiento financiero.

Funciones clave

  • 01Sincroniza operaciones cerradas desde Hyperliquid y Alpaca en una base de datos local
  • 02Antes de una nueva orden, prioriza las operaciones con pérdidas en condiciones similares
  • 03El proxy comprueba las llamadas MCP que colocan órdenes según una política definida por el usuario antes de que lleguen al bróker
  • 04Las decisiones rechazadas y aprobadas se registran en un log de auditoría encadenado mediante hashes
  • 05Raíces de Merkle diarias con sellado temporal RFC 3161 opcional
  • 06Ofrece 20 herramientas MCP y una API REST

Casos de uso

  • Revisar el historial de operaciones propio para descubrir qué condiciones o tamaños de posición precedieron a las pérdidas
  • Proporcionar a un agente conectado mediante MCP una comprobación previa a la operación basada en sus pérdidas anteriores
  • Interponer una capa de políticas entre un agente conectado a Alpaca y las órdenes de paper trading o reales
  • Mantener un registro de las decisiones del agente a prueba de manipulaciones, incluidas las decisiones de no operar

Inicio rápido

  1. 1

    Instala el paquete desde PyPI

    pip install tradememory-protocol
  2. 2

    Sincroniza tu historial de operaciones de Hyperliquid (ejecuciones públicas, no necesitas clave)

    tradememory sync hyperliquid --address 0xYourAddress
  3. 3

    Registra el servidor en Claude Code

    claude mcp add tradememory -- uvx tradememory-protocol

Antes de usarlo

  • El freno del bróker (extra proxy) es una versión preliminar y actualmente solo es compatible con Alpaca.
  • El extra proxy requiere Python 3.12 o posterior.
  • La API de Hyperliquid solo devuelve las ejecuciones recientes, por lo que el historial anterior se pierde si no sincronizas pronto.
  • La cadena de auditoría permite detectar manipulaciones, pero no impedirlas; los registros tampoco se firman con una clave privada.

En colecciones

Temas

Preguntas frecuentes

¿Qué es tradememory-protocol?
Memoria local y freno previo a las órdenes para agentes de trading con IA: registra decisiones en una cadena de auditoría SHA-256 a prueba de manipulaciones y ofrece 20 herramientas MCP. TradeMemory Protocol proporciona a los agentes de trading con IA una memoria de su propio historial de operaciones. Sincroniza operaciones cerradas desde Hyperliquid y Alpaca (y desde MT5 o Binance spot mediante scripts) y señala en qué casos las operaciones anteriores generaron pérdidas, como las rachas de pérdidas relacionadas con posiciones demasiado grandes. Antes de abrir una nueva operación, un agente puede llamar a recall_memories para consultar primero las operaciones con pérdidas en condiciones similares. Todo se almacena en un archivo SQLite local.
¿tradememory-protocol es gratuito? ¿Qué licencia tiene?
tradememory-protocol es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿tradememory-protocol sigue mantenido?
Mantenimiento activo. El último commit de tradememory-protocol fue el 23 oct 2026.
¿Para qué puedo usar tradememory-protocol?
Revisar el historial de operaciones propio para descubrir qué condiciones o tamaños de posición precedieron a las pérdidas Proporcionar a un agente conectado mediante MCP una comprobación previa a la operación basada en sus pérdidas anteriores Interponer una capa de políticas entre un agente conectado a Alpaca y las órdenes de paper trading o reales Mantener un registro de las decisiones del agente a prueba de manipulaciones, incluidas las decisiones de no operar
¿Cómo se instala tradememory-protocol?
Instala el paquete desde PyPI: pip install tradememory-protocol Sincroniza tu historial de operaciones de Hyperliquid (ejecuciones públicas, no necesitas clave): tradememory sync hyperliquid --address 0xYourAddress Registra el servidor en Claude Code: claude mcp add tradememory -- uvx tradememory-protocol
¿Dónde consigo tradememory-protocol?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/mnemox-ai/tradememory-protocol

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados