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

​
Wallet API란 무엇인가요?

Wallet API는 Solana 지갑 데이터(잔액, 거래 내역, 토큰 전송, 신원 확인, 과거 잔액, 자금 출처)를 쿼리하기 위한 고수준 REST 엔드포인트를 제공합니다. 여러 RPC 호출을 통해 원시 블록체인 데이터를 분석하지 않고, 구조화된 인간이 읽을 수 있는 정보와 USD 가격을 단일 요청으로 얻을 수 있습니다. 이 API는 지갑, 포트폴리오 추적기, 탐색기, 결제 처리기, 세금 도구, 규제 준수 및 AML 시스템을 위해 구축되었습니다. 모든 엔드포인트는 기본 URL https://api.helius.xyz을 공유하며, 인간이 읽을 수 있는 단위로 금액을 반환합니다(라포트 변환 필요 없음).

​
왜 지갑 데이터에 Helius를 사용해야 하나요?

하나의 REST 호출

원시 RPC 응답을 연결할 필요 없이 구조화된 잔액, 내역 및 전송을 제공

USD 가격 내장

토큰 잔액에는 DAS에서 제공하는 USD 값과 포트폴리오 총액이 포함됩니다.

신원 확인

32,500개 이상의 라벨링된 계정과 프로그램, 21.5M+ 범주 태그.

인간이 읽을 수 있는 출력

원시 라포트 및 명령 대신 명확하고 소수점이 조정된 데이터.

​
주요 엔드포인트

지갑 신원

주소 또는 SNS/ANS 도메인으로 알려진 지갑 식별 — 거래소, 프로토콜, 기관.

지갑 잔액

USD 값, 로고, 메타데이터를 포함한 모든 토큰 및 NFT 잔액.

과거 잔액

과거 타임스탬프, 날짜, 슬롯에 따른 토큰 또는 SOL 잔액.

지갑 내역

각 거래에 대한 잔액 변화를 포함한 전체 거래 내역.

토큰 전송

발신자/수신자 정보를 포함한 모든 입출금 전송.

자금 출처

지갑의 원래 자금 출처를 첫 번째 입력 SOL까지 추적.

​
어떤 엔드포인트를 사용해야 하나요?

간단한 경로 참조 (기본 URL https://api.helius.xyz):
  • GET /v1/wallet/{wallet}/identity — 주소 또는 SNS/ANS 도메인으로 지갑 신원 가져오기
  • POST /v1/wallet/batch-identity — 최대 100개 주소 및/또는 도메인에 대한 배치 신원 검색
  • GET /v1/wallet/{wallet}/balances — 모든 토큰 및 NFT 잔액 가져오기
  • GET /v1/wallet/{wallet}/balance-at — 과거 타임스탬프, 날짜, 슬롯의 토큰 또는 SOL 잔액 가져오기
  • GET /v1/wallet/{wallet}/history — 잔액 변화를 포함한 거래 내역 가져오기
  • GET /v1/wallet/{wallet}/transfers — 모든 토큰 전송 활동 가져오기
  • GET /v1/wallet/{wallet}/funded-by — 원래 자금 출처 찾기

​
인증

모든 Wallet API 요청에는 API 키가 필요합니다. 쿼리 매개변수나 헤더로 전달할 수 있습니다:

​
플랜 요구 사항

신원 및 자금 출처 엔드포인트에는 유료 플랜이 필요합니다. 무료 플랜에서는 이러한 엔드포인트 요청 시 403 Forbidden가 반환됩니다. 다른 모든 엔드포인트는 무료 플랜을 포함하여 모든 플랜에서 열려 있습니다. 유료 티어는 게이트 엔드포인트를 잠금 해제합니다 — 개발자, 비즈니스 및 그보다 높은 모든 티어(엔터프라이즈 등). 신원 및 자금 출처 조회를 활성화하려면, 대시보드에서 플랜을 업그레이드하세요.

​
금액 및 단위

Wallet API는 원시 Solana 데이터에 대한 고수준 추상화입니다. 응답의 모든 amount 필드는 인간이 읽을 수 있는 형태로 제공됩니다 — 이미 토큰의 decimals으로 나누어져 있어 어떤 변환도 필요하지 않습니다. 원시 Solana RPC 호출은 라포트(가장 작은 단위, 10⁻⁹ SOL)로 값을 반환하지만, Wallet API는 그렇지 않습니다. "amount": 1.5은 1.5 SOL을 의미하며, 1.5 라포트가 아닙니다. 정확한 산술이 필요한 경우 일부 엔드포인트는 amountRaw를 노출합니다: 정수로 직렬화된 문자열로 부동 소수점 정밀도 손실을 방지합니다. 변환 공식은 다음과 같습니다: amount = parseInt(amountRaw) / 10**decimals 표시에 amount를 사용하세요. 정확한 정수 산술이 필요한 온체인 명령이나 다른 시스템에 값을 전달할 때는 amountRaw를 사용하세요.

​
시작하기

1

API 키를 받으세요

dashboard.helius.dev에 가입하여 API 키를 받으세요.
2

엔드포인트를 선택하세요

위 표를 사용하여 귀하의 사용 사례에 맞는 엔드포인트를 선택하세요.
3

첫 요청을 만드세요

간단한 잔액 조회부터 시작하세요:
4

응답 처리

JSON 응답을 파싱하고 애플리케이션에서 데이터를 표시하세요.

​
다음 단계

데이터 가져오기

Helius에서 Solana 데이터를 쿼리하는 모든 방법을 탐색하세요.

API 참조

모든 Wallet API 엔드포인트의 요청 및 응답 스키마.

지원 문의

Discord, 채팅 또는 이메일을 통해 도움 받기.