Solana API Quickstart - GoldRush API Documentation

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 -X GET "https://api.covalenthq.com/v1/solana-mainnet/address/4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY/balances_v2/" \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY"

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.

​Prerequisites