Skip to content

Getting Started with the GoldRush API

Introduction

GoldRush, formerly known as Covalent, provides structured blockchain data APIs for developers building wallets, dashboards, analytics, and automation tooling. Instead of stitching data from many RPC calls, you can query balances, transactions, token transfers, logs, and chain metadata through REST endpoints.

On Moonbeam networks, GoldRush can be used to read both historical and current on-chain data for Moonbeam, Moonriver, and Moonbase Alpha. This page is a concise integration guide focused on the most common setup values and endpoint groups.

The information presented herein is for informational purposes only and has been provided by third parties. Moonbeam does not endorse any project listed and described on the Moonbeam docs website (https://docs.moonbeam.network/).

Quick Start

To begin using GoldRush, create an API key from the GoldRush dashboard. Requests use the base URL:

https://api.covalenthq.com/v1/

Use the following network values in path parameters:

Parameter Value
chainName moonbeam-mainnet
chainID 1284
Parameter Value
chainName moonbeam-moonriver
chainID 1285
Parameter Value
chainName moonbeam-moonbase-alpha
chainID 1287

API Usage

The following examples show typical request patterns for Moonbeam and Moonriver. Replace INSERT_API_KEY with your GoldRush key and INSERT_WALLET_ADDRESS with a wallet address for your use case. You can use GoldRush through direct HTTP requests or through the TypeScript SDK, which wraps the same API endpoints.

Direct API Calls (curl)

Use these curl requests to quickly validate connectivity and response format before integrating in an application.

curl -X GET "https://api.covalenthq.com/v1/moonbeam-mainnet/address/INSERT_WALLET_ADDRESS/balances_v2/?key=INSERT_API_KEY"
curl -X GET "https://api.covalenthq.com/v1/moonbeam-moonriver/address/INSERT_WALLET_ADDRESS/balances_v2/?key=INSERT_API_KEY"

TypeScript SDK Usage

If you're building a service or frontend, the GoldRush SDK can simplify request construction and response handling.

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

async function main() {
  const client = new GoldRushClient('INSERT_API_KEY');
  const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: 'moonbeam-mainnet',
    walletAddress: 'INSERT_WALLET_ADDRESS',
  });
  console.log(resp);
}

main().catch(console.error);
import { GoldRushClient } from '@covalenthq/client-sdk';

async function main() {
  const client = new GoldRushClient('INSERT_API_KEY');
  const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: 'moonbeam-moonriver',
    walletAddress: 'INSERT_WALLET_ADDRESS',
  });
  console.log(resp);
}

main().catch(console.error);

Supported Foundational API Categories

Moonbeam networks support a broad set of GoldRush Foundational API methods. Commonly used categories are listed in the following sections. For the complete and most current endpoint list, refer to the Foundational API overview and API reference.

Wallet APIs

Activity APIs

Utility and Explorer APIs

Security APIs

Additional Resources

The information presented herein has been provided by third parties and is made available solely for general information purposes. Moonbeam does not endorse any project listed and described on the Moonbeam Doc Website (https://docs.moonbeam.network/). Moonbeam Foundation does not warrant the accuracy, completeness or usefulness of this information. Any reliance you place on such information is strictly at your own risk. Moonbeam Foundation disclaims all liability and responsibility arising from any reliance placed on this information by you or by anyone who may be informed of any of its contents. All statements and/or opinions expressed in these materials are solely the responsibility of the person or entity providing those materials and do not necessarily represent the opinion of Moonbeam Foundation. The information should not be construed as professional or financial advice of any kind. Advice from a suitably qualified professional should always be sought in relation to any particular matter or circumstance. The information herein may link to or integrate with other websites operated or content provided by third parties, and such other websites may link to this website. Moonbeam Foundation has no control over any such other websites or their content and will have no liability arising out of or related to such websites or their content. The existence of any such link does not constitute an endorsement of such websites, the content of the websites, or the operators of the websites. These links are being provided to you only as a convenience and you release and hold Moonbeam Foundation harmless from any and all liability arising from your use of this information or the information provided by any third-party website or service.
Last update: February 17, 2026
| Created: June 9, 2021