Skip to main content
Wallet API는 베타 버전입니다. 엔드포인트와 응답 형식이 변경될 수 있습니다.

개요

Wallet Funding Source 엔드포인트는 처음으로 들어온 SOL 전송을 분석하여 Solana 지갑을 초기 자금 후원자를 식별합니다. 이는 귀속, 규정 준수, 지갑 관계 이해 및 거래소 자금 조달 지갑 식별에 유용합니다. 자금 제공자의 이름과 범주는 Identity 엔드포인트에서 사용하는 동일한 식별 시스템에서 가져오므로, 자금 제공자가 알려진 엔티티일 경우 응답에 인간이 읽을 수 있는 레이블과 범주가 직접 제공됩니다. 이 엔드포인트는 유료 플랜이 필요합니다. 무료 플랜 API 키로 요청한 경우 403 Forbidden이 반환됩니다. 전체 커버리지 표는 플랜 요구 사항을 참조하세요.

사용 시기

Wallet Funding Source API를 사용하세요:
  • 지갑 귀속: 새로운 지갑이 어디에서 자금을 받는지 추적합니다.
  • 거래소 감지: 중앙화 거래소에서 직접 자금을 받은 지갑 식별.
  • 규정 준수 및 AML: 규정 준수 검사를 위해 알려진 엔티티에서 자금을 받은 지갑을 플래그.
  • 봇 감지: 동일한 출처에서 자금을 받은 봇 팜 식별.
  • 에어드롭 분석: 프로젝트에서 초기 자금을 받은 지갑 추적.
  • Sybil 감지: 동일한 주소에서 자금을 받은 지갑 클러스터 찾기.

빠른 시작

기본 자금 조회

지갑을 누가 자금을 댔는지 알아보세요:

응답 형식

성공적인 응답은 지갑의 첫 번째 SOL 전송을 설명합니다:
지갑이 SOL을 받은 적이 없는 경우 API는 404를 반환합니다:

필드 노트

  • funder: 이 지갑에 첫 SOL 전송을 보낸 주소.
  • funderName: 자금 제공자가 알려진 엔티티인 경우 인간이 읽을 수 있는 이름 (예: 거래소, 프로토콜); 그렇지 않으면 null.
  • funderType: 자금 제공자의 범주 (예: exchange, defi-protocol); 식별 데이터베이스에 없는 경우 null.
  • mint: 토큰 민트 주소 (SOL의 경우 So11111111111111111111111111111111111111111).
  • symbol: 토큰 심볼 (자금 거래에서는 항상 SOL).
  • amount: 받은 초기 SOL 금액 (사람이 읽을 수 있는 형식, 예: 0.05 SOL).
  • 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와 결합. 응답에는 funderNamefunderType가 포함되지만, 더 자세한 내용을 위해 Identity 엔드포인트를 funder 주소에서 호출할 수 있습니다.
  • 자금 데이터 캐싱. 지갑의 자금 출처는 변경되지 않습니다. 이 데이터를 영구적으로 캐시하여 반복적인 API 호출을 피하세요.
  • 컨텍스트를 위한 연령 확인. timestamp는 지갑이 처음 자금을 받았을 때을 알려줍니다. 자금 출처와 연령을 결합하여 더 나은 컨텍스트를 제공하세요.

일반적인 오류

제한 사항

  • 이 엔드포인트는 지갑의 첫 SOL 전송만 추적합니다.
  • 에어드롭이나 프로그래밍 초기화를 통해 SOL 전송 없이 생성된 지갑은 자금 데이터를 갖지 않습니다.
  • 자금 출처는 즉시 자금을 제공한 자를 나타내며, 반드시 자금의 최종 출처를 나타내지는 않습니다.
  • 이 기능이 배포된 후 생성된 지갑에 대한 데이터만 사용할 수 있습니다.

다음 단계

지갑 ID

자금 제공자 주소를 전체 레이블, 범주 및 태그로 해결하세요.

지갑 API 개요

모든 지갑 API 엔드포인트 및 공유 규칙.

API 참조

자금 출처 조회를 위한 요청 및 응답 스키마.