GET
/
v1
/
evm
/
token-holders
/
{chain_id}
/
{token_address}
Get Token Holders
curl --request GET \
  --url https://api.sim.dune.com/v1/evm/token-holders/{chain_id}/{token_address} \
  --header 'X-Sim-Api-Key: <x-sim-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="
}
Type=holders Sv 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.

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

​
chain_id
integer
default:8453
required

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

​
token_address
string<address>
default:0x63706e401c06ac8513145b7687A14804d17f814b
required

The address of the token contract.

Query Parameters

​
limit
integer
default:500

Maximum number of token holders to return. Default is 500 when not provided. Values above 500 are reduced to 500.

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.