TradeMemory Protocol

TradeMemory помнит, чего это стоило. Это открытая, локально-ориентированная память и тормоз для ИИ-торговых агентов: она подтягивает ваши исполненные сделки, находит, где ваша собственная история теряет деньги, выводит эти убыточные сделки перед агентом до следующего ордера и может отказать в ордере, нарушающем установленные вами правила, прежде чем он дойдёт до брокера.

Брокеры теперь позволяют ИИ-агентам торговать через MCP с разными ограничениями: Webull и tastytrade устанавливают лимиты на размер или покупательную способность, Interactive Brokers позволяет агенту только составить ордер для вашей подачи, а Robinhood и Public не накладывают ограничений, которые вы могли бы задать внешнему агенту (StockBrokers, 2026-09-30). Лимиты — это фиксированные числа. Ни один из них не учитывает, как прошли ваши собственные прошлые сделки.

Начните с собственной истории

pip install tradememory-protocol

# Hyperliquid: public fills, no key needed
tradememory sync hyperliquid --address 0xYourAddress

# Alpaca: read-only calls with your own keys, kept in a local file
tradememory sync alpaca --env-file ~/.secrets/alpaca.env

Каждая закрытая сделка сохраняется в памяти один раз; повторный запуск сохраняет только новые сделки. Затем выводится, где ваша история теряет деньги. Формат с иллюстративными числами:

After 2 losses in a row (20 trades):
  5 of them (25%) were 1.5x your usual size or more.
  All 20 won 60% and made -$1,500.
  The 5 sized-up trades won 20% and made -$1,700.

Median hold: winners 1.5h, losers 9.0h.

Это описательные статистики ваших собственных прошлых сделок, а не совет по следующей. API Hyperliquid предоставляет только недавние исполнения адреса, а не всю его историю, поэтому чем раньше выполнена синхронизация, тем больше истории сохранится. Другие площадки: скрипты синхронизации MT5 и Binance spot находятся в scripts/, и любой агент может записать сделку с помощью remember_trade.

Перед следующим ордером

recall_memories(order="losses_first") ставит каждую убыточную сделку впереди остальных, сначала более крупные потери в похожих условиях, с их размером и P&L. Помимо самых последних сделок по символу, он ищет недавние убыточные сделки по символу, чтобы более старая потеря не была вытеснена. Сервер сообщает подключённым агентам вызывать его перед предложением сделки. Порядок по умолчанию ранжирует лучшие результаты выше (по R-множителю, где он был записан) и сохраняет как минимум 20% убытков в списке.

Подключите своего агента

pip install tradememory-protocol

Добавьте в Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "tradememory": {
      "command": "uvx",
      "args": ["tradememory-protocol"]
    }
  }
}

Затем скажите Claude: «Запиши мою длинную позицию по AAPL по $195 — превышение прибыли, институциональные покупки, высокая уверенность.»

# 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

Полное руководство: Getting Started (трек трейдера + трек разработчика)

Поставьте тормоз перед брокером (предварительная версия)

Дополнение proxy запускает TradeMemory между вашим агентом и MCP-сервером брокера (сегодня — Alpaca). Каждый инструмент передаётся без изменений, кроме тех, что размещают ордера, которые Mnemox Control оценивает по вашей политике до того, как они достигнут брокера. Каждая оценка — разрешённая или отклонённая — записывается и включается в цепочку журнала аудита. Разрешённый ордер возвращается с вашими убыточными сделками из похожих условий впереди, а tradememory sync alpaca позже заполняет, как завершилась каждая переданная сделка, в R, когда вход содержал стоп. Ваш существующий агент продолжает работать; меняется только одна строка его MCP-конфигурации.

pip install "tradememory-protocol[proxy]"   # Python 3.12+
tradememory proxy init --account-id <your Alpaca account id> --symbols AAPL,MSFT
tradememory proxy doctor --env-file ~/.secrets/alpaca-paper.env   # checks the live tool names and the account id
tradememory proxy config                                           # prints the MCP client entry that replaces the direct Alpaca one

Отклоняется по умолчанию: символы вне вашего списка, ордера выше ваших лимитов по номиналу и позициям, входы без брекет-стопа, любой новый ордер после вашего дневного лимита убытков или просадки, отмена защитного стопа открытой позиции, любой инструмент, не классифицированный тормозом, и всё, пока запущен tradememory proxy halt FULL_HALT. Никогда не блокируется: закрытие позиции. Ордера на уровне или выше approval_notional ожидают tradememory proxy approve <intent_id> --terms <fingerprint>, который одобряет ровно те условия, которые вы прочитали; агент повторяет попытку с тем же client_order_id и теми же условиями, и прокси передаёт его не более одного раза. evaluate_order возвращает то же решение без размещения чего-либо, для предварительных проверок и консультационных слоёв в других фреймворках. Всё, что тормоз не может оценить (мёртвый поток котировок, неизвестный актив, тип ордера, не покрытый политикой), отклоняется, а не пропускается.

Статус: протестировано сквозным образом против stateful-имитации MCP-сервера Alpaca (tests/proxy/) и запущено против реального бумажного счёта Alpaca 2026-10-01: три отказа (символ не в списке, вход без стопа, номинал сверх лимита), один разрешённый ордер с одной акцией с брекетом, достигший брокера, и одна повторная попытка с тем же client_order_id, на которую ответили из записи без второго ордера. Опционы, замена ордеров, стоп-лимитные и трейлинг-ордера отклоняются, а не оцениваются. Ваши ключи брокера идут только в процесс брокера, который запускает прокси; TradeMemory никогда их не хранит.

Пошаговое руководство с реальными выводами: docs/recipes/alpaca-brake.md.

Три способа использования

Как это работает

1. Recall (Вспомнить) — Перед торговлей извлеките прошлые сделки, взвешенные по качеству результата, схожести контекста, недавности, уверенности и эмоциональному состоянию (OWM Framework)
2. Record (Записать) — После торговли один вызов remember_trade записывает в пять слоёв памяти: эпизодический, семантический, процедурный, аффективный и записи сделок
3. Reflect (Рефлексия) — Ежедневные/еженедельные/ежемесячные обзоры выявляют поведенческий дрейф, деградацию стратегии и ошибки торговли
4. Audit (Аудит) — Каждое решение хэшируется SHA-256 при создании и связывается с предыдущим. Экспорт в любое время для проверки

MCP-инструменты

Получите помощь с подключением

Запускаете агента против брокера или хотите, чтобы ваша история была синхронизирована и прочитана? Откройте issue по интеграции тормоза или забронируйте 30 минут. Помощь с настройкой бесплатна, и люди, которые её используют, решают, что будет построено дальше.

Журнал аудита

Каждое торговое решение вашего агента — включая решения не торговать — записывается как запись торгового решения (TDR). Хэши содержимого SHA-256 для каждой записи связываются в прямую цепочку журнала аудита; каждый день UTC резюмируется корнем Меркла, который сам связывается между днями. Вмешательство в любую историческую запись делает недействительными все последующие ссылки.

Правила, требующие записей решений, обязывают инвестиционные фирмы, а не розничных пользователей. Согласно EU AI Act, обязательства по ведению журналов для высокорисковых систем из Приложения III были отложены до 2 декабря 2027 года, а надзорный брифинг ESMA от февраля 2026 года по алгоритмической торговле гласит, что ИИ-алгоритмическая торговля в настоящее время исключена из высокорискового охвата. Таблица показывает, какие функции TradeMemory соответствуют этим текстам, если и когда они к вам применяются. Это не заявление о соответствии.

# 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
GET /audit/export?strategy=VolBreakout&start=2026-03-01&format=jsonl

Ежедневные корни по умолчанию заверяются временной меткой органа RFC 3161 с версии 0.5.3. Не реализовано: подпись записей закрытым ключом, привязка к публичному журналу, доказательство отсутствия пропусков. См. LIMITATIONS.md.

Безопасность

• Сервер памяти (по умолчанию). Никогда не размещает ордера и не запрашивает ключи брокера. Только запись и извлечение, в локальном файле SQLite.
• Синхронизация. tradememory sync hyperliquid читает публичные данные без ключа. tradememory sync alpaca выполняет вызовы только для чтения с ключами из файла на вашей машине. Синхронизированные сделки остаются в вашей локальной базе данных.
• Тормоз (дополнение proxy). Передаёт ордера, разрешённые вашей политикой, на MCP-сервер брокера. Ваши ключи брокера передаются только процессу брокера, который запускает прокси; TradeMemory никогда их не хранит.
• Исходящие вызовы. RFC 3161 заверение временных меток ежедневных корней аудита, 32-байтовый хэш без данных о сделках (включено по умолчанию; TRADEMEMORY_TSA=off отключает). tradememory sync вызывает указанную вами площадку. Инструменты эволюции читают публичные рыночные данные Binance (api.binance.com), когда агент их вызывает, а эволюция вызывает API Anthropic только если вы установите ANTHROPIC_API_KEY. Replay по умолчанию вызывает DeepSeek (или Anthropic) и только с ключом этого провайдера. Если вы установите sentence-transformers для гибридного извлечения, он загружает свою модель с Hugging Face при первом использовании. Скрипты синхронизации MT5 и Binance в scripts/ читают свои учётные данные из вашего окружения, а скрипт MT5 публикует сводки сделок (символ, цены, P&L) в вебхук Discord только если вы установите DISCORD_WEBHOOK_URL.
• Защита от вмешательства, а не от взлома. Каждая запись хэшируется и связывается с предыдущей, с ежедневными корнями Меркла. Изменение записи разрывает цепочку; тот, кто может переписать всю базу данных, может перестроить её.

Статус исследований

Фреймворк OWM TradeMemory основан на когнитивной науке (Tulving 1972) и обучении с подкреплением (Schaul et al. 2015). Текущий статус:

• OWM пятифакторное скоринг: реализовано и протестировано (см. бейдж CI)
• Статистическая валидация: DSR, MBL реализованы (Bailey-de Prado 2014)
• Журнал аудита: SHA-256 защищённый от вмешательства TDR
• Движок эволюции: фаза исследований (генерация стратегий работает, статистический гейт проходит при оптимизации)
• Гибридное извлечение: активен режим только OWM, векторное слияние доступно при настройке эмбеддингов
• Эмпирическая валидация: продолжается (n=14 сделок, целевое n>=100 для статистической значимости; при n=14 доверительные интервалы слишком широки для выводов — см. validation/final_verdict.md)

Документация

Участие

См. Руководство по участию · Политика безопасности

MIT, см. ЛИЦЕНЗИЯ. Дополнительная установка proxy включает Mnemox Control, чей движок распространяется только под лицензией AGPL-3.0 (доступна коммерческая лицензия); сам TradeMemory остаётся под лицензией MIT. Только для образовательных и исследовательских целей. Не является финансовой рекомендацией.