> ## 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. # Overview # GoldRush API for Solana - Overview ## Quick Reference | Item | Value | | --------------------------- | -------------------------------------------------------------------------------------- | | **Foundational base URL** | `https://api.covalenthq.com/v1/solana-mainnet/...` | | **Streaming WebSocket URL** | `wss://streaming.goldrushdata.com/graphql` | | **Authentication** | `Authorization: Bearer ` (same key for all surfaces) | | **REST chain name** | `solana-mainnet` (kebab-case) | | **Streaming chain enum** | `SOLANA_MAINNET` (SCREAMING\_SNAKE\_CASE) | | **Wallet address format** | base58, 32-44 chars, case-preserved | | **Transaction id** | `signature` (base58, \~88 chars) | | **Block identifier** | `slot` (primary) / `block_height` (secondary, \~5% gaps) / `block_time` (unix seconds) | | **Native unit** | lamports (1 SOL = 10^9 lamports) | | **Default commitment** | `confirmed` (\~1s). `finalized` (\~13s) via `?commitment=finalized` | ## Surfaces | Surface | What it provides | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Foundational API | REST endpoints for SPL balances (Token + Token-2022), historical balances by slot, SPL transfers, transactions by signature, NFTs (Metaplex + Bubblegum cNFTs), pricing, and Solana-native primitives. | | Streaming API | Real-time `newPairs` (DEX firehose across Raydium / Orca / Meteora / Jupiter / PumpFun), `ohlcvCandlesForPair`, `ohlcvCandlesForToken`, `walletTxs`. | | Pipeline API | Decoded `swaps`, `transfers`, and PumpFun lifecycle (`sol_pf_create` / `sol_pf_swap` / `sol_pf_complete` / `sol_pf_withdraw`) to ClickHouse, BigQuery, Postgres, Kafka, S3, or webhooks. | *** GoldRush is the **complete data layer for Solana**. Wallet, transactions, NFTs, pricing, Solana-native primitives, real-time streams, and warehouse delivery - all under one API key, served from validator-peered nodes. ### Foundational API REST endpoints for SPL token balances, transactions, NFTs (Metaplex + compressed), pricing, stake accounts, and Solana-native primitives. Base58 addresses and signatures, slot-aware history. ### Real-time Streaming Sub-second WebSocket streams for new DEX pairs (Raydium, Orca, Meteora, PumpFun), OHLCV candles, and wallet activity. One connection, thousands of wallets or pools. ### Pipeline to your warehouse Land decoded DEX swaps, SPL transfers, and PumpFun lifecycle events directly in ClickHouse, BigQuery, Postgres, Kafka, or S3. ### PumpFun discovery Track every new PumpFun token from launch through bonding curve to Raydium graduation - in real time or via warehouse. ## Solana limitations addressed by GoldRush Public Solana RPC is free, but it has hard limits that production apps hit fast: * **Per-IP rate limits** on free RPC tiers throttle wallet activity scanning past a few thousand users. * **No decoded SPL transfers or DEX swaps** - you parse Token Program / Token-2022 logs yourself, repeat for every AMM. * **No historical depth** on cheap providers - balances "as of slot N" requires expensive `getSignaturesForAddress` + per-tx `getTransaction` round-trips. * **No real-time DEX firehose** - the cheap way to discover new Raydium / Orca / Meteora pools is poll-based. * **No PumpFun-native indexing** - bonding curve state, graduations, and pre-graduation swaps need custom decoders. * **cNFT (Bubblegum) accounts are invisible** to standard `getTokenAccountsByOwner` scans - you need DAS-compatible indexing. * **No warehouse delivery** - landing Solana data in ClickHouse / BigQuery means writing your own ETL on top of RPC. GoldRush closes every one of these gaps. See **GoldRush vs Solana RPC** for the full breakdown. ## What's included ## Infrastructure * **Dedicated Solana validator-peered nodes** for low-latency reads and slot-tip ingestion. * **No rate limits** on Foundational or Streaming for Solana. * **Full historical depth** - SPL transfers, swaps, and PumpFun events back to genesis where available (per-endpoint backfill horizon noted in the **roadmap**). * **400ms slot times, sub-cent fees** - GoldRush ingests and decodes at slot tip. ## Quickstart Three "first 5 minutes" quickstarts. Pick the one that maps to what you're building. ### Look up a Solana wallet Balances, NFTs, transactions, and portfolio history for any base58 address. ### Stream new pumps & DEX pairs Real-time pool launches across Raydium, Orca, Meteora, and PumpFun. ### Pipe SPL transfers to a warehouse Land SPL Token + Token-2022 transfers in ClickHouse, BigQuery, or Postgres. *** Pick the path that matches what you're building. All three use the same GoldRush API key. ## Prerequisites A GoldRush API key. Sign up at [goldrush.dev/platform](https://goldrush.dev/platform/auth/register/). ### Vibe Coders \$10/mo - Built for solo builders and AI-native workflows. ### Teams \$250/mo - Production-grade with priority support. *** ## 1. Look up a Solana wallet Get SPL token balances (Token Program + Token-2022) 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. ### Foundational on Solana walkthrough Historical balances, SPL transfers, NFTs (Metaplex + cNFT), and Solana-native endpoints in one place. *** ## 2. Stream new pumps and DEX pairs Subscribe to every new pool minted on Raydium, Orca, Meteora, Jupiter, and PumpFun in real time over a single WebSocket. ```typescript GoldRush SDK theme={null} import { GoldRushClient, StreamingChain } from "@covalenthq/client-sdk"; const client = new GoldRushClient(process.env.GOLDRUSH_API_KEY); client.StreamingService.subscribeToNewPairs( { chain_name: StreamingChain.SOLANA_MAINNET }, { next: (data) => { const pair = data.newPairs; console.log(`new pool: ${pair.exchange} ${pair.pair_address} ${pair.base_token.symbol}/${pair.quote_token.symbol}`); }, error: (err) => console.error(err), complete: () => console.log("done"), } ); ``` ```graphql GraphQL Subscription theme={null} subscription { newPairs(chain_name: SOLANA_MAINNET) { block_signed_at exchange pair_address base_token { address symbol decimals } quote_token { address symbol decimals } initial_liquidity_usd } } ``` ```bash Install theme={null} npm install @covalenthq/client-sdk ``` Connect via WebSocket at `wss://streaming.goldrushdata.com/graphql` with your API key. See **DEX firehose** and **PumpFun launchpad** for the full patterns. *** ## 3. Pipe SPL transfers to your warehouse Stream decoded SPL transfers (Token Program + Token-2022) into ClickHouse, BigQuery, Postgres, Kafka, or S3 with one config - no ETL on your side. **Create a pipeline** In the [GoldRush Platform](https://goldrush.dev/platform/), navigate to **Manage Pipelines** and click **Create Pipeline**. **Pick Solana + Transfers** Choose **Solana** as the chain and **Transfers** as the data type. **Choose your destination** Connect ClickHouse, BigQuery, Postgres, Kafka, S3/GCS/R2, SQS, or a Webhook. **Deploy** Decoded transfers begin flowing within seconds. Full walkthrough with sample SQL: **Solana SPL Transfers normalizer**. *** ## What's next ### Foundational endpoints Per-category walkthroughs for wallet, transactions, NFT, pricing, and Solana-native primitives. ### DEX firehose Real-time new pool discovery across Raydium / Orca / Meteora / Jupiter / PumpFun. ### PumpFun launchpad Track bonding curves and Raydium graduations in real time. ### Roadmap What's shipping next - Jito bundles, validator rewards, IDL coverage. *** # Roadmap GoldRush for Solana ships in phases. This page tracks what is live today and what is on deck. ## Live today | Surface | What ships now | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Foundational - Tier 1** | Wallet (SPL + Token-2022 balances, historical balances by slot, SPL transfers, portfolio over time, token holders), Transactions (by signature, paginated history, summary), and cross-chain endpoints (`get-allchains-balances`, `get-address-activity`) extended to include `solana-mainnet`. | | **Foundational - Tier 2** | NFTs (Metaplex Token Metadata + Bubblegum cNFTs, ownership checks), historical token prices and pool spot prices (Raydium / Orca / Meteora), block and slot lookup. | | **Streaming** | `newDexPairs`, `ohlcvCandlesForPair`, `ohlcvCandlesForToken`, `walletTxs`, plus update streams - all on `SOLANA_MAINNET`. | | **Pipeline** | Solana normalizers: `swaps` (DEX trades across protocols), `transfers` (SPL Token + Token-2022), and PumpFun lifecycle (`sol_pf_create`, `sol_pf_swap`, `sol_pf_complete`, `sol_pf_withdraw`). | See the **Foundational overview** for the full live endpoint catalog. *** ## Next: Solana-native endpoints (Tier 3) Endpoints with no EVM analog, addressed under the same Foundational base URL. Each gets its own design doc and ships independently as the underlying indexer support lands. | Endpoint | What it adds | Status | | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----------- | | Anchor IDL fetch (`/program/{programId}/idl/`) | Decoded program instructions, sourced from on-chain IDL accounts plus a curated registry fallback. | In design | | Program log events (`/program/{programId}/log_events/`) | Solana analog of `get-log-events-by-contract-address`. Returns IDL-decoded events for the program. | In design | | Stake accounts (`/address/{walletAddress}/stake_accounts/`) | Per-wallet stake accounts (active, deactivating, withdrawn). | In progress | | Stake rewards (`/address/{walletAddress}/stake_rewards/`) | Historical per-epoch reward attribution by validator. | In progress | | Token-2022 extensions (`/tokens/{tokenMint}/extensions/`) | Transfer fees, interest-bearing rate, confidential transfer state, default account state. | In design | | Validators (`/validators/`) | Vote-account list with stake, commission, last vote, root slot. | In design | | SPL delegations (`/address/{walletAddress}/spl_delegations/`) | SPL `Approve` delegation state - delegate, amount, and revocation tracking. | In design | The Solana-native walkthrough page already enumerates these surfaces - see **Solana-native**. Sections gated as "shipping in \`\`" point at this roadmap. *** ## Then: deeper market structure Capabilities aimed at MEV searchers, trading firms, and high-frequency analytics: * **Jito bundle and tip data** - per-slot bundle attribution, tip amounts, and bundle-internal ordering. * **MEV firehose** - decoded sandwich, arbitrage, and back-running classifications in the Streaming and Pipeline surfaces. * **Expanded validator coverage** - per-leader performance, epoch boundary attestations, vote latency. * **Program IDL coverage for the top 50 programs** - decoded instructions and events out of the box, ahead of generic IDL fetch. *** ## Best-in-class differentiators Solana-specific extensions to what GoldRush already does on EVM: | Capability | What it adds | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Slot-aware time-travel | Any `historical_balances` / `portfolio_v2` request accepts both `slot` and `block_time` indexing - critical because \~5% of Solana slots are skipped. | | ALT pre-resolution | Versioned transactions (`v0`) reference accounts via Address Lookup Tables. GoldRush pre-resolves the full account list at index time so clients see no opaque indices. | | Token-2022 first-class | Every balance/transfer/holder response aggregates Token Program + Token-2022 by default; opt out with `?include-token-2022=false`. | | Recommended priority fee | Endpoint returns 10/50/90th percentile priority fees in micro-lamports per CU over the last N slots. | | cNFT (Bubblegum) coverage | Compressed NFTs surface in `balances_nft/` alongside Metaplex Token Metadata NFTs, disambiguated by `compressed: true`. | *** ## Have a request? Need an endpoint, decoded program, or capability that isn't on this list? **Email us** - we prioritize against real customer use cases.