Token Holders | Docs | The Graph

⌘ K

GET/holders/evm/{contract}

Provides ERC-20 token holder balances by contract address.

Path Parameters

Parameter Description Value

contract

string

Filter by contract address

Required

Query Parameters

Parameter	Description	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

Status	Description
200	Successful Response
400	Client side error
401	Authentication failed
403	Forbidden
404	Not found
500	Server side error

Test this endpoint

1curl --request GET \2  --url 'https://token-api.thegraph.com/holders/evm/{contract}?network_id=mainnet&orderBy=value&orderDirection=desc&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

1{2  "data": [3    {4      "block_num": 22966764,5      "last_balance_update": "2025-07-21 09:47:11",6      "address": "0x36aff7001294dae4c2ed4fdefc478a00de77f090",7      "amount": "2904244446383157108596275005",8      "value": 2904244446.3831573,9      "name": "Graph Token",10      "decimals": 18,11      "symbol": "GRT",12      "network_id": "mainnet"13    }14  ]15}