Wallet API - Helius

Wallet API Documentation

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.

Endpoints

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