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

개요

Wallet Balances 엔드포인트는 Solana 지갑의 모든 토큰 및 NFT 보유량 — SOL, SPL 토큰, Token-2022 및 NFT — 를 USD 가격, 로고 및 메타데이터와 함께 검색합니다. 결과는 내림차순으로 USD 가치에 따라 정렬됩니다: 가격 데이터가 있는 토큰이 먼저 나타나고, 가격이 없는 토큰이 뒤따릅니다. 엔드포인트는 요청당 최대 100개의 토큰을 반환하므로 페이지 매김은 수동입니다. 추가 페이지를 가져오려면 page 매개변수를 사용하고 더 많은 결과가 있을 때는 pagination.hasMore를 읽으십시오. 각 요청은 하나의 API 호출이며 100 크레딧이 소요됩니다.
USD 가격은 DAS에서 소스하며 시가 총액 상위 10,000개의 토큰을 대상으로 매시간 업데이트됩니다. 지원되지 않는 토큰은 pricePerTokenusdValuenull입니다. 가격은 추정치이며 실시간 시장 가격이 아닙니다.

언제 사용할지

Wallet Balances API가 필요한 경우:
  • 포트폴리오 보유 내역 표시: 사용자의 전체 토큰 및 NFT 보유 내역을 보여줍니다.
  • USD 값 계산: 매시간 업데이트되는 가격으로 포트폴리오 평가를 수행합니다.
  • 지갑 UI 구축: 지갑 대시보드와 자산 목록에 힘을 실어줍니다.
  • 토큰 보유 추적: 여러 지갑에서 특정 토큰 잔액을 모니터링합니다.
  • 포트폴리오 분석: 보유 분포 및 집중도를 분석합니다.
  • 세금 보고: 세금 목적으로 보유 내역 스냅샷을 생성합니다.

빠른 시작

기본 잔액 쿼리

지갑의 모든 토큰 잔액을 USD 값과 함께 가져옵니다:

NFT 결과 포함

showNfts=true를 사용하여 단일 요청으로 토큰과 NFT를 모두 가져옵니다:

결과 필터링

쿼리 매개변수를 사용하여 반환되는 내용을 제한합니다:

쿼리 매개변수

응답 형식

필드 노트

  • balance: 사람이 읽을 수 있는 수량, 이미 소수점에 맞게 조정됨 — 1.5은 1.5 SOL을 의미하고 1000.5은 1000.5 USDC를 의미합니다. 람포트 변환이 필요하지 않습니다. 이 엔드포인트는 원래 amountRaw 필드를 노출하지 않습니다; 정확한 정수 값을 원하면 Math.round(balance * 10 ** decimals)처럼 도출하십시오.
  • decimals: 참조용으로만 제공됩니다.
  • pricePerToken / usdValue: DAS 가격 데이터가 없는 토큰을 위한 null입니다 (위의 가격 노트를 참조하십시오).
  • totalUsdValue: 현재 응답 페이지에 대한 총 USD 값입니다. 전체 포트폴리오 가치는 모든 페이지를 통해 페이지 매김하고 각 잔액의 usdValue을 합산하십시오.
  • tokenProgram: 각 토큰이 사용하는 토큰 표준 — spl-token (레거시 SPL 토큰) 또는 token-2022 (토큰 확장). 두 가지 모두 완전히 지원됩니다.

사용 사례

포트폴리오 대시보드 구축

USD 값을 사용하여 사용자 보유 내역을 표시합니다:

토큰 집중도 계산

포트폴리오 다각화를 분석합니다:

특정 토큰 잔액 추적

여러 지갑에서 특정 토큰을 모니터링합니다:

세금 보고를 위한 보유 내역 내보내기

보유 내역 스냅샷을 생성합니다:

페이지 매김

100개 이상의 토큰이 있는 지갑의 경우 page 매개변수와 pagination.hasMore를 사용하여 결과를 페이지 매깁니다:
NFT는 토큰 페이지 매김과 상관없이 첫 번째 페이지에만 반환됩니다 (최대 100).

베스트 프랙티스

  • 0 잔액을 필터링하여 깔끔한 UI를 만듭니다. 지갑이 더 이상 보유하지 않는 토큰을 숨기려면 showZeroBalance=false를 사용하십시오.
  • 필요할 때만 NFT를 포함합니다. 성능을 위해 기본적으로 NFT는 제외되며, 표시할 때만 showNfts=true를 설정하십시오.
  • 가격 데이터 누락 처리. pricePerTokenusdValuenull인지 항상 확인하십시오. 이는 DAS의 시간별 추정치이며 실시간 시장 가격이 아닙니다.
  • 응답 캐시. 잔액 데이터는 몇 초간 캐시하여 API 호출을 줄일 수 있습니다.
  • 대규모 지갑 페이지 매김. 일부 지갑에는 수천 개의 토큰이 있습니다; 페이지 매김을 구현하여 효율적으로 처리하십시오.

일반 오류

다음 단계

과거 잔액

과거 타임스탬프, 날짜 및 슬롯에서 토큰 또는 SOL 잔액을 가져옵니다.

지갑 API 개요

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

API 참조

지갑 잔액을 위한 요청 및 응답 스키마.