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

                NFT Items

                GET/v1/evm/nft/items

                Returns NFT token metadata, attributes, current owner, and media URIs.

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

                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
                  token_id
                  string

                  Token ID
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

                    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 HoldersNFT Ownerships by Address
                    Test this endpoint

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

                    1{2  "data": [3    {4      "address": "0x9379557bdf32f5ee296ca7b360ccb8dcb9543d8e",5      "contract": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",6      "token_id": "5712",7      "token_standard": "ERC721",8      "name": "Pudgy Penguin #5712",9      "description": "A collection 8888 Cute Chubby Pudgy Penquins sliding around on the freezing ETH blockchain.",10      "image": "ipfs://QmNf1UsmdGaMbpatQ6toXSkzDpizaGmC9zfunCyoz1enD5/penguin/5712.png",11      "uri": "ipfs://bafybeibc5sgo2plmjkq2tzmhrn54bk3crhnc23zd2msg4ea7a4pxrkgfna/5712",12      "attributes": [13        {14          "trait_type": "Background",15          "value": "Blue"16        },17        {18          "trait_type": "Skin",19          "value": "Olive Green"20        },21        {22          "trait_type": "Body",23          "value": "Turtleneck Green"24        },25        {26          "trait_type": "Face",27          "value": "Scar"28        },29        {30          "trait_type": "Head",31          "value": "Party Hat"32        }33      ],34      "network": "mainnet"35    }36  ]37}
                    The GraphСтатусТестовая сетьБрундовые ресурсыФорумБезопасностьПолитика конфиденциальностиУсловия обслуживания