Skip to main content
getTokenLargestAccounts RPC 메서드는 주어진 SPL 토큰 민트에 대해 가장 큰 20개의 토큰 계정 목록을 반환합니다. 이는 토큰 분배를 분석하거나 특정 토큰의 주요 보유자를 식별하는 데 유용합니다.

일반 사용 사례

  • 토큰 분배 분석: 토큰의 공급이 보유자들 사이에 어떻게 분배되는지 이해하기.
  • 고래 식별: 특정 토큰을 대량으로 보유한 계정 찾기.
  • 시장 조사: 토큰 소유 집중도 측정.
  • 상위 보유자 표시: 토큰 탐색기 또는 대시보드에서 가장 큰 계정 목록 표시.

요청 매개변수

  1. mintAddress (string, 필수): 가장 큰 계정을 찾고자 하는 토큰 민트의 base-58로 인코딩된 공개 키입니다.
  2. options (object, 선택 사항): 포함할 수 있는 선택적 구성 객체:
    • commitment (string, 선택 사항): 쿼리를 위한 커밋 수준을 지정합니다 (예: "finalized", "confirmed", "processed").

응답 구조

JSON-RPC 응답의 result.value 필드는 최대 20개의 객체로 구성된 배열입니다. 각 객체는 가장 큰 토큰 계정 중 하나를 나타내며 다음 필드를 포함합니다:
  • address (string): 토큰 계정의 base-58로 인코딩된 공개 키입니다.
  • amount (string): 토큰 계정의 원시 잔액을 문자열로 나타내며, 이 값은 소숫점으로 조정되지 않았습니다.
  • decimals (u8): 이 토큰 민트를 위해 정의된 소숫점 자리 수입니다.
  • uiAmount (number | null): 소숫점으로 조정된 부동 소수점 형식의 토큰 잔액. 이 필드는 사용되지 않거나 신뢰도가 낮을 수 있으며 uiAmountString가 선호됩니다.
  • uiAmountString (string): 소숫점으로 조정된 문자열 형식의 토큰 잔액으로, 사용자 친화적인 잔액 표현입니다.
예시 응답:

코드 예제

개발자 팁

  • 고정 제한: 이 메서드는 항상 최대 20개의 가장 큰 계정을 반환합니다. 페이징 또는 20개 이상의 계정 요청을 지원하지 않습니다.
  • 데이터 정확성: 데이터는 지정된 커밋 수준에 의해 결정된 슬롯에서의 원장 상태를 반영합니다.
  • 토큰 민트 전용: 결과는 요청에서 제공된 단일 토큰 민트에 한정됩니다.
  • 성능: 이는 타겟 쿼리로 일반적으로 성능이 좋습니다. 그러나 과도한 폴링은 피해야 합니다.
이 가이드는 Solana의 모든 SPL 토큰에서 주요 보유자를 발견하기 위해 getTokenLargestAccounts RPC 메서드를 사용하는 방법을 안내합니다.