goldrush-api

name	goldrush-api
description	Query blockchain data across 100+ chains: wallet balances, token prices, transactions, DEX pairs, and real-time OHLCV streams via the GoldRush API by Covalent.
category	blockchain
risk	safe
source	community
date_added	2026-03-17
author	covalenthq
tags	["blockchain","crypto","web3","api","defi","wallet","multi-chain"]
tools	["claude","cursor","gemini","codex","copilot"]
license	MIT

GoldRush API

Overview

GoldRush by Covalent provides blockchain data across 100+ chains through a unified REST API, real-time WebSocket streams, a CLI, and an x402 pay-per-request proxy. This skill enables AI agents to query wallet balances, token prices, transaction history, NFT holdings, and DEX pair data without building chain-specific integrations.

When to Use This Skill

• Retrieving wallet token balances or total portfolio value across any chain
• Fetching transaction history or decoded event logs for an address
• Getting current or historical token prices (USD or native)
• Monitoring DEX pairs, liquidity events, and real-time OHLCV candles via WebSocket
• Building block explorers, portfolio dashboards, tax tools, or DeFi analytics
• Accessing on-chain data with no signup via x402 pay-per-request

How It Works

Step 1: Get credentials

Sign up at https://goldrush.dev for a free API key. For agent-native no-signup access, use the x402 proxy instead.

Step 2: Set your API key

export GOLDRUSH_API_KEY="your_api_key_here"

Step 3: Query data

REST API (most endpoints):

# Wallet token balances on Ethereum
curl -H "Authorization: Bearer $GOLDRUSH_API_KEY"   "https://api.covalenthq.com/v1/eth-mainnet/address/0xADDRESS/balances_v2/"

CLI (quick terminal queries):

npx @covalenthq/goldrush-cli balances --chain eth-mainnet --address 0xADDRESS

SDK (in code):

import GoldRushClient from "@covalenthq/client-sdk";
const client = new GoldRushClient(process.env.GOLDRUSH_API_KEY);
const resp = await client.BalanceService.getTokenBalancesForWalletAddress(
  , 
);