212 lines
3.8 KiB
Markdown
212 lines
3.8 KiB
Markdown
# Auto Stock Trading System - 사용 가이드
|
|
|
|
## 기능 소개
|
|
|
|
### 1. 대시보드
|
|
- 실시간 포트폴리오 현황
|
|
- 총 자산 및 수익률 모니터링
|
|
- 보유 종목 상세 정보
|
|
|
|
### 2. 전략 룰 설정
|
|
- 자동 매매 규칙 생성/수정/삭제
|
|
- 규칙 활성화/비활성화
|
|
- 조건 및 액션 설정
|
|
|
|
### 3. 매매 로그
|
|
- 모든 거래 내역 조회
|
|
- 실행 상태 확인
|
|
- 거래 통계
|
|
|
|
### 4. MCP 상태 모니터
|
|
- MCP 서버 연결 상태
|
|
- 사용 가능한 도구 목록
|
|
- 실시간 MCP 로그
|
|
|
|
## 트레이딩 규칙 생성 가이드
|
|
|
|
### 규칙 구조
|
|
|
|
```json
|
|
{
|
|
"name": "규칙 이름",
|
|
"description": "규칙 설명",
|
|
"rule_type": "BUY" | "SELL",
|
|
"conditions": {
|
|
// 실행 조건
|
|
},
|
|
"actions": {
|
|
// 실행할 액션
|
|
}
|
|
}
|
|
```
|
|
|
|
### 조건 예시
|
|
|
|
#### RSI 기반 매수
|
|
```json
|
|
{
|
|
"conditions": {
|
|
"rsi_below": 30,
|
|
"volume_above_average": 1.5
|
|
}
|
|
}
|
|
```
|
|
|
|
#### 손절매
|
|
```json
|
|
{
|
|
"conditions": {
|
|
"loss_rate_below": -5
|
|
}
|
|
}
|
|
```
|
|
|
|
#### 익절
|
|
```json
|
|
{
|
|
"conditions": {
|
|
"profit_rate_above": 15
|
|
}
|
|
}
|
|
```
|
|
|
|
### 액션 예시
|
|
|
|
#### 매수 액션
|
|
```json
|
|
{
|
|
"actions": {
|
|
"order_type": "BUY",
|
|
"quantity_percent": 10,
|
|
"max_amount": 1000000
|
|
}
|
|
}
|
|
```
|
|
|
|
#### 매도 액션
|
|
```json
|
|
{
|
|
"actions": {
|
|
"order_type": "SELL",
|
|
"quantity_percent": 100
|
|
}
|
|
}
|
|
```
|
|
|
|
## Claude AI 분석 활용
|
|
|
|
### 1. 규칙 검증
|
|
시장 상황에 맞게 규칙이 적절한지 Claude AI가 분석합니다.
|
|
|
|
### 2. 시장 분석
|
|
기술적 지표와 뉴스를 종합하여 시장 트렌드를 분석합니다.
|
|
|
|
### 3. 리스크 평가
|
|
포트폴리오와 거래 계획을 분석하여 리스크를 평가합니다.
|
|
|
|
## MCP 도구
|
|
|
|
### get_market_data
|
|
시장 데이터를 조회합니다.
|
|
|
|
```json
|
|
{
|
|
"tool_name": "get_market_data",
|
|
"parameters": {
|
|
"stock_code": "005930",
|
|
"period": "D"
|
|
}
|
|
}
|
|
```
|
|
|
|
### calculate_indicators
|
|
기술적 지표를 계산합니다.
|
|
|
|
```json
|
|
{
|
|
"tool_name": "calculate_indicators",
|
|
"parameters": {
|
|
"price_data": [...],
|
|
"indicators": ["RSI", "MACD", "BB"]
|
|
}
|
|
}
|
|
```
|
|
|
|
### check_portfolio
|
|
현재 포트폴리오를 확인합니다.
|
|
|
|
```json
|
|
{
|
|
"tool_name": "check_portfolio",
|
|
"parameters": {}
|
|
}
|
|
```
|
|
|
|
### execute_order
|
|
주문을 실행합니다.
|
|
|
|
```json
|
|
{
|
|
"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: 거래가 실행되지 않아요
|
|
A:
|
|
1. 규칙이 활성화되어 있는지 확인
|
|
2. 조건이 충족되었는지 확인
|
|
3. 계좌 잔액 확인
|
|
4. API 연결 상태 확인
|
|
|
|
### Q: MCP 서버가 연결되지 않아요
|
|
A:
|
|
1. MCP 서버가 실행 중인지 확인
|
|
2. Claude API 키가 올바른지 확인
|
|
3. 네트워크 연결 확인
|
|
|
|
### Q: 포트폴리오가 동기화되지 않아요
|
|
A:
|
|
1. "포트폴리오 동기화" 버튼 클릭
|
|
2. API 키와 계좌번호 확인
|
|
3. 한국투자증권 API 상태 확인
|
|
|
|
## 지원
|
|
|
|
문제가 발생하거나 도움이 필요하시면 GitHub Issues에 문의해주세요.
|