Docs
Search⌘ K
  • Home
  • About The Graph
  • Supported Networks
  • Protocol Contracts
  • Subgraphs
    • Substreams
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Resources
                Token API > EVM Endpoints

                Token Metadata

                GET/tokens/evm/{contract}

                Provides ERC-20 token contract metadata.

                Path Parameters

                ParameterDescriptionValue
                contract
                string

                Filter by contract address

                  Required

                  Query Parameters

                  ParameterDescriptionValue
                  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

                  StatusDescription
                  200Successful Response
                  400Client side error
                  401Authentication failed
                  403Forbidden
                  404Not found
                  500Server side error
                  ⁠Edit on GitHub⁠

                  Token HoldersLiquidity 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 GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service