Wallet API는 베타 버전입니다. 엔드포인트와 응답 형식이 변경될 수 있습니다.
개요
Wallet Funding Source 엔드포인트는 처음으로 들어온 SOL 전송을 분석하여 Solana 지갑을 초기 자금 후원자를 식별합니다. 이는 귀속, 규정 준수, 지갑 관계 이해 및 거래소 자금 조달 지갑 식별에 유용합니다. 자금 제공자의 이름과 범주는 Identity 엔드포인트에서 사용하는 동일한 식별 시스템에서 가져오므로, 자금 제공자가 알려진 엔티티일 경우 응답에 인간이 읽을 수 있는 레이블과 범주가 직접 제공됩니다. 이 엔드포인트는 유료 플랜이 필요합니다. 무료 플랜 API 키로 요청한 경우403 Forbidden이 반환됩니다. 전체 커버리지 표는 플랜 요구 사항을 참조하세요.
사용 시기
Wallet Funding Source API를 사용하세요:- 지갑 귀속: 새로운 지갑이 어디에서 자금을 받는지 추적합니다.
- 거래소 감지: 중앙화 거래소에서 직접 자금을 받은 지갑 식별.
- 규정 준수 및 AML: 규정 준수 검사를 위해 알려진 엔티티에서 자금을 받은 지갑을 플래그.
- 봇 감지: 동일한 출처에서 자금을 받은 봇 팜 식별.
- 에어드롭 분석: 프로젝트에서 초기 자금을 받은 지갑 추적.
- Sybil 감지: 동일한 주소에서 자금을 받은 지갑 클러스터 찾기.
빠른 시작
기본 자금 조회
지갑을 누가 자금을 댔는지 알아보세요:- JavaScript
- Python
- cURL
응답 형식
성공적인 응답은 지갑의 첫 번째 SOL 전송을 설명합니다:필드 노트
funder: 이 지갑에 첫 SOL 전송을 보낸 주소.funderName: 자금 제공자가 알려진 엔티티인 경우 인간이 읽을 수 있는 이름 (예: 거래소, 프로토콜); 그렇지 않으면null.funderType: 자금 제공자의 범주 (예:exchange,defi-protocol); 식별 데이터베이스에 없는 경우null.mint: 토큰 민트 주소 (SOL의 경우So11111111111111111111111111111111111111111).symbol: 토큰 심볼 (자금 거래에서는 항상SOL).amount: 받은 초기 SOL 금액 (사람이 읽을 수 있는 형식, 예:0.05SOL).amountRaw: 라포트 단위의 원시 금액 (예: 0.05 SOL인 경우"50000000").decimals: 토큰의 소수 자릿수 (SOL의 경우 9).date: ISO 8601 형식의 날짜 문자열 (예:"2024-01-01T00:00:00.000Z").signature: 자금 전송의 거래 서명.timestamp: 지갑이 자금을 받은 시점의 유닉스 타임스탬프 (초 단위).slot: 자금 거래가 확인된 Solana 슬롯 번호.explorerUrl: Orb에서 거래를 볼 수 있는 직접 링크.
사용 사례
거래소 자금 조달 지갑 감지
중앙화 거래소에서 직접 자금을 받은 지갑 식별:지갑 클러스터 찾기 (Sybil 감지)
동일한 출처에서 자금을 받은 지갑 그룹 식별:에어드롭 수신자 추적
에어드롭 수신자가 어디에서 왔는지 분석:지갑 타임라인 구축
지갑 생성을 시작으로 타임라인 생성:규정 준수 위험 점수 매기기
자금 출처를 기반으로 위험 점수 할당:귀속 추적
가장 많은 새로운 지갑을 생성하는 소스 추적:자금 제공자 유형
funderType 필드는 주소에 자금을 댄 지갑의 범주를 나타냅니다. Identity Categories의 모든 값이 지원됩니다.
지원되는 자금 제공자 유형
지원되는 자금 제공자 유형
일반적 자금 제공자 유형:
전체 목록에는 에어드롭, 권한, 크로스체인 브리지, 카지노 및 도박, DAO, DeFi, DePIN, 중앙화 거래소, 악용자/해커/사기, 수수료, 모금, 게임, 제네시스 블록 배포, 거버넌스, 해커, Jito, 핵심 의견 리더, 시장 조성자, 밈코인, 멀티시그, NFT, 비유통 공급, 오라클, 기타, 결제, 독점 AMM, 재스테이킹, 러거, 사기꾼, 스팸, 스테이크 풀, 시스템, 도구, 트레이딩 앱/봇, 트레이딩 회사, 거래 전송, 재무부, 검증자, 금고, 그리고 X402가 포함됩니다.전체 목록 및 설명은 Identity Categories 섹션을 참조하세요.
모범 사례
- 404 응답 처리. SOL을 받은 적이 없는 지갑은 404를 반환합니다. 이는 새로 생성되었지만 자금을 받지 않은 지갑의 경우 예상됩니다.
- Identity API와 결합. 응답에는
funderName와funderType가 포함되지만, 더 자세한 내용을 위해 Identity 엔드포인트를funder주소에서 호출할 수 있습니다. - 자금 데이터 캐싱. 지갑의 자금 출처는 변경되지 않습니다. 이 데이터를 영구적으로 캐시하여 반복적인 API 호출을 피하세요.
- 컨텍스트를 위한 연령 확인.
timestamp는 지갑이 처음 자금을 받았을 때을 알려줍니다. 자금 출처와 연령을 결합하여 더 나은 컨텍스트를 제공하세요.
일반적인 오류
제한 사항
- 이 엔드포인트는 지갑의 첫 SOL 전송만 추적합니다.
- 에어드롭이나 프로그래밍 초기화를 통해 SOL 전송 없이 생성된 지갑은 자금 데이터를 갖지 않습니다.
- 자금 출처는 즉시 자금을 제공한 자를 나타내며, 반드시 자금의 최종 출처를 나타내지는 않습니다.
- 이 기능이 배포된 후 생성된 지갑에 대한 데이터만 사용할 수 있습니다.
다음 단계
지갑 ID
자금 제공자 주소를 전체 레이블, 범주 및 태그로 해결하세요.
지갑 API 개요
모든 지갑 API 엔드포인트 및 공유 규칙.
API 참조
자금 출처 조회를 위한 요청 및 응답 스키마.