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

# Foundational API on Solana

> REST endpoint on Solana for SPL token balances.

The GoldRush Foundational API on Solana is the same REST surface that serves other chains, adapted for Solana addressing. Wallets and mints are base58.

## Endpoint

```
GET https://api.covalenthq.com/v1/solana-mainnet/...
Authorization: Bearer <GOLDRUSH_API_KEY>
```

`solana-mainnet` slots into the same `{chainName}` path parameter as `eth-mainnet`, `base-mainnet`, or other supported chains.

## Solana addressing conventions

| Topic              | Convention                                                                                                                                                                                                                  |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Wallet address** | Base58, 32-44 chars, **case-preserved** (unlike EVM 0x-hex which is lowercased). Example: `4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY`.                                                                                   |
| **Token mint**     | Base58 mint pubkey - takes the same path slot as `contract_address` on EVM. SOL is represented as `So11111111111111111111111111111111111111112` (wrapped SOL mint), USDC as `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`. |
| **Native unit**    | Lamports - 1 SOL = 10⁹ lamports.                                                                                                                                                                                            |

## Supported endpoint

| Endpoint                                                                                                  | What it returns                                                         |
| --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| [Get token balances for address](/api-reference/foundational-api/balances/get-token-balances-for-address) | SPL token balances plus native SOL with USD quote where pricing exists. |

Walkthrough: [Wallet](/goldrush-solana/foundational/wallet).

## Not supported today

The following are **not** part of Foundational REST coverage on Solana today:

* SPL token transfer history (REST). Available in the warehouse via the [`transfers` normalizer](/goldrush-solana/warehouse/spl-transfers).
* Solana transactions (signature lookup, paginated history, summary)
* NFTs (Metaplex and Bubblegum compressed)
* Token pricing REST endpoints (historical or pool spot). Real-time OHLCV is available via the [streaming OHLCV recipe](/goldrush-solana/streaming/ohlcv-markets).
* Solana-native primitives (stake, IDL, validators, Token-2022 extensions, SPL delegations)

## Error handling

Follows the standard GoldRush envelope and error taxonomy - see [Error handling](/error-handling).