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’s coverage on Solana today spans these primitives:
- SPL token balances for any wallet - Foundational REST.
- New DEX pairs decoded in real time - Streaming
newPairs. - Wallet activity for arbitrary wallets in real time - Streaming
walletTxs. - OHLCV candles for pools and tokens in real time - Streaming
ohlcvCandlesForPairandohlcvCandlesForToken. - DEX swaps decoded, landed in your warehouse - Pipeline
swapsnormalizer. - SPL token transfers decoded, landed in your warehouse - Pipeline
transfersnormalizer.
Foundational API
REST endpoint for SPL token balances onsolana-mainnet. Base58 addresses.
Real-time Streaming
newPairs, walletTxs, and OHLCV subscriptions on SOLANA_MAINNET.
Pipeline to your warehouse
Decodedswaps and transfers to ClickHouse, BigQuery, Postgres, Kafka, S3, or webhooks.
GoldRush vs Solana RPC
What GoldRush adds on top of plain Solana RPC.What’s included
Quickstart
Look up a Solana wallet
SPL token balances and native SOL for any base58 address.Stream new DEX pairs
New pool events via thenewPairs subscription on SOLANA_MAINNET.
Pipe SPL transfers to a warehouse
Land decoded SPL 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 SPL token balances
Get SPL token balances and native SOL for any base58 wallet address.cURL
TypeScript
Python
contract_address as the base58 mint pubkey, contract_decimals from the Mint account, and USD quote where pricing is available.
Foundational on Solana walkthrough
SPL token balance details and request shape.2. Stream new DEX pairs
Subscribe to new DEX pairs on Solana over a WebSocket.GraphQL Subscription
wss://streaming.goldrushdata.com/graphql with your API key. See DEX firehose for the full pattern.
3. Pipe SPL transfers to your warehouse
Stream decoded SPL token transfers into ClickHouse, BigQuery, Postgres, Kafka, or S3. 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. The companionSwaps data type for decoded DEX trades is also available.
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: SPL Transfers warehouse recipe and DEX Swaps warehouse recipe.
What’s next
Foundational endpoints
SPL token balances onsolana-mainnet.
DEX firehose
newPairs subscription on SOLANA_MAINNET.
Wallet activity
walletTxs subscription on SOLANA_MAINNET.