Tokens (Beta)
This endpoint is currently in beta and requires authentication using a normal Dune API key. The chain_ids query parameter is mandatory.
The Tokens API provides metadata and real-time pricing information for native and ERC20 tokens on supported EVM blockchains. The API returns:
- Token metadata (symbol, name, decimals)
- Current USD pricing information
- Supply information
- Logo URLs when available
To fetch tokens for all supported chains, pass the chain_ids=all parameter. See EVM Supported Chains for more details. You can also specify specific chains with ?chain_ids=11,250,1.
Response Fields
| Field | Description | Type |
|---|---|---|
| contract_address | Contract address for an ERC20 token or native | string |
| chain_id | The ID of the blockchain | integer |
| chain | The name of the blockchain | string |
| price_usd | The price of the token in USD, if available | double |
| total_supply | The total supply of the token | string |
| fully_diluted_value | Fully diluted value of the total supply in USD, if available | double |
| pool_size | Current size of pool used to price the token in USD, if available | double |
| symbol | Symbol of token, if available | string |
| name | Name of token, if available | string |
| logo | URL of the image logo for the token, if available | string |
| decimals | Decimals of token, if available | integer |
Token Prices
Echo looks up prices onchain. We use the most liquid onchain pair to determine a usd price. We return the available liquidity in pool_size as part of the response.
Pagination
This endpoint uses cursor-based pagination. You can use the limit parameter to define the maximum page size.
Results might at times be less than the maximum page size.
The next_offset value is included in the initial response and can be utilized to fetch the next page of results by passing it as the offset query parameter in the next request.
next_offset to set the offset parameter of the next page of results. Using your own offset value will not have any effect.Headers
API key to access the service
Path Parameters
The contract address of the token or 'native' for the native token of the chain
Query Parameters
Either 'all' or a comma separated list of chain ids to get balances for
The offset to paginate through result sets; this is a cursor being passed from the previous response, only use what the backend returns here
x >= 0Maximum number of prices to return
Was this page helpful?