Skip to main content

개요

이 가이드는 Solana에서 대체 가능한 토큰을 읽는 방법을 다룹니다: 계정 잔액, 소유자 또는 민트별 토큰 계정, 총 공급량, 최대 소유자 및 DAS 대체 가능한 토큰 확장. Helius는 표준 Solana RPC 토큰 메서드와 메타데이터 및 USD 가격을 추가하는 DAS 메서드를 제공합니다. NFT, 압축 NFT, 에디션 및 증명에 대해서는 Get Assets 가이드를 참조하세요. 이 페이지는 대체 가능한 (SPL 및 Token-2022) 토큰에 중점을 둡니다.

사용 시점

이 페이지의 메서드를 사용할 때:
  • 단일 토큰 계정의 잔액을 읽을 때
  • 지갑이 보유한 모든 토큰 계정을 나열할 때
  • 특정 민트를 보유한 모든 계정을 찾을 때
  • 토큰의 총 공급량 또는 최대 소유자를 확인할 때
  • 잔액과 함께 토큰 메타데이터 및 USD 가격을 가져올 때

토큰 계정 잔액

표준 RPC를 사용하여 특정 토큰 계정의 잔액을 가져옵니다:

API 참고자료

getTokenAccountBalance

소유자별 토큰 계정

지갑이 소유한 모든 토큰 계정을 나열하십시오:

API 참고자료

getTokenAccountsByOwner

민트별 토큰 계정

특정 토큰을 보유한 모든 계정을 나열하십시오:

API 참고자료

getTokenAccountsByOwner
모든 소유자에 걸친 민트를 보유한 모든 계정을 찾으려면 아래에 설명된 DAS getTokenAccounts 메서드를 사용하십시오.

토큰 공급

토큰의 총 공급량을 확인하십시오:

API 참고자료

getTokenSupply

최대 토큰 소유자

토큰을 보유한 최대 계정을 식별하십시오:

API 참고자료

getTokenLargestAccounts
최대 20개의 민트 계정을 반환합니다:

DAS API와의 토큰 계정

DAS getTokenAccounts 메서드는 민트 또는 소유자별로 토큰 계정을 반환하며, 단일 페이지네이션 호출 내에서 잔액을 포함합니다. getTokenAccountsByOwner와 달리, mint 만으로 모든 소유자에 걸쳐 토큰을 보유한 모든 계정을 나열할 수 있습니다.

API 참고자료

getTokenAccounts
페이지네이션; 각 항목에는 계정, 민트, 소유자, 잔액이 포함됩니다:

DAS API로 토큰 메타데이터 및 가격

토큰 메타데이터 및 USD 가격을 위해 DAS getAsset 메서드를 showFungible가 활성화된 상태로 호출하십시오. 검증된 토큰의 가격은 token_info.price_info에서 반환됩니다.
getAsset의 가격 데이터는 최대 600초간 캐시되므로 최대 10분까지 오래될 수 있습니다.

API 참고자료

getAsset
응답은 token_info 하에 공급량, 소수점 및 가격을 반환합니다:

시가 총액 계산

가격을 소수점 조정된 공급량과 곱합니다:
지갑의 모든 대체 가능한 토큰을 한 번의 호출로 나열하려면 잔액 및 가격과 함께 getAssetsByOwner 또는 searchAssetstokenType: "fungible"와 함께 사용하십시오. tokenType, 잔액, Token-2022 확장 및 가격 데이터가 응답에 나타나는 방법은 대체 가능한 토큰 확장을 참조하십시오.

모범 사례

  • 큰 결과 집합을 반환하는 메서드에는 페이지네이션을 사용하십시오. 자세한 내용은 페이지네이션 가이드를 참조하십시오.
  • 메타데이터나 USD 가격이 필요한 경우 DAS 메서드(getAsset, getAssetsByOwner, getTokenAccounts)를 사용하고, 원시 온체인 잔액 및 공급의 경우 표준 RPC 메서드를 사용하십시오.
  • 오류를 try/catch 블록과 재시도를 사용하여 원활하게 처리하십시오.
  • 적절할 때 응답을 캐시하여 API 호출을 줄이십시오.

다음 단계

대체 가능한 토큰 확장

DAS가 대체 가능한 토큰, Token-2022 확장 및 가격을 반환하는 방법.

자산 가져오기 (NFT)

NFT, 압축 NFT, 에디션 및 증명을 검색합니다.

DAS API 참조

모든 DAS 메서드에 대한 전체 스키마.