♦️NFTs

Learn how to recommend users based on NFTs

NFTs are often built around communities of common interests and can be a solid basis for contact recommendations.

Building such a contract recommendation feature based on NFTs takes two steps:

1. Query Get All NFTs Held By A User(s)

2. Using the array of NFTs returned from step 1, use it as an input to query Get All NFT Holders And Images Of An NFT Collection(s)

Airstack provides you the TokenBalances API to fetch the NFT held by a user(s) and the TokenNFTs API to fetch all the holders of a certain NFT collection.

With Airstack, it's possible to do cross-chain queries that get NFT results from multiple chains, e.g. Ethereum, Base, Degen Chain, and other Airstack-supported chains, in a single call.

Get All NFTs Held By A User(s)

First, you will fetch all the NFTs held by a user(s) to create the contact recommendation. All you need to provide the address variable, which takes the user(s) address that the recommendation will be given to, to the following query:

Query

query GetNFTs($Identity: [Identity!]) {
  ethereum: TokenBalances(
    input: {
      filter: {
        owner: { _in: $Identity }
        tokenType: { _in: [ERC1155, ERC721] }
      }
      blockchain: ethereum
      limit: 50
    }
  ) {
    TokenBalance {
      tokenAddress
      amount
      formattedAmount
      tokenType
      tokenNfts {
        address
        tokenId
        blockchain
        contentValue {
          image {
            original
          }
        }
      }
    }
    pageInfo {
      nextCursor
      prevCursor
      hasNextPage
      hasPrevPage
    }
  }
  polygon: TokenBalances(
    input: {
      filter: {
        owner: { _in: $Identity }
        tokenType: { _in: [ERC1155, ERC721] }
      }
      blockchain: polygon
      limit: 50
    }
  ) {
    TokenBalance {
      tokenAddress
      amount
      formattedAmount
      tokenType
      tokenNfts {
        address
        tokenId
        blockchain
        contentValue {
          image {
            original
          }
        }
      }
    }
    pageInfo {
      nextCursor
      prevCursor
      hasNextPage
      hasPrevPage
    }
  }
  base: TokenBalances(
    input: {
      filter: {
        owner: { _in: $Identity }
        tokenType: { _in: [ERC1155, ERC721] }
      }
      blockchain: base
      limit: 50
    }
  ) {
    TokenBalance {
      tokenAddress
      amount
      formattedAmount
      tokenType
      tokenNfts {
        address
        tokenId
        blockchain
        contentValue {
          image {
            original
          }
        }
      }
    }
    pageInfo {
      nextCursor
      prevCursor
      hasNextPage
      hasPrevPage
    }
  }
}

Variables

{
  "Identity": ["0xd8da6bf26964af9d7eed9e03e53415d37aa96045"]
}

Get All NFT Holders And Images Of An NFT Collection(s)

Once you have the list of NFT collections that was fetched from the first query above, you can format and compile the list of all NFT contract addresses and provide it as an address input to the query below.

The query below will fetch all the NFT holders’ web3 identities, which include the Ethereum addresses, ENS, Lens, and Farcasters.

In addition, the query will also fetch all NFT images that you can use to be displayed in your application.

Query

query GetNFTHoldersAndImages($address: [Address!]) {
  ethereum: TokenNfts(
    input: { filter: { address: { _in: $address } }, blockchain: ethereum }
  ) {
    TokenNft {
      address
      tokenId
      contentValue {
        image {
          extraSmall
          small
          medium
          large
          original
        }
      }
      tokenBalances {
        owner {
          domains {
            name
            isPrimary
          }
          identity
          socials {
            profileName
            dappName
          }
        }
      }
    }
    pageInfo {
      nextCursor
      prevCursor
    }
  }
}

Variables

{
  "address": ["0x9C8fF314C9Bc7F6e59A9d9225Fb22946427eDC03"]
}

Developer Support

If you have any questions or need help regarding integrating or building recommendation engine with NFT data into your application, please join our Airstack's Telegram group.

More Resources

• TokenBalances API Reference

• On-Chain Graph