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
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

                  • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
                  • Format: evm-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-02-13 20:22:47",5      "last_update_block_num": 24450218,6      "last_update_timestamp": 1771014167,7      "contract": "0xdac17f958d2ee523a2206206994597c13d831ec7",8      "circulating_supply": 96130932922.42769,9      "holders": 12473360,10      "total_transfers": 430131249,11      "name": "Tether USD",12      "symbol": "USDT",13      "decimals": 6,14      "network": "mainnet",15      "icon": {16        "web3icon": "usdt"17      }18    }19  ]20}
                  The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service