Question 1

How do you query an endpoint?

Accepted Answer

The API host for all requests is ,https://api.covalenthq.com/v1/,.The endpoint path is appended to the API host (without repeating the ,/v1/,). For example, if the endpoint is ,GET /v1/{chain_id}/address/{address}/balances_v2/,, then an example of the full request URL is:All Covalent API endpoints are called using ,GET, requests.Each request must include your ,API_KEY, passed either in the request header (Basic Auth) or as a query parameter (see below).Your ,API_KEY, starts with ,ckey_,.

Question 2

What can you build using the API?

Accepted Answer

The Covalent API can be used across a wide variety of Web3 use cases from custom wallets, to NFT marketplaces and dashboards to gaming. Learn how to build popular Web3 dapps using the API by checking out our ,,.

Question 3

When should you use Basic Auth over authenticating via query parameter?

Accepted Answer

We recommend that you should always use Basic Auth over authenticating via query parameter ,when possible., Authentication via query parameter is offered for all endpoints otherwise:This works well when embedding the API in applications like Google Sheets or as iFrames that don't support more sophisticated auth methods. However, a key benefit of using Basic Auth is that your request can reliably take advantage of our caching mechanism for better query performance.where ,API_KEY, is passed as the username with no password.

Question 4

What's the chain_id?

Accepted Answer

The ,chain_id, parameter is the unique integer or name identifier of an EVM-supported blockchain network. A global list of EVM network Chain IDs can be found at: https://chainlist.org/. For example, Ethereum Mainnet has a ,chain_id, of ,1, while Ethereum Kovan Testnet has a ,chain_id, of ,42,.Note:, the Covalent API supports both the ,chain_id, as an integer as well as the chain ,name,. For example, you can use the value of ,1, or ,eth-mainnet, in your path parameter.See the full list of Covalent API ,, and their corresponding ,chain_id, and ,name, values.

Question 5

What are the current API rate limits?

Accepted Answer

See the Covalent API ,, for details on rate limits for the free and premium API tiers.

Question 6

What if you need a higher API rate limit?

Accepted Answer

Covalent offers paid ,, for select endpoints which offer higher rate limits.

Question 7

Why do you only get back 100 items (or rows) of data?

Accepted Answer

By default, the API returns 100 items in a single page. To get all the data, pass a large value for the ,page-size, parameter in your request.

Question 8

What do the following error messages mean in the context of the Covalent API?

Accepted Answer

Error codes:,,,,,,,

Question 9

How do you get data in CSV format?

Accepted Answer

Just use the query parameter ,format=csv, in your request. For example:Using our ,,, you can also switch to Analyst Mode in the Global Settings and download files directly in CSV format.How do you fix the ,CORS header 'Access-Control-Allow-Origin' missing, error?, is an HTTP header-based mechanism that allows a server to indicate any origins (domain, scheme, or port) other than its own from which a browser should permit loading resources. If you are running your app locally on ,localhost,, you may run into this error when trying to make API calls.One workaround is to use this ,,.

Question 10

Why is the logo_url missing in the response of Get token balances for address?

Accepted Answer

We fetch token logos from the Trust Wallet ,,. If your logo isn't available there, the token balances endpoint won't be able to fetch it.Use the Trust Wallet ,, to add your token and corresponding logo.

Question 11

Why are some NFT collections not found using the Get historical data for NFT collection endpoint, even though they're found using the Get NFT external metadata for contract?

Accepted Answer

The ,Get historical data for NFT Collection, only supports collections that have had ,sales activity, on a ,,.Get NFT external metadata for contract, supports ,all, chains and collections.

Question 12

Why does the call to Get token balances for address sometimes timeout when using the nft=true option?

Accepted Answer

Timouts using the ,nft=true, option are likely due to corresponding timeouts with an ,external service call, made by our API to fetch the NFT metadata. You can confirm this by making the same call and setting ,no-nft-fetch=true, and see if that returns successfully.

Question 13

What's a 'dust' token?

Accepted Answer

When fetching token balances for an Externally Owned Account (,EOA,), if a token's ,quote, value is less than ,0.10, USD equivalent, it's classified as ,dust,.

Question 14

How does Covalent determine if an address is involved in a transaction?

Accepted Answer

What criteria does Covalent use for determining if an address is involved in a transaction? Covalent's transactions endpoints that accept addresses as input will return all transactions where the address appears in:,,,

Question 15

Why are there data issues with the PancakeSwap endpoints?

Accepted Answer

The standalone PancakeSwap Class B endpoints are no longer maintained as PancakeSwap is now a supported DEX under the ,XY=K, category of endpoints.You can try the PancakeSwap ,XY=K, ,, using ,pancakeswap_v2, as the ,dexname, and ,chain_id, of ,56, or ,bsc-mainnet, for BSC Mainnet.

Question 16

Why are the token quote rates different than the rates from another provider like CoinGecko?

Accepted Answer

Token quote rates are currently fetched in BTC and then converted into USD which likely causes the discrepancies. This will be changed soon with the launch of a new pricing endpoint powered by AMMs across all supported blockchains.

Question 17

Why are quote_rates for some tokens unusually high?

Accepted Answer

When token prices aren't available from our pricing provider, we attempt to calculate the ,quote_rate, ourselves based on its trading parameters from an automated market maker (AMM). Certain tokens that are being traded this way have extremely low trading volume, which when used as an input to an AMM pricing calculation leads to very high token prices. At this time, we recommend users implement a ,quote_rate, threshold to filter out these low-volume tokens where the ,quote_rate, is too high.

Question 18

What does the message 'Support for chain 'klaytn-mainnet' has been sunsetted'?

Accepted Answer

This message means that the foundation's support contract with Covalent has expired and we've decided to discontinue support for the chain.

Question 19

How do you contact Developer Support when you're stuck?

Accepted Answer

We've API support staff available on ,,. Please ask all questions in the ,#feedback-and-support, channel.

FAQ

General Use

How do you query an endpoint?

What can you build using the API?

When should you use Basic Auth over authenticating via query parameter?

What's the chain_id?

What are the current API rate limits?

What if you need a higher API rate limit?

Why do you only get back 100 items (or rows) of data?

What do the following error messages mean in the context of the Covalent API?

How do you get data in CSV format?

Class A Endpoints

Why is the logo_url missing in the response of Get token balances for address?

Why are some NFT collections not found using the Get historical data for NFT collection endpoint, even though they're found using the Get NFT external metadata for contract?

Why does the call to Get token balances for address sometimes timeout when using the nft=true option?

What's a "dust" token?

How does Covalent determine if an address is involved in a transaction?

Class B Endpoints

Why are there data issues with the PancakeSwap endpoints?

Pricing Endpoints

Why are the token quote rates different than the rates from another provider like CoinGecko?

Why are quote_rates for some tokens unusually high?

Miscellaneous

What does the message "Support for chain 'klaytn-mainnet' has been sunsetted"?

How do you contact Developer Support when you're stuck?

Was this helpful?

Get the Covalent newsletter.

Products

Use Cases

Developer

Covalent Network

Company