defi-onchain-analytics은(는) 무엇을 하나요?
AI 에이전트 스킬 for DeFi 온체인 분석 via JSON-RPC — 지갑 프로파일링, 프로토콜 분석, 토큰 메트릭, DEX 분석, 스마트 컨트랙트 검사 (6개 EVM 체인, 108개의 검증된 퍼블릭 RPC 엔드포인트 지원)
개요
이 스킬은 AI 에이전트가 JSON-RPC API를 통해 블록체인 데이터를 직접 쿼리할 수 있게 해줍니다. 다음을 포함한 포괄적인 온체인 분석 기능을 제공합니다:
- 지갑 프로파일링: 잔액 조회, 트랜잭션 내역, 토큰 보유 현황
- 프로토콜 분석: TVL, 유동성, 주요 프로토콜 메트릭
- 토큰 메트릭: 가격, 시가총액, 공급량, 전송 내역
- DEX 분석: 스왑 데이터, 유동성 풀 정보, 거래량
- 스마트 컨트랙트 검사: 코드 검증, 이벤트 로그, 함수 호출
지원 체인
| 체인 | 체인 ID | 엔드포인트 수 |
|---|---|---|
| 이더리움 (Ethereum) | 1 | 20 |
| BNB 스마트 체인 (BSC) | 56 | 18 |
| 폴리곤 (Polygon) | 137 | 18 |
| 아비트럼 (Arbitrum) | 42161 | 18 |
| 옵티미즘 (Optimism) | 10 | 18 |
| 베이스 (Base) | 8453 | 16 |
사용 방법
1. 설정
스킬을 사용하려면 다음과 같이 환경 변수를 설정하세요:
# 필수: 기본 체인 설정 (선택 사항, 기본값: 이더리움)
export CHAIN=ethereum
# 선택 사항: 사용자 정의 RPC URL (기본값 대신 사용)
export RPC_URL=https://eth-mainnet.g.alchemy.com/v2/your-api-key
2. 기본 쿼리 예제
# 지갑 잔액 조회
response = agent.execute("지갑 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18의 ETH 잔액을 조회해줘")
# 토큰 정보
response = agent.execute("USDC 토큰 (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48)의 총 공급량을 알려줘")
# 최근 트랜잭션
response = agent.execute("지갑 0x1234...5678의 최근 10개 트랜잭션을 보여줘")
3. 고급 분석
# 프로토콜 TVL 확인
agent.chat("Uniswap V3 이더리움 풀의 TVL을 분석해줘")
# DEX 스왑 데이터
agent.chat("지난 24시간 동안 PancakeSwap BNB/USDT 풀의 거래량을 알려줘")
# 스마트 컨트랙트 검사
agent.chat("컨트랙트 0xdAC17F958D2ee523a2206206994597C13D831ec7의 최근 이벤트 로그를 보여줘")
API 참조
JSON-RPC 메서드
이 스킬은 표준 Ethereum JSON-RPC 메서드를 사용합니다:
eth_getBalance— 지갑 잔액eth_getTransactionCount— 트랜잭션 수eth_getTransactionReceipt— 트랜잭션 영수증eth_call— 컨트랙트 함수 호출eth_getLogs— 이벤트 로그 필터링eth_blockNumber— 최신 블록 번호
사용자 정의 분석 엔드포인트
고급 분석을 위해 스킬은 다음을 제공합니다:
/api/wallet/profile— 종합 지갑 프로필/api/token/metrics— 토큰 메트릭/api/protocol/tvl— 프로토콜 TVL 데이터/api/dex/pools— DEX 풀 정보
예제 워크플로우
트레이딩 봇 통합
// AI 에이전트가 온체인 데이터를 분석하고 트레이딩 결정을 내립니다
const walletData = await agent.queryWallet("0x...");
const tokenMetrics = await agent.getTokenMetrics("0x...");
if (tokenMetrics.priceChange > 5 && walletData.balance > threshold) {
await agent.executeTrade("BUY", tokenMetrics.symbol, amount);
}
리스크 평가
- 지갑 활동 분석으로 의심스러운 패턴 감지
- 스마트 컨트랙트 감사 이력 확인
- DEX 유동성 깊이 평가
- 토큰 보유 집중도 분석
문제 해결
일반적인 문제
| 문제 | 해결 방법 |
|---|---|
| RPC 연결 실패 | 다른 엔드포인트로 재시도하거나 RPC_URL 설정 확인 |
| 잘못된 체인 ID | CHAIN 환경 변수를 올바른 체인 이름으로 설정 |
| 속도 제한 초과 | 요청 간 지연 시간 추가 또는 프리미엄 RPC 제공자 사용 |
| 잘못된 주소 | 주소가 올바른 0x 접두사 42자 형식인지 확인 |
라이선스
MIT