Covalent
Our Free Tier changed on March 1st
Read More
Docs: Docs HomeSupported NetworksUnified APICovalent Network API Reference

Overview

Welcome to the Covalent API!

The Covalent Unified API can be used to pull token balances, positions and historical granular transaction data from dozens of blockchain networks. This data enables hundreds of end-user use-cases like wallets, investor dashboards, taxation tools and as-of-yet unknown use-cases.

Switching from one blockchain network to another is simply changing the chain_name path parameter. It's really that simple.

One Unified API. One Billion Possibilities.

The Covalent API is RESTful. The API is designed around the main resources that's available through the web interface. Sample API calls are provided next to each method using cURL.

Broadly speaking, there are three classes of APIs:

  • Class A - APIs that return enriched blockchain data applicable to all blockchain networks, eg: token balances, transactions, log events, etc.

  • Class B - APIs maintained by Covalent for a specific protocol on a specific blockchain, eg: Constant Product AMMs (XY=K) on various blockchains.

  • Class C - APIs created and maintained by the community.

URL Patterns

The API Host for all requests is https://api.covalenthq.com/v1/. Some additional points to keep in mind:

  • The current version of the API is v1.

  • All requests are done over HTTPS (calls over plain HTTP will fail.)

  • The default return format for all endpoints is JSON, unless the query parameter format=csv is specified.

  • All requests require authentication.

Authentication

To access the Covalent API, you will need an API key. You can find your API key in the web interface. Various authentication mechanisms are available:

Authentication via Query parameter

curl -X GET https://api.covalenthq.com/v1/ENDPOINT/?key=API_KEY

Simply append key=API_KEY as a query parameter to all requests. The main advantage of this method is to embed the API endpoints within applications that do not support more sophisticated auth mechanisms, like Google Sheets or as IFrames.

Authentication via Basic Auth

curl -X GET https://api.covalenthq.com/v1/ENDPOINT/ \
     -u API_KEY:
     -H 'Content-Type: application/json'
     # The colon prevents curl from asking for a password.

Provide your API key as the basic auth username. You can find your API key in the web interface. You do not need to provide a password.

Use of $CQT (Covalent Query Token)

The Covalent API does not require the CQT token in order to use it. CQT is a staking and governance token and for every API call, CQT is market bought and distributed to the service providers who are fulfilling the API requests. This "fee switch" mechanism is yet to launch.

Response format

❴ 
    "data": ...,
    "error": false,
    "error_message": null,
    "error_code": null
❵

By default, the Covalent API returns JSON responses with the same shape for all endpoints. The main keys are data, error, error_message and error_code.

You can ask for a CSV format by sending the format=csv query parameter.

Supported Networks

Covalent supports over 70+ different blockchains all with the same unified API. For a full list see here.

Rate limiting & Premium Tier

We have a limit of 5 requests per second per API key for free users. Furthermore, free users are also limited to 100,000 credits per month, reset on the first of each month.

If you upgrade to a Premium Tier, you get access to higher rate limits and the ability to unlock flex credits.

Refresh rate

We classify the APIs as:

  • real time

  • batched

Real-time endpoints have a delay of 2 blocks – for example, on blockchains like Ethereum with block times of 15 seconds, the delay will be 30 seconds which on blockchains like Polygon with blocktimes of 3 seocnds, the delay will be 6 seconds.

Batched endpoints have a delay of 30 minutes.

Pagination

Certain endpoints take two parameters: page-size and page-number implementing offset-limit pagination.

Error codes

Covalent uses standard HTTP response codes to indicate the success or failure of an API request. In general: codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, etc.). Codes in the 5xx range indicate an error with Covalent's servers (these are rare).

CodeDescription
200 - OKEverything worked as expected.
400 - Bad RequestThe request could not be accepted, usually due to a missing required parameter.
401 - UnauthorizedNo valid API key was provided.
404 - Not FoundThe request path does not exist.
429 - Too Many RequestsYou are being rate-limited. Please see the rate limiting section for more information.
500, 502, 503 - Server ErrorsSomething went wrong on Covalent's servers. These are rare.

Support channels

Support is available via multiple channels:

Change log

Available here.

Class A

APIs that return enriched blockchain data applicable to all blockchain networks, eg: token balances, transactions, log events, etc.

Get token balances for address

GET/v1/{chainName}/address/{walletAddress}/balances_v2/

Commonly used to fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata.

Each API Call Currently Costs: 1.00 Credits.

Show BalancesResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/address/{walletAddress}/balances_v2/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get historical portfolio value over time

GET/v1/{chainName}/address/{walletAddress}/portfolio_v2/

Commonly used to render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days. Add `&days={days}` to the end of your query to configure the timeframe, eg. `&days=100`.

Each API Call Currently Costs: 2.00 Credits per 30 days.

Show PortfolioResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/address/{walletAddress}/portfolio_v2/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get ERC20 token transfers for address

GET/v1/{chainName}/address/{walletAddress}/transfers_v2/

Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.

Each API Call Currently Costs: 0.05 Credits per item.

Show Erc20TransfersResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/address/{walletAddress}/transfers_v2/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get token holders as of any block height

GET/v1/{chainName}/tokens/{tokenAddress}/token_holders/

Commonly used to render a pie chart of the token holders either historically or as of the latest block (default).

Each API Call Currently Costs: 2.00 Credits.

Show TokenHoldersResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/tokens/{tokenAddress}/token_holders/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get NFTs for address

GET/v1/{chainName}/address/{walletAddress}/balances_nft/

Commonly used to render the NFTs (including ERC721 and ERC1155) held by an address.

Each API Call Currently Costs: 1.00 Credits.

Show NftAddressBalanceNftResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/address/{walletAddress}/balances_nft/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get NFT token IDs for contract with metadata

GET/v1/{chainName}/nft/{contractAddress}/metadata/{tokenId}/

Commonly used to get a single NFT metadata by token ID from a collection. Useful for building NFT card displays.

Each API Call Currently Costs: 2.00 Credits.

Show NftMetadataResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/nft/{contractAddress}/metadata/{tokenId}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get NFT transactions for contract

GET/v1/{chainName}/tokens/{contractAddress}/nft_transactions/{tokenId}/

Commonly used to get all transactions of an NFT token. Useful for building a transaction history table or price chart.

Each API Call Currently Costs: 0.10 Credits per item.

Show NftTransactionsResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/tokens/{contractAddress}/nft_transactions/{tokenId}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get Traits for a collection

GET/v1/{chainName}/nft/{collectionContract}/traits/

Commonly used to fetch and render the traits of a collection as seen in rarity calculators.

Each API Call Currently Costs: 2.00 Credits.

Show NftCollectionTraitsResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/nft/{collectionContract}/traits/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get Attributes for a collection trait

GET/v1/{chainName}/nft/{collectionContract}/traits/{trait}/attributes/

Commonly used to render deeper stats on the attributes for a collections's traits.

Each API Call Currently Costs: 2.00 Credits.

Show NftCollectionAttributesForTraitResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/nft/{collectionContract}/traits/{trait}/attributes/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get Trait Summary for collection

GET/v1/{chainName}/nft/{collectionContract}/traits_summary/

Commonly used to calculate rarity scores for a collection based on its traits.

Each API Call Currently Costs: 5.00 Credits.

Show NftCollectionTraitSummaryResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/nft/{collectionContract}/traits_summary/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions for address

GET/v1/{chainName}/address/{walletAddress}/transactions_v2/

Commonly used to fetch the transactions involving an address including the decoded log events.

Each API Call Currently Costs: 0.10 Credits per item.

Show TransactionsResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/address/{walletAddress}/transactions_v2/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get a transaction

GET/v1/{chainName}/transaction_v2/{txHash}/

Commonly used to fetch and render a single transaction including its decoded log events.

Each API Call Currently Costs: 0.10 Credits.

Show TransactionResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/transaction_v2/{txHash}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get recent transactions for address (v3)

GET/v1/{chainName}/address/{walletAddress}/transactions_v3/

Commonly used to fetch and render the most recent transactions involving an address. Frequently seen in wallet applications.

Each API Call Currently Costs: 0.10 Credits per item.

Show RecentTransactionsResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/address/{walletAddress}/transactions_v3/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get paginated transactions for address (v3)

GET/v1/{chainName}/address/{walletAddress}/transactions_v3/page/{page}/

Commonly used to fetch the transactions involving an address including the decoded log events in a paginated fashion.

Each API Call Currently Costs: 0.10 Credits per item.

Show TransactionsResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/address/{walletAddress}/transactions_v3/page/{page}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all transactions in a block (v3)

GET/v1/{chainName}/block/{blockHeight}/transactions_v3/page/{page}/

Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.

Each API Call Currently Costs: 0.10 Credits per item.

Show TransactionsBlockPageResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/block/{blockHeight}/transactions_v3/page/{page}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all transactions in a block by page (v3)

GET/v1/{chainName}/block/{blockHeight}/transactions_v3/page/{page}/

Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.

Each API Call Currently Costs: 0.10 Credits per item.

Show TransactionsBlockPageResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/block/{blockHeight}/transactions_v3/page/{page}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get bulk time bucket transactions for address (v3)

GET/v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/

Commonly used to fetch all transactions including their decoded log events in a 15-minute time bucket interval.

Each API Call Currently Costs: 0.10 Credits per item.

Show TransactionsTimeBucketResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get a block

GET/v1/{chainName}/block_v2/{blockHeight}/

Commonly used to fetch and render a single block for a block explorer.

Each API Call Currently Costs: 0.00 Credits.

Show BlockResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/block_v2/{blockHeight}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get block heights

GET/v1/{chainName}/block_v2/{startDate}/{endDate}/

Commonly used to get all the block heights within a particular date range. Useful for rendering a display where you sort blocks by day.

Each API Call Currently Costs: 0.00 Credits.

Show BlockHeightsResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/block_v2/{startDate}/{endDate}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get logs

GET/v1/events/{chainName}/events/

Commonly used to get all the event logs of the latest block, or for a range of blocks. Includes sender contract metadata as well as decoded logs.

Each API Call Currently Costs: 0.00 Credits.

Show GetLogsResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/events/{chainName}/events/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get log events by contract address

GET/v1/{chainName}/events/address/{contractAddress}/

Commonly used to get all the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions.

Each API Call Currently Costs: 0.00 Credits.

Show LogEventsByAddressResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/events/address/{contractAddress}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get log events by topic hash(es)

GET/v1/{chainName}/events/topics/{topicHash}/

Commonly used to get all event logs of the same topic hash across all contracts within a particular chain. Useful for cross-sectional analysis of event logs that are emitted on-chain.

Each API Call Currently Costs: 0.00 Credits.

Show LogEventsByTopicHashResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/events/topics/{topicHash}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all chains

GET/v1/chains/

Commonly used to build internal dashboards for all supported chains on Covalent.

Each API Call Currently Costs: 0.00 Credits.

Show AllChainsResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/chains/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all chain statuses

GET/v1/chains/status/

Commonly used to build internal status dashboards of all supported chains.

Each API Call Currently Costs: 0.00 Credits.

Show AllChainsStatusResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/chains/status/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Class B

APIs maintained by Covalent for a specific protocol on a specific blockchain, eg: Constant Product AMMs (XY=K) on various blockchains.

Get XY=K pools

GET/v1/{chainName}/xy=k/{dexName}/pools/

Commonly used to get all the pools of a particular DEX. Supports most common DEXs (Uniswap, SushiSwap, etc), and returns detailed trading data (volume, liquidity, swap counts, fees, LP token prices).

Each API Call Currently Costs: 2.00 Credits.

Show PoolResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/xy=k/{dexName}/pools/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get XY=K pools by address

GET/v1/{chainName}/xy=k/{dexName}/pools/address/{poolAddress}/

Commonly used to get the 7 day and 30 day time-series data (volume, liquidity, price) of a particular liquidity pool in a DEX. Useful for building time-series charts on DEX trading activity.

Each API Call Currently Costs: 2.00 Credits.

Show PoolByAddressResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/xy=k/{dexName}/pools/address/{poolAddress}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get XY=K address exchange balances

GET/v1/{chainName}/xy=k/{dexName}/address/{accountAddress}/balances/

Commonly used to return balance of a wallet/contract address on a specific DEX.

Each API Call Currently Costs: 2.00 Credits.

Show AddressExchangeBalancesResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/xy=k/{dexName}/address/{accountAddress}/balances/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get XY=K network exchange tokens

GET/v1/{chainName}/xy=k/{dexName}/tokens/

Commonly used to get the balance of a wallet address in a DEX. Useful for finding out user balances locked up in DEX pools.

Each API Call Currently Costs: 2.00 Credits.

Show NetworkExchangeTokensResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/xy=k/{dexName}/tokens/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get XY=K supported DEXes

GET/v1/xyk/supported_dexes/

Commonly used to get all the supported DEXs available for the xy=k endpoints, along with the swap fees and factory addresses.

Each API Call Currently Costs: 1.00 Credits.

Show SupportedDexesResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/xyk/supported_dexes/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get XY=K single network exchange token

GET/v1/{chainName}/xy=k/{dexName}/tokens/address/{tokenAddress}/

Commonly used to get historical daily swap count for a single network exchange token.

Each API Call Currently Costs: 2.00 Credits.

Show SingleNetworkExchangeTokenResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/xy=k/{dexName}/tokens/address/{tokenAddress}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get XY=K transactions for account address

GET/v1/{chainName}/xy=k/{dexName}/address/{accountAddress}/transactions/

Commonly used to get all the DEX transactions of a wallet. Useful for building tables of DEX activity segmented by wallet.

Each API Call Currently Costs: 0.10 Credits per item.

Show TransactionsForAccountAddressResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/xy=k/{dexName}/address/{accountAddress}/transactions/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get XY=K transactions for token address

GET/v1/{chainName}/xy=k/{dexName}/tokens/address/{tokenAddress}/transactions/

Commonly used to get all the transactions of a token within a particular DEX. Useful for getting a per-token view of DEX activity.

Each API Call Currently Costs: 0.10 Credits per item.

Show TransactionsForTokenAddressResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/xy=k/{dexName}/tokens/address/{tokenAddress}/transactions/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get XY=K transactions for exchange

GET/v1/{chainName}/xy=k/{dexName}/pools/address/{poolAddress}/transactions/

Commonly used for getting all the transactions of a particular DEX liquidity pool. Useful for building a transactions history table for an individual pool.

Each API Call Currently Costs: 0.10 Credits per item.

Show TransactionsForExchangeResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/xy=k/{dexName}/pools/address/{poolAddress}/transactions/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get XY=K ecosystem chart data

GET/v1/{chainName}/xy=k/{dexName}/ecosystem/

Commonly used to get a 7d and 30d time-series chart of DEX activity. Includes volume and swap count.

Each API Call Currently Costs: 4.00 Credits.

Show EcosystemChartDataResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/xy=k/{dexName}/ecosystem/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get XY=K health data

GET/v1/{chainName}/xy=k/{dexName}/health/

Commonly used to ping the health of xy=k endpoints to get the synced block height per chain.

Each API Call Currently Costs: 0.00 Credits.

Show HealthDataResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/{chainName}/xy=k/{dexName}/health/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Pricing

Get historical token prices

GET/v1/pricing/historical_by_addresses_v2/{chainName}/{quoteCurrency}/{contractAddress}/

Commonly used to get historic prices of a token between date ranges. Supports native tokens.

Each API Call Currently Costs: 1.00 Credits.

Show TokenPricesResponse Object
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/pricing/historical_by_addresses_v2/{chainName}/{quoteCurrency}/{contractAddress}/ 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Class C

APIs created and maintained by the community.

Get market data by address

GET/v1/cq/covalent/app/aave/market_data/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/aave/market_data 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all markets

GET/v1/cq/covalent/app/aave/markets/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/aave/markets 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get balances for a wallet address

GET/v1/cq/covalent/app/aave/balances/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/aave/balances 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions by wallet address

GET/v1/cq/covalent/app/aave/transactions/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/aave/transactions 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get redeemable token balance

GET/v1/cq/covalent/app/balancer/tokens/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/balancer/tokens 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get market data by address

GET/v1/cq/covalent/app/balancer/market_data/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/balancer/market_data 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all markets

GET/v1/cq/covalent/app/balancer/markets/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/balancer/markets 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions by wallet address

GET/v1/cq/covalent/app/balancer/transactions/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/balancer/transactions 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get balances for a wallet address

GET/v1/cq/covalent/app/balancer/balances/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/balancer/balances 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions by wallet address

GET/v1/cq/covalent/app/bitcoin/transactions/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/bitcoin/transactions 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get market data by address

GET/v1/cq/covalent/app/compound/market_data/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/compound/market_data 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all markets

GET/v1/cq/covalent/app/compound/markets/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/compound/markets 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get balances for a wallet address

GET/v1/cq/covalent/app/compound/balances/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/compound/balances 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions by wallet address

GET/v1/cq/covalent/app/compound/transactions/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/compound/transactions 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get redeemable token balance

GET/v1/cq/covalent/app/curve/tokens/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/curve/tokens 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get market data by address

GET/v1/cq/covalent/app/curve/market_data/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/curve/market_data 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all markets

GET/v1/cq/covalent/app/curve/markets/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/curve/markets 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions by wallet address

GET/v1/cq/covalent/app/curve/transactions/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/curve/transactions 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get balances for a wallet address

GET/v1/cq/covalent/app/curve/balances/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/curve/balances 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get market data by address

GET/v1/cq/covalent/app/dodo/market_data/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/dodo/market_data 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all markets

GET/v1/cq/covalent/app/dodo/markets/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/dodo/markets 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions by wallet address

GET/v1/cq/covalent/app/dodo/transactions/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/dodo/transactions 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get balances for a wallet address

GET/v1/cq/covalent/app/dodo/balances/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/dodo/balances 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get redeemable token balance

GET/v1/cq/covalent/app/frax/tokens/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/frax/tokens 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get market data by address

GET/v1/cq/covalent/app/frax/market_data/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/frax/market_data 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all markets

GET/v1/cq/covalent/app/frax/markets/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/frax/markets 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get balances for a wallet address

GET/v1/cq/covalent/app/frax/balances/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/frax/balances 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions by wallet address

GET/v1/cq/covalent/app/frax/transactions/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/frax/transactions 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all markets

GET/v1/cq/covalent/app/instadapp/markets/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/instadapp/markets 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get market data by address

GET/v1/cq/covalent/app/instadapp/market_data/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/instadapp/market_data 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions by wallet address

GET/v1/cq/covalent/app/instadapp/transactions/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/instadapp/transactions 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get balances for a wallet address

GET/v1/cq/covalent/app/instadapp/balances/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/instadapp/balances 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get market data by address

GET/v1/cq/covalent/app/lido/market_data/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/lido/market_data 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get balances for a wallet address

GET/v1/cq/covalent/app/lido/balances/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/lido/balances 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions by wallet address

GET/v1/cq/covalent/app/lido/transactions/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/lido/transactions 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get market data by address

GET/v1/cq/covalent/app/yearn/market_data/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/yearn/market_data 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get all markets

GET/v1/cq/covalent/app/yearn/markets/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/yearn/markets 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get transactions by wallet address

GET/v1/cq/covalent/app/yearn/transactions/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/yearn/transactions 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'

Get balances for a wallet address

GET/v1/cq/covalent/app/yearn/balances/
  1. shell
  2. JavaScript
  3. ruby
  4. python
Request
curl --request GET 
     --url https://api.covalenthq.com/v1/cq/covalent/app/yearn/balances 
     --header 'accept: application/json' 
     --header 'x-api-key: demo'
  • Select Chain
  • Bitcoin
  • Ethereum
  • Polygon
  • BNB Smart Chain (BSC)
  • Avalanche C-Chain
  • Fantom
  • Arbitrum
  • Astar
  • Shiden
  • Aurora
  • Axie/Ronin
  • Base Testnet
  • BitTorrent
  • Canto
  • ConsenSys zkEVM Testnet
  • Covalent
  • Cronos
  • Oasis
  • Evmos
  • Flare
  • Harmony
  • KCC
  • Mantle Testnet
  • Meter
  • Metis
  • Milkomeda A1
  • Milkomeda C1
  • Moonbeam
  • Moonriver
  • Nervos Godwoken
  • Oasys
  • Optimism
  • Palm
  • Rootstock
  • SKALE
  • Solana
  • HECO
  • IoTeX
  • Klaytn

    © 2023 Covalent