Update to Token Holders API

The following changes were made to the Token Holders API:

• When no 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.
• To fetch the current token holders list without using the snapshot, set 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:

1. Displaying a list of token holders on leaderboards to provide guidance on a token’s distribution. This list does not generally need to be accurate to the minute.
2. Token holder lists for reward distributions and token gating. This is generally an accurate token list generated at a specific point in time.

Learn more

Berachain & Unichain Mainnets, Monad Testnet Indexed

The following chains are now indexed and available via GoldRush:

Update to the GoldRush Professional Tier and Pricing Change

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.

What has Changed?

Our new Professional Tier has replaced the Premium Tier.

• Professional Tier: $250 per month for 300,000 API credits, with overages at 0.00077 per credit.
• Existing Premium Tier users: You need to transition to the Professional Tier to ensure you continue to receive the same high-quality performance and features.

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.

• Existing grandfathered Free Tier users who signed up before the 14-day Free Trial was implemented will now need to upgrade to a paid tier effective February 1, 2025.

Why the Changes?

We are making these updates to:

• Ensure consistent pricing for our API across various marketplaces.
• Provide better and more responsive support.
• Maintain and enhance the quality of our services.

For any questions or assistance, please contact us at [email protected].

Learn more

Tracing Enhancements Supported on Ethereum

Introducing the following tracing enhancements to our Multichain & Multiaddress Transactions API and Get a Transaction for ethereum-mainnet:

• Internal Transactions
• State Changes
• Input Data

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 values
• with-input-data - includes the transaction’s input data, currently just the Method ID.

Learn more

New Multichain Balances API

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:

• The pagination method used for this API are cursors . Note the response includes the following cursor specific fields:
  • cursor_before - fetch token balances before a certain point in the response.
  • The values of these fields can be passed as query params to scroll through the token balances using before={cursor_before}.
• If cursor_before=null , you have reached the first page of the token balances list.
• 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.
• ERC20 token spam filtering is currently not supported but will be added. In the response, is_spam will always default to false.
• When the cutoff-timestamp query param is passed, the balance snapshot will be from the nearest block before the specified cutoff time.

Learn more

GoldRush Changes Phase 1: Chain Classification & Prioritization

GoldRush is reorganizing its support for various chains by grouping them into three 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 as well as chains that are entering an archival phase. For these, GoldRush will maintain historical data access while limiting live data support.

Learn more

ApeChain, World Chain Mainnets & Unichain Testnet Indexed

The following chains are now indexed and available via GoldRush:

New Multichain & Multiaddress Transactions API

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.

Learn more

Cronos zkEVM, Sei, Fraxtal, Redstone Mainnets and Berachain Testnet Indexed

The following chains are now indexed and available via GoldRush:

Introducing the Customizable Block Explorer Template

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:

• Real-time Block Explorer: Provides up-to-date information on blockchain transactions, blocks, and account balances in real time, giving users the latest data.
• Ready-to-use customizable template: Jumpstart your dApp journey with a beautifully designed UI that’s both intuitive and engaging.
• Cross Chain Support: Supports 100+ chains, providing a unified explorer for all your needs.
• Comprehensive Data Filtering: Search and filter through blockchain data with options to refine by transaction type, block height, or account, making it ideal for both casual users and developers.
• UI Template: The GoldRush Block Explorer can be customized with different colors and modes per deployment.

Learn more

Introducing the GoldRush Professional Tier and Pricing Change

There are some significant updates to our pricing structure, effective September 1, 2024.

What’s Changing?

Our new Professional Tier will replace the Premium Tier.

• Professional Tier: $250 per month for 300,000 API credits, with overages at 0.00077 per credit.
• Existing Premium Tier users: You can continue with your current plan until February 1, 2025. You will then need to transition to the Professional Tier to ensure you continue to receive the same high-quality performance and features.

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.

Why the Changes?

We are making these updates to:

• Ensure consistent pricing for our API across various marketplaces.
• Provide better and more responsive support.
• Maintain and enhance the quality of our services.

What’s Next?

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 [email protected].

Learn more

New (Non-Breaking) Import Statement for GoldRush SDKs

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.

Learn more

Cached NFT Thumbnail Data Added

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.

Current NFT Owner Data Added

We’ve added a current_owner field to our NFT ownership endpoints:

• Get NFTs from contract with metadata.
• Get single NFT with cached metadata from contract.

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.

New Viem-Compatible Client SDK

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.

Introducing GoldRush Decoder: Decode, Visualize, Understand

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.

New Gas Parameter in Transaction Summary Endpoint

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, Celo and Taiko Katla Testnet Indexed

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.

New Gas Prices Endpoint

We just added a new endpoint; Get gas prices!

This endpoint enables users to get real-time gas estimates for different transaction speeds on a specific network, for the following event types:

• erc20 token transfers
• nativetokens transfers
• uniswapv3 swap events

Using these estimates, optimize your transaction costs and/or build your own gas tracker!

Note: the l1_gas_quote field is only relevant for queries on OP stack chains like Optimism, Base, etc.

Decibling, StarkSport and Public zkSync Indexed

The Lumoz Rollups Decibling, StarkSport and Public zkSync are now fully indexed! Users can query all on-chain data through our Class A endpoints.

Covalent Launches GoldRush; a Customizable Block Explorer Toolkit

During the week of DevConnect in Istanbul, our team announced a brand new product; GoldRush.

GoldRush is a customizable block explorer toolkit designed for the evolving blockchain ecosystem. The first to launch is GoldRush UI Kit, which users can fork and customize on GitHub.

In the future, GoldRush Decoder and a Hosted Solution will be available. Stay tuned for more updates!

Learn more

Sunsetting Boba Avalanche

As of October 31, 2023, Boba is sunsetting the Boba Avalanche network. GoldRush API support for both Boba Avalanche mainnet and testnet will no longer be available.

Missing Optimism L1 Fees Fixed

Earlier this month, we discovered missing L1 fees in our fees_paid field for Optimism and other OP stack chains. We have since corrected this issue.

New NFT Endpoints for Floor Price, Volume and Sales Count

We’ve just added new NFT endpoints under “Market Data” on our API Reference that allow you to get hitorical floor prices, volume and sales counts for over 130,000 NFT collections across 9 chains and marketplaces!

Check out the new endpoints:

• Get historical floor prices for a collection
• Get historical volume for a collection
• Get historical sales count for a collection

Learn more

Safe (Prev. Gnosis Safe) Account Data Added to Transactions API

We have integrated Safe (formerly known as Gnosis Safe) data into our transactions API, offering richer insights into multi-signature wallet transactions and signatory data.

Using the query parameter with-safe=true will return the safe_details for each transaction item. The following endpoints support this enhancement:

• Get a transaction
• Get earliest transactions for address (v3)
• Get recent transactions for address (v3)
• Get paginated transactions for address (v3)
• Get bulk time bucket transactions for address (v3)
• Get all transactions in a block (v3)
• Get all transactions in a block by page (v3)

New NFT Approvals Endpoint

Following the release of our first token approvals endpoint (ERC-20 only) a few months back, we’re pleased to release a new approvals endpoint exclusively for NFTs!

Get NFT approvals for address returns a list of NFTs that can be accessed by contracts like Opensea’s marketplace and others.

Telos, Taiko Jonlir Testnet and FNCY Testnet Indexed

The Telos network, Taiko Jonlir Testnet and FNCY Testnet are now fully indexed! Users can query all on-chain data through our Class A endpoints.

Calypso Hub, Razor, CryptoBlades/Omnus, Europa Hub, Exorde, Nebula Gaming Hub, and 0xBattleGround Suspended

The following SKALE appchains have been suspended: Calypso Hub, Razor, CryptoBlades/Omnus, Europa Hub, Exorde, Nebula Gaming Hub, and 0xBattleGround. API access will no longer be available.

Loot Chain, Mode Testnet and Kinto Testnet Indexed

The OP-Stack blockchains Loot Chain, Mode Testnet and Kinto Testnet are now indexed! Users can query all on-chain data for these chains through our Class A endpoints.

Gnosis Chain and ZetaChain Testnet Indexed

Gnosis Chain and ZetaChain Testnet are now fully indexed! Users can query all on-chain data through our Class A endpoints.

Rollux, Manta Pacific Testnet and Public Goods Network Indexed

The OP-Stack chains Rollux, Manta Pacific Testnet and Public Goods Network are now fully indexed! Users can query all on-chain data through our Class A endpoints.

New DEX for Pool Address Endpoint

We’ve just added a new endpoint to our XY=K DeFi suite: Get XY=K DEX for pool address.

This endpoint returns the corresponding supported DEX for a given liquidity pool address, along with the swap fees, the DEX’s logo url, and factory addresses.

It is useful for identifying the specific DEX to which a token pair address is associated. Check it out!