Community

Guides

GoldRush API Reference

API Reference

GoldRush Platform

Support

Commonly used to get a list of all the token holders for a specified ERC20 or ERC721 token. Returns historic token holders when block-height is set (defaults to `latest`). Useful for building pie charts of token holders.

Get token holders as of any block height (v2)

Quickstart

Overview

GoldRush APIs

GoldRush SDKs

GoldRush UI Kit

GoldRush Decoder

The GoldRush API can be used to easily retrieve onchain data including token balances, positions and historical granular transaction data from 100+ blockchains. This data enables hundreds of use cases like wallets, taxation tools, AI model training, onchain data forensics, and many other applications. The GoldRush API is powered by the [Covalent Network](https://covalenthq.com/).

FAQs

Commonly used to locate chains which an address is active on with a single API call.

Get activity across all chains for address

Fetch transactions for up to 10 addresses and 10 EVM chains with one API call. Useful for building Activity Feeds. 

Get Multichain & Multiaddress transactions

Commonly used to fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata.

Get token balances for address

Commonly used to fetch the historical native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address at a given block height or date. Response includes daily prices and other metadata.

Get historical token balances for address

Commonly used to get the native token balance for an address. This endpoint is required because native tokens are usually not ERC20 tokens and sometimes you want something lightweight.

Get native token balance for address

Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.

Get ERC20 token transfers for address

Commonly used to fetch and render a single transaction including its decoded log events.

Get a transaction

Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet. Calculate the age of the wallet and the time it has been idle and quickly gain insights into their engagement with web3.

Get transaction summary for address

Commonly used to fetch and render the earliest transactions involving an address. Frequently seen in wallet applications.

Get earliest transactions for address (v3) 

Commonly used to fetch and render the most recent transactions involving an address. Frequently seen in wallet applications.

Get recent transactions for address (v3)

Commonly used to fetch the transactions involving an address including the decoded log events in a paginated fashion.

Get paginated transactions for address (v3)

Commonly used to fetch all transactions including their decoded log events in a 15-minute time bucket interval.

Get bulk time bucket transactions for address (v3)

Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.

Get all transactions in a block by page (v3) 

Get all transactions in a block (v3)

Commonly used to render the NFTs (including ERC721 and ERC1155) held by an address.

Get NFTs for address

Commonly used to get NFT token IDs with metadata from a collection. Useful for building NFT card displays.

Get NFTs from contract with metadata

Commonly used to get a single NFT metadata by token ID from a collection. Useful for building NFT card displays.

Get single NFT from contract with metadata

Commonly used to get all transactions of an NFT token. Useful for building a transaction history table or price chart.

Get NFT transactions for contract

Commonly used to calculate rarity scores for a collection based on its traits.

Get trait summary for collection

Commonly used to fetch and render the traits of a collection as seen in rarity calculators.

Get traits for a collection

Commonly used to get the count of unique values for traits within an NFT collection.

Get attributes for a collection trait

Commonly used to fetch the list of NFT collections with downloaded and cached off chain data like token metadata and asset files.

Get chain collections

Commonly used to render a price floor chart for an NFT collection.

Get historical floor prices for a collection

Commonly used to build a time-series chart of the transaction volume of an NFT collection.

Get historical volume for a collection

Commonly used to build a time-series chart of the sales count of an NFT collection.

Get historical sales count for a collection

Commonly used to verify ownership of NFTs (including ERC-721 and ERC-1155) within a collection.

Check ownership in NFT collection

Commonly used to verify ownership of a specific token (ERC-721 or ERC-1155) within a collection.

Check ownership in NFT collection for specific token

Commonly used to get a list of approvals across all token contracts categorized by spenders for a wallet’s assets.

Get token approvals for address

Commonly used to get a list of NFT approvals across all token contracts categorized by spenders for a wallet’s assets.

Get NFT approvals for address

Fetch balances for each active child address derived from a Bitcoin HD wallet. 

Get Bitcoin balances for HD address

Fetch Bitcoin balance for a non-HD address. Response includes spot prices and other metadata.

Get Bitcoin balances for non-HD address

Used to fetch the full transaction history of a Bitcoin wallet. 

Get transactions for Bitcoin address

Commonly used to get all the event logs of the latest block, or for a range of blocks. Includes sender contract metadata as well as decoded logs.

Get logs

Commonly used to get all event logs of the same topic hash across all contracts within a particular chain. Useful for cross-sectional analysis of event logs that are emitted on-chain.

Get log events by topic hash(es)

Commonly used to get all the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions.

Get log events by contract address

Commonly used to fetch and render a single block for a block explorer.

Get a block

Commonly used to get all the block heights within a particular date range. Useful for rendering a display where you sort blocks by day.

Get block heights

Commonly used to build internal dashboards for all supported chains on Covalent.

Get all chains

Commonly used to build internal status dashboards of all supported chains.

Get all chain statuses

Commonly used to resolve ENS, RNS and Unstoppable Domains addresses.

Get resolved address for registered address

Get real-time gas estimates for different transaction speeds on a specific network, enabling users to optimize transaction costs and confirmation times.

Get gas prices

Commonly used to get historic prices of a token between date ranges. Supports native tokens.

API Reference

Cross Chain

Balances

Transactions

NFT

Security

Bitcoin

Utility

Get token holders as of any block height (v2)

Path Parameters

Query Parameters

Response