Docs
Поиск⌘ K
  • Главная страница
  • О The Graph
  • Поддерживаемые сети
  • Protocol Contracts
  • Субграфы
    • Субпотоки
      • Token API
        • Hypergraph
          • AI Suite
            • Индексирование
              • Ресурсы
                Token API > evm-nfts

                NFT Holders

                GET/v1/evm/nft/holders

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

                Параметры запроса

                ParameterОписаниеValue
                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

                  СтатусОписание
                  200

                  Successful Response

                  400

                  Client side error

                  401

                  Authentication failed

                  403

                  Forbidden

                  404

                  Not found

                  500

                  Server side error

                  ⁠Редактировать на 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 GraphСтатусТестовая сетьБрундовые ресурсыФорумБезопасностьПолитика конфиденциальностиУсловия обслуживания