Docs
La Recherche⌘ K
  • Accueil
  • À propos de The Graph
  • Réseaux pris en charge
  • Contrats du Protocole
  • Subgraphs
    • Substreams
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Graph Horizon
                • Resources
                  Token API > EVM NFT Endpoints

                  NFT Holders

                  GET/v1/evm/nft/holders

                  Returns wallet addresses holding NFT collection tokens with quantity and percentage distribution.

                  Paramètres de requête

                  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
                    limit
                    integer

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

                    • Default value: 10
                    • Minimum value: 1
                    • Maximum value: 1000
                    page
                    integer

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

                    • Default value: 1
                    • Minimum value: 1
                    • Maximum value: 767465558638

                    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⁠

                    NFT CollectionNFT Items
                    Test this endpoint

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

                    1{2  "data": [3    {4      "contract": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",5      "token_standard": "ERC721",6      "address": "0x29469395eaf6f95920e59f858042f0e28d98a20b",7      "quantity": 358,8      "unique_tokens": 358,9      "percentage": 4.027902790279028,10      "network": "mainnet"11    }12  ]13}
                    The GraphStatusTestnetActifs de la MarqueForumSécuritéPolitique de confidentialitéConditions d'utilisation