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

# Solana Onchain Data API

> Solana data API - indexed SPL token balances (REST), a real-time DEX firehose (Raydium / Orca / Meteora / Jupiter / PumpFun) with OHLCV candles, plus historical decoded swaps and SPL transfers delivered to your warehouse.

export const AdditionalResources = () => <ul>
    <li>
      <a href="/goldrush-solana/overview">GoldRush API for Solana - overview</a>
    </li>
    <li>
      <a href="/goldrush-solana/foundational/overview">
        Foundational endpoints on Solana
      </a>
    </li>
    <li>
      <a href="/goldrush-solana/streaming/dex-firehose">DEX firehose recipe</a>
    </li>
    <li>
      <a href="/goldrush-solana/streaming/wallet-activity">
        Wallet activity recipe
      </a>
    </li>
    <li>
      <a href="/goldrush-solana/streaming/ohlcv-markets">OHLCV markets recipe</a>
    </li>
    <li>
      <a href="/goldrush-pipeline-api/normalizers/solana">
        Pipeline Solana normalizers
      </a>
    </li>
    <li>
      <a href="/resources/differentiate-your-solana-app">
        GoldRush vs Solana RPC
      </a>
    </li>
    <li>
      <a href="/chains/overview">Supported Chains</a>
    </li>
  </ul>;

export const StreamingApiSupport = () => <>
    <p>
      The Streaming API uses <code>SOLANA_MAINNET</code> (SCREAMING_SNAKE_CASE)
      as the chain enum (distinct from the Foundational API's{" "}
      <code>solana-mainnet</code>).
    </p>

    <table>
      <thead>
        <tr>
          <th>Stream</th>
          <th>Notes</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>New DEX Pairs Stream (<code>newPairs</code>)</td>
          <td>
            New DEX pair events on <code>SOLANA_MAINNET</code>. Filter
            client-side on the <code>protocol</code> field to scope to a
            particular venue.
          </td>
        </tr>
        <tr>
          <td>Wallet Activity Stream (<code>walletTxs</code>)</td>
          <td>
            Pass an array of base58 wallet pubkeys; receive transactions with{" "}
            <code>decoded_details</code> as a <code>SwapTransaction</code> or{" "}
            <code>TransferTransaction</code> union member.
          </td>
        </tr>
        <tr>
          <td>OHLCV Pairs Stream (<code>ohlcvCandlesForPair</code>)</td>
          <td>
            Subscribe by base58 pool address(es) for real-time candles per pool.
          </td>
        </tr>
        <tr>
          <td>OHLCV Tokens Stream (<code>ohlcvCandlesForToken</code>)</td>
          <td>
            Subscribe by SPL mint(s) for aggregated candles across pools carrying
            that token.
          </td>
        </tr>
      </tbody>
    </table>
  </>;

export const Overview = () => <>
    <p>
      GoldRush is an indexed <strong>Solana data API</strong>: it serves
      decoded, typed Solana data - balances, DEX markets, and wallet activity -
      so you skip raw RPC round-trips and per-protocol decoders. Solana's fast
      block times and low fees make it a common chain of choice for trading,
      memecoin discovery, gaming, and consumer applications.
    </p>
    <p>
      <strong>Data coverage:</strong> GoldRush covers SPL token balances
      (REST); new DEX pair events, wallet activity, and OHLCV candles
      (real-time streaming); and <strong>historical</strong> decoded DEX swaps
      and SPL transfers (warehouse) on <code>solana-mainnet</code>. See the
      dedicated <a href="/goldrush-solana/overview">Solana API</a> tab for the
      full picture.
    </p>

    <h3>What's available today</h3>
    <ul>
      <li>
        <strong>SPL token balances</strong> for any wallet - Foundational REST.
      </li>
      <li>
        <strong>New DEX pair events</strong> - Streaming <code>newPairs</code>{" "}
        on <code>SOLANA_MAINNET</code>.
      </li>
      <li>
        <strong>Wallet activity</strong> for arbitrary wallets - Streaming{" "}
        <code>walletTxs</code> on <code>SOLANA_MAINNET</code>.
      </li>
      <li>
        <strong>OHLCV candles</strong> for pools and tokens - Streaming{" "}
        <code>ohlcvCandlesForPair</code> and{" "}
        <code>ohlcvCandlesForToken</code> on <code>SOLANA_MAINNET</code>.
      </li>
      <li>
        <strong>Decoded DEX swaps</strong> - Pipeline (warehouse){" "}
        <code>swaps</code> normalizer.
      </li>
      <li>
        <strong>Decoded SPL transfers</strong> - Pipeline (warehouse){" "}
        <code>transfers</code> normalizer.
      </li>
    </ul>

    <h3>Supported APIs</h3>
    <Columns cols={2}>
      <Card title="Full Solana product suite" icon="/images/icons/foundational.svg" href="/goldrush-solana/overview" cta="Read docs">
        Aggregated entry point for GoldRush on Solana - SPL balances, new DEX
        pair streaming, and decoded DEX swaps.
      </Card>
      <Card title="Foundational API" icon="/images/icons/foundational.svg" href="/goldrush-solana/foundational/overview" cta="Read docs">
        REST endpoint for SPL token balances on{" "}
        <code>solana-mainnet</code>.
      </Card>
      <Card title="Streaming API" icon="/images/icons/streaming.svg" href="/goldrush-solana/streaming/dex-firehose" cta="Read docs">
        <code>newPairs</code>, <code>walletTxs</code>, and OHLCV subscriptions
        (<code>ohlcvCandlesForPair</code> and <code>ohlcvCandlesForToken</code>) on{" "}
        <code>SOLANA_MAINNET</code>.
      </Card>
      <Card title="Pipeline API" icon="/images/icons/pipeline.svg" href="/goldrush-pipeline-api/normalizers/solana" cta="Read docs">
        Decoded <code>swaps</code> and <code>transfers</code> landed in
        ClickHouse, BigQuery, Postgres, Kafka, or S3.
      </Card>
    </Columns>
  </>;

export const FoundationalApiSupport = () => <>
    See the dedicated <a href="/goldrush-solana/foundational/overview">Foundational on Solana</a> walkthrough for the full endpoint surface, organized by category (Wallet, Transactions, NFT, Pricing, Solana-native).
  </>;

export const IntroCard = () => <Card title="Full Solana product suite →" icon="bolt" href="/goldrush-solana/overview">
    GoldRush is the complete data layer for Solana - REST (Foundational), real-time (Streaming), and warehouse delivery (Pipeline) under one API key. Open the dedicated Solana tab for the full product story.
  </Card>;

<IntroCard />

## Overview

<Tip>
  Solana delivers 400ms block times and sub-cent transaction fees, making it the chain of choice for high-frequency trading, gaming, PumpFun memecoin discovery, and consumer applications at scale.
</Tip>

<Overview />

## Mainnet

| Property             | Value                                                                  |
| -------------------- | ---------------------------------------------------------------------- |
| **Chain Name**       | `solana-mainnet` (Foundational API) / `SOLANA_MAINNET` (Streaming API) |
| **Chain ID**         | `1399811149`                                                           |
| **Network Type**     | Frontier Chain                                                         |
| **Support Level**    | frontier                                                               |
| **Block Explorer**   | [Explorer](https://explorer.solana.com/)                               |
| **Official Website** | [Solana Website](https://solana.com/)                                  |
| **Native Gas Token** | SOL                                                                    |

## API Usage

To use this blockchain network in GoldRush API calls, use:

#### Chain Name

* `solana-mainnet` / `SOLANA_MAINNET` (mainnet)

#### Example API Calls

<CodeGroup>
  ```bash Chain Name (Mainnet) theme={null}
  curl -X GET "https://api.covalenthq.com/v1/solana-mainnet/address/4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY/balances_v2/?key=<GOLDRUSH_API_KEY>"
  ```
</CodeGroup>

#### SDK Usage

<CodeGroup>
  ```typescript TypeScript SDK (Mainnet) theme={null}
  import { GoldRushClient } from "@covalenthq/client-sdk";

  const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
  const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
      chainName: "solana-mainnet",
      walletAddress: "4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY"
  });
  ```
</CodeGroup>

## Foundational API Support

<FoundationalApiSupport />

## Streaming API Support

This chain supports **8** GoldRush Streaming APIs:

* [New DEX Pairs Stream](/api-reference/streaming-api/subscriptions/new-dex-pairs-stream/)
* [OHLCV Pairs Stream](/api-reference/streaming-api/subscriptions/ohlcv-pairs-stream/)
* [OHLCV Tokens Stream](/api-reference/streaming-api/subscriptions/ohlcv-tokens-stream/)
* [Update Pairs Stream](/api-reference/streaming-api/subscriptions/update-pairs-stream/)
* [Update Tokens Stream](/api-reference/streaming-api/subscriptions/update-tokens-stream/)
* [OHLCV Pairs Query](/api-reference/streaming-api/queries/ohlcv-pairs-query/)
* [OHLCV Tokens Query](/api-reference/streaming-api/queries/ohlcv-tokens-query/)
* [Token Search Query](/api-reference/streaming-api/queries/token-search-query/)

<StreamingApiSupport />

## Pipeline API Support

This chain supports **2** GoldRush Pipeline API data objects that can be streamed to your infrastructure:

* [DEX Swaps](/goldrush-pipeline-api/supported-chains#solana)
* [SPL Token Transfers](/goldrush-pipeline-api/supported-chains#solana)

## Additional Resources

<AdditionalResources />