스냅샷

특정 시점의 포트폴리오 가치를 기록합니다. 스냅샷은 총 시가와 개별 포지션이 일별로 어떻게 변하는지 추적할 수 있게 합니다.

firma add snapshot

Finnhub에서 가격을 동기화한 뒤 모든 보유 종목의 현재 시가를 로컬 스냅샷 테이블에 기록합니다. 하루 한 번 (또는 필요할 때) 실행해 포트폴리오 가치 시계열을 만듭니다.

$firma add snapshot

→Syncing prices...

✓Snapshot recorded for 2026-04-26: 4 holdings.

Finnhub API 키가 필요합니다. firma config set finnhub-key <key>로 한 번 설정합니다. 스냅샷은 ~/.firma/firma.db에 저장되며, 같은 날 재실행이 아닌 한 동일 날짜는 덮어쓰지 않습니다.

firma show snapshot

티커 없이 실행: 일자별 총 시가를 ASCII 막대 차트로 표시하며 전일 대비 변화도 함께 보여줍니다. 기간을 좁히려면 --from과 --to를 사용합니다. 외화로 변환하려면 -c USD 등을 추가합니다.

$firma show snapshot

ATH  $168,042  2026-04-24  ·  -1.6% from ATH  ·  max drawdown  -10.2%

firma show snapshot <ticker>

티커와 함께 실행: 종목별 시계열을 표시. 각 스냅샷 날짜의 보유 수량, 가격, 시가, 미실현 손익. 표 아래에 드로다운 요약 한 줄이 나옵니다.

$firma show snapshot TSLA

DATE	SHARES	PRICE	MKT VALUE	UNREALIZED P&L

2026-04-24	392.0000	$350.40	$137,356.80	+$40,879.04
2026-04-25	392.0000	$347.18	$136,094.56	+$39,616.80
2026-04-26	392.0000	$344.97	$135,228.24	+$38,750.48

ATH  $137,356.80  2026-04-24  ·  -1.6% from ATH  ·  max drawdown  -1.6%

기간을 제한하려면 --from 2026-01-01 --to 2026-04-26을 사용합니다. 스크립트나 Claude에 머신 친화 출력을 주려면 --json을 추가합니다.

드로다운 라인 읽기

모든 firma show snapshot 출력은 데이터 아래에 한 줄 드로다운 요약을 추가합니다. 각 부분의 의미는 다음과 같습니다:

ATH전고점: 스냅샷 이력에서 기록된 최고 시가. 데이터 내 최댓값입니다.

-1.6% from ATH현재 ATH 대비 얼마나 낮은지 백분율로 표시. 0이면 (녹색 "at all-time high"로 표시) 오늘이 새 고점. 드로다운 중일 때 빨간색.

max drawdown전체 스냅샷 이력에서 발생한 가장 큰 peak-to-trough 하락. 회복 전까지의 최대 백분율 하락. -10%이면 어느 시점에 국지 고점에서 10% 하락 후 회복했음을 의미. 0%에 가까우면 큰 하락이 없었음.

드로다운은 기록된 스냅샷에서만 계산되며, 실시간 가격은 사용하지 않습니다. 연속된 시계열을 위해 firma add snapshot을 매일 (또는 cron으로) 실행합니다. 이력 갭이 있으면 그림이 거칠어집니다.

수정과 삭제

firma edit snapshot인터랙티브 피커: 날짜 → 티커 → 수정할 필드 선택

firma delete snapshot [date]특정 날짜의 모든 항목 삭제. 날짜 생략 시 프롬프트 표시

firma rm snapshot은 firma delete snapshot의 별칭입니다.

Claude와 함께

Claude Desktop · firma MCP 연결됨

사용자

지난 일주일 동안 포트폴리오 어떻게 움직였어?

Claude

포트폴리오는 7일간 $143,218 → $165,271로 상승, +$22,053 (+15.4%). 가장 좋은 날은 4/24 (+$28,322), 광범위한 시장 랠리. TSLA는 일주일간 +20.4%.