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

                  Token Holders

                  GET/v1/evm/holders

                  Returns top token holders ranked by balance.

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

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

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

                  • स्वीकृत मान: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
                  आवश्यक
                  mainnet
                  contract
                  string

                  Filter by contract address

                    आवश्यक
                    limit
                    integer

                    Number of items* returned in a single request.
                    *Plan restricted.

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

                    Page number to fetch.
                    Empty data array signifies end of results.

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

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

                    स्थितिDescription
                    200

                    Successful Response

                    400

                    Client side error

                    401

                    Authentication failed

                    403

                    Forbidden

                    404

                    Not found

                    500

                    Server side error

                    ⁠GitHub पर संपादित करें⁠

                    Historical BalancesSupported DEXs
                    इस एंडपॉइंट का परीक्षण करें

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

                    1{2  "data": [3    {4      "last_update": "2025-10-16 09:08:11",5      "last_update_block_num": 23589233,6      "last_update_timestamp": 1760605691,7      "address": "0x59cd1c87501baa753d0b5b5ab5d8416a45cd71db",8      "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",9      "amount": "97590855599990900949144",10      "value": 97590.85559999091,11      "name": "Wrapped Ether",12      "symbol": "WETH",13      "decimals": 18,14      "network": "mainnet"15    }16  ]17}
                    The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service