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

                  Token Metadata

                  GET/v1/evm/tokens

                  Returns ERC-20 token metadata including supply and holder count.

                  Query Parameters

                  ParameterDescriptionValue
                  network
                  string

                  The Graph Network ID for EVM networks https://thegraph.com/networks

                  • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
                  Required
                  mainnet
                  contract
                  string

                  Filter by contract address

                    Required

                    Potential Responses

                    StatusDescription
                    200

                    Successful Response

                    400

                    Client side error

                    401

                    Authentication failed

                    403

                    Forbidden

                    404

                    Not found

                    500

                    Server side error

                    ⁠Edit on GitHub⁠

                    Swap EventsToken Transfers
                    Test this endpoint

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

                    1{2  "data": [3    {4      "last_update": "2026-01-25 14:26:59",5      "last_update_block_num": 24312418,6      "last_update_timestamp": 1769351219,7      "contract": "0xdac17f958d2ee523a2206206994597c13d831ec7",8      "circulating_supply": 103302123410.98102,9      "holders": 11573781,10      "name": "Tether USD",11      "symbol": "USDT",12      "decimals": 6,13      "network": "mainnet",14      "icon": {15        "web3icon": "USDT"16      }17    }18  ]19}
                    The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service