Docs
खोज⌘ K
  • Home
  • The Graph के बारे में
  • समर्थित नेटवर्क
  • Protocol Contracts
  • सबग्राफ
    • सबस्ट्रीम
      • टोकन API
        • Hypergraph
          • AI Suite
            • Overview
            • Indexer टूलिंग
              • GraphTally Guide
              • Supported Network Requirements
              • Chain Integration Process Overview
              • नई श्रृंखला एकीकरण
              • संसाधन
                टोकन API > EVM Endpoints

                Token Holders by Contract Address

                GET/holders/evm/{contract}

                The EVM Holders endpoint provides information about the addresses holding a specific token, including each holder’s balance. This is useful for analyzing token distribution for a particular contract.

                पथ पैरामीटर

                पैरामीटरDescriptionमान
                contract
                string

                Filter by contract address

                  आवश्यक

                  क्वेरी पैरामीटर

                  पैरामीटरDescriptionमान
                  network_id
                  string

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

                  • डिफ़ॉल्ट मान: mainnet
                  • स्वीकृत मान: arbitrum-one, avalanche, base, bsc, mainnet, matic, optimism, unichain
                  आवश्यक
                  mainnet
                  orderBy
                  string

                  The field by which to order the results.

                  • डिफ़ॉल्ट मान: value
                  • स्वीकृत मान: value
                  value
                  orderDirection
                  string

                  The order in which to return the results: Ascending (asc) or Descending (desc).

                  • डिफ़ॉल्ट मान: desc
                  • स्वीकृत मान: asc, desc
                  desc
                  limit
                  integer

                  The maximum number of items returned in a single request.

                  • डिफ़ॉल्ट मान: 10
                  • न्यूनतम मान: 1
                  • अधिकतम मान : 1000
                  page
                  integer

                  The page number of the results to return.

                  • डिफ़ॉल्ट मान: 1
                  • न्यूनतम मान: 1
                  • अधिकतम मान : 767465558638

                  संभावित प्रतिक्रियाएँ

                  स्थितिDescription
                  200Successful Response
                  400Client side error
                  401Authentication failed
                  403Forbidden
                  404Not found
                  500Server side error
                  ⁠GitHub पर संपादित करें⁠

                  Swap EventsToken Holders and Supply by Contract Address
                  इस एंडपॉइंट का परीक्षण करें

                  1curl --request GET \2  --url 'https://token-api.thegraph.com/holders/evm/{contract}?network_id=mainnet&orderBy=value&orderDirection=desc&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                  1{2  "data": [3    {4      "block_num": 22966764,5      "last_balance_update": "2025-07-21 09:47:11",6      "address": "0x36aff7001294dae4c2ed4fdefc478a00de77f090",7      "amount": "2904244446383157108596275005",8      "value": 2904244446.3831573,9      "name": "Graph Token",10      "decimals": 18,11      "symbol": "GRT",12      "network_id": "mainnet"13    }14  ]15}
                  The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service