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

# Solana API Quickstart

> Get started with Solana on GoldRush: look up SPL token balances for any wallet via REST.

## Prerequisites

A GoldRush API key. Sign up at [goldrush.dev/platform](https://goldrush.dev/platform/auth/register/).

> [card] [Vibe Coders](https://goldrush.dev/platform/auth/register/?plan=vibe)
>
> \$10/mo - Built for solo builders and AI-native workflows.

> [card] [Teams](https://goldrush.dev/platform/auth/register/?plan=professional)
>
> \$250/mo - Production-grade with priority support.

***

## Look up SPL token balances

Get SPL token balances and native SOL for any base58 wallet address.

```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 token of resp.data.items) {
  console.log(`${token.contract_ticker_symbol}: ${token.balance} (${token.pretty_quote})`);
}
```

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

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

for item in resp.json()["data"]["items"]:
    print(item["contract_ticker_symbol"], item["balance"], item.get("pretty_quote"))
```

Balances are returned with `contract_address` as the base58 mint pubkey, `contract_decimals` from the Mint account, and USD `quote` where pricing is available.

> [card] [Foundational on Solana walkthrough](https://goldrush.dev/docs/goldrush-solana/foundational/wallet.md)
>
> SPL token balance details and request shape.

***

## What's next

> [card] [Foundational endpoints](https://goldrush.dev/docs/goldrush-solana/foundational/overview.md)
>
> SPL token balances on `solana-mainnet`.

> [card] [GoldRush vs Solana RPC](https://goldrush.dev/docs/resources/differentiate-your-solana-app.md)
>
> What GoldRush adds on top of plain Solana RPC.


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