shuim/auto-stock

Fork 0

Files

shuim b147498c31 Initial commit

2025-11-14 11:05:31 +09:00

3.8 KiB

Raw Blame History

Auto Stock Trading System - 사용 가이드

기능 소개

1. 대시보드

실시간 포트폴리오 현황
총 자산 및 수익률 모니터링
보유 종목 상세 정보

2. 전략 룰 설정

자동 매매 규칙 생성/수정/삭제
규칙 활성화/비활성화
조건 및 액션 설정

3. 매매 로그

모든 거래 내역 조회
실행 상태 확인
거래 통계

4. MCP 상태 모니터

MCP 서버 연결 상태
사용 가능한 도구 목록
실시간 MCP 로그

트레이딩 규칙 생성 가이드

규칙 구조

{
  "name": "규칙 이름",
  "description": "규칙 설명",
  "rule_type": "BUY" | "SELL",
  "conditions": {
    // 실행 조건
  },
  "actions": {
    // 실행할 액션
  }
}

조건 예시

RSI 기반 매수

{
  "conditions": {
    "rsi_below": 30,
    "volume_above_average": 1.5
  }
}

손절매

{
  "conditions": {
    "loss_rate_below": -5
  }
}

익절

{
  "conditions": {
    "profit_rate_above": 15
  }
}

액션 예시

매수 액션

{
  "actions": {
    "order_type": "BUY",
    "quantity_percent": 10,
    "max_amount": 1000000
  }
}

매도 액션

{
  "actions": {
    "order_type": "SELL",
    "quantity_percent": 100
  }
}

Claude AI 분석 활용

1. 규칙 검증

시장 상황에 맞게 규칙이 적절한지 Claude AI가 분석합니다.

2. 시장 분석

기술적 지표와 뉴스를 종합하여 시장 트렌드를 분석합니다.

3. 리스크 평가

포트폴리오와 거래 계획을 분석하여 리스크를 평가합니다.

MCP 도구

get_market_data

시장 데이터를 조회합니다.

{
  "tool_name": "get_market_data",
  "parameters": {
    "stock_code": "005930",
    "period": "D"
  }
}

calculate_indicators

기술적 지표를 계산합니다.

{
  "tool_name": "calculate_indicators",
  "parameters": {
    "price_data": [...],
    "indicators": ["RSI", "MACD", "BB"]
  }
}

check_portfolio

현재 포트폴리오를 확인합니다.

{
  "tool_name": "check_portfolio",
  "parameters": {}
}

execute_order

주문을 실행합니다.

{
  "tool_name": "execute_order",
  "parameters": {
    "stock_code": "005930",
    "order_type": "BUY",
    "quantity": 10,
    "price": 71000
  }
}

모범 사례

1. 리스크 관리

한 종목에 총 자산의 10% 이상 투자하지 않기
손절매 규칙 반드시 설정
일일 최대 거래 횟수 제한

2. 규칙 우선순위

손절매: 최고 우선순위 (100)
익절: 높은 우선순위 (90)
일반 매매: 중간 우선순위 (10-50)

3. 백테스팅

새로운 규칙은 과거 데이터로 먼저 테스트하세요.

4. 모니터링

실시간 로그 확인
규칙 성과 정기 검토
MCP 서버 연결 상태 체크

주의사항

⚠️ 중요: 이 시스템은 자동 매매를 수행합니다.

실제 계좌로 사용하기 전에 충분히 테스트하세요
시장 상황을 항상 모니터링하세요
규칙을 신중하게 설정하세요
손실 위험을 항상 고려하세요

문제 해결

Q: 거래가 실행되지 않아요

규칙이 활성화되어 있는지 확인
조건이 충족되었는지 확인
계좌 잔액 확인
API 연결 상태 확인

Q: MCP 서버가 연결되지 않아요

MCP 서버가 실행 중인지 확인
Claude API 키가 올바른지 확인
네트워크 연결 확인

Q: 포트폴리오가 동기화되지 않아요

"포트폴리오 동기화" 버튼 클릭
API 키와 계좌번호 확인
한국투자증권 API 상태 확인

지원

문제가 발생하거나 도움이 필요하시면 GitHub Issues에 문의해주세요.

3.8 KiB Raw Blame History