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 값과 함께 가져옵니다:- JavaScript
- Python
- cURL
NFT 결과 포함
showNfts=true를 사용하여 단일 요청으로 토큰과 NFT를 모두 가져옵니다:
- JavaScript
- Python
결과 필터링
쿼리 매개변수를 사용하여 반환되는 내용을 제한합니다:쿼리 매개변수
응답 형식
필드 노트
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를 사용하여 결과를 페이지 매깁니다:
베스트 프랙티스
- 0 잔액을 필터링하여 깔끔한 UI를 만듭니다. 지갑이 더 이상 보유하지 않는 토큰을 숨기려면
showZeroBalance=false를 사용하십시오. - 필요할 때만 NFT를 포함합니다. 성능을 위해 기본적으로 NFT는 제외되며, 표시할 때만
showNfts=true를 설정하십시오. - 가격 데이터 누락 처리.
pricePerToken및usdValue가null인지 항상 확인하십시오. 이는 DAS의 시간별 추정치이며 실시간 시장 가격이 아닙니다. - 응답 캐시. 잔액 데이터는 몇 초간 캐시하여 API 호출을 줄일 수 있습니다.
- 대규모 지갑 페이지 매김. 일부 지갑에는 수천 개의 토큰이 있습니다; 페이지 매김을 구현하여 효율적으로 처리하십시오.
일반 오류
다음 단계
과거 잔액
과거 타임스탬프, 날짜 및 슬롯에서 토큰 또는 SOL 잔액을 가져옵니다.
지갑 API 개요
모든 지갑 API 엔드포인트 및 공유 규칙.
API 참조
지갑 잔액을 위한 요청 및 응답 스키마.