Docs
Search⌘ K
  • Home
  • حول The Graph
  • الشبكات المدعومة
  • Protocol Contracts
  • Subgraphs
    • متعدد-السلاسل
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Resources
                Token API > EVM Endpoints

                NFT Holders

                GET/nft/holders/evm/{contract}

                Provides NFT holders per contract.

                Path Parameters

                ParameterالوصفValue
                contract
                string

                Filter by NFT contract address

                  Required

                  Query Parameters

                  ParameterالوصفValue
                  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

                  Statusالوصف
                  200Successful Response
                  400Client side error
                  401Authentication failed
                  403Forbidden
                  404Not found
                  500Server side error
                  ⁠Edit on GitHub⁠

                  NFT CollectionNFT Items
                  Test this endpoint

                  1curl --request GET \2  --url 'https://token-api.thegraph.com/nft/holders/evm/{contract}?network_id=mainnet' \3  --header 'Authorization: Bearer {token}'

                  1{2  "data": [3    {4      "token_standard": "ERC721",5      "address": "0x29469395eaf6f95920e59f858042f0e28d98a20b",6      "quantity": 534,7      "unique_tokens": 534,8      "percentage": 0.06008100810081008,9      "network_id": "mainnet"10    }11  ]12}
                  The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service