Skip to content

Revise GoldRush API Integration documentation #451

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
alexander-sei merged 3 commits into from
Nov 8, 2025
Merged

Revise GoldRush API Integration documentation #451

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
566c744
Revise GoldRush API Integration documentation
zeeshan8281 Nov 7, 2025
29e82ca
polish up tutorial
alexander-sei Nov 7, 2025
d191d84
fix links
alexander-sei Nov 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
264 changes: 158 additions & 106 deletions content/evm/indexer-providers/goldrush.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,118 +4,170 @@ description: 'Learn how to integrate GoldRush indexing services with Sei network
keywords: ['goldrush', 'blockchain indexing', 'api integration', 'data analysis']
---

import { ImageWithCaption } from '../../../src/components';
import { Callout } from 'nextra/components';

import imgWalletUiComponent from '../../../public/assets/ecosystem/resources/goldrush/wallet_ui_component.png';
import { IconCode, IconChevronRight } from '@tabler/icons-react';

# GoldRush - powered by Covalent

[GoldRush](https://goldrush.dev/?utm_source=sei&utm_medium=partner-docs) is a
set foundational multichain data APIs and toolkits for easy web3 development
across [100+ supported blockchains](https://goldrush.dev/docs/networks/?utm_source=sei&utm_medium=partner-docs),
including Sei mainnet (EVM only). GoldRush offers structured onchain data,
including token balances, transactions and event logs through powerful APIs,
SDKs and UI Kits for building dapps.

<Callout type="info">[Sign up to start building on Sei](https://goldrush.dev/platform/?utm_source=sei&utm_medium=partner-docs)</Callout>

## APIs

The GoldRush APIs enable developers to quickly and easily access structured
onchain data. This means consistent response schemas that are blockchain
agnostic. Available APIs and corresponding use cases include:

### Wallet API

- **Features:** All token balances (ERC20, 721, 1155, native), token transfers
and prices (spot and historical) for a wallet.
- **Use cases:**
[Wallets, portfolio trackers](https://goldrush-wallet-portfolio-ui.vercel.app/?utm_source=sei&utm_medium=partner-docs),
token gating, airdrop snapshots.

### Transactions API

- **Features:** All historical transactions with human-readable log events.
Includes gas usage/spend summaries.
- **Use cases:** [Accounting and tax tools](https://bit.ly/crypto-tax-tool),
branded in-app
[transaction receipts](https://goldrush-dfk-tx-receipt-ui.vercel.app/tx/defi-kingdoms-mainnet/0x4e5c0af28b2cea27d06677fae1f573572e0ff863c43ae42d2959ca67b90c4390/?utm_source=sei&utm_medium=partner-docs).

### Cross-Chain Activity API

- **Features:** Single API call to fetch a list of active chains and the latest
transaction date on each for an address.
- **Use cases:**
[App onboarding](https://goldrush-wallet-portfolio-ui.vercel.app/activity/0x6d68A318D0632f7B9Ce9d6757Dea0e9dE19D7CCA/?utm_source=sei&utm_medium=partner-docs).

### Security API

- **Features:** NFT and ERC20 token allowances, including value-at-risk.
- **Use cases:**
[Revoke features](https://goldrush-revokehub.vercel.app/?utm_source=sei&utm_medium=partner-docs)
in wallets, security applications.

### Blockchain API

- **Features:** Block details, log events by contract address or topic hash, gas
prices, token prices and holders.
- **Use cases:**
[Custom block explorers](https://goldrush-block-explorer-ui.vercel.app/?utm_source=sei&utm_medium=partner-docs).

## Developer Tools

There are 4 primary developer tools for using the APIs:

1. [GoldRush APIs](https://goldrush.dev/docs/api) - enterprise-grade REST APIs
to use with any programming language. Switch blockchains with one path
parameter.

```sh copy
curl -X GET https://api.covalenthq.com/v1/sei-mainnet/address/0x6d68A318D0632f7B9Ce9d6757Dea0e9dE19D7CCA/balances_v2/ \
-H 'Content-Type: application/json' \
-u YOUR_API_KEY:
```

2. [GoldRush SDKs](https://goldrush.mintlify.app/docs/goldrush-sdks?utm_source=sei&utm_medium=partner-docs) -
official client libraries including TypeScript and Python.

```sh copy
npm install @covalenthq/client-sdk
```

```ts copy
import { GoldRushClient } from '@covalenthq/client-sdk';

(async () => {
try {
const client = new GoldRushClient('YOUR_API_KEY');
const transactions = client.TransactionService.getAllTransactionsForAddress('sei-mainnet', '0x6d68A318D0632f7B9Ce9d6757Dea0e9dE19D7CCA');

for await (const tx of transactions) {
console.log('tx', tx);
}
} catch (error) {
console.log(error.message);
}
})();
```

3. [GoldRush UI Kit](https://github.com/covalenthq/goldrush-kit/?utm_source=sei&utm_medium=partner-docs) -
beautifully designed React components for your dApp frontend.

<ImageWithCaption img={imgWalletUiComponent} alt="GoldRush UI Kit Wallet Component" caption="Example of a Wallet Component using the GoldRush UI Kit" />

4. [GoldRush Decoder](https://github.com/covalenthq/goldrush-decoder/?utm_source=sei&utm_medium=partner-docs) -
decode any raw event logs into human-readable structured data.

## Get started

- [API Key](https://goldrush.dev/platform/auth/register/?utm_source=sei&utm_medium=partner-docs) -
sign up for free
- [Docs](https://goldrush.dev/docs/?utm_source=sei&utm_medium=partner-docs) -
## Overview

GoldRush offers the most comprehensive Sei Data API suite for developers, analysts, and enterprises. Whether you're
building a DeFi dashboard, a wallet, a trading bot, an AI agent or a compliance platform,
our Sei Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need.

### Supported APIs

| **Product Name** | **Description** | **Key Data Feeds** | **Use Cases** |
| -------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Foundational API** | Access structured historical blockchain data across 100+ chains via REST APIs | <ul><li>Token balances (spot & historical)</li><li>Token transfers</li><li>Token holders (spot & historical)</li><li>Token prices (onchain)</li><li>Wallet transactions</li><li>Get logs</li></ul> | <ul><li>Wallets</li><li>Portfolio trackers</li><li>Crypto accounting & tax tools</li><li>DeFi dashboards</li><li>Activity feeds</li></ul> |

## Mainnet

<div className="rounded-xl border border-neutral-200/50 dark:border-neutral-800/50 p-4">
<div style={{ width: '100%', margin: '-16px', padding: '0' }}>
<table style={{ width: '100%', margin: '0', borderCollapse: 'collapse' }}>
<thead style={{ width: '100%' }}>
<tr>
<th style={{ textAlign: 'left', padding: '12px 16px' }}>
<strong>Property</strong>
</th>
<th style={{ textAlign: 'left', padding: '12px 16px', width: '500px' }}>
<strong>Value</strong>
</th>
</tr>
</thead>
<tbody>
<tr>
<td style={{ padding: '12px 16px' }}>
<strong>Chain Name</strong>
</td>
<td style={{ padding: '12px 16px' }}>
<code>sei-mainnet</code>
</td>
</tr>
<tr>
<td style={{ padding: '12px 16px' }}>
<strong>Chain ID</strong>
</td>
<td style={{ padding: '12px 16px' }}>
<code>1329</code>
</td>
</tr>
<tr>
<td style={{ padding: '12px 16px' }}>
<strong>Network Type</strong>
</td>
<td style={{ padding: '12px 16px' }}>Frontier Chain</td>
</tr>
<tr>
<td style={{ padding: '12px 16px' }}>
<strong>Support Level</strong>
</td>
<td style={{ padding: '12px 16px' }}>frontier</td>
</tr>
<tr>
<td style={{ padding: '12px 16px' }}>
<strong>Block Explorer</strong>
</td>
<td style={{ padding: '12px 16px' }}>
<a href="https://seistream.app/">Explorer</a>
</td>
</tr>
<tr>
<td style={{ padding: '12px 16px' }}>
<strong>Official Website</strong>
</td>
<td style={{ padding: '12px 16px' }}>
<a href="https://www.sei.io/">Sei Website</a>
</td>
</tr>
<tr>
<td style={{ padding: '12px 16px' }}>
<strong>Native Gas Token</strong>
</td>
<td style={{ padding: '12px 16px' }}>SEI</td>
</tr>
</tbody>
</table>
</div>
</div>

## API Usage

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

#### Chain Name

- `sei-mainnet` (mainnet)

#### Example API Calls (bash)

```bash
curl -X GET "https://api.covalenthq.com/v1/sei-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY"
```

### SDK Usage (TypeScript)

```ts
import { GoldRushClient } from '@covalenthq/client-sdk';

const client = new GoldRushClient('API_KEY');

const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
chainName: 'sei-mainnet',
walletAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
});
```

## Foundational API Support

This chain supports **34** GoldRush Foundational APIs:

#### Wallet API

- **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address)**
- **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance)**
- **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time)**
- **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address)**

#### Pricing API

- **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices)**

#### Security API

- **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address)**

#### Activity Feed API

- **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction)**
- **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address)**
- **[Get earliest transactions for address (v3) ](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3)**
- **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3)**
- **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3)**
- **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3)**
- **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block)**
- **[Get all transactions in a block by page (v3) ](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page)**

#### Block Explorer API

- **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block)**
- **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses)**
- **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains)**
- **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights)**
- **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices)**
- **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address)**
- **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash)**
- **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs)**

## Additional Resources

- [Goldrush Docs](https://goldrush.dev/docs/?utm_source=sei&utm_medium=partner-docs) -
comprehensive knowledge base for all things GoldRush including a quickstart
- [Sei Network Details](https://goldrush.dev/chains/sei/?utm_source=sei&utm_medium=partner-docs) -
setup details and supported APIs for Sei
- [Guides](https://goldrush.dev/guides/?utm_source=sei&utm_medium=partner-docs) -
learn how to build for various use cases and expand your onchain knowledge
- [API Reference](https://goldrush.dev/docs/api-reference/)
- [API Key](https://goldrush.dev/platform/auth/register/?utm_source=sei&utm_medium=partner-docs) -
sign up for free