Querying NFTs

Querying Available NFT Models

In order to display the NFT content available for your app, use the nftModels API. This query returns all the NFTModel that you have marked as Available in the Admin Portal

In Admin Portal, NFTModel is referred to as Collectible.

Recall that an NFTModel is basically a blueprint for an NFT -- it contains all the content and metadata that would get minted into an NFT. You can limit the supply of NFTs for an NFTModel by setting its quantity appropriately (using the Admin Portal as follows).

nftModels - returns NFTModel's for the current App context.

query NFTModelsQuery($filter: NFTModelFilterInput) {
  nftModels(filter: $filter) {
    id
    blockchainId
    title
    description
    quantity
    status
    rarity
    content {
      files {
        media {
          url
          contentType
        }
        thumbnail {
          url
          contentType          
        }
      }
      poster {
        url
      }
    }
  }
}

Note: You can do some rich filtering on which NFTModels to display in your application using the (optional) NFTModelFilterInput parameter.

Query NFTModels Sample Response

{
  "data": {
    "nftModels": [{
      "status": "AVAILABLE",
      "blockchainId": "f253fc2cb42c078436d07fb77e5a76a649892172",
      "id": "45",
      "title": "First NFT Drop",
      "description": "MyApp's First NFT",
      "quantity": 123,
      "content": NFTContent,
      "set": NFTSet,
      "nfts": [NFT]
    }]
  }
}

Query an NFTModel by ID

nftModel - returns an NFTModel by its Niftory database ID.

query NftModelQuery($id: String!) {
  nftModel(id: $id) {
    blockchainId
    metadata
    id
    title
    description
    rarity
    quantity
    content {
      ...NFTContentFragment
    }
    set {
      ...NFTSetFragment
    }
    nfts {
      ...NFTFragment
    }
  }
}

Querying User NFTs

Use the nfts query to get NFT's belonging to the currently logged-in user. Like the nftModels query, you can optionally filter this query as needed (by particular NFTModel's, for example).

nfts - Gets all NFT's belonging to the current AppUser context.

query NFTsQuery($filter: NFTFilterInput) {
  nfts(filter: $filter) {
    id
    blockchainId
    serialNumber
    metadata
    model {
      id
    }
    wallet {
      address
    }
    status
  }
}

The queries above don't query the blockchain directly. Instead, they query Niftory's database representation of the blockchain, which helps make them very fast, and allows non-blockchain data (such as not-yet-minted NFTModels) to be retrieved from the same API.

NFTSet, NFTModel and NFT types all have blockchainId, which is set once an NFT is minted, and can be used to look up these entities on the blockchain itself.