Skip to main content

GoldRush API for Solana - Overview

Quick Reference

ItemValue
Foundational base URLhttps://api.covalenthq.com/v1/solana-mainnet/...
Streaming WebSocket URLwss://streaming.goldrushdata.com/graphql
AuthenticationAuthorization: Bearer <GOLDRUSH_API_KEY> (same key for all surfaces)
REST chain namesolana-mainnet (kebab-case)
Streaming chain enumSOLANA_MAINNET (SCREAMING_SNAKE_CASE)
Wallet address formatbase58, 32-44 chars, case-preserved
Transaction idsignature (base58, ~88 chars)
Block identifierslot (primary) / block_height (secondary, ~5% gaps) / block_time (unix seconds)
Native unitlamports (1 SOL = 10^9 lamports)
Default commitmentconfirmed (~1s). finalized (~13s) via ?commitment=finalized

Surfaces

SurfaceWhat it provides
Foundational APIREST 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 APIReal-time newPairs (DEX firehose across Raydium / Orca / Meteora / Jupiter / PumpFun), ohlcvCandlesForPair, ohlcvCandlesForToken, walletTxs.
Pipeline APIDecoded 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 ohlcvCandlesForPair and ohlcvCandlesForToken.
  • DEX swaps decoded, landed in your warehouse - Pipeline swaps normalizer.
  • SPL token transfers decoded, landed in your warehouse - Pipeline transfers normalizer.

Foundational API

REST endpoint for SPL token balances on solana-mainnet. Base58 addresses.

Real-time Streaming

newPairs, walletTxs, and OHLCV subscriptions on SOLANA_MAINNET.

Pipeline to your warehouse

Decoded swaps 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 the newPairs 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
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

SPL token balance details and request shape.

2. Stream new DEX pairs

Subscribe to new DEX pairs on Solana over a WebSocket.
GraphQL Subscription
subscription {
  newPairs(chain_name: SOLANA_MAINNET) {
    block_signed_at
    protocol
    pair_address
    base_token { contract_address contract_ticker_symbol contract_decimals }
    quote_token { contract_address contract_ticker_symbol contract_decimals }
    liquidity
  }
}
Connect via WebSocket at 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 companion Swaps 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 on solana-mainnet.

DEX firehose

newPairs subscription on SOLANA_MAINNET.

Wallet activity

walletTxs subscription on SOLANA_MAINNET.

OHLCV markets

Real-time OHLCV candles by pool or token.

DEX swaps to your warehouse

Decoded swaps via the Pipeline API.

SPL transfers to your warehouse

Decoded SPL transfers via the Pipeline API.

GoldRush vs Solana RPC

What GoldRush adds on top of plain Solana RPC.

Roadmap