The GoldRush Streaming API is now available in public Beta! It provides real-time updates on blockchain events, including:
This API is ideal for applications that require immediate notifications or updates on blockchain activities such as:
The API is offered via GraphQL endpoints allowing developers to filter for specific chains, or DEXs and to start real-time subscriptions.
Note: The GoldRush Streaming API is currently in Beta. It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. No API credits are currently charged.
We welcome your feedback so please reach out to us directly to report issues or request features.
The Cross Chain Address Activity API has undergone a major performance improvement to significantly reduce the number of timeouts or 503
network error responses. The improvement stems from optimizing the unified query conducted over multiple shards.
The Cross Chain Address Activity API does a deep crawl across all supported blockchains to identify which chains a wallet is active on along with a last_seen_at
timestamp with one API call.
The GoldRush MCP Server exposes the GoldRush APIs as MCP resources and tools, enabling LLMs to interact with extensive, structured, multichain data.
Developers and product teams can leverage the GoldRush MCP server to power AI-driven use-cases such as:
Lens Mainnet is now indexed and available via GoldRush. Here are the chain details for the supported mainnet and testnet:
Chain | Chain Name | Chain ID |
---|---|---|
Lens Mainnet | lens-mainnet | 232 |
Lens Testnet | lens-sepolia-testnet | 37111 |
Lens Mainnet & Testnet are classified as ‘Frontier Chains’ meaning comprehensive support for core structured data, including token balances, complete transaction histories and decoded event logs. Lens support also includes NFT caching.
With the release of the Enhanced Spam Lists for ERC20 tokens and NFTs across all Foundational Chains, the following GoldRush APIs are now seamlessly updated to leverage these lists:
no-spam
query parameter.no-spam
query parameter.no-spam
query parameter.In addition, any of the API responses with the is_spam
field will incorporate the Enhanced Spam Lists.
The following changes were made to the Token Holders API:
block-height
is specified, the response is from the latest token holder snapshot that is updated every 30 minutes. This results in a fast response time.no-snapshot=true
. This bypasses the cache and is dynamically calculated at request time.The snapshot exists for the top 100 tokens on each Foundational Chain as listed on CoinGecko.
This modification is to help address the two unique use cases for this API:
The following chains are now indexed and available via GoldRush:
Chain | Chain Name | Chain ID |
---|---|---|
Berachain Mainnet | berachain-mainnet | 80094 |
Unichain Mainnet | unichain-mainnet | 130 |
Monad Testnet | monad-testnet | 10143 |
There are some significant updates to our pricing structure, which were announced in late August, 2024, that are now in effect as of February 1, 2025.
Our new Professional Tier has replaced the Premium Tier.
If you prefer the existing Premium Tier pricing, you can sign up through one of our channel partners where the Premium Tier is available at $50/month for 50,000 credits.
Our Free Tier has ended and replaced with the Free Trial.
We are making these updates to:
For any questions or assistance, please contact us at support@covalenthq.com.
Given the meme coin trading hype, GoldRush has released a new DEX pool spot prices API that supports pools on Uniswap V2, V3 and their forks on all Foundational Chains.
The API takes in the contractAddress
of the pool and returns the following key fields:
token_0_price
- Price of token_0
in units of token_1
.token_0_price_24
- Price of token_0
in units of token_1
as of 24 hours ago.token_0_price_quote
- Price of token_0
in the selected quote currency (defaults to USD
)token_1_xx
making up the pool pair.This API leverages the onchain sync event to get the spot prices.
Introducing the following tracing enhancements to our Multichain & Multiaddress Transactions API and Get a Transaction for ethereum-mainnet
:
Use the following query params:
with-internal
- includes internal transfers/transactions in the chain’s native token.with-state
- includes all transaction state changes with before and after valueswith-input-data
- includes the transaction’s input data, currently just the Method ID.Introducing the new GoldRush Multichain Balances API where you can fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call.
Some key points to note:
cursor_before
- fetch token balances before a certain point in the response.before={cursor_before}
.cursor_before=null
, you have reached the first page of the token balances list.chains=
query param (both chain names and ID’s are supported) up to a maximum of 10 chains.is_spam
will always default to false
.cutoff-timestamp
query param is passed, the balance snapshot will be from the nearest block before the specified cutoff time.GoldRush is reorganizing its support for various chains by grouping them into four distinct categories:
Foundational Chains: These are the top EVM-compatible chains that have achieved wide adoption. For these chains, GoldRush guarantees product parity across its entire suite of features. This includes tracing enhancements, historical token balances, token holders, and cached NFT assets. In addition, we’ll provide ecosystem support in the form of API credits, hackathon bounties, workshops, guides, and co-marketing activities.
Frontier Chains: These chains, both EVM and non-EVM compatible, represent the cutting edge of blockchain innovation. While not all product features will be available for Frontier Chains, GoldRush will continue to offer its core APIs at an enterprise level, along with ecosystem support.
Community Chains: These chains include those with passionate builder communities and will will offer core APIs including balances, transactions, and decoded log events.
Archived Chains: No live data will be available for archived chains. Only historical data will continue to be provided for a brief period of time.
The following chains are now indexed and available via GoldRush:
Chain | Chain Name | Chain ID |
---|---|---|
ApeChain Mainnet | apechain-mainnet | 33139 |
World Chain Mainnet | world-mainnet | 480 |
World Chain Testnet | world-sepolia-testnet | 4801 |
Unichain Testnet | unichain-sepolia-testnet | 1301 |
Introducing the new GoldRush Multichain & Multiaddress Transactions API where you can fetch transactions for up to 10 EVM addresses across 10 EVM chains with one API call.
Some key points to note:
The pagination method used for this API are cursors . Note the response includes the following cursor specific fields:
cursor_before
cursor_after
The values of these fields can be passed as query params to scroll through the transactions using before={cursor_before}
or after={cursor_after}
If cursor_before=null
, you’ve reached the first page of the descending transaction list
Cursors are linked to the list of chains that transactions are fetched from. If, for example, you obtain a cursor_before
value when querying chains=1,56
and then try to use that value with chains=1,137
, you will get an error.
ALL supported chains can be passed in the chains=
query param (both chain names and ID’s are supported) up to a maximum of 10 chains.
When no chains are specified, the API defaults to use the Foundational Chains.
Support for several chains with little to no use will be limited to historical data and categorized as ‘Archived Chains’ effective immediately. No live data will be available for these chains.
See the current list of Archived Chains here.
In general, GoldRush is reorganizing its prioritization and support for various chains with more on this to be announced soon.
The following chains are now indexed and available via GoldRush:
Chain | Chain Name | Chain ID |
---|---|---|
Berachain Testnet | berachain-testnet | 80084 |
Sei Mainnet | sei-mainnet | 1329 |
Fraxtal Mainnet | fraxtal-mainnet | 252 |
Redstone Mainnet | redstone-mainnet | 690 |
Cronos zkEVM Mainnet | cronos-zkevm-mainnet | 388 |
Leveraging the GoldRush UI Kit, the customizable GoldRush Block Explorer templateworks seamlessly across all supported chains and is designed to make onchain verification and exploration easier than ever.
Some of the key features are:
There are some significant updates to our pricing structure, effective September 1, 2024.
Our new Professional Tier will replace the Premium Tier.
If you prefer the existing Premium Tier pricing, you can sign up through one of our channel partners where the Premium Tier is available at $50/month for 50,000 credits.
We are making these updates to:
The new Professional Tier will offer the same performance and features you’ve come to expect from our Premium Tier. We’ll provide more details soon, and we’re here to support you during this transition. For any questions or assistance, please contact us at support@covalenthq.com.
Following the rebrand of Covalent’s data products to “GoldRush”, the following import statement is now supported through the SDKs: import { GoldRushClient } from "@covalenthq/client-sdk";
This is a non-breaking change, so projects using import { CovalentClient } from "@covalenthq/client-sdk";
will be unaffected.
We just majorly updated our NFT endpoints with new cached thumbnail data!
This update includes several key fields: thumbnails, which provide various sizes of asset thumbnails like image_256
, image_512
, image_1024
, and image_opengraph_url
, tailored to different use cases including OpenGraph protocol; image_preview
, an unmodified thumbnail of the asset; and asset_properties
, detailing dimensions and the dominant color of the asset.
Devs can also benefit from the thumbhash
feature, which allows for the decoding of thumbnail hashes into a blurred image preview, useful for enhancing loading experiences and privacy in NFT galleries and marketplaces.
This suite of enhancements supports a wide range of asset types, from images and videos to audio files, catering to diverse NFT displays.
We’ve added a current_owner
field to our NFT ownership endpoints:
The current_owner
field gives you the wallet address of the current owner of that NFT. This new feature applies to all chains with NFT support.
We now offer The Covalent Viem SDK, developed in TypeScript, which leverages the viem framework to offer a seamless integration path with the GoldRush API.
Reduce the number of API calls required to power your application and gain access to Covalent’s detailed, historical data across 200+ blockchains.
In November 2023, we launched GoldRush Kit, a series of customizable React components for dApp frontends. Now, we introduce GoldRush Decoder, a transformative tool that translates raw log events from blockchain transactions into structured, human-readable formats.
GoldRush Decoder pairs directly with GoldRush Kit for easy visualization, however, it can be used as a standalone tool.
Traditional block explorers keep their data transformations private and inaccessible to users. GoldRush Decoder is different. This open-source tool acts as a public good for decoded data.
We recently added a new with-gas
query parameter to the Get transaction summary for address endpoint.
This endpoint is commonly used to fetch the earliest and latest transactions, and the total transaction count for a wallet. The new with-gas
parameter allows you to see the total gas quote for the wallet, as well as the average quote per transaction, and other insightful metadata.
CrossFi Testnet, Syndr Testnet, Taiko Katla Testnet and Celo are now fully indexed! Users can query all on-chain data through our Class A endpoints.
The GoldRush Streaming API is now available in public Beta! It provides real-time updates on blockchain events, including:
This API is ideal for applications that require immediate notifications or updates on blockchain activities such as:
The API is offered via GraphQL endpoints allowing developers to filter for specific chains, or DEXs and to start real-time subscriptions.
Note: The GoldRush Streaming API is currently in Beta. It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. No API credits are currently charged.
We welcome your feedback so please reach out to us directly to report issues or request features.
The Cross Chain Address Activity API has undergone a major performance improvement to significantly reduce the number of timeouts or 503
network error responses. The improvement stems from optimizing the unified query conducted over multiple shards.
The Cross Chain Address Activity API does a deep crawl across all supported blockchains to identify which chains a wallet is active on along with a last_seen_at
timestamp with one API call.
The GoldRush MCP Server exposes the GoldRush APIs as MCP resources and tools, enabling LLMs to interact with extensive, structured, multichain data.
Developers and product teams can leverage the GoldRush MCP server to power AI-driven use-cases such as:
Lens Mainnet is now indexed and available via GoldRush. Here are the chain details for the supported mainnet and testnet:
Chain | Chain Name | Chain ID |
---|---|---|
Lens Mainnet | lens-mainnet | 232 |
Lens Testnet | lens-sepolia-testnet | 37111 |
Lens Mainnet & Testnet are classified as ‘Frontier Chains’ meaning comprehensive support for core structured data, including token balances, complete transaction histories and decoded event logs. Lens support also includes NFT caching.
With the release of the Enhanced Spam Lists for ERC20 tokens and NFTs across all Foundational Chains, the following GoldRush APIs are now seamlessly updated to leverage these lists:
no-spam
query parameter.no-spam
query parameter.no-spam
query parameter.In addition, any of the API responses with the is_spam
field will incorporate the Enhanced Spam Lists.
The following changes were made to the Token Holders API:
block-height
is specified, the response is from the latest token holder snapshot that is updated every 30 minutes. This results in a fast response time.no-snapshot=true
. This bypasses the cache and is dynamically calculated at request time.The snapshot exists for the top 100 tokens on each Foundational Chain as listed on CoinGecko.
This modification is to help address the two unique use cases for this API:
The following chains are now indexed and available via GoldRush:
Chain | Chain Name | Chain ID |
---|---|---|
Berachain Mainnet | berachain-mainnet | 80094 |
Unichain Mainnet | unichain-mainnet | 130 |
Monad Testnet | monad-testnet | 10143 |
There are some significant updates to our pricing structure, which were announced in late August, 2024, that are now in effect as of February 1, 2025.
Our new Professional Tier has replaced the Premium Tier.
If you prefer the existing Premium Tier pricing, you can sign up through one of our channel partners where the Premium Tier is available at $50/month for 50,000 credits.
Our Free Tier has ended and replaced with the Free Trial.
We are making these updates to:
For any questions or assistance, please contact us at support@covalenthq.com.
Given the meme coin trading hype, GoldRush has released a new DEX pool spot prices API that supports pools on Uniswap V2, V3 and their forks on all Foundational Chains.
The API takes in the contractAddress
of the pool and returns the following key fields:
token_0_price
- Price of token_0
in units of token_1
.token_0_price_24
- Price of token_0
in units of token_1
as of 24 hours ago.token_0_price_quote
- Price of token_0
in the selected quote currency (defaults to USD
)token_1_xx
making up the pool pair.This API leverages the onchain sync event to get the spot prices.
Introducing the following tracing enhancements to our Multichain & Multiaddress Transactions API and Get a Transaction for ethereum-mainnet
:
Use the following query params:
with-internal
- includes internal transfers/transactions in the chain’s native token.with-state
- includes all transaction state changes with before and after valueswith-input-data
- includes the transaction’s input data, currently just the Method ID.Introducing the new GoldRush Multichain Balances API where you can fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call.
Some key points to note:
cursor_before
- fetch token balances before a certain point in the response.before={cursor_before}
.cursor_before=null
, you have reached the first page of the token balances list.chains=
query param (both chain names and ID’s are supported) up to a maximum of 10 chains.is_spam
will always default to false
.cutoff-timestamp
query param is passed, the balance snapshot will be from the nearest block before the specified cutoff time.GoldRush is reorganizing its support for various chains by grouping them into four distinct categories:
Foundational Chains: These are the top EVM-compatible chains that have achieved wide adoption. For these chains, GoldRush guarantees product parity across its entire suite of features. This includes tracing enhancements, historical token balances, token holders, and cached NFT assets. In addition, we’ll provide ecosystem support in the form of API credits, hackathon bounties, workshops, guides, and co-marketing activities.
Frontier Chains: These chains, both EVM and non-EVM compatible, represent the cutting edge of blockchain innovation. While not all product features will be available for Frontier Chains, GoldRush will continue to offer its core APIs at an enterprise level, along with ecosystem support.
Community Chains: These chains include those with passionate builder communities and will will offer core APIs including balances, transactions, and decoded log events.
Archived Chains: No live data will be available for archived chains. Only historical data will continue to be provided for a brief period of time.
The following chains are now indexed and available via GoldRush:
Chain | Chain Name | Chain ID |
---|---|---|
ApeChain Mainnet | apechain-mainnet | 33139 |
World Chain Mainnet | world-mainnet | 480 |
World Chain Testnet | world-sepolia-testnet | 4801 |
Unichain Testnet | unichain-sepolia-testnet | 1301 |
Introducing the new GoldRush Multichain & Multiaddress Transactions API where you can fetch transactions for up to 10 EVM addresses across 10 EVM chains with one API call.
Some key points to note:
The pagination method used for this API are cursors . Note the response includes the following cursor specific fields:
cursor_before
cursor_after
The values of these fields can be passed as query params to scroll through the transactions using before={cursor_before}
or after={cursor_after}
If cursor_before=null
, you’ve reached the first page of the descending transaction list
Cursors are linked to the list of chains that transactions are fetched from. If, for example, you obtain a cursor_before
value when querying chains=1,56
and then try to use that value with chains=1,137
, you will get an error.
ALL supported chains can be passed in the chains=
query param (both chain names and ID’s are supported) up to a maximum of 10 chains.
When no chains are specified, the API defaults to use the Foundational Chains.
Support for several chains with little to no use will be limited to historical data and categorized as ‘Archived Chains’ effective immediately. No live data will be available for these chains.
See the current list of Archived Chains here.
In general, GoldRush is reorganizing its prioritization and support for various chains with more on this to be announced soon.
The following chains are now indexed and available via GoldRush:
Chain | Chain Name | Chain ID |
---|---|---|
Berachain Testnet | berachain-testnet | 80084 |
Sei Mainnet | sei-mainnet | 1329 |
Fraxtal Mainnet | fraxtal-mainnet | 252 |
Redstone Mainnet | redstone-mainnet | 690 |
Cronos zkEVM Mainnet | cronos-zkevm-mainnet | 388 |
Leveraging the GoldRush UI Kit, the customizable GoldRush Block Explorer templateworks seamlessly across all supported chains and is designed to make onchain verification and exploration easier than ever.
Some of the key features are:
There are some significant updates to our pricing structure, effective September 1, 2024.
Our new Professional Tier will replace the Premium Tier.
If you prefer the existing Premium Tier pricing, you can sign up through one of our channel partners where the Premium Tier is available at $50/month for 50,000 credits.
We are making these updates to:
The new Professional Tier will offer the same performance and features you’ve come to expect from our Premium Tier. We’ll provide more details soon, and we’re here to support you during this transition. For any questions or assistance, please contact us at support@covalenthq.com.
Following the rebrand of Covalent’s data products to “GoldRush”, the following import statement is now supported through the SDKs: import { GoldRushClient } from "@covalenthq/client-sdk";
This is a non-breaking change, so projects using import { CovalentClient } from "@covalenthq/client-sdk";
will be unaffected.
We just majorly updated our NFT endpoints with new cached thumbnail data!
This update includes several key fields: thumbnails, which provide various sizes of asset thumbnails like image_256
, image_512
, image_1024
, and image_opengraph_url
, tailored to different use cases including OpenGraph protocol; image_preview
, an unmodified thumbnail of the asset; and asset_properties
, detailing dimensions and the dominant color of the asset.
Devs can also benefit from the thumbhash
feature, which allows for the decoding of thumbnail hashes into a blurred image preview, useful for enhancing loading experiences and privacy in NFT galleries and marketplaces.
This suite of enhancements supports a wide range of asset types, from images and videos to audio files, catering to diverse NFT displays.
We’ve added a current_owner
field to our NFT ownership endpoints:
The current_owner
field gives you the wallet address of the current owner of that NFT. This new feature applies to all chains with NFT support.
We now offer The Covalent Viem SDK, developed in TypeScript, which leverages the viem framework to offer a seamless integration path with the GoldRush API.
Reduce the number of API calls required to power your application and gain access to Covalent’s detailed, historical data across 200+ blockchains.
In November 2023, we launched GoldRush Kit, a series of customizable React components for dApp frontends. Now, we introduce GoldRush Decoder, a transformative tool that translates raw log events from blockchain transactions into structured, human-readable formats.
GoldRush Decoder pairs directly with GoldRush Kit for easy visualization, however, it can be used as a standalone tool.
Traditional block explorers keep their data transformations private and inaccessible to users. GoldRush Decoder is different. This open-source tool acts as a public good for decoded data.
We recently added a new with-gas
query parameter to the Get transaction summary for address endpoint.
This endpoint is commonly used to fetch the earliest and latest transactions, and the total transaction count for a wallet. The new with-gas
parameter allows you to see the total gas quote for the wallet, as well as the average quote per transaction, and other insightful metadata.
CrossFi Testnet, Syndr Testnet, Taiko Katla Testnet and Celo are now fully indexed! Users can query all on-chain data through our Class A endpoints.