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

# Wallet endpoints on Solana

> REST endpoint on Solana for SPL token balances.

This page walks through the wallet-centric Foundational endpoint currently supported on `solana-mainnet`: SPL token balances.

## Balances (SPL + native SOL)

Returns SPL token holdings plus native SOL with USD pricing where available.

```bash cURL theme={null}
curl -X GET "https://api.covalenthq.com/v1/solana-mainnet/address/4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY/balances_v2/" \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY"
```

```typescript TypeScript theme={null}
import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient(process.env.GOLDRUSH_API_KEY);

const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
  chainName: "solana-mainnet",
  walletAddress: "4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY",
});

for (const item of resp.data.items) {
  console.log(item.contract_ticker_symbol, item.balance, item.pretty_quote);
}
```

```python Python theme={null}
import os, requests

resp = requests.get(
    "https://api.covalenthq.com/v1/solana-mainnet/address/"
    "4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY/balances_v2/",
    headers={"Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}"},
)
print(resp.json()["data"]["items"][:3])
```

Each item carries the SPL mint as `contract_address`, decimals from the Mint account, and `quote` in USD where pricing exists. The wrapped-SOL row (`So111…`) is the native balance.

Reference: [`get-token-balances-for-address`](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address).

## SPL transfer history

SPL transfer history is **not** available on the Foundational REST API for Solana today.

## Related

* [Foundational on Solana overview](https://goldrush.dev/docs/goldrush-solana/foundational/overview.md) - full endpoint coverage and what's not supported today.


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