Docs
Search⌘ K
  • Home
  • حول The Graph
  • الشبكات المدعومة
  • Protocol Contracts
  • Subgraphs
    • متعدد-السلاسل
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Resources
                Token API > EVM Endpoints

                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الوصفValue
                contract
                string

                Filter by contract address

                  Required

                  Query Parameters

                  Parameterالوصف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الوصف
                  200Successful Response
                  400Client side error
                  401Authentication failed
                  403Forbidden
                  404Not found
                  500Server side error
                  ⁠Edit on GitHub⁠

                  Swap EventsToken Holders and Supply by Contract Address
                  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}
                  The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service