Docs
Buscar⌘ K
  • Inicio
  • Acerca de The Graph
  • Redes Admitidas
  • Protocol Contracts
  • Subgrafos
    • Corrientes secundarias
      • Token API
        • Hypergraph
          • AI Suite
            • Indexación
              • Recursos
                Token API > EVM Endpoints

                Token Holders and Supply by Contract Address

                GET/tokens/evm/{contract}

                The Tokens endpoint delivers contract metadata for a specific ERC-20 token contract from a supported EVM blockchain. Metadata includes name, symbol, number of holders, circulating supply, decimals, and more.

                Path Parameters

                ParameterDescripciónValue
                contract
                string

                Filter by contract address

                  Required

                  Query Parameters

                  ParameterDescripciónValue
                  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

                  Potential Responses

                  EstadoDescripción
                  200Successful Response
                  400Client side error
                  401Authentication failed
                  403Forbidden
                  404Not found
                  500Server side error
                  ⁠Editar en GitHub⁠

                  Token Holders by Contract AddressLiquidity Pools
                  Test this endpoint

                  1curl --request GET \2  --url 'https://token-api.thegraph.com/tokens/evm/{contract}?network_id=mainnet' \3  --header 'Authorization: Bearer {token}'

                  1{2  "data": [3    {4      "last_update": "2025-09-17 14:26:47",5      "last_update_block_num": 23383390,6      "last_update_timestamp": 1758119207,7      "contract": "0xc944e90c64b2c07662a292be6244bdf05cda44a7",8      "name": "Graph Token",9      "symbol": "GRT",10      "decimals": 18,11      "circulating_supply": 10800334780.716036,12      "total_supply": 10800262816.048214,13      "holders": 174139,14      "network_id": "mainnet",15      "icon": {16        "web3icon": "GRT"17      }18    }19  ]20}
                  The GraphEstadoTestnetRecursos de marcaForoSeguridadPolítica de privacidadTérminos de servicio