GET
/
v1
/
evm
/
balances
/
{uri}
Get EVM token balances for a given address
curl --request GET \
  --url https://api.sim.dune.com/v1/evm/balances/{uri} \
  --header 'X-Sim-Api-Key: <x-sim-api-key>'
{
  "wallet_address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "balances": [
    {
      "chain": "ethereum",
      "chain_id": 1,
      "address": "0x0e36c45d16585d1801e37cfaa577a9ad39f9343a",
      "amount": "45787557175393926414790300082",
      "symbol": "Kendu",
      "name": "Kendu of Bank",
      "decimals": 18,
      "price_usd": 1.233346836175539e+21,
      "value_usd": 5.647193877847869e+31,
      "pool_size": 1233.34683617554,
      "low_liquidity": true
    },
    {
      "chain": "ethereum",
      "chain_id": 1,
      "address": "0x113404d2003c4acf4231a3a62374bb503bff03d7",
      "amount": "432599243131405501735524",
      "symbol": "ALT",
      "name": "AltLayer",
      "decimals": 18,
      "price_usd": 9388386012000030000,
      "value_usd": 4.061408683016688e+24,
      "pool_size": 9.38838601200001,
      "low_liquidity": true
    }
  ],
  "next_offset": "opaque-pagination-token",
  "request_time": "2025-08-13T10:31:08Z",
  "response_time": "2025-08-13T10:31:08Z"
}
Balance Sv The Token Balances API provides accurate and fast real time balances of the native and ERC20 tokens of accounts on supported EVM blockchains.
The Balances API only returns balances for certain low latency chains by default. To learn more see the tags section of the Supported Chains page.

​
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, and show a warning low_liquidity: true if this value is less than $10k.

​
Historical prices

You can request historical point-in-time prices by adding the historical_prices query parameter. Use whole numbers to specify the number of hours in the past. You can request up to three offsets. For example, &historical_prices=168 returns the price 168 hours (1 week) ago. &historical_prices=720,168,24 returns prices 720 hours (1 month) ago, 168 hours (1 week) ago, and 24 hours ago.
The historical_prices parameter is currently supported only on the EVM Balances and EVM Token Info endpoints.
When set, each balance includes a historical_prices array with one entry per offset: 
{
  "balances": [
    {
      "symbol": "ETH",
      "price_usd": 3896.8315,
      "historical_prices": [
        { "offset_hours": 8760, "price_usd": 2816.476803 },
        { "offset_hours": 720,  "price_usd": 3710.384068 },
        { "offset_hours": 168,  "price_usd": 3798.632723 }
      ]
    }
  ]
}
Percent changes are not returned. You can compute your own differences using the price_usd on the balance and the values in historical_prices[].price_usd.
The maximum number of historical price offsets is 3. If more than 3 are provided, the API returns an error.

​
Token Filtering

We also include the pool_size field in all responses, allowing you to implement custom filtering logic based on your specific requirements. For a detailed explanation of our approach, see our Token Filtering guide.

​
Pagination

This endpoint is using cursor based pagination. You can use the limit query parameter to define the maximum page size. Results might at times be less than the maximum page size. The next_offset value is passed back by the initial response and can be used 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 query parameter of the next page of results.

Headers

​
X-Sim-Api-Key
string
required

Used for authenticating requests. Provide an API key with a purpose of Sim API. See Authentication.

Path Parameters

​
uri
string
default:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
required

Wallet to get balances for

Query Parameters

​
chain_ids
string

Filter by chain(s). Accepts a single numeric chain ID (e.g. ?chain_ids=1), a single chain name (e.g. ?chain_ids=ethereum), or a comma separated list of either (e.g. ?chain_ids=1,137 or ?chain_ids=ethereum,polygon). If omitted, results include collectibles from chains with the "default" tag for the address. See the Supported Chains Tags section.

​
filters
enum<string>

Specify erc20 or native to get only ERC20 tokens or native assets, respectively

Available options:
erc20,
native
​
metadata
string

A comma separated list of additional metadata fields to include for each token. Supported values: logo, url

​
historical_prices

Historical price selection. Accepts integer | integer[]. Provide whole numbers representing hours in the past, up to 3 time offsets (e.g. 8760 for 1 year ago or 720,168,24 for 1 month, 1 week, and 1 day ago). When set, each balance includes a historical_prices array with one entry per offset.

Required range: x >= 1
​
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.

​
limit
integer
default:1000

Maximum number of balances to return. Default is 1000 when not provided. Values above 1000 are reduced to 1000.

Required range: 1 <= x <= 1000

Response

Successful Response

​
balances
object[]
required
​
wallet_address
string
required
Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

​
errors
object
​
next_offset
string

Use this value as the offset in your next request to continue pagination. Not included when there are no more balances.

​
request_time
string<date-time>

Timestamp of when the request was received.

​
response_time
string<date-time>

Timestamp of when the response was generated.