> ## 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), plus historical decoded swaps and SPL transfers delivered to your warehouse.

export const AdditionalResources = () => <ul>
    <li>
      <a href="/docs/goldrush-solana/overview">GoldRush API for Solana - overview</a>
    </li>
    <li>
      <a href="/docs/goldrush-solana/foundational/overview">
        Foundational endpoints on Solana
      </a>
    </li>
    <li>
      <a href="/docs/goldrush-solana/warehouse/dex-swaps">Decoded DEX swaps recipe</a>
    </li>
    <li>
      <a href="/docs/goldrush-solana/warehouse/spl-transfers">
        Decoded SPL transfers recipe
      </a>
    </li>
    <li>
      <a href="/docs/resources/differentiate-your-solana-app">
        GoldRush vs Solana RPC
      </a>
    </li>
    <li>
      <a href="/docs/chains/overview">Supported Chains</a>
    </li>
  </ul>;

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) and <strong>historical</strong> decoded DEX swaps
      and SPL transfers (warehouse) on <code>solana-mainnet</code>. See the
      dedicated <a href="/docs/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>Decoded DEX swaps</strong> - warehouse{" "}
        <code>swaps</code> table.
      </li>
      <li>
        <strong>Decoded SPL transfers</strong> - warehouse{" "}
        <code>transfers</code> table.
      </li>
    </ul>

    <h3>Supported APIs</h3>
    <Columns cols={2}>
      <Card title="Full Solana product suite" icon="/images/icons/foundational.svg" href="/docs/goldrush-solana/overview" cta="Read docs">
        Aggregated entry point for GoldRush on Solana - SPL balances and decoded
        DEX swaps.
      </Card>
      <Card title="Foundational API" icon="/images/icons/foundational.svg" href="/docs/goldrush-solana/foundational/overview" cta="Read docs">
        REST endpoint for SPL token balances on{" "}
        <code>solana-mainnet</code>.
      </Card>
    </Columns>
  </>;

export const FoundationalApiSupport = () => <>
    See the dedicated <a href="/docs/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="/docs/goldrush-solana/overview">
    GoldRush is the complete data layer for Solana - REST (Foundational) and warehouse delivery 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`                         |
| **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` (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 />

## JSON-RPC

Solana is available on the GoldRush JSON-RPC service. Point your existing Solana tooling (`@solana/web3.js` or raw HTTP) at the GoldRush endpoint — the standard Solana JSON-RPC method set is supported over HTTP, with live subscriptions over WebSocket.

#### Endpoint

```
https://rpc.goldrushdata.com/v1/solana-mainnet
```

WebSocket subscriptions are available at `wss://rpc.goldrushdata.com/v1/solana-mainnet`.

#### Example JSON-RPC Calls

<CodeGroup>
  ```bash getSlot theme={null}
  curl https://rpc.goldrushdata.com/v1/solana-mainnet \
    -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","id":1,"method":"getSlot","params":[]}'
  ```

  ```bash getBalance theme={null}
  curl https://rpc.goldrushdata.com/v1/solana-mainnet \
    -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","id":1,"method":"getBalance","params":["4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY"]}'
  ```
</CodeGroup>

#### Sample Methods

* **[getSlot on Solana](/docs/api-reference/json-rpc/solana/getslot)**
* **[getBalance on Solana](/docs/api-reference/json-rpc/solana/getbalance)**
* **[getBlock on Solana](/docs/api-reference/json-rpc/solana/getblock)**
* **[getTransaction on Solana](/docs/api-reference/json-rpc/solana/gettransaction)**
* **[getSignaturesForAddress on Solana](/docs/api-reference/json-rpc/solana/getsignaturesforaddress)**

See the [full method list and per-method examples for Solana](/docs/api-reference/json-rpc/chains/solana).

## Additional Resources

<AdditionalResources />