​

GoldRush Foundational API on Solana

​

Critical Rules

1. Base URL: https://api.covalenthq.com/v1/solana-mainnet/... (kebab-case chain name).
2. Wallet address format: base58, case-preserved (unlike EVM 0x-hex which is lowercased).
3. Token mints: base58 mint pubkey - takes the contract_address / tokenMint slot. USDC = EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, wrapped SOL = So11111111111111111111111111111111111111112.
4. Transaction id: base58 signature (~88 chars), addressed via /transaction_v2/{signature}/ - not tx_hash and not /transaction_v2/{txHash}/.
5. Slot is primary; block_height is secondary and can be null because ~5% of slots are skipped.
6. SPL Token + Token-2022 are aggregated by default in every balance/transfer/holder response. Opt out with ?include-token-2022=false.
7. cNFTs surface alongside Metaplex NFTs with compressed: true. For cNFTs, contract_address is the Bubblegum Merkle tree (not a mint), and token_id is the Merkle leaf index.
8. ALT references in versioned transactions (v0) are pre-resolved at index time - clients always see the full account_keys.
9. processed commitment is not exposed via Foundational (too unstable for REST semantics). Default is confirmed; use ?commitment=finalized for rollback-impossible reads.

​

Endpoint

GET https://api.covalenthq.com/v1/solana-mainnet/...
Authorization: Bearer

​

Solana addressing conventions

​

Supported endpoint

​

Not supported 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

​

Balances (SPL + native SOL)

curl -X GET "https://api.covalenthq.com/v1/solana-mainnet/address/4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY/balances_v2/" \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY"

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);
}

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])

​

SPL transfer history

​

Related

• DEX firehose - new DEX pair events on SOLANA_MAINNET.
• Wallet activity - real-time push of decoded swaps and transfers for a list of wallets.
• OHLCV markets - real-time candles by pool or token mint.
• SPL Transfers warehouse recipe - decoded SPL transfers landed in your warehouse.
• DEX Swaps warehouse recipe - decoded DEX swaps landed in your warehouse.