Token Holders by Contract Address

GET/holders/evm/{contract}

The EVM Holders endpoint provides information about the addresses holding a specific token, including each holder’s balance. This is useful for analyzing token distribution for a particular contract.

Path Parameters

Parameter Descripción Value

Parameter	Descripción	Value
`contract` string	Filter by contract address	Required

contract

string

Filter by contract address

Required

Query Parameters

Parameter	Descripción	Value
`network_id` string	The Graph Network ID for EVM networks https://thegraph.com/networks Default value: `mainnet` Accepted values: `arbitrum-one`, `avalanche`, `base`, `bsc`, `mainnet`, `matic`, `optimism`, `unichain`	Required mainnet
`orderBy` string	The field by which to order the results. Default value: `value` Accepted values: `value`	value
`orderDirection` string	The order in which to return the results: Ascending (asc) or Descending (desc). Default value: `desc` Accepted values: `asc`, `desc`	desc
`limit` integer	The maximum number of items returned in a single request. Default value: `10` Minimum value: `1` Maximum value: `1000`
`page` integer	The page number of the results to return. Default value: `1` Minimum value: `1` Maximum value: `767465558638`

Potential Responses

Estado	Descripción
200	Successful Response
400	Client side error
401	Authentication failed
403	Forbidden
404	Not found
500	Server side error