Starchild-ai-agent/official-skills

스크립트 사용법

스크립트 모드 스킬입니다. 이 파일을 읽은 후 bash 블록에서 호출하세요:

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/birdeye")
from exports import birdeye_token_overview, birdeye_token_security, birdeye_wallet_networth

# SOL 개요
sol = birdeye_token_overview(address="So11111111111111111111111111111111111111112", chain="solana")
print(json.dumps(sol, indent=2))
EOF

exports.py에서 사용 가능한 함수: birdeye_token_security, birdeye_token_overview, birdeye_wallet_networth. 정확한 시그니처는 exports.py를 직접 확인하세요.

Birdeye

토큰 인텔리전스 및 지갑 분석을 위한 멀티체인 데이터 제공자입니다. Solana + EVM 체인(이더리움, Arbitrum, Base 등)을 지원합니다. 보안 분석 및 포트폴리오 추적을 위한 Birdeye의 고유 기능에 중점을 둡니다.

함수 참조 (시그니처)

모든 함수는 exports.py에 있습니다. chain의 기본값은 solana입니다. 지원되는 EVM 체인: ethereum, bsc, polygon, arbitrum, optimism, base, avalanche, zksync, sui. Solana의 토큰 address는 민트 주소입니다 (예: SOL = So11111111111111111111111111111111111111112).

함수	설명
birdeye_token_overview(address, chain='solana')	포괄적인 토큰 데이터: 가격, 시가총액, FDV, 공급량, 보유자, 유동성, 24시간 거래량, 소셜 링크. {data: {...}} 래퍼를 반환합니다.
birdeye_token_security(address, chain='solana')	보안 감사: 소유권, 발행 가능 여부, 동결 가능 여부, 상위 보유자 집중도, 변경 가능한 메타데이터, 러그 풀 지표.
birdeye_wallet_networth(wallet, chain='solana')	지갑 순자산 + 토큰 분류. wallet = 지갑 주소.

Birdeye는 카멜케이스 필드(marketCap, priceChange24h 등)를 사용합니다. 모든 응답은 {data: {...}} 형태로 래핑됩니다. result.get('data', {})를 통해 추출하세요.

사용 가능한 도구 (3개)

토큰 인텔리전스 (2개 도구)

• birdeye_token_security: 보안 점수 및 러그 풀 위험 분석
• birdeye_token_overview: 포괄적인 토큰 데이터 (가격, 거래량, 시가총액, 유동성)

지갑 분석 (1개 도구)

• birdeye_wallet_networth: 현재 지갑 순자산 및 포트폴리오 분류

각 도구 사용 시기

"이 토큰 안전한가요?" → birdeye_token_security 보안 점수, 러그 풀 위험 분석 및 컨트랙트 취약점 탐지.

"이 토큰에 대한 전체 정보를 알려주세요" → birdeye_token_overview 가격, 거래량, 시가총액, 유동성 및 가격 변동을 한 번에 확인할 수 있습니다.

"이 지갑의 가치는 얼마인가요?" → birdeye_wallet_networth 현재 포트폴리오 가치와 잔액 및 가치가 포함된 상세 토큰 분류.

멀티체인 지원

모든 도구는 chain 매개변수를 지원합니다:

• Solana: solana (대부분의 쿼리에서 기본값)
• EVM: ethereum, arbitrum, base, optimism, polygon, bsc, avalanche, zksync, sui

체인 선택 가이드라인:

• Solana: 가장 활발한 거래, 밈코인에 최적
• Ethereum: 블루칩 토큰, DeFi 프로토콜
• Arbitrum/Base: L2 거래, 저수수료 DeFi
• 토큰/지갑이 네이티브인 체인을 사용하세요

해석 가이드

보안 점수

점수	위험 수준	조치
90-100	매우 낮음	안전하게 거래 가능, 검증된 컨트랙트
70-89	낮음	일반적으로 안전, 표준 위험
50-69	중간	주의하여 진행, 문제 목록 확인
30-49	높음	위험 높음 — 문제를 주의 깊게 조사
0-29	매우 높음	러그 풀 또는 사기 가능성 높음 — 회피

일반적인 위험 신호:

• 민트 권한이 해지되지 않음 (소유자가 토큰을 발행할 수 있음)
• 동결 권한 활성화 (소유자가 거래를 동결할 수 있음)
• 낮은 유동성 (< $10k = 러그 위험 높음)
• 집중된 보유 (상위 10명의 보유자가 공급량의 80% 초과)
• 소셜 링크 또는 웹사이트 없음

토큰 개요 지표

가격 및 시가총액: 현재 평가 및 거래 가격 거래량: 거래 활동은 유동성과 관심도를 나타냄 유동성: 거래에 사용 가능한 유동성 (높을수록 안전한 출구) 가격 변동률 %: 1시간/24시간/7일 가격 변동

유동성 해석:

• < $10k: 매우 높은 위험, 조작하기 쉬움
• $10k-$100k: 중간 위험, 대량 출구 주의
• $100k-$1M: 소규모/중간 거래에 적합한 유동성

• $1M: 강력한 유동성, 큰 포지션에 더 안전

지갑 순자산

총 USD 가치: 현재 가격 기준 모든 토큰 보유액의 합계 토큰 분류: 잔액과 가치가 포함된 개별 보유량 포트폴리오 집중도: 지갑이 얼마나 분산되어 있는가?

포트폴리오 건강 지표:

• 한 토큰에 대한 높은 집중도 (>80%) = 높은 위험
• 균형 잡힌 보유 = 더 나은 위험 관리
• 큰 미실현 이익 = 이익 실현 가능성

일반적인 워크플로우

토큰 실사

1. birdeye_token_security — 보안 점수 및 위험 확인
2. birdeye_token_overview — 가격, 거래량, 시가총액, 유동성

위험 신호: 낮은 보안 점수 (<50) + 낮은 유동성 (<$10k) = 러그 풀 위험

예시:

사용자: "이 토큰 안전한가요? [Solana 주소]"
1. birdeye_token_security 확인 → 점수 85 (낮은 위험)
2. birdeye_token_overview 확인 → $500k 유동성, $2M 거래량
3. 결과: 일반적으로 안전, 거래에 적합한 유동성

지갑 분석

1. birdeye_wallet_networth — 현재 포트폴리오 가치 및 분류

사용 사례:

• 자신의 포트폴리오 가치 추적
• 고래 지갑 분석
• 경쟁사 보유량 모니터링

예시:

사용자: "이 지갑에 뭐가 있나요? [주소]"
1. birdeye_wallet_networth 확인 → 총 $45k 가치
2. 분류: SOL 60%, USDC 25%, 밈코인 15%
3. 결과: 스테이블코인 헤징이 포함된 균형 잡힌 Solana 포트폴리오

빠른 토큰 확인

거래 전 토큰을 빠르게 검증하려면:

birdeye_token_overview → 가격, 유동성, 거래량을 한 번에 확인

유동성 < $10k 또는 거래량 < $1k → 높은 위험, 주의하여 진행

도구 상세

birdeye_token_security

매개변수:

• address (필수): 토큰 컨트랙트 주소
• chain (선택): 블록체인 (기본값: solana)

반환값:

• 보안 점수 (0-100)
• 위험 수준
• 감지된 문제 목록
• 컨트랙트 분석 결과

예시:

birdeye_token_security(
  address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  chain="solana"
)

birdeye_token_overview

매개변수:

• address (필수): 토큰 컨트랙트 주소
• chain (선택): 블록체인 (기본값: solana)

반환값:

• 심볼, 이름
• 현재 가격
• 24시간 거래량
• 시가총액
• 유동성
• 가격 변동 (1시간, 24시간, 7일)

예시:

birdeye_token_overview(
  address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  chain="solana"
)

birdeye_wallet_networth

매개변수:

• wallet (필수): 지갑 주소
• chain (선택): 블록체인 (기본값: solana)

반환값:

• 총 USD 가치
• 토큰 보유 분류:
  • 토큰 심볼, 이름
  • 잔액
  • 현재 가격
  • USD 가치
  • 포트폴리오 비율

예시:

birdeye_wallet_networth(
  wallet="7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  chain="solana"
)

참고: 지갑 API에는 요청 속도 제한이 있습니다 (5 req/s, 75 req/min). 요청 간격을 두세요.

체인별 참고 사항

Solana:

• Birdeye에서 가장 잘 지원되는 체인
• 토큰 주소는 base58로 인코딩됨
• Raydium, Orca에서 가장 유동적인 거래
• 밈코인 분석 및 포트폴리오 추적에 사용

Ethereum:

• 블루칩 토큰 및 DeFi 프로토콜
• 토큰 주소는 0x... 형식
• 높은 가스 수수료 = 소액 거래 감소

Arbitrum/Base:

• 낮은 수수료의 L2 확장 솔루션
• 성장하는 DeFi 생태계
• L2 네이티브 프로젝트에 적합

다른 스킬과의 통합

CoinGecko와 상호 보완:

• Birdeye 사용: 보안 확인, Solana 토큰, 지갑 분석
• CoinGecko 사용: 광범위한 시장 데이터, 과거 가격, 시가총액 순위

중복 금지: 각 서비스는 고유한 강점을 가지고 있습니다. Birdeye는 특화된 데이터(보안, Solana 집중, 지갑 추적)에 사용하세요.

참고 사항

• API 키 필요: BIRDEYE_API_KEY 환경 변수 설정
• 요청 속도 제한: 지갑 엔드포인트는 5 req/s, 75 req/min으로 제한됨
• 멀티체인: Solana 이외의 쿼리는 항상 chain 매개변수 지정
• 보안 점수: 자동화된 분석 — 고액 거래의 경우 수동으로 확인
• 실시간 데이터: 가격과 데이터가 자주 업데이트되며, 활발한 거래 결정에 적합

제한 사항

• 트렌딩 토큰 없음: 트렌딩/상위 토큰 목록은 CoinGecko 사용
• 보유자 분포 없음: 토큰을 보유한 사람을 확인할 수 없음
• 거래 내역 없음: 최근 거래를 볼 수 없음
• 스마트 머니 신호 없음: 고래 추적은 다른 소스 사용
• 제한된 지갑 도구: 순자산만 제공 (PnL, 보유 상세, 전송 내역 없음)

보안 확인, 토큰 개요 및 지갑 평가를 위한 3가지 사용 가능한 도구에 집중하세요.