clawdfolio은(는) 무엇을 하나요?
전문 투자자를 위한 정량 포트폴리오 툴킷. 멀티 브로커 통합 (Longport, Moomoo/Futu, 데모), 기관 수준 위험 분석, 옵션 전략 라이프사이클 관리, 20개 이상의 자동화된 금융 워크플로우, CSV/JSON 데이터 내보내기를 제공합니다.
PyPI: pip install clawdfolio · 저장소: https://github.com/YichengYang-Ethan/clawdfolio · Python >= 3.10 (3.10–3.13 테스트 완료)
전체 Python API 참조는 API.md를, 구성, 환경 변수, 브로커 설정 및 모니터 상세 정보는 CONFIG.md를 참조하세요.
CLI 명령어
모든 명령어는 --broker {longport,futu,demo,all}, --output {console,json}, --config PATH 옵션을 지원합니다.
포트폴리오
clawdfolio summary # 포트폴리오 개요 (기본 명령어)
clawdfolio summary --top 20 # 상위 20개 보유 종목 표시
clawdfolio quotes AAPL MSFT # 실시간 시세
clawdfolio alerts # 가격/RSI/PnL/집중도 알림
clawdfolio alerts --severity critical
위험 분석
clawdfolio risk # 변동성, 베타, 샤프, 소르티노, VaR, CVaR, 낙폭
clawdfolio risk --detailed # + RSI 극단값, 집중도, 섹터 익스포저, 포트폴리오 RSI
계산되는 위험 지표:
- 변동성: 20일, 60일, 연환산
- 베타: SPY 대비, QQQ 대비
- 샤프 비율: 연환산, 초과 수익 / 총 변동성
- 소르티노 비율: 연환산, 초과 수익 / 하방 변동성만
- VaR: 95% 및 99% (역사적), 절대값 및 백분율
- CVaR / 기대 부족액: 95% 및 99% — VaR를 초과하는 꼬리 위험
- 최대 낙폭: 역사적 및 현재
- HHI: 허핀달-허쉬만 집중도 지수
- RSI: 포트폴리오 수준 14일 RSI
- 상관관계: 고상관 쌍 감지 (>= 0.8)
실적
clawdfolio earnings # 다가오는 실적 발표 (기본 14일)
clawdfolio earnings --days 30 # 30일 조회
DCA (달러 원가 평균법)
clawdfolio dca # 포트폴리오용 DCA 신호 (리밸런싱 + 하락 감지)
clawdfolio dca AAPL --months 12 --amount 1000 # 과거 DCA 백테스트
신호 유형: REGULAR (예정된), DIP (최고가 대비 가격 하락), REBALANCE (목표 대비 비중 이탈)
내보내기
clawdfolio export portfolio # CSV를 stdout으로
clawdfolio export portfolio --format json # JSON을 stdout으로
clawdfolio export risk --file risk.csv # 위험 지표를 파일로
clawdfolio export alerts --format json --file alerts.json
내보내기 대상: portfolio, risk, alerts. 형식: csv, json.
옵션
clawdfolio options expiries TQQQ
clawdfolio options chain TQQQ --expiry 2026-03-21 --side calls --limit 10
clawdfolio options quote TQQQ --expiry 2026-03-21 --strike 80 --type C
clawdfolio options buyback # 설정에서 바이백 트리거 확인
clawdfolio options buyback --strict # 트리거된 대상이 없으면 종료 코드 1
금융 워크플로우
7개 카테고리에 걸친 20개의 번들 워크플로우. 검증된 설정 순서:
- 브로커 연결 확인:
clawdfolio summary --broker demo(10개의 데모 포지션을 표시해야 함) - 작업 공간 초기화:
clawdfolio finance init후ls ~/.clawdfolio/finance로 확인 - 사용 가능한 워크플로우 목록:
clawdfolio finance list - 워크플로우 실행:
clawdfolio finance run portfolio_daily_brief_tg - 출력 확인:
--output json을 추가하여 기계 판독 가능한 결과 확인; 오류 발생 시--broker demo로 재시도하여 브로커 문제와 워크플로우 문제를 분리
clawdfolio finance list --category alerts_monitors # 카테고리별 필터
clawdfolio finance run dca_proposal_tg -- --budget 5000 # 추가 인수 전달
카테고리: portfolio_reports, briefing_cards, alerts_monitors, market_intel, broker_snapshots, strategy, security.
주요 워크플로우:
| ID | 설명 |
|---|---|
portfolio_report | 성과, 위험, 보유 종목이 포함된 일일 포트폴리오 보고서 |
portfolio_daily_brief_tg | 텔레그램 친화적인 일일 브리핑 카드 |
portfolio_alert_monitor | 중복 제거된 RSI/PnL/집중도/이동 알림 |
option_buyback_monitor | 상태 저장 옵션 바이백 트리거 모니터 |
earnings_calendar | 현재 보유 종목의 다가오는 실적 발표 |
dca_proposal_tg | 예산 제약이 있는 DCA 제안 카드 |
account_report | Longport + moomoo 결합 스냅샷 |
작업 공간: ~/.clawdfolio/finance (--workspace로 설정 가능)
설치
pip install clawdfolio # 핵심 (yfinance + 데모 브로커)
pip install clawdfolio[longport] # + Longport 브로커
pip install clawdfolio[futu] # + Moomoo/Futu 브로커
pip install clawdfolio[all] # 모든 브로커
pip install clawdfolio[dev] # + pytest, mypy, ruff (개발)
Python API
프로그래밍 방식 사용을 위한 주요 imports:
from clawdfolio import Symbol, Position, Quote, Portfolio, RiskMetrics, Alert
from clawdfolio.brokers import get_broker
from clawdfolio.analysis.risk import analyze_risk
from clawdfolio.analysis.technical import calculate_rsi, calculate_macd
from clawdfolio.market import get_price, get_history, is_market_open
from clawdfolio.strategies.dca import DCAStrategy, calculate_dca_performance
from clawdfolio.output import export_portfolio_csv, export_risk_json
전체 API 참조와 사용 예제는 API.md를 참조하세요.
구성
검색 순서: --config 플래그 > CLAWDFOLIO_CONFIG 환경 변수 > ./config.yaml > ~/.config/clawdfolio/config.yaml. YAML 및 JSON을 지원합니다.
지원되는 브로커: Longport (환경 변수), Moomoo/Futu (로컬 OpenD), 데모 (내장), 집계기 (멀티 브로커 병합).
전체 구성 참조, 환경 변수, 브로커 설정 및 모니터 상세 정보는 CONFIG.md를 참조하세요.