Learn about GoldRush
Changelog
Updated Streaming API URL
The GoldRush Streaming API URL has been updated to support authentication using the GoldRush API key.The updated URL is:wss://gr-staging-v2.streaming.covalenthq.com/graphqlThe prior URL was: wss://gr-staging.streaming.covalenthq.com/graphqlSee the Streaming API Docs for more details.Learn moreNew GraphQL Queries for Wallet Trading Data
New GraphQL queries, as part of the GoldRush Streaming API, are now available in public Beta. These queries provides real-time insights into wallet trading data and include:- Get top trading wallets for token: provides a list of wallets with the highest trading volume for a specific token over the last 30 days, along with detailed information about their holdings, transaction activity, realized and unrealized profit/loss metrics
- Get PnL for wallet: provides detailed financial metrics, including unrealized and realized profit and loss (PnL), current balance, and transaction insights for each token held by a specific wallet address on a given chain.
- Trading platforms that enable copy trading or following strategies of high-performing wallets.
- Portfolio trackers and personal finance dashboards.
- Trading bots and dashboards that highlight whale wallet activity or smart money moves.
GoldRush MCP Server v0.0.3 - Multi-Transport Support Release
GoldRush MCP Server is a Model Context Protocol server that enables AI applications to access blockchain and cryptocurrency data through a standardized interface. The server provides AI models with secure, structured access to blockchain data and cryptocurrency information, allowing them to answer questions and perform tasks related to digital assets, transactions, and market data.Previous Limitations
Previously, users could only run the GoldRush MCP Server using STDIO transport, which limited deployment flexibility. This meant:- Only command-line and local integrations were possible
- No web-based or HTTP API access
- Limited options for authentication and security
- Fewer deployment scenarios for production environments
New Capabilities
With this update, users can now:- Deploy over HTTP: Run the server as a web service with HTTP transport, enabling web applications and remote integrations
- Choose deployment method: Select between STDIO (for local/command-line use) or HTTP (for web services) based on their needs
- Secure with authentication: Use Bearer token authentication for HTTP deployments to protect access
- Customize configurations: Set custom ports and configure transport settings via command-line arguments
- Integrate more easily: Connect from web applications, mobile apps, or any system that can make HTTP requests
Impact
This release significantly expands how and where GoldRush MCP Server can be deployed, making it more versatile for different use cases from local development to production web services.Learn moreStreaming API Launch!
The GoldRush Streaming API is now available in public Beta! It provides real-time updates on blockchain events, including:- Token balances
- New DEX pairs (on Uniswap V2, V3)
- Wallet activity
- OHLCV token and pair price data.
- Trading bots
- Gaming
- AI agents
Upgrade to Cross Chain Address Activity API
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.Learn moreMCP Server for Blockchain Data
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:- Real-time blockchain analytics and insights directly within conversational AI and assistants.
- Enhanced risk assessment and compliance tools powered by AI with live on-chain data feeds.
- Dynamic NFT and DeFi marketplaces utilizing AI-driven discovery and recommendation engines based on real-time blockchain activity.
- AI Agents: Enable autonomous AI agents to fetch, analyze, and act upon blockchain data in real-time, powering automated trading strategies, monitoring, and governance mechanisms.
Lens Mainnet Now Supported
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 |
Enhanced Token Spam Lists
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:- Get token balances for address using the
no-spamquery parameter. - Get historical token balances for address using the
no-spamquery parameter. - Get NFTs for address using the
no-spamquery parameter.
is_spam field will incorporate the Enhanced Spam Lists.Learn moreUpdate to Token Holders API
The following changes were made to the Token Holders API:- When no
block-heightis 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.
- 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.
- Token holder lists for reward distributions and token gating. This is generally an accurate token list generated at a specific point in time.
Berachain & Unichain Mainnets, Monad Testnet Indexed
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 |
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.
- 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.
New DEX pool spot prices API
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 oftoken_0in units oftoken_1.token_0_price_24- Price oftoken_0in units oftoken_1as of 24 hours ago.token_0_price_quote- Price oftoken_0in the selected quote currency (defaults toUSD)- Similar values for
token_1_xxmaking up the pool pair.
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
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.
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_spamwill always default tofalse. - When the
cutoff-timestampquery param is passed, the balance snapshot will be from the nearest block before the specified cutoff time.
GoldRush Changes Phase 1: Chain Classification & Prioritization
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.Learn moreApeChain, World Chain Mainnets & Unichain Testnet Indexed
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 |
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_beforecursor_afterThe values of these fields can be passed as query params to scroll through the transactions usingbefore={cursor_before}orafter={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_beforevalue when queryingchains=1,56and then try to use that value withchains=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.
Archiving 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.Learn moreCronos zkEVM, Sei, Fraxtal, Redstone Mainnets and Berachain Testnet Indexed
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 |
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.
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.
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 support@covalenthq.com.Learn moreNew (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 moreCached NFT Thumbnail Data Added
We just 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: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.