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

                NFT Items

                GET/nft/items/evm/contract/{contract}/token_id/{token_id}

                Provides single NFT token metadata, ownership & traits.

                Path Parameters

                ParameterالوصفValue
                token_id
                string

                NFT token ID

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

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

                    1{2  "data": [3    {4      "token_standard": "ERC721",5      "contract": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",6      "token_id": "5712",7      "owner": "0x9379557bdf32f5ee296ca7b360ccb8dcb9543d8e",8      "uri": "ipfs://bafybeibc5sgo2plmjkq2tzmhrn54bk3crhnc23zd2msg4ea7a4pxrkgfna/5712",9      "name": "Pudgy Penguin #5712",10      "description": "A collection 8888 Cute Chubby Pudgy Penquins sliding around on the freezing ETH blockchain.",11      "image": "ipfs://QmNf1UsmdGaMbpatQ6toXSkzDpizaGmC9zfunCyoz1enD5/penguin/5712.png",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_id": "mainnet"35    }36  ]37}
                    The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service