Repolode
제출하기
mnemox-ai

mnemox-ai/tradememory-protocol

AI 트레이딩 에이전트를 위한 로컬 우선 메모리 및 주문 전 안전장치로, SHA-256 변조 감지 감사 체인에 결정을 기록하고 MCP 도구 20개를 제공합니다.

GitHub에서 보기웹사이트
스타
1,440
포크
170
열린 이슈
10
마지막 커밋
14일 전

이 페이지는 오픈소스 프로젝트 소개이며 투자 조언이 아닙니다. 거래와 투자는 손실이 발생할 수 있으니, 사용 전에 위험을 직접 판단하고 거주 지역의 법규를 따르세요.

어떤 프로젝트인가요?

TradeMemory Protocol은 AI 트레이딩 에이전트가 자신의 거래 이력을 기억하도록 합니다. Hyperliquid와 Alpaca의 종료된 거래를 동기화하고(MT5 또는 Binance 현물 거래는 스크립트로 가져올 수 있음), 과도한 포지션 규모와 연관된 연속 손실처럼 과거 거래에서 손실이 발생한 패턴을 알려 줍니다. 새 거래를 시작하기 전에 에이전트는 recall_memories를 호출해 비슷한 조건에서 발생한 손실 거래를 우선순위에 따라 확인할 수 있습니다. 모든 데이터는 로컬 SQLite 파일에 저장됩니다.

선택 사항인 proxy extra를 사용하면 에이전트와 Alpaca의 MCP 서버 사이에 프록시를 둘 수 있습니다. 읽기 전용 도구는 그대로 전달하고, 주문을 실행하는 호출은 종목 목록, 명목 금액 및 포지션 한도, 손절 주문, 일일 손실 한도를 포함하는 사용자 정의 정책에 따라 평가합니다. 거부된 결정과 허용된 결정 모두 감사 로그에 기록됩니다. 설정된 명목 금액 기준을 넘는 주문은 명시적인 승인을 기다리며, 프록시는 승인된 주문을 최대 한 번만 전달합니다.

각 결정 기록은 SHA-256으로 해시된 뒤 이전 기록과 연결되며, 매일 생성되는 Merkle root는 RFC 3161을 통해 타임스탬프를 찍을 수 있습니다. 이 프로젝트는 MIT 라이선스로 제공되며, 자체 문서에서도 실증 표본이 작고 금융 조언이 아닌 연구 및 교육용이라고 밝힙니다.

핵심 기능

  • 01Hyperliquid와 Alpaca의 종료된 거래를 로컬 데이터베이스로 동기화합니다
  • 02새 주문 전에 비슷한 조건에서 발생한 손실 거래를 우선적으로 보여 줍니다
  • 03주문 실행 MCP 호출이 브로커에 전달되기 전에 사용자 정의 정책에 따라 확인하는 프록시를 제공합니다
  • 04거부된 결정과 허용된 결정을 해시 체인 감사 로그에 기록합니다
  • 05선택적으로 RFC 3161 타임스탬프를 적용할 수 있는 일일 Merkle root를 생성합니다
  • 06MCP 도구 20개와 REST API를 제공합니다

활용 사례

  • 자신의 거래 이력을 검토해 손실 전에 어떤 조건이나 포지션 규모가 있었는지 파악하기
  • MCP에 연결된 에이전트가 과거 손실 거래를 바탕으로 주문 전 점검을 수행하도록 하기
  • Alpaca에 연결된 에이전트와 모의 또는 실거래 주문 사이에 정책 계층을 두기
  • 거래하지 않기로 한 결정을 포함해 에이전트의 결정을 변조 감지 가능한 방식으로 기록하기

빠른 시작

  1. 1

    PyPI에서 패키지를 설치합니다

    pip install tradememory-protocol
  2. 2

    Hyperliquid 거래 내역을 동기화합니다(공개 체결 내역만 사용하며 키가 필요하지 않습니다)

    tradememory sync hyperliquid --address 0xYourAddress
  3. 3

    Claude Code에 서버를 등록합니다

    claude mcp add tradememory -- uvx tradememory-protocol

사용 전 알아둘 점

  • 브로커 브레이크(proxy extra)는 미리 보기 단계이며 현재 Alpaca만 지원합니다.
  • proxy extra를 사용하려면 Python 3.12 이상이 필요합니다.
  • Hyperliquid API는 최근 체결 내역만 반환하므로 일찍 동기화하지 않으면 이전 내역이 사라집니다.
  • 감사 체인은 변조를 감지할 수 있지만 변조를 방지하지는 않으며, 레코드에 개인 키로 서명하지 않습니다.

포함된 컬렉션

AI 에이전트 장기 기억Claude Code용 MCP 서버Claude Code 도구·스킬·플러그인오픈소스 AI 에이전트 프레임워크와 앱MCP 서버

토픽

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

자주 묻는 질문

tradememory-protocol은(는) 무엇인가요?
AI 트레이딩 에이전트를 위한 로컬 우선 메모리 및 주문 전 안전장치로, SHA-256 변조 감지 감사 체인에 결정을 기록하고 MCP 도구 20개를 제공합니다. TradeMemory Protocol은 AI 트레이딩 에이전트가 자신의 거래 이력을 기억하도록 합니다. Hyperliquid와 Alpaca의 종료된 거래를 동기화하고(MT5 또는 Binance 현물 거래는 스크립트로 가져올 수 있음), 과도한 포지션 규모와 연관된 연속 손실처럼 과거 거래에서 손실이 발생한 패턴을 알려 줍니다. 새 거래를 시작하기 전에 에이전트는 recall_memories를 호출해 비슷한 조건에서 발생한 손실 거래를 우선순위에 따라 확인할 수 있습니다. 모든 데이터는 로컬 SQLite 파일에 저장됩니다.
tradememory-protocol은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
tradememory-protocol은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
tradememory-protocol은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. tradememory-protocol의 마지막 커밋은 2026년 10월 23일입니다.
tradememory-protocol은(는) 어디에 사용할 수 있나요?
자신의 거래 이력을 검토해 손실 전에 어떤 조건이나 포지션 규모가 있었는지 파악하기 MCP에 연결된 에이전트가 과거 손실 거래를 바탕으로 주문 전 점검을 수행하도록 하기 Alpaca에 연결된 에이전트와 모의 또는 실거래 주문 사이에 정책 계층을 두기 거래하지 않기로 한 결정을 포함해 에이전트의 결정을 변조 감지 가능한 방식으로 기록하기
tradememory-protocol는 어떻게 설치하나요?
PyPI에서 패키지를 설치합니다: pip install tradememory-protocol Hyperliquid 거래 내역을 동기화합니다(공개 체결 내역만 사용하며 키가 필요하지 않습니다): tradememory sync hyperliquid --address 0xYourAddress Claude Code에 서버를 등록합니다: claude mcp add tradememory -- uvx tradememory-protocol
tradememory-protocol은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/mnemox-ai/tradememory-protocol

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트

olaxbt / ai-market-maker

전문 AI 데스크가 시그널을 생성하고 Risk Guard가 거래를 거부할 수 있으며, 바이 앤 홀드와 비교하는 백테스트를 지원하는 오픈소스 멀티 에이전트 암호화폐 거래 시스템입니다.

AI·머신러닝#agentic-trading#crypto#multiagent-systems
2.1천302PythonAGPL-3.0업데이트 3개월 전