> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> GoldRush API for Solana. Use this skill whenever the user wants SPL token balances for a Solana wallet (REST); real-time new DEX pair events (`newPairs`), wallet activity (`walletTxs`), or OHLCV candles (`ohlcvCandlesForPair` / `ohlcvCandlesForToken`) on `SOLANA_MAINNET` via GraphQL streaming; or decoded DEX swaps and SPL token transfers landed in a warehouse (ClickHouse/BigQuery/Postgres/Kafka/S3). REST is at `https://api.covalenthq.com/v1/solana-mainnet/...` (kebab-case chain name); GraphQL Streaming uses `SOLANA_MAINNET` (SCREAMING_SNAKE_CASE). SPL transfer history is NOT on the Foundational REST API for Solana - use the warehouse `transfers` normalizer instead. Solana transactions, NFTs (Metaplex + Bubblegum cNFTs), and token pricing REST endpoints are NOT supported on Solana today. For non-Solana chain data, use goldrush-foundational-api. For real-time streams on any chain, use goldrush-streaming-api. For warehouse delivery on any chain, use goldrush-pipeline-api. For Hyperliquid specifically, use goldrush-hyperliquid.

# SKILL

# GoldRush API for Solana

GoldRush's Solana coverage today:

* **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)

```bash theme={null}
curl https://api.covalenthq.com/v1/solana-mainnet/address/4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY/balances_v2/ \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY"
```

### New-pair firehose (Streaming)

```graphql theme={null}
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)

```graphql theme={null}
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)

```graphql theme={null}
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)

In the platform, create a pipeline with chain `Solana` and data type `Swaps` or `Transfers`. Pick ClickHouse / BigQuery / Postgres / Kafka / S3 as the destination. Decoded rows begin flowing within seconds.

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

| Need                                                                      | Use                                                  |
| ------------------------------------------------------------------------- | ---------------------------------------------------- |
| SPL token balances for a wallet                                           | Foundational `get-token-balances-for-address`        |
| Real-time new DEX pair events                                             | Streaming `newPairs` on `SOLANA_MAINNET`             |
| Real-time wallet activity (swaps + transfers)                             | Streaming `walletTxs` on `SOLANA_MAINNET`            |
| Real-time OHLCV for a pool                                                | Streaming `ohlcvCandlesForPair` on `SOLANA_MAINNET`  |
| Real-time OHLCV aggregated for a token                                    | Streaming `ohlcvCandlesForToken` on `SOLANA_MAINNET` |
| Decoded DEX swaps in a warehouse                                          | Pipeline `swaps` normalizer                          |
| Decoded SPL transfers in a warehouse                                      | Pipeline `transfers` normalizer                      |
| SPL transfer history via REST / Solana transactions / NFTs / pricing REST | Not supported on Solana today                        |

## Agent routing

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

## Reference Files

| File                                          | When to read                                                         |
| --------------------------------------------- | -------------------------------------------------------------------- |
| [overview.md](references/overview.md)         | Product overview for Solana                                          |
| [foundational.md](references/foundational.md) | REST reference for SPL balances on Solana                            |
| [streaming.md](references/streaming.md)       | Streaming reference for `newPairs`, `walletTxs`, and OHLCV on Solana |