암호화폐 포트폴리오 추적하기
개요
실시간 CoinGecko 가치 평가, 할당 분석, 손익(P&L) 추적 및 집중 위험 알림을 통해 암호화폐 보유 현황을 추적합니다.
사전 요구 사항
- Python 3.8+ 설치
- 의존성:
pip install requests - CoinGecko API 접근을 위한 인터넷 연결
- 보유 현황이 포함된 포트폴리오 JSON 파일 (
references/implementation.md파일에서 형식 확인)
지침
-
사용자 의도 파악 - 필요한 포트폴리오 보기 유형 결정:
- 빠른 확인: 총 가치 및 상위 보유 자산
- 보유 목록: 모든 포지션의 전체 내역
- 상세 분석: 할당, 손익, 위험 플래그
- 내보내기: 외부 도구용 JSON 또는 CSV
-
적절한 옵션으로 포트폴리오 추적기 실행:
# 빠른 포트폴리오 요약 python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json # 전체 보유 내역 python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings # 손익 및 할당을 포함한 상세 분석 python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed -
분석 도구 또는 세금 보고용 결과 내보내기:
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format json --output portfolio_export.json python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output portfolio.csv -
사용자에게 결과 제시:
- 총 포트폴리오 가치를 눈에 띄게 표시
- 24시간 및 7일 변동 사항 강조
- 할당 비율 설명
- 집중 위험(기본적으로 25% 초과 포지션) 플래그 표시
출력
총 가치, 24시간/7일 변동, 자산별 할당 및 임계값을 초과하는 포지션에 대한 집중 경고를 보여주는 요약:
==============================================================================
CRYPTO PORTFOLIO TRACKER 업데이트: 2026-01-14 15:30 # 2026 - 현재 연도 타임스탬프
==============================================================================
포트폴리오 요약: 내 포트폴리오
------------------------------------------------------------------------------
총 가치: $125,450.00 USD
24시간 변동: +$2,540.50 (+2.07%)
7일 변동: +$8,125.00 (+6.92%)
보유 자산 수: 8개
주요 보유 자산
------------------------------------------------------------------------------
코인 수량 가격 가치 할당 24시간 변동
BTC 0.500 $95,000.00 $47,500.00 37.9% +2.5%
ETH 10.000 $3,200.00 $32,000.00 25.5% +1.8%
SOL 100.000 $180.00 $18,000.00 14.4% +4.2%
경고: BTC (37.9%)가 25% 임계값을 초과합니다
==============================================================================
오류 처리
| 오류 | 원인 | 해결 방법 |
|---|---|---|
| 포트폴리오 파일을 찾을 수 없음 | 잘못된 경로 | 파일 경로가 존재하는지 확인 |
| 잘못된 JSON | 손상된 파일 | JSON 구문 확인 |
| 코인을 찾을 수 없음 | 알 수 없는 심볼 | 심볼 철자 확인, 표준 심볼 사용 |
| API 속도 제한 | 너무 많은 요청 | 대기 후 재시도, 캐싱 사용 |
포괄적인 오류 처리는 ${CLAUDE_SKILL_DIR}/references/errors.md를 참조하세요.
예시
빠른 확인부터 상세 분석 및 내보내기까지 포트폴리오 추적 워크플로:
# 기본 포트폴리오 확인
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio ~/crypto/holdings.json
# 할당 기준 정렬된 모든 보유 자산
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings --sort allocation
# 사용자 지정 15% 임계값으로 상세 분석
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed --threshold 15
# 세금 소프트웨어용 내보내기
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output tax_export.csv
리소스
${CLAUDE_SKILL_DIR}/references/implementation.md- 포트폴리오 파일 형식, CLI 옵션, 할당 임계값, JSON 형식${CLAUDE_SKILL_DIR}/references/errors.md- 포괄적인 오류 처리${CLAUDE_SKILL_DIR}/references/examples.md- 상세 사용 예시- CoinGecko API: https://www.coingecko.com/en/api
${CLAUDE_SKILL_DIR}/config/settings.yaml- 구성 옵션