NFT API Endpoints Overview

List of all NFT API endpoints

NFT API Chain Support Matrix

MethodEthereumPolygonArbitrumOptimismBaseStarknetAstarSolana
getNFTsForOwner:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupported
getContractsForOwner:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupported
getOwnersForNFT:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupported
isHolderOfContract:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupported
getOwnersForContract:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupported
getNFTMetadata:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupported
getNFTMetadataBatch:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupported
getContractMetadata:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupported
getContractMetadataBatch:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupported
searchContractMetadata
BETA
:white-check-mark:; mainnet onlyUnsupportedUnsupportedUnsupported:white-check-mark:; mainnet onlyUnsupportedUnsupportedUnsupported
getNFTsForContract:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupportedUnsupported
getCollectionMetadata:white-check-mark:UnsupportedUnsupportedUnsupportedUnsupportedUnsupportedUnsupportedUnsupported
getCollectionsForOwner:white-check-mark:UnsupportedUnsupportedUnsupportedUnsupportedUnsupportedUnsupportedUnsupported
getSpamContracts:white-check-mark:; mainnet only:white-check-mark:; mainnet onlyUnsupportedUnsupportedUnsupportedUnsupportedUnsupportedUnsupported
isSpamContract :white-check-mark:; mainnet only:white-check-mark:; mainnet onlyUnsupportedUnsupportedUnsupported:white-check-mark:UnsupportedUnsupported
isAirdropNft:white-check-mark:; mainnet only:white-check-mark:; mainnet onlyUnsupportedUnsupportedUnsupportedUnsupportedUnsupportedUnsupported
getFloorPrice :white-check-mark:; mainnet onlyUnsupportedUnsupportedUnsupportedUnsupportedUnsupportedUnsupportedUnsupported
getNFTSales:white-check-mark:; mainnet only:white-check-mark:; mainnet onlyUnsupported:white-check-mark:; mainnet onlyUnsupportedUnsupportedUnsupportedUnsupported
computeRarity :white-check-mark:; mainnet only:white-check-mark:; mainnet onlyUnsupportedUnsupportedUnsupportedUnsupportedUnsupportedUnsupported
summarizeNFTAttributes:white-check-mark:; mainnet only:white-check-mark:; mainnet onlyUnsupportedUnsupportedUnsupportedUnsupportedUnsupportedUnsupported
reportSpam:white-check-mark::white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupportedUnsupported
refreshNftMetadata:white-check-mark::white-check-mark::white-check-mark::white-check-mark:UnsupportedUnsupportedUnsupportedUnsupported

NFT API Endpoints By Usecase

🚧

Choosing a testnet

For every mention of Goerli in the supported chains below, please note that we recommend using Sepolia instead, as the Ethereum Foundation has announced that Goerli will soon be deprecated.

Alchemy has full Sepolia support and a free Sepolia faucet. You can get 0.5 Sepolia ETH per day from the Sepolia faucet. Please note that the faucet does not drip NFTs.

EndpointUse CaseWhat to use it for
getNFTsForOwnerOwnership & Token GatingRetrieve the NFTs owned by a wallet address
getContractsForOwnerRetrieve the list of NFT contracts from which a wallet address owns one or more tokens.
getOwnersForNFTRetrieve the owners of a given token
getOwnersForCollectionRetrieve all the owners for a given NFT contract or collection, including snapshotting owners at any block number.
isHolderOfCollectionCheck whether a given wallet owns any NFT in a collection
getNFTMetadataMetadata Retrieve the metadata associated with a given NFT i.e. a specific tokenId
getNFTMetadataBatchRetrieve the metadata associated with several NFTs across collections in a single request
getContractMetadataRetrieve the metadata associated with a given contract or collection
getContractMetadataBatchRetrieve contract metadata for several different contracts in a single request
searchContractMetadata
BETA
Search the metadata across contracts for specific keywords
refreshNftMetadata







Submit a request that Alchemy refresh the cached NFT metadata for a particular token.
reingestContract BETATriggers metadata refresh for an NFT collection/refreshes stale metadata after a reveal
getNFTsForContractRetrieve all the NFTs for a given contract or collection
getSpamContracts BETASpam Detection Retrieve a list of contracts marked as spam
isSpamContract BETAReturns whether a specific contract is marked as spam or not
reportSpam
BETA
Report a contract if you think its spam
getFloorPrice BETAMarketplace Data Retrieve the floor price of a NFT collection by marketplace
getNFTSales BETARetrieve NFT sales data across marketplaces
computeRarity BETARarityCompute the rarity of each attribute of an NFT.
summarizeNFTAttributes BETAGenerate a summary of attribute prevalence for an NFT collection.
NFT Activity WebhookNotificationsReceiving real-time updates for NFT Transfers and NFT mints
NFT Metadata Updates WebhookReceiving real-time updates for NFT metadata changes
ReadMe