openclaw-backups/skills/openclaw-self-healing/docs/realtime-api-setup.md

실시간 TQQQ/QQQ 모니터링 설정 가이드

🚀 빠른 시작 (5분)

1. Finnhub API 키 발급

1. 브라우저에서 열기: https://finnhub.io/register
2. 이메일로 가입 (무료)
3. Dashboard → API Keys 섹션
4. API Key 복사

2. 환경변수 설정

macOS/Linux:

export FINNHUB_API_KEY="your_api_key_here"

영구 설정 (재부팅 후에도 유지):

echo 'export FINNHUB_API_KEY="your_api_key_here"' >> ~/.zshrc
source ~/.zshrc

3. 실시간 모니터 실행

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차 목표 (전량 매도)

⚙️ 설정 커스터마이징

스크립트 내 변수 수정:

// 손절선 퍼센트
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 환경변수가 설정되지 않았습니다"

# 환경변수 확인
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)

# 터미널 1: 실시간 모니터
node ~/openclaw/scripts/realtime-tqqq-monitor.js

# 터미널 2: OpenClaw (자비스와 소통)
# Discord에서 실시간 가격 공유 불필요 - 자동 모니터링!

진입/손절 자동 알림

스크립트가 자동으로:

1. 가격 변동 실시간 출력
2. 손절선 근접 경고
3. 목표가 도달 알림

정우님은 알림만 보고 토스증권에서 실행!

🔄 백그라운드 실행 (선택)

# 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초 (실시간)