GET
https://api.sim.dune.com
/
v1
/
evm
/
token-holders
/
{chain_id}
/
{token_address}
curl --request GET \
  --url https://api.sim.dune.com/v1/evm/token-holders/{chain_id}/{token_address} \
  --header 'X-Sim-Api-Key: <api-key>'
{
  "token_address": "0x63706e401c06ac8513145b7687a14804d17f814b",
  "chain_id": 8453,
  "holders": [
    {
      "wallet_address": "0x4a79b0168296c0ef7b8f314973b82ad406a29f1b",
      "balance": "13794442047246482254818",
      "first_acquired": "2025-02-06T15:11:07+00:00",
      "has_initiated_transfer": false
    },
    {
      "wallet_address": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
      "balance": "25000000000000000000",
      "first_acquired": "2024-01-15T10:30:00+00:00",
      "has_initiated_transfer": true
    }
  ],
  "next_offset": "eyJwYWdlIjoyLCJsaW1pdCI6Mn0="
}

The Token Holders API provides information about accounts holding a specific ERC20 or ERC721 token on supported EVM blockchains.

​
Pagination

This endpoint uses 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 included in 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.

Authorizations

​
X-Sim-Api-Key
string
header
required

API key for authenticating requests.

Path Parameters

​
chain_id
integer
required

The identifier of the blockchain (e.g., 8453 for Base). For a full list see Supported Chains.

​
token_address
string
required

The address of the token contract.

Query Parameters

​
limit
integer
default:50

Maximum number of token holders to return.

Required range: 1 <= x <= 500
​
next_offset
string

Offset value for fetching the next page of results.

Response

200
application/json

A list of token holders for the specified token address on the specified chain.

The response is of type object.