TradeMemory Protocol

프로젝트 상태 (2026년 8월): 기능 완료, 유지보수 모드 — 버그 및 보안 보고는 여전히 검토됨; 새로운 기능이나 호스팅 서비스는 계획 없음. 유료 작업은 Trading Record Analysis 참조.

당신의 트레이딩 AI는 기억상실증에 걸려 있습니다. 그리고 규제 기관들이 이를 주목하기 시작했습니다.

매 세션마다 같은 실수를 반복합니다. 왜 거래했는지 설명할 수 없습니다. 컨텍스트 창이 끝나면 모든 것을 잊어버립니다. 한편, MiFID II는 알고리즘 결정 문서화 기준을 높이고 있습니다 (Article 17). EU AI Act는 AI 행동의 체계적 로깅을 요구합니다 (Article 14). 경쟁사의 에이전트는 모든 거래에서 학습하고 있습니다.

AI 트레이딩 스택에 한 계층이 빠져 있습니다. 모든 MCP 서버는 실행을 처리합니다 — 주문 체결, 가격 조회, 차트 읽기. 어느 것도 메모리를 처리하지 않습니다.

당신의 에이전트는 AAPL 100주를 매수할 수 있지만, *"이 조건에서 AAPL을 마지막으로 매수했을 때 무슨 일이 있었지?"*라는 질문에는 답할 수 없습니다.

TradeMemory는 메모리 계층입니다. 하나의 pip install로, 당신의 AI 에이전트는 모든 거래, 모든 결과, 모든 실수를 기억합니다 — SHA-256 변조 방지 감사 추적과 함께.

독립 트레이더가 모든 포지션 전에 사전 점검 체크리스트로 사용하며, 실행된 신호뿐만 아니라 차단된 신호도 기록하는 MT5 계정에 대한 일차 당사자(first-party)로도 사용됩니다. 어느 것이 어느 것인지는 USE_CASES.md를 참조하세요.

기능

• 거래 전: 메모리에 물어보세요 — 이 시장 조건에서 마지막에 무슨 일이 있었나요? 어떻게 끝났나요?
• 거래 후: 한 번의 호출로 모든 것이 기록됩니다 — 5개의 메모리 계층이 자동으로 업데이트됩니다
• 안전 장치: 신뢰도 추적, 손실률 경고, 연패 감지 — 시스템이 언제 멈춰야 하는지 알려줍니다

모든 시장(주식, 외환, 암호화폐, 선물), 모든 브로커, 모든 AI 플랫폼에서 작동합니다. TradeMemory는 거래를 실행하거나 자금에 접근하지 않습니다 — 기록하고 회상만 합니다.

인터페이스 보기

tradememory-dashboard.onrender.com — 예시 데모 데이터로 실행되는 대시보드. 설치할 것이 없습니다.

인터페이스 미리보기이며 실적 기록이 아닙니다: 거래는 합성 데이터이며 모든 수치는 그렇게 표시됩니다. 메모리 계층이 터미널에서 실제로 하는 일을 보려면, pip install tradememory-protocol && tradememory demo --fast가 30건의 거래를 재생하고 그로부터 도출된 회상 및 매개변수 조정을 보여줍니다.

빠른 시작

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 (트레이더 트랙 + 개발자 트랙)

TradeMemory 사용자

작동 방식

1. 회상 — 거래 전, 결과 품질, 컨텍스트 유사성, 최신성, 신뢰도, 감정 상태에 따라 가중치가 적용된 과거 거래를 검색합니다 (OWM Framework)
2. 기록 — 거래 후, remember_trade에 대한 한 번의 호출로 5개의 메모리 계층에 기록합니다: 일화, 의미, 절차, 감정, 거래 기록
3. 반성 — 일일/주간/월간 검토로 행동 편향, 전략 쇠퇴, 거래 실수를 감지합니다
4. 감사 — 모든 결정은 생성 시 SHA-256 해시됩니다. 언제든지 검토 또는 규제 제출용으로 내보낼 수 있습니다

MCP 도구

Trading Record Analysis

TradeMemory 자체는 무료이며 자체 호스팅됩니다. 유지관리자가 유료 서비스로 제공하는 것은 귀하의 거래 기록에 대한 통계 분석입니다: MT4/MT5 기록을 내보내면 기술 통계 보고서를 받습니다 — 손실이 집중되는 위치, 손실 후 포지션 크기 변화, 강제 청산 구조, 거래당 실제 위험 — 이후 워크스루 통화가 이어집니다.

과거 거래의 기술 통계만 제공합니다: 거래 신호, 투자 조언, 성과 약속이 없습니다. 전달 후 파일은 삭제됩니다.

dev@mnemox.ai | 통화 예약

엔터프라이즈 및 컴플라이언스

에이전트가 내리는 모든 거래 결정 — 거래 하지 않기로 한 결정 포함 — 은 Trading Decision Record (TDR)로 기록됩니다. 레코드별 SHA-256 콘텐츠 해시는 전방 체인 감사 원장에 연결됩니다; 매 UTC 일은 일별 Merkle 루트로 요약되며, 이 루트는 다시 일별로 체인됩니다. 과거 기록을 변조하면 이후의 모든 링크가 무효화됩니다.

# 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

전체 감사 체인 성숙도 진술은 LIMITATIONS.md를 참조하세요. v0.5.2에 아직 없는 항목(TSA 타임스탬프, 외부 앵커링, zkML 추론 증명)을 포함합니다.

펀드를 위한 맞춤 배포가 필요하신가요? → dev@mnemox.ai

보안

• API 키에 절대 접근하지 않습니다. TradeMemory는 거래를 실행하거나, 자금을 이동하거나, 지갑에 접근하지 않습니다.
• 읽기 및 기록 전용. 에이전트가 결정 컨텍스트를 TradeMemory에 전달합니다. 저장합니다. 그게 전부입니다.
• 로컬 우선. 유일한 아웃바운드 호출은 일별 감사 루트의 RFC 3161 신뢰 타임스탬프입니다 — 32바이트 해시, 거래 데이터 없음 (기본 활성화; TRADEMEMORY_TSA=off로 비활성화). 다른 것은 기계를 떠나지 않습니다.
• SHA-256 체인 감사 원장. 모든 레코드는 생성 시 해시되고 이전 레코드에 연결됩니다. 일별 Merkle 루트가 체인을 앵커링합니다. 레코드, 슬라이스 또는 일 수준에서 무결성을 검증하세요. 변조는 모든 수준에서 감지 가능합니다; 외부 앵커링(기본 TSA)은 로드맵에 있습니다.
• 1,400개 이상의 테스트 통과. CI가 포함된 전체 테스트 스위트.

연구 상태

TradeMemory의 OWM 프레임워크는 인지 과학(Tulving 1972)과 강화 학습(Schaul et al. 2015)에 기반합니다. 현재 상태:

• OWM 5요인 점수: 구현됨, 테스트됨 (1,400개 이상의 테스트)
• 통계 검증: DSR, MBL 구현됨 (Bailey-de Prado 2014)
• 감사 추적: SHA-256 변조 방지 TDR
• 진화 엔진: 연구 단계 (전략 생성 작동, 최적화 중 통계 게이트 통과율)
• 하이브리드 회상: OWM 전용 모드 활성, 임베딩 구성 시 벡터 융합 사용 가능
• 경험적 검증: 진행 중 (n=14 거래, 통계적 유의성을 위해 n>=100 목표; n=14에서는 신뢰 구간이 너무 넓어 결론을 내릴 수 없음 — validation/final_verdict.md 참조)

문서

기여

Contributing Guide · Security Policy 참조

MIT — LICENSE 참조. 교육/연구 목적으로만 사용. 금융 조언이 아닙니다.