지갑 포트폴리오 분석
목표: EVM 지갑의 간결한 자산 분포 분석 및 위험 평가 제공
입력
wallet_address(필수): EVM 주소 (0x...)
데이터 출처
기본: Zerion API (zerion-portfolio.py)
# 모든 자산 조회
python3 zerion-portfolio.py <주소>
# DeFi 포지션만 조회
python3 zerion-portfolio.py <주소> --only-defi
환경 변수: ZERION_API_KEY가 설정되어 있어야 합니다. 설정되지 않은 경우 API 키는 https://www.zerion.io/api 에서 발급받을 수 있습니다.
실행 워크플로우
단계 1: 입력 검증
1. 주소 형식 확인: 0x + 40개의 16진수 문자
2. 형식이 잘못된 경우: 오류 메시지와 함께 종료
단계 2: 포트폴리오 데이터 가져오기
# Zerion 포트폴리오 스크립트 실행
python3 skills/pubfi-wallet-portfolio-analysis/zerion-portfolio.py <주소>
에지 케이스 처리:
- 빈 지갑 → "빈 지갑" 보고
- API 실패 → 오류와 함께 종료, 진행 불가
- 가치 0인 포지션 → 건너뛰기
단계 3: 자산 분류
유형별 그룹화:
네이티브: ETH, MATIC, BNB 등
스테이블코인: USDC, USDT, DAI, USDS
DeFi 포지션: 프로토콜 속성 보유 + position_type != 'wallet'
기타 토큰: 그 외 모든 것
분포 비율을 위해 각 카테고리의 총 가치 추적
단계 4: DeFi 프로토콜 식별
각 DeFi 포지션에 대해:
1. attributes.protocol에서 프로토콜 이름 추출
2. 포지션 유형 식별 (대출/스테이킹/LP 등)
3. 포지션 가치 및 포트폴리오 비율 기록
4. 위험 평가를 위한 고유 프로토콜 목록 생성
단계 5: 위험 평가 (DeFi 프로토콜만)
식별된 각 프로토콜에 대해:
A. 프로토콜 데이터 가져오기 (병렬):
- DefiLlama API: curl "https://api.llama.fi/protocol/{slug}"
- TVL, 체인, 감사 정보, 카테고리 추출
B. 최근 익스플로잇 확인:
- rekt.news에서 프로토콜 이름 검색
- 지난 90일로 필터링
- 모든 사고 기록
C. 위험 점수 계산:
위험 = 기본 + 이벤트 + 감사 + TVL 추세
요인:
- 감사 없음: +5
- 최근 익스플로잇 (90일 이내): +5
- TVL 30일간 50% 이상 하락: +3
- TVL 20-50% 하락: +2
- 신규 프로토콜 (6개월 미만): +2
- 단일 감사: +1
- 다중 감사: -2
- 검증됨 (1년 이상): -1
D. 위험 수준 할당:
- 점수 > 7: 🔴 고위험
- 점수 4-7: 🟡 중간 위험
- 점수 < 4: 🟢 저위험
E. 오류 처리:
- DefiLlama 실패: TVL을 "N/A"로 표시, 계속 진행
- Rekt.news 사용 불가: 익스플로잇을 "알 수 없음"으로 표시
알려진 안전 프로토콜 (자동 🟢):
- Aave V2/V3, Uniswap V2/V3, Compound V2/V3
- Lido, Curve, MakerDAO/Sky
단계 6: 보고서 생성
아래 출력 형식 섹션을 따라 구조화된 마크다운 보고서를 출력합니다.
출력 형식
1) 요약
포트폴리오: 0x...
총 가치: $X,XXX USD
체인: Ethereum, Arbitrum, Base
2) 자산 분포
자산 구성:
• 네이티브: $XXX (XX%)
• 스테이블코인: $XXX (XX%)
• DeFi 포지션: $XXX (XX%)
• 기타 토큰: $XXX (XX%)
3) 주요 포지션
가치순으로 정렬된 모든 포지션을 표 형태로 표시:
프로토콜/지갑 | 포지션 유형 | 가치 | 포트폴리오 비율
---------------|---------------|-------|---------------
Wallet Assets | Wallet | $XXX | XX%
프로토콜 A | Lending | $XXX | XX%
프로토콜 B | LP | $XXX | XX%
4) 주요 보유 자산 (포트폴리오의 2% 초과)
표 형식:
체인 | 자산 | 유형 | 수량 | 가치 | 포트폴리오 비율
------|-------|------|--------|-------|---------------
5) DeFi 노출
🟡 중간 위험 또는 🔴 고위험 프로토콜만 표시 (🟢 저위험은 건너뜀):
프로토콜 이름 (체인)
• 포지션 가치: $XXX (포트폴리오의 XX%)
• 포지션 유형: 대출/스테이킹/LP 등
• 위험: 🟡/🔴
• TVL: $XXX (DefiLlama)
• 감사: 예/아니오 (감사 기관명)
• 최근 문제: 없음 / [설명]
모든 프로토콜이 저위험인 경우: "모든 DeFi 포지션이 저위험 프로토콜에 있습니다 (🟢)"
6) 위험 요약
우선 순위 높음:
- 🔴 고위험 포지션과 권장 조치 나열
우선 순위 중간:
- 🟡 중간 위험 포지션과 고려 사항 나열
종합 평가:
- 한 단락 요약
- 위험 점수: 낮음/중간/높음
7) 데이터 출처
- Zerion API: 포트폴리오 데이터 (타임스탬프)
- DefiLlama: 프로토콜 TVL 및 정보
- Rekt.news: 보안 사고
- [기타 사용된 출처]
품질 기준
간결성:
- 전체 보고서: 200-400단어 (표 제외)
- 실행 가능한 인사이트에만 집중
- 불필요한 내용이나 일반적인 진술 없음
정확성:
- 모든 데이터에는 타임스탬프가 있어야 함
- 모든 값은 실제 API 호출에서 가져와야 함
- 위험 평가는 특정 증거를 인용해야 함
유용성:
- 포트폴리오의 5%를 초과하는 포지션 강조
- 고위험 노출 즉시 플래그
- 필요한 경우 명확한 다음 조치 제공
업데이트 빈도
- 위험 데이터베이스: rekt.news로 매월 업데이트
- 알려진 프로토콜: 주요 신규 프로토콜 출시 시 업데이트
- 감사 상태: 분기별로 확인
마지막 업데이트: 2026-02-05