Solana API Quickstart

Two quickstarts for Solana on GoldRush: SPL token balances (REST) and DEX swaps to a warehouse.

Pick the path that matches what you’re building. Both 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"

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})`);
}

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. Pipe SPL transfers to your warehouse

Stream decoded SPL token transfers into ClickHouse, BigQuery, Postgres, Kafka, or S3.

1. Create a pipeline

   In the GoldRush Platform, navigate to Manage Pipelines and click Create Pipeline.

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

3. Choose your destination

   Connect ClickHouse, BigQuery, Postgres, Kafka, S3/GCS/R2, SQS, or a Webhook.

4. 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 swaps to your warehouse

Decoded DEX swaps landed in your warehouse.

SPL transfers to your warehouse

Decoded SPL transfers landed in your warehouse.

GoldRush vs Solana RPC

What GoldRush adds on top of plain Solana RPC.