## 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](/content/docs/billing/credits#wallet-api-credits/index.html) 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**](/content/docs/api-reference/wallet-api/identity/index.html)  
  Get wallet identity by address or SNS/ANS domain
- [**balances**](/content/docs/api-reference/wallet-api/balances/index.html)  
  Retrieve all token and NFT balances with USD values
- [**balance-at**](/content/docs/api-reference/wallet-api/balance-at/index.html)  
  Get a token or SOL balance at a past timestamp or slot
- [**history**](/content/docs/api-reference/wallet-api/history/index.html)  
  Fetch transaction history with balance changes
- [**transfers**](/content/docs/api-reference/wallet-api/transfers/index.html)  
  Get all token transfer activity with sender/recipient info
- [**funded-by**](/content/docs/api-reference/wallet-api/funded-by/index.html)  
  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 |