GET
https://api.sim.dune.com
/
v1
/
evm
/
token-info
/
{uri}
curl --request GET \
  --url https://api.sim.dune.com/v1/evm/token-info/{uri} \
  --header 'X-Sim-Api-Key: <x-sim-api-key>'
{
  "contract_address": "native",
  "tokens": [
    {
      "chain": "ethereum",
      "chain_id": 1,
      "price_usd": 12.34,
      "symbol": "ETH"
    }
  ]
}

The Tokens API provides metadata and realtime 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

The ?chain_ids query parameter is mandatory. To fetch tokens for all supported chains, pass the ?chain_ids=all query parameter. You can also specify specific chains with ?chain_ids=11,250,1.

Token Prices

Sim 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.

You can only use the value from next_offset to set the offset parameter of the next page of results. Using your own offset value will not have any effect.

Headers

X-Sim-Api-Key
string
required

API key to access the service

Path Parameters

uri
string
required

The contract address of the token or 'native' for the native token of the chain

Query Parameters

chain_ids
string | null
required

Either 'all' or a comma separated list of chain ids to get token info for

limit
integer | null

Maximum number of prices to return

Required range: x >= 0
offset
string

The offset to paginate through result sets; this is a cursor being passed from the previous response, only use what the backend returns here

Response

200
application/json

Successful Response

The response is of type object.