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 <GOLDRUSH_API_KEY>` (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.

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.

cURL

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

TypeScript

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

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.

GoldRush SDK

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 Subscription

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

Install

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

​GoldRush API for Solana - Overview

​Quick Reference

​Surfaces

​Foundational API

​Real-time Streaming

​Pipeline to your warehouse

​PumpFun discovery

​Solana limitations addressed by GoldRush

​What’s included

​Infrastructure

​Quickstart

​Look up a Solana wallet

​Stream new pumps & DEX pairs

​Pipe SPL transfers to a warehouse

​Prerequisites

​Vibe Coders

​Teams

​1. Look up a Solana wallet

​Foundational on Solana walkthrough

​2. Stream new pumps and DEX pairs

​3. Pipe SPL transfers to your warehouse

​What’s next

​Foundational endpoints

​DEX firehose

​PumpFun launchpad

​Roadmap

​Roadmap

​Live today

​Next: Solana-native endpoints (Tier 3)

​Then: deeper market structure

​Best-in-class differentiators

​Have a request?

GoldRush API for Solana - Overview

Quick Reference

Surfaces

Foundational API

Real-time Streaming

Pipeline to your warehouse

PumpFun discovery

Solana limitations addressed by GoldRush

What’s included

Infrastructure

Quickstart

Look up a Solana wallet

Stream new pumps & DEX pairs

Pipe SPL transfers to a warehouse

Prerequisites

Vibe Coders

Teams

1. Look up a Solana wallet

Foundational on Solana walkthrough

2. Stream new pumps and DEX pairs

3. Pipe SPL transfers to your warehouse

What’s next

Foundational endpoints

DEX firehose

PumpFun launchpad

Roadmap

Roadmap

Live today

Next: Solana-native endpoints (Tier 3)

Then: deeper market structure

Best-in-class differentiators

Have a request?