155 lines
3.3 KiB
Markdown
155 lines
3.3 KiB
Markdown
# 실시간 TQQQ/QQQ 모니터링 설정 가이드
|
|
|
|
## 🚀 빠른 시작 (5분)
|
|
|
|
### 1. Finnhub API 키 발급
|
|
|
|
1. 브라우저에서 열기: https://finnhub.io/register
|
|
2. 이메일로 가입 (무료)
|
|
3. Dashboard → API Keys 섹션
|
|
4. API Key 복사
|
|
|
|
### 2. 환경변수 설정
|
|
|
|
**macOS/Linux:**
|
|
```bash
|
|
export FINNHUB_API_KEY="your_api_key_here"
|
|
```
|
|
|
|
**영구 설정 (재부팅 후에도 유지):**
|
|
```bash
|
|
echo 'export FINNHUB_API_KEY="your_api_key_here"' >> ~/.zshrc
|
|
source ~/.zshrc
|
|
```
|
|
|
|
### 3. 실시간 모니터 실행
|
|
|
|
```bash
|
|
node ~/openclaw/scripts/realtime-tqqq-monitor.js
|
|
```
|
|
|
|
## 📊 출력 예시
|
|
|
|
```
|
|
✅ Finnhub WebSocket 연결 성공!
|
|
📊 실시간 모니터링 시작...
|
|
|
|
📈 TQQQ: $46.50 | 변동: +0.87% | 거래량: 125,432 | 07:30:15
|
|
📉 QQQ: $591.20 | 변동: -0.15% | 거래량: 85,234 | 07:30:16
|
|
📈 TQQQ: $46.55 | 변동: +0.11% | 거래량: 98,765 | 07:30:18
|
|
|
|
⚠️ 경고: 손절선 2% 근접 ($46.55 vs $41.40)
|
|
```
|
|
|
|
## 🚨 자동 알림
|
|
|
|
스크립트는 자동으로 다음을 체크합니다:
|
|
|
|
### 손절선 알림
|
|
- **-10% 도달 시**: 🚨 긴급 알림
|
|
- **-8% 근접 시**: ⚠️ 경고
|
|
|
|
### 목표가 알림
|
|
- **$50 도달**: 🎯 1차 목표 (30% 매도)
|
|
- **$54 도달**: 🎯 2차 목표 (50% 매도)
|
|
- **$58 도달**: 🎯 3차 목표 (전량 매도)
|
|
|
|
## ⚙️ 설정 커스터마이징
|
|
|
|
스크립트 내 변수 수정:
|
|
|
|
```javascript
|
|
// 손절선 퍼센트
|
|
const STOP_LOSS_PERCENT = -10; // -10%
|
|
|
|
// 평단가
|
|
const avgPrice = 46; // 실제 매수가로 수정
|
|
|
|
// 목표가
|
|
const targets = [
|
|
{ price: 50, name: '1차 목표', action: '30% 매도' },
|
|
{ price: 54, name: '2차 목표', action: '50% 매도' },
|
|
{ price: 58, name: '3차 목표', action: '전량 매도' },
|
|
];
|
|
```
|
|
|
|
## 🔧 트러블슈팅
|
|
|
|
### "FINNHUB_API_KEY 환경변수가 설정되지 않았습니다"
|
|
|
|
```bash
|
|
# 환경변수 확인
|
|
echo $FINNHUB_API_KEY
|
|
|
|
# 다시 설정
|
|
export FINNHUB_API_KEY="your_key"
|
|
```
|
|
|
|
### "WebSocket Error: Unauthorized"
|
|
|
|
- API 키가 올바른지 확인
|
|
- https://finnhub.io/dashboard 에서 키 재확인
|
|
|
|
### "연결이 자주 끊김"
|
|
|
|
- 무료 티어: 60 requests/분 제한
|
|
- 연결 재시도 자동 처리됨
|
|
|
|
## 📝 유료 업그레이드 (선택)
|
|
|
|
**무료 티어 충분하지만, 필요 시:**
|
|
|
|
- **Starter Plan**: $59/월
|
|
- 300 requests/분
|
|
- 더 빠른 속도
|
|
- 우선 지원
|
|
|
|
https://finnhub.io/pricing
|
|
|
|
## 🎯 실전 사용 예시
|
|
|
|
### 고용지표 발표 (08:30)
|
|
|
|
```bash
|
|
# 터미널 1: 실시간 모니터
|
|
node ~/openclaw/scripts/realtime-tqqq-monitor.js
|
|
|
|
# 터미널 2: OpenClaw (자비스와 소통)
|
|
# Discord에서 실시간 가격 공유 불필요 - 자동 모니터링!
|
|
```
|
|
|
|
### 진입/손절 자동 알림
|
|
|
|
스크립트가 자동으로:
|
|
1. 가격 변동 실시간 출력
|
|
2. 손절선 근접 경고
|
|
3. 목표가 도달 알림
|
|
|
|
정우님은 알림만 보고 토스증권에서 실행!
|
|
|
|
## 🔄 백그라운드 실행 (선택)
|
|
|
|
```bash
|
|
# tmux 세션으로 백그라운드 실행
|
|
tmux new -s tqqq-monitor
|
|
node ~/openclaw/scripts/realtime-tqqq-monitor.js
|
|
|
|
# Detach: Ctrl+B, D
|
|
# Re-attach: tmux attach -t tqqq-monitor
|
|
```
|
|
|
|
## ✅ 체크리스트
|
|
|
|
- [ ] Finnhub 가입 완료
|
|
- [ ] API 키 발급
|
|
- [ ] 환경변수 설정
|
|
- [ ] 스크립트 실행 테스트
|
|
- [ ] 실시간 데이터 수신 확인
|
|
- [ ] 알림 동작 확인
|
|
|
|
---
|
|
|
|
**설정 완료 시간: 약 5분**
|
|
**비용: 무료 (60 requests/분)**
|
|
**지연 시간: < 1초 (실시간)**
|