Docs
Arama⌘ K
  • Ana sayfa
  • Graph Hakkında
  • Desteklenen Ağlar
  • Protocol Contracts
  • Subgraph'ler
    • Substream'ler
      • Token API
        • AI Suite
          • Endeksleme
            • Kaynaklar
              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

              ParameterTanımValue
              contract
              string

              Filter by contract address

                Required

                Sorgu Parametreleri

                ParameterTanımValue
                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

                DurumTanım
                200Successful Response
                400Client side error
                401Authentication failed
                403Forbidden
                404Not found
                500Server side error
                ⁠GitHub'da Düzenle⁠

                Token Holders by Contract AddressToken OHLCV prices by Contract Address
                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      "block_num": 22966816,5      "datetime": "2025-07-21 09:57:35",6      "timestamp": 1753091855,7      "contract": "0xc944e90c64b2c07662a292be6244bdf05cda44a7",8      "decimals": 18,9      "symbol": "GRT",10      "name": "Graph Token",11      "circulating_supply": 27051707794.58071,12      "total_supply": 10800262823.318213,13      "holders": 175151,14      "network_id": "mainnet",15      "icon": {16        "web3icon": "GRT"17      }18    }19  ]20}
                The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service