Wallet API (Beta)

REST API endpoints for querying Solana wallet data including balances, transaction history, transfers, identity, and funding information.

Beta: The Wallet API is currently in beta. APIs and response formats may change.

All Wallet API requests cost 100 credits per call. See credit costs for details.

The identity, batch-identity, and funded-by endpoints require a paid plan — Free-plan requests return 403 Forbidden. All other endpoints are available on every plan.

identity

Get wallet identity by address or SNS/ANS domain

balances

Retrieve all token and NFT balances with USD values

balance-at

Get a token or SOL balance at a past timestamp or slot

history

Fetch transaction history with balance changes

transfers

Get all token transfer activity with sender/recipient info

funded-by

Discover the original funding source for a wallet

Authentication

All Wallet API requests require authentication via API key:

# Query parameter
GET https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=YOUR_API_KEY

# Header (recommended)
GET https://api.helius.xyz/v1/wallet/{wallet}/balances
X-Api-Key: YOUR_API_KEY

Base URL

https://api.helius.xyz

Quick Reference

Endpoint	Credits	Free plan	Description
GET /v1/wallet/{wallet}/identity	100	403	Get wallet identity by address or SNS/ANS domain
POST /v1/wallet/batch-identity	100	403	Batch identity lookup (up to 100 addresses/domains)
GET /v1/wallet/{wallet}/balances	100	Available	Get all token and NFT balances
GET /v1/wallet/{wallet}/balance-at	100	Available	Get a token or SOL balance at a past timestamp, datetime, or slot
GET /v1/wallet/{wallet}/history	100	Available	Get transaction history with balance changes
GET /v1/wallet/{wallet}/transfers	100	Available	Get all token transfer activity
GET /v1/wallet/{wallet}/funded-by	100	403	Find the original funding source