> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet API (Beta)

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

> [!NOTE]
>
> **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](https://www.helius.dev/docs/billing/credits.md#wallet-api-credits) 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.

> [card] [identity](https://www.helius.dev/docs/api-reference/wallet-api/identity.md)
>
> Get wallet identity by address or SNS/ANS domain

> [card] [balances](https://www.helius.dev/docs/api-reference/wallet-api/balances.md)
>
> Retrieve all token and NFT balances with USD values

> [card] [balance-at](https://www.helius.dev/docs/api-reference/wallet-api/balance-at.md)
>
> Get a token or SOL balance at a past timestamp or slot

> [card] [history](https://www.helius.dev/docs/api-reference/wallet-api/history.md)
>
> Fetch transaction history with balance changes

> [card] [transfers](https://www.helius.dev/docs/api-reference/wallet-api/transfers.md)
>
> Get all token transfer activity with sender/recipient info

> [card] [funded-by](https://www.helius.dev/docs/api-reference/wallet-api/funded-by.md)
>
> Discover the original funding source for a wallet

## Authentication

All Wallet API requests require authentication via API key:

```bash theme={"system"}
# 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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.