wss://gr-staging-v2.streaming.covalenthq.com/graphql
The prior URL was: wss://gr-staging.streaming.covalenthq.com/graphql
See the Streaming API Docs for more details.Learn more503
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 moreChain | Chain Name | Chain ID |
---|---|---|
Lens Mainnet | lens-mainnet | 232 |
Lens Testnet | lens-sepolia-testnet | 37111 |
no-spam
query parameter.no-spam
query parameter.no-spam
query parameter.is_spam
field will incorporate the Enhanced Spam Lists.Learn moreblock-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.Chain | Chain Name | Chain ID |
---|---|---|
Berachain Mainnet | berachain-mainnet | 80094 |
Unichain Mainnet | unichain-mainnet | 130 |
Monad Testnet | monad-testnet | 10143 |
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.ethereum-mainnet
: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.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.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 |
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}
cursor_before=null
, you’ve reached the first page of the descending transaction list
cursor_before
value when querying chains=1,56
and then try to use that value with chains=1,137
, you will get an error.
chains=
query param (both chain names and ID’s are supported) up to a maximum of 10 chains.
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 |
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 moreimage_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_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.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.