Skip to main content
Beta: The Wallet API is currently in beta. APIs and response formats may change. This is an experimental API that we’re actively improving coverage and adding new features to.

​
Guides and Tutorials

Wallet Identity

Look up wallet identities and known addresses

Wallet Balances

Get token and NFT balances with USD values

Wallet History

Fetch complete transaction history with balance changes

Token Transfers

See all token transfers with sender/recipient info

Funding Source

Discover who originally funded a wallet
Quick Reference:
  • GET /v1/wallet/{wallet}/identity - Get wallet identity information
  • POST /v1/wallet/batch-identity - Batch identity lookup (up to 100 addresses)
  • GET /v1/wallet/{wallet}/balances - Get all token and NFT balances
  • GET /v1/wallet/{wallet}/history - Get transaction history with balance changes
  • GET /v1/wallet/{wallet}/transfers - Get all token transfer activity
  • GET /v1/wallet/{wallet}/funded-by - Find the original funding source
  • Base URL: https://api.helius.xyz

​
Overview

The Wallet API provides high-performance REST endpoints for querying comprehensive Solana wallet data. Instead of making multiple RPC and third-party API calls and parsing raw blockchain data, get structured, human-readable information in a single request.

​
Key Features

Complete Wallet Profiles

Get everything about a wallet: balances, history, transfers, and identity in structured format

USD Pricing

Token balances include USD values (hourly updates via DAS) and portfolio totals

Identity Resolution

Identify known wallets with 5100+ tagged accounts and 1900+ programs (exchanges, protocols, institutions)

Fast & Efficient

Optimized queries return data in milliseconds, not seconds

Pagination Support

Efficiently fetch large datasets with cursor-based pagination

Human-Readable

Get clear, structured data instead of raw blockchain instructions

​
What You Get

The Wallet API provides:
  • Token Balances: All SPL tokens and Token-2022 with USD values, logos, and metadata
  • NFT Holdings: Compressed and uncompressed NFTs with collection information
  • Transaction History: Complete history with balance changes for each transaction
  • Transfer Activity: All incoming and outgoing transfers with counterparty information
  • Identity Data: Names and categories for known wallets (exchanges, protocols, etc.)
  • Funding Analysis: Original funding source and amount for wallet attribution

​
Use Cases

The Wallet API is ideal for:
  • Wallet Applications: Display portfolio balances and transaction history to users
  • Payment Processors: Track payment history and verify transactions for merchants
  • Portfolio Trackers: Show current holdings with USD values
  • Tax & Accounting: Generate complete transaction reports for tax filing
  • Compliance & AML: Monitor wallet activity and identify exchange funding sources
  • Analytics Platforms: Track whale wallets, smart money, and on-chain behavior
  • Trading Bots: Analyze wallet holdings and activity patterns
  • DeFi Dashboards: Display user positions across protocols

​
Authentication

All Wallet API requests require an API key. You can pass it in two ways: 
curl "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=YOUR_API_KEY"

​
Getting Started

1

Get Your API Key

Sign up at dashboard.helius.dev to get your API key.
2

Choose Your Endpoint

Select the endpoint that matches your use case:
  • Identity: Identify known wallets (exchanges, protocols)
  • Balances: Get portfolio holdings with USD values
  • History: Fetch complete transaction history
  • Transfers: Track all token movements
  • Funding: Find original funding source
3

Make Your First Request

Start with a simple balance query:
curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"
4

Handle the Response

Parse the JSON response and display the data in your application.

​
Need Help?

API Reference

View detailed API documentation with request/response schemas

Contact Support

Get help from our team through Discord, chat, or email