> ## 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.
</Note>

All Wallet API requests cost **100 credits** per call. See [credit costs](/billing/credits#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.

<CardGroup cols={2}>
  <Card title="identity" href="/api-reference/wallet-api/identity">
    Get wallet identity by address or SNS/ANS domain
  </Card>

  <Card title="balances" href="/api-reference/wallet-api/balances">
    Retrieve all token and NFT balances with USD values
  </Card>

  <Card title="balance-at" href="/api-reference/wallet-api/balance-at">
    Get a token or SOL balance at a past timestamp or slot
  </Card>

  <Card title="history" href="/api-reference/wallet-api/history">
    Fetch transaction history with balance changes
  </Card>

  <Card title="transfers" href="/api-reference/wallet-api/transfers">
    Get all token transfer activity with sender/recipient info
  </Card>

  <Card title="funded-by" href="/api-reference/wallet-api/funded-by">
    Discover the original funding source for a wallet
  </Card>
</CardGroup>

## 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                                  |