Skip to main content
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

TopicConvention
Wallet addressBase58, 32-44 chars, case-preserved (unlike EVM 0x-hex which is lowercased). Example: 4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY.
Token mintBase58 mint pubkey - takes the same path slot as contract_address on EVM. SOL is represented as So11111111111111111111111111111111111111112 (wrapped SOL mint), USDC as EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.
Native unitLamports - 1 SOL = 10⁹ lamports.

​
Supported endpoint

EndpointWhat it returns
Get token balances for addressSPL token balances plus native SOL with USD quote where pricing exists.
Walkthrough: 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.
  • 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.
  • Solana-native primitives (stake, IDL, validators, Token-2022 extensions, SPL delegations)

​
Error handling

Follows the standard GoldRush envelope and error taxonomy - see Error handling.