신규: Helius가 Light Protocol을 인수했습니다
Wallet API (베타)

간편해진 Solana 지갑 데이터

하나의 REST API로 Solana 지갑 잔액, 내역, 신원, 자금 출처를 확인하세요. Solana JSON-RPC 메서드를 외우거나 lamport를 계산할 필요가 없습니다.

시작하기문서 보기
히어로 이미지
신원

지갑 소유자 파악

Solana 주소나 도메인 이름을 신원 정보로 변환합니다. 32,500개 이상의 레이블과 2,150만 개 이상의 태그를 지원합니다.

GET /v1/wallet/{wallet}/identity
          
{
  "address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
  "type": "exchange",
  "name": "Binance 1",
  "category": "Centralized Exchange",
  "tags": ["Centralized Exchange"]
}
시작하기문서 보기
  • 단건 조회 또는 최대 100개 주소 일괄 조회
  • 메인넷에서 SNS 및 ANS 사용자 지정 TLD 변환
  • 거래소 주소, 프로토콜 지갑, 기관, 신고된 주소의 레이블 지원
자금 제공자

지갑에 자금을 보낸 주체 추적

지갑의 최초 자금 출처를 확인합니다. 누가 첫 SOL을 언제, 얼마나 보냈는지 보여줍니다. 자금 제공자의 이름과 유형은 동일한 신원 시스템에서 가져옵니다.

GET /v1/wallet/{wallet}/funded-by
          
{
  "funder": "26MAyPNpK4At8LgRECMMbgiKQuJyg3oACtw1Q9FRyuba",
  "funderName": null,
  "funderType": null,
  "mint": "So11111111111111111111111111111111111111111",
  "symbol": "SOL",
  "amount": 0.09811972,
  "amountRaw": "98119720",
  "decimals": 9,
  "date": "2022-01-19T20:46:34.000Z",
  "signature": "5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG",
  "timestamp": 1642625194,
  "slot": 116984883,
  "explorerUrl": "https://orbmarkets.io/tx/5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG?tab=summary"
}
시작하기문서 보기
  • 직접 자금을 보낸 주소, 수량, 슬롯, 서명
  • 거래소, 프로토콜 또는 알 수 없음으로 분류하고, 확인된 경우 레이블 표시
  • 영구 캐시. 지갑의 최초 자금 제공자는 바뀌지 않습니다
함께 보기

Orb로 지갑 자금 출처 데이터 찾기

→

Orb 블록 탐색기가 자금 정보를 제공하는 방식을 확인하세요

내역

완전히 파싱된 지갑 활동

각 트랜잭션의 잔액 변동을 사람이 읽기 쉬운 형식으로 제공하는 트랜잭션 내역입니다.

GET /v1/wallet/{wallet}/history
          
{
  "data": [
    {
      "signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
      "timestamp": 1704067200,
      "slot": 250000000,
      "fee": 0.000005,
      "feePayer": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
      "error": null,
      "balanceChanges": [
        {
          "mint": "So11111111111111111111111111111111111111111",
          "amount": -0.05,
          "decimals": 9
        }
      ]
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
  }
}
시작하기문서 보기
  • 최신순으로 페이지당 최대 100개 트랜잭션
  • 변경된 항목만 받으려면 tokenAccounts=balanceChanged 사용
  • amount는 이미 소수점이 조정되어 있어 lamport 계산이 불필요합니다
함께 보기

파싱된 이벤트 및 스트림

→

3,600개 이상의 프로그램에서 디코딩된 트랜잭션 내역을 가져오세요

HELIUS WALLETS-AS-A-SERVICE

지갑과 데이터 레이어를 함께 출시하세요

helius-wallet-kit을 사용해 패스키, 이메일, 기존 지갑 로그인 옵션을 지원하는 비수탁형 임베디드 지갑을 앱에 추가하세요

자세히 알아보기

Wallet API 활용 사례

지갑 대시보드

한 번의 REST 호출로 잔액, USD 가치, 메타데이터를 가져옵니다. DAS 조합이나 lamport 계산이 필요 없습니다

포트폴리오 추적기

내역과 balance-at을 사용해 보유 자산을 재구성하고 기간별 손익을 계산합니다

결제 처리 서비스

상대방, 수량, mint, 방향과 함께 트랜잭션과 전송을 기록합니다

세무 및 회계

각 트랜잭션의 보유 잔액과 변동이 포함된 읽기 쉬운 내역을 가져옵니다

규정 준수 및 AML

알려진 거래소와 재무 지갑을 조회하고 지갑의 자금 조달 경로를 확인합니다

탐색기 및 분석

2,100만 개 이상의 지갑 태그를 가져와 앱에 계정 레이블을 추가합니다

작동 방식

하나의 REST API로 모든 Solana 지갑 데이터를

getWalletBalances
const getWalletBalances = async (address) => {
  const url = `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`;

  const response = await fetch(url);
  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  const data = await response.json();

  const solBalance = data.balances[0]; // SOL is always first when showNative=true
  console.log(`SOL Balance: ${solBalance.balance} SOL ($${solBalance.usdValue})`);
  console.log(`Page ${data.pagination.page} Total Value: $${data.totalUsdValue}`);
  console.log(`Token Count (this page): ${data.balances.length}`);

  // Display top holdings
  data.balances.slice(0, 5).forEach(token => {
    console.log(`${token.symbol}: ${token.balance} ($${token.usdValue || 'N/A'})`);
  });

  return data;
};

getWalletBalances("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");

1. API 키 발급

가입 후 Helius API 키를 발급받아 쿼리 문자열의 api-key 또는 X-Api-Key 헤더로 전달합니다

2. 하나의 REST 경로 호출

GET /v1/wallet/{wallet}/balances, identity, history 또는 다른 Wallet API 엔드포인트를 호출합니다

3. 앱에 바로 적용

수량은 소수점이 조정되고, 신원에는 레이블이 지정되며, 데이터는 올바른 형식으로 제공됩니다. 추가 작업이 필요 없습니다

구축 시작하기문서 보기

자주 묻는 질문

자주 묻는 질문의 답변을 확인하세요. 도움이나 맞춤형 플랜이 필요하신가요? 팀에 문의하세요.

CTA 동영상
구분선 이미지

Solana 지갑
알아보기

모두 보기
차이를 경험하세요

복잡함 없이 활용하는 지갑 데이터

원시 Solana JSON-RPC 메서드 대신 몇 분 만에 온체인 지갑 데이터 조회를 시작하세요

구축 시작하기 문서 보기