벤치마크

같은 기간 동안 포트폴리오 수익률을 SPY, QQQ 또는 사용자 지정 인덱스와 비교합니다. 결국 보고 싶은 건 하나입니다. 시장을 이기고 있는지, 아니면 그냥 따라가고 있는지입니다.

각 벤치마크의 일별 캔들을 Finnhub에서 가져와, 포트폴리오와 동일한 기간에 대한 총 수익률을 비교합니다. 일별 스냅샷이 있으면 가장 이른 스냅샷을 시작일로 사용하고, 없으면 가장 이른 거래 날짜를 기준으로 cost-basis 비교 모드로 전환됩니다.
$firma show benchmark
Benchmark Comparison  2024-01-02 → 2026-04-27  (846d)
Portfolio+61.23%$100,000 → $161,230(snapshot)
SPY+28.41%$450.00 → $578.00
QQQ+35.10%$380.00 → $513.80
Alpha vs SPY+32.82%
Alpha vs QQQ+26.13%
Finnhub API 키가 필요합니다. 무료 플랜은 일별 캔들을 최대 1년까지 제공합니다. 그보다 긴 기간을 비교하면 응답에 경고가 붙고 벤치마크 기간이 잘립니다.
--from YYYY-MM-DD시작일 (기본: 가장 이른 스냅샷 또는 거래)
--to YYYY-MM-DD종료일 (기본: 오늘)
-b, --benchmarks쉼표로 구분한 티커 목록 (기본: SPY,QQQ; IWM, DIA, VOO 등도 가능)
--json스크립트용 JSON 출력
snap
일별 스냅샷이 있을 때 (권장)
일별 포트폴리오 합계를 사용해 벤치마크의 일별 종가와 같은 기준으로 비교합니다. 스냅샷이 많을수록 결과도 더 믿을 만합니다.
cost
스냅샷이 없을 때 (폴백)
총 cost basis와 현재 시가를 비교하고, 출력에 그 한계도 함께 표시합니다. 자본이 서로 다른 날짜에 들어간 점은 반영하지 못하므로 방향성 정도로만 봐야 합니다. 정확도를 높이려면 firma add snapshot을 꾸준히 기록하세요.
MIT License