Skip to main content

ERC721 Standard

You can utilize these features of the SDK if your contract implements the ERC721 standard.

Learn how to implement ERC721 in your smart contract

View NFT Balance​

Get a wallet's NFT balance (number of NFTs in this contract owned by the wallet).

const { data: ownerBalance, isLoading, error } = useNFTBalance(contract, "{{wallet_address}}");
// for ERC1155 contracts, you can also pass a tokenId
const tokenId = 0;
const { data: ownerBalance, isLoading, error } = useNFTBalance(contract, "{{wallet_address}}", tokenId);

This snippet is for v3 of the SDK. Learn how to upgrade.

View in React SDK Documentation

Get NFT Metadata​

Read the URI this NFT points to and fetch that data automatically.

If the metadata is stored on IPFS, this function uses our IPFS gateway (or the one you specify) to read the data.

const tokenId = 0; // the tokenId to look up
const { data: nft, isLoading, error } = useNFT(contract, tokenId);

This snippet is for v3 of the SDK. Learn how to upgrade.

View in React SDK Documentation

Transfer NFT​

Transfer an NFT from the connected wallet to another wallet.

const Component = () => {
  const { contract } = useContract("{{contract_address}}");
  const {
    mutate: transferNFT,
    isLoading,
    error,
  } = useTransferNFT(contract);

  if (error) {
    console.error("failed to transfer NFT", error);
  }

  return (
    <button
      disabled={isLoading}
      onClick={() => transferNFT({
        to: "{{wallet_address}}",
        tokenId: 2
      })}
    >
      Transfer
    </button>
  );
};

This snippet is for v3 of the SDK. Learn how to upgrade.

View in React SDK Documentation