메인 콘텐츠로 건너뛰기
Wallet API는 베타 버전에 있습니다. 엔드포인트 및 응답 형식이 변경될 수 있습니다.

개요

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

언제 사용할지

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를 설정하십시오.
  • 가격 데이터 누락 처리. pricePerToken 및 usdValue가 null인지 항상 확인하십시오. 이는 DAS의 시간별 추정치이며 실시간 시장 가격이 아닙니다.
  • 응답 캐시. 잔액 데이터는 몇 초간 캐시하여 API 호출을 줄일 수 있습니다.
  • 대규모 지갑 페이지 매김. 일부 지갑에는 수천 개의 토큰이 있습니다; 페이지 매김을 구현하여 효율적으로 처리하십시오.

일반 오류

다음 단계

과거 잔액

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

지갑 API 개요

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

API 참조

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