Docs: Docs HomeSupported NetworksUnified APICovalent NetworkIncrementAPI Reference

Unified API Catalog

ClassCredit rate modelCredit rate
Class A - Token Balances
1 Get token balances for address
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.
Class AFixed1.00 Credits
2 Get historical token balances for address
Commonly used to fetch the historical native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address at a given block height or date. Response includes daily prices and other metadata.
Class AFixed1.00 Credits
3 Get native token balance for address
Commonly used to get the native token balance for an address. This endpoint is required because native tokens are usually not ERC20 tokens and sometimes you want something lightweight.
Class AFixed0.50 Credits
4 Get historical portfolio value over time
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.
Class ALinear2.00 Credits per 30 days
5 Get ERC20 token transfers for address
Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.
Class ALinear0.05 Credits per item
6 Get token holders as of any block height (v2)
Commonly used to get a list of all the token holders for a specified ERC20 or ERC721 token. Returns historic token holders when block-height is set (defaults to `latest`). Useful for building pie charts of token holders.
Class ALinear0.02 Credits per item
Class A - Transactions
7 Get a transaction
Commonly used to fetch and render a single transaction including its decoded log events. Additionally return semantically decoded information for DEX trades, lending and NFT sales.
Class AFixed0.10 Credits
8 Get transaction summary for address
Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet. Calculate the age of the wallet and the time it has been idle and quickly gain insights into their engagement with web3.
Class AFixed1.00 Credits
9 Get earliest transactions for address (v3)
Commonly used to fetch and render the earliest transactions involving an address. Frequently seen in wallet applications.
Class ALinear0.10 Credits per item
10 Get recent transactions for address (v3)
Commonly used to fetch and render the most recent transactions involving an address. Frequently seen in wallet applications.
Class ALinear0.10 Credits per item
11 Get paginated transactions for address (v3)
Commonly used to fetch the transactions involving an address including the decoded log events in a paginated fashion.
Class ALinear0.10 Credits per item
12 Get bulk time bucket transactions for address (v3)
Commonly used to fetch all transactions including their decoded log events in a 15-minute time bucket interval.
Class ALinear0.10 Credits per item
13 Get all transactions in a block (v3)
Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.
Class ALinear0.10 Credits per item
14 Get all transactions in a block by page (v3)
Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.
Class ALinear0.10 Credits per item
Class A - NFT
Core rendering
15 Get NFTs for address
Commonly used to render the NFTs (including ERC721 and ERC1155) held by an address.
Class AFixed1.00 Credits
16 Get NFTs from contract with metadata
Commonly used to get NFT token IDs with metadata from a collection. Useful for building NFT card displays.
Class AFixed15.00 Credits
17 Get single NFT with cached metadata from contract
Commonly used to get a single NFT metadata by token ID from a collection. Useful for building NFT card displays.
Class AFixed2.00 Credits
18 Get NFT transactions for contract
Commonly used to get all transactions of an NFT token. Useful for building a transaction history table or price chart.
Class ALinear0.10 Credits per item
19 Get traits for a collection
Commonly used to fetch and render the traits of a collection as seen in rarity calculators.
Class AFixed2.00 Credits
20 Get trait summary for collection
Commonly used to calculate rarity scores for a collection based on its traits.
Class AFixed5.00 Credits
21 Get attributes for a collection trait
Commonly used to get the count of unique values for traits within an NFT collection.
Class AFixed2.00 Credits
22 Get chain collections
Commonly used to fetch the list of NFT collections with downloaded and cached off chain data like token metadata and asset files.
Class AFixed0.01 Credits
Ownership & Token gating
23 Check ownership in NFT collection
Commonly used to verify ownership of NFTs (including ERC-721 and ERC-1155) within a collection.
Class AFixed1.00 Credits
24 Check ownership in NFT collection for specific token
Commonly used to verify ownership of a specific token (ERC-721 or ERC-1155) within a collection.
Class AFixed1.00 Credits
Class A - Security
25 Get token approvals for address
Commonly used to get a list of approvals across all token contracts categorized by spenders for a wallet’s assets.
Class AFixed2.00 Credits
26 Get NFT approvals for address
Commonly used to get a list of NFT approvals across all token contracts categorized by spenders for a wallet’s assets.
Class AFixed2.00 Credits
Class A - Base
27 Get a block
Commonly used to fetch and render a single block for a block explorer.
Class AFixed1.00 Credits
28 Get block heights
Commonly used to get all the block heights within a particular date range. Useful for rendering a display where you sort blocks by day.
Class AFixed1.00 Credits
29 Get logs
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.
Class ALinear5.00 Credits per block
30 Get log events by contract address
Commonly used to get all the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions.
Class ALinear0.01 Credits per item
31 Get log events by topic hash(es)
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.
Class ALinear0.01 Credits per item
32 Get resolved address for registered address
Commonly used to resolve ENS, RNS and Unstoppable Domains addresses.
Class AFixed1.00 Credits
33 Get all chains
Commonly used to build internal dashboards for all supported chains on Covalent.
Class AFixed0.01 Credits
34 Get all chain statuses
Commonly used to build internal status dashboards of all supported chains.
Class AFixed1.00 Credits
35 Get gas prices
Get real-time gas estimates for different transaction speeds on a specific network, enabling users to optimize transaction costs and confirmation times.
Class AFixed1.00 Credits
36 Get cross-chain activity for address
Commonly used to locate chains which an address is active on with a single API call.
Class AFixed0.50 Credits
Class B - XY=K
37 Get XY=K 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).
Class BFixed1.00 Credits
38 Get XY=K pool by address
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.
Class BFixed1.00 Credits
39 Get XY=K pools for ERC20 token address
Commonly used to get all pools and the supported DEX for a token. Useful for building a table of top pairs across all supported DEXes that the token is trading on.
Class BFixed1.00 Credits
40 Get XY=K pools for wallet address
Commonly used to get all pools and supported DEX for a wallet. Useful for building a personal DEX UI showcasing pairs and supported DEXes associated to the wallet.
Class BFixed1.00 Credits
41 Get XY=K address exchange balances
Commonly used to return balance of a wallet/contract address on a specific DEX.
Class BFixed1.00 Credits
42 Get XY=K network exchange tokens
Commonly used to retrieve all network exchange tokens for a specific DEX. Useful for building a top tokens table by total liquidity within a particular DEX.
Class BFixed1.00 Credits
43 Get XY=K supported DEXes
Commonly used to get all the supported DEXs available for the xy=k endpoints, along with the swap fees and factory addresses.
Class BFixed0.01 Credits
44 Get XY=K DEX for pool address
Commonly used to get the corresponding supported DEX given a pool address, along with the swap fees, DEX's logo url, and factory addresses. Useful to identifying the specific DEX to which a pair address is associated.
Class BFixed1.00 Credits
45 Get XY=K swap count for exchange token
Commonly used to get historical daily swap count for a single network exchange token.
Class BFixed1.00 Credits
46 Get XY=K network liquidity pool token details
Commonly used to get a detailed view for a single liquidity pool token. Includes time series data.
Class BFixed1.00 Credits
47 Get XY=K transactions for account address
Commonly used to get all the DEX transactions of a wallet. Useful for building tables of DEX activity segmented by wallet.
Class BFixed1.00 Credits
48 Get XY=K transactions for token address
Commonly used to get all the transactions of a token within a particular DEX. Useful for getting a per-token view of DEX activity.
Class BFixed1.00 Credits
49 Get XY=K transactions for DEX
Commonly used to get all the the transactions for a given DEX. Useful for building DEX activity views.
Class BFixed1.00 Credits
50 Get XY=K transactions for exchange pool
Commonly used for getting all the transactions of a particular DEX liquidity pool. Useful for building a transactions history table for an individual pool.
Class BFixed1.00 Credits
51 Get XY=K ecosystem chart data
Commonly used to get a 7d and 30d time-series chart of DEX activity. Includes volume and swap count.
Class BFixed1.00 Credits
52 Get XY=K health data
Commonly used to ping the health of xy=k endpoints to get the synced block height per chain.
Class BFixed1.00 Credits
Pricing
Get historical token prices
Commonly used to get historic prices of a token between date ranges. Supports native tokens.
PricingFixed1.00 Credits
Class C - Aave
53 Get market data by address
Get market data for a specific Aave lending pool.
Class CLinear1.00 Credits
54 Get all markets
Get all markets for Aave including TVL, Supply and Borrow rates.
Class CLinear1.00 Credits
55 Get balances for a wallet address
Get balances for a Aave wallet.
Class CLinear1.00 Credits
56 Get transactions by wallet address
Get transactions for a Aave wallet.
Class CLinear1.00 Credits
Class C - Balancer
57 Get redeemable token balance
Get underlying tokens for a wallet's LP tokens.
Class CLinear1.00 Credits
58 Get market data by address
Get market data for a specific Balancer pool.
Class CLinear1.00 Credits
59 Get all markets
Get all markets for Balancer including TVL, Supply and Borrow rates.
Class CLinear1.00 Credits
60 Get transactions by wallet address
Get transactions for a Balancer wallet.
Class CLinear1.00 Credits
61 Get balances for a wallet address
Get balances for a Balancer wallet.
Class CLinear1.00 Credits
Class C - Bitcoin
62 Get transactions by wallet address
Get transactions for a Bitcoin wallet.
Class CLinear1.00 Credits
Class C - Compound
63 Get market data by address
Get market data for a specific Compound lending pool.
Class CLinear1.00 Credits
64 Get all markets
Get all markets for Compound including TVL, Supply and Borrow rates.
Class CLinear1.00 Credits
65 Get balances for a wallet address
Get balances for a Compound wallet.
Class CLinear1.00 Credits
66 Get transactions by wallet address
Get transactions for a Compound wallet.
Class CLinear1.00 Credits
Class C - Curve
67 Get redeemable token balance
Get underlying tokens for a wallet's LP tokens.
Class CLinear1.00 Credits
68 Get market data by address
Get market data for all Curve pools.
Class CLinear1.00 Credits
69 Get all markets
Get all markets for Curve including TVL, Supply and Borrow rates.
Class CLinear1.00 Credits
70 Get transactions by wallet address
Get transactions for a Curve wallet.
Class CLinear1.00 Credits
71 Get balances for a wallet address
Get balances for a Curve wallet.
Class CLinear1.00 Credits
Class C - Dodo
72 Get market data by address
Get market data for a specific Dodo pool.
Class CLinear1.00 Credits
73 Get all markets
Get all markets for Dodo.
Class CLinear1.00 Credits
74 Get transactions by wallet address
Get transactions for a Dodo wallet.
Class CLinear1.00 Credits
75 Get balances for a wallet address
Get balances for a Dodo wallet.
Class CLinear1.00 Credits
Class C - Frax Lending
76 Get redeemable token balance
Get underlying tokens for a wallet's LP tokens.
Class CLinear1.00 Credits
77 Get market data by address
Get market data for a specific Frax lending pool.
Class CLinear1.00 Credits
78 Get all markets
Get all markets for Frax including TVL, Supply and Borrow rates.
Class CLinear1.00 Credits
79 Get balances for a wallet address
Get balances for a Frax wallet.
Class CLinear1.00 Credits
80 Get transactions by wallet address
Get transactions for a Frax wallet.
Class CLinear1.00 Credits
Class C - InstaDapp
81 Get all markets
Get all markets for InstaDapp.
Class CLinear1.00 Credits
82 Get market data by address
Get market data for all InstaDapp vaults.
Class CLinear1.00 Credits
83 Get transactions by wallet address
Get transactions for a InstaDapp wallet.
Class CLinear1.00 Credits
84 Get balances for a wallet address
Get balances for a InstaDapp wallet.
Class CLinear1.00 Credits
Class C - Lido
85 Get market data by address
Get market data for a specific Lido lending pool.
Class CLinear1.00 Credits
86 Get balances for a wallet address
Get balances for a Lido wallet.
Class CLinear1.00 Credits
87 Get transactions by wallet address
Get transactions for a Lido wallet.
Class CLinear1.00 Credits
Class C - Yearn
88 Get market data by address
Get market data for all Yearn vaults.
Class CLinear1.00 Credits
89 Get all markets
Get all markets for Yearn including TVL, Supply and Borrow rates.
Class CLinear1.00 Credits
90 Get transactions by wallet address
Get transactions for a Yearn wallet.
Class CLinear1.00 Credits
91 Get balances for a wallet address
Get balances for a Yearn wallet.
Class CLinear1.00 Credits