​

GoldRush API for Solana

• SPL token balances for any wallet - Foundational REST.
• New DEX pairs decoded in real time - Streaming newPairs on SOLANA_MAINNET.
• Wallet activity for arbitrary wallets in real time - Streaming walletTxs on SOLANA_MAINNET.
• OHLCV candles for pools and tokens - Streaming ohlcvCandlesForPair and ohlcvCandlesForToken on SOLANA_MAINNET.
• DEX swaps decoded - Pipeline swaps normalizer (warehouse).
• SPL token transfers decoded - Pipeline transfers normalizer (warehouse).

​

Not supported on Solana today

• SPL token transfer history on the Foundational REST API (use the warehouse transfers normalizer instead).
• Solana transactions (signature lookup, paginated history, summary).
• NFTs (Metaplex Token Metadata, Bubblegum compressed NFTs).
• Token pricing REST endpoints (historical or pool spot).
• Solana-native primitives (stake, validators, IDL, Token-2022 extensions, SPL delegations).
• PumpFun-specific lifecycle tables.

​

Quick examples

​

Token balances (REST)

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

​

New-pair firehose (Streaming)

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

​

Wallet activity (Streaming)

subscription {
  walletTxs(
    wallet_addresses: ["4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY"]
    chain_name: SOLANA_MAINNET
  ) {
    tx_hash
    block_signed_at
    successful
    decoded_details {
      typeString
      ... on SwapTransaction {
        amount_in amount_out
        token_in { contract_address contract_ticker_symbol contract_decimals }
        token_out { contract_address contract_ticker_symbol contract_decimals }
      }
      ... on TransferTransaction {
        amount from to quote_usd
        contract_metadata { contract_address contract_ticker_symbol contract_decimals }
      }
    }
  }
}

​

OHLCV candles (Streaming)

subscription {
  ohlcvCandlesForPair(
    chain_name: SOLANA_MAINNET
    pair_addresses: ["<base58-pool-address>"]
    interval: ONE_MINUTE
    timeframe: ONE_HOUR
  ) {
    pair_address timestamp open high low close volume_usd
  }
}

​

Decoded swaps and SPL transfers to a warehouse (Pipeline)

​

Critical rules

1. Chain name (REST) - solana-mainnet (kebab-case). Used in Foundational API paths: /v1/solana-mainnet/....
2. Chain enum (Streaming) - SOLANA_MAINNET (SCREAMING_SNAKE_CASE). Used in GraphQL: chain_name: SOLANA_MAINNET. Not interchangeable with the REST kebab-case form.
3. Wallet address format - base58, 32-44 chars, case-preserved (unlike EVM 0x-hex which is lowercased).
4. Token mint - base58 mint pubkey. USDC = EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. Wrapped SOL = So11111111111111111111111111111111111111112.
5. Native unit - lamports. 1 SOL = 10⁹ lamports.

​

Decision matrix

​

Agent routing

• For Solana-specific REST / Streaming / Pipeline questions → this skill.
• For the same products on a different chain → goldrush-foundational-api, goldrush-streaming-api, or the broader docs.
• For Hyperliquid (HyperCore + HyperEVM) → goldrush-hyperliquid.
• For x402 (pay-per-request) → goldrush-x402.
• For the CLI / MCP wrappers → goldrush-cli.

​

Reference Files