Transfer Event

Swap Event

Bridge Event

Deposit Event

Withdraw Event

Approve Event

Transaction Logs

Error Details

Decoded Events

GoldRush API Reference

Overview

Jumpstart your blockchain project with the GoldRush quickstart guide. Use our TypeScript SDK & UI Kit to access multichain data and get your free API key now!

Quickstart

GoldRush APIs

GoldRush SDKs

GoldRush UI Kit

GoldRush Decoder

A server that exposes Covalent's GoldRush APIs as MCP resources and tools, enabling LLMs to interact with blockchain data.

GoldRush MCP Server

NFT Supported Formats

A public, open-source npm package that provides enhanced spam lists for ERC20 tokens and NFTs.

Enhanced Spam Lists

Token Balances Stream

The OHLCV Tokens stream provides real-time updates on the Open, High, Low, Close prices and Volume of <b>one or many tokens</b> at configurable intervals. This documentation follows our standard streaming API structure.

OHLCV Tokens Stream

The OHLCV Pairs stream provides real-time updates on the Open, High, Low, Close prices and Volume of <b> one or many token pairs</b> at configurable intervals. This documentation follows our standard streaming API structure.

OHLCV Pairs Stream

New DEX Pairs Stream

Wallet Activity Stream

GraphQL Endpoints

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 paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call.

Get multichain balances

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

Get multichain & multiaddress transactions

Commonly used to fetch the native and fungible (ERC20) tokens held by an address. Response includes spot prices and other metadata.

Get token balances for address

Commonly used to fetch the historical native and fungible (ERC20) 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

Lightweight endpoint to just get the native token balance for an address. 

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 render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days.

Get historical portfolio value over time

Used to get a paginated list of current or historical token holders for a specified ERC20 or ERC721 token. 

Get token holders as of any block height (v2)

Used to fetch and render a single transaction including its decoded event logs. For foundational chains, can also retrieve internal transactions, state changes and method ID where available. 

Get a transaction

Used to fetch the earliest and latest transactions, and the transaction count for a wallet. Also enriched with gas expenditure details and total ERC20 token transfers count.

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 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

Use to request enhanced NFT processing, specifically cached assets, metadata and thumbnails, for a given NFT collection.

Request NFT Collection Cache

Use to check the status of an NFT collection cache request.

Get NFT Collection Cache Status

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

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 balance for non-HD address

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

Get transactions for Bitcoin address

Get the historical prices of one (or many) large cap ERC20 tokens between specified date ranges. Also supports native tokens.

Get historical token prices

Get the spot token pair prices for a specified pool contract address. Supports pools on Uniswap V2, V3 and their forks. 

Get pool spot prices

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 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

The GoldRush Playground is a tool for exploring the GoldRush API.

GoldRush Playground

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.

Field	Type	Description
`from`	`string`	The source address
`to`	`string`	The destination address
`amount`	`string`	Unscaled token amount (scale by `metadata.contract_decimals`)
`quote_rate_usd`	`string`	Exchange rate of the token in USD
`quote_usd`	`string`	The quote amount of the token in USD
`contract_metadata`	`object`	Contract details including `contract_name`, `contract_address`, `contract_decimals`, and `contract_ticker_symbol`

Field	Type	Description
`token_in`	`string`	The input token address
`token_out`	`string`	The output token address
`amount_in`	`string`	The amount of input tokens
`amount_out`	`string`	The amount of output tokens

Field	Type	Description
`type`	`string`	The bridge transaction type
`typeString`	`string`	Human-readable bridge transaction type
`from`	`string`	The source address
`to`	`string`	The destination address
`amount`	`string`	Unscaled token amount (scale by `metadata.contract_decimals`)
`quote_rate_usd`	`string`	Exchange rate of the token in USD
`quote_usd`	`string`	The quote amount of the token in USD
`contract_metadata`	`object`	Contract details including `contract_name`, `contract_address`, `contract_decimals`, and `contract_ticker_symbol`

Field	Type	Description
`from`	`string`	The source address
`to`	`string`	The destination address
`amount`	`string`	Unscaled token amount (scale by `metadata.contract_decimals`)
`quote_rate_usd`	`string`	Exchange rate of the token in USD
`quote_usd`	`string`	The quote amount of the token in USD
`contract_metadata`	`object`	Contract details including `contract_name`, `contract_address`, `contract_decimals`, and `contract_ticker_symbol`

Field	Type	Description
`from`	`string`	The source address
`to`	`string`	The destination address
`amount`	`string`	Unscaled token amount (scale by `metadata.contract_decimals`)
`quote_rate_usd`	`string`	Exchange rate of the token in USD
`quote_usd`	`string`	The quote amount of the token in USD
`contract_metadata`	`object`	Contract details including `contract_name`, `contract_address`, `contract_decimals`, and `contract_ticker_symbol`

GoldRush Streaming API

Available Streams

Resources

Decoded Events

Transfer Event

Swap Event

Bridge Event

Deposit Event

Withdraw Event

Approve Event

Transaction Logs

Error Details

Field	Type	Description
`spender`	`string`	The address approved to spend tokens
`amount`	`string`	Unscaled token amount (scale by `metadata.contract_decimals`)
`quote_rate_usd`	`string`	Exchange rate of the token in USD
`quote_usd`	`string`	The quote amount of the token in USD
`contract_metadata`	`object`	Contract details including `contract_name`, `contract_address`, `contract_decimals`, and `contract_ticker_symbol`

Field	Type	Description
`emitter_address`	`string`	The address that emitted the log
`log_offset`	`integer`	The offset of the log in the transaction
`data`	`string`	The raw log data
`topics`	`array`	Array of log topics

GoldRush Streaming API

Available Streams

Resources

​Transfer Event

​Swap Event

​Bridge Event

​Deposit Event

​Withdraw Event

​Approve Event

​Transaction Logs

​Error Details

Transfer Event

Swap Event

Bridge Event

Deposit Event

Withdraw Event

Approve Event

Transaction Logs

Error Details