List of all NFT API endpoints
NFT API Chain Support Matrix
Method | Ethereum | Polygon | Arbitrum | Optimism | Astar | Solana |
---|---|---|---|---|---|---|
getNfts | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
getContractsForOwner | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
getOwnersForToken | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
getOwnersForCollection | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
isHolderOfCollection | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
getNFTMetadata | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
getNFTMetadataBatch | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
getContractMetadata | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
getContractMetadataBatch | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
searchContractMetadataBETA | Mainnet only | Unsupported | Unsupported | Unsupported | Unsupported | Unsupported |
reingestContract BETA | Mainnet only | Unsupported | Unsupported | Unsupported | Unsupported | Unsupported |
getNFTsForCollection | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
getSpamContracts BETA | Mainnet only | Mainnet only | Unsupported | Unsupported | Unsupported | Unsupported |
isSpamContract BETA | Mainnet only | Mainnet only | Unsupported | Unsupported | Unsupported | Unsupported |
getFloorPrice BETA | Mainnet only | Unsupported | Unsupported | Unsupported | Unsupported | Unsupported |
getNFTSales BETA | Mainnet only | Mainnet only | Unsupported | Mainnet only | Unsupported | Unsupported |
computeRarity BETA | Mainnet only | Mainnet only | Unsupported | Unsupported | Unsupported | Unsupported |
summarizeNFTAttributes BETA | Mainnet only | Mainnet only | Unsupported | Unsupported | Unsupported | Unsupported |
reportSpam BETA | All Networks | All Networks | All Networks | All Networks | Unsupported | Unsupported |
NFT API Endpoints by usecase
Deprecation Notice
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](https://sepoliafaucet.com/ also.
Use Case | Endpoint | What to use it for | Supported Chains |
---|---|---|---|
Ownership & Token Gating | getNfts | Retrieve the NFTs owned by a wallet address | Ethereum: Mainnet, Goerli, Sepolia Polygon: Mainnet, Mumbai Arbitrum: Mainnet, Goerli BETA , Sepolia BETA Optimism: Mainnet, Goerli BETA , Sepolia BETA |
getContractsForOwner | Retrieve the list of NFT contracts from which a wallet address owns one or more tokens. | Ethereum: Mainnet, Goerli, Sepolia Polygon: Mainnet, Mumbai Arbitrum: Mainnet, Goerli, Sepolia Optimism: Mainnet, Goerli, Sepolia | |
getOwnersForToken | Retrieve the owners of a given token | Ethereum: Mainnet, Goerli, Sepolia Polygon: Mainnet, Mumbai Arbitrum: Mainnet, Goerli BETA , Sepolia BETA Optimism: Mainnet, Goerli BETA , Sepolia BETA | |
getOwnersForCollection | Retrieve all the owners for a given NFT contract or collection, including snapshotting owners at any block number. | Ethereum: Mainnet, Goerli, Sepolia Polygon: Mainnet, Mumbai Arbitrum: Mainnet, Goerli BETA , Sepolia BETA Optimism: Mainnet, Goerli BETA , Sepolia BETA | |
isHolderOfCollection | Check whether a given wallet owns any NFT in a collection | Ethereum: Mainnet, Goerli BETA , Sepolia BETA Polygon: Mainnet, Mumbai BETA , BETA Arbitrum: Mainnet, Goerli BETA , Sepolia BETA Optimism: Mainnet, Goerli BETA , Sepolia BETA | |
Metadata | getNFTMetadata | Retrieve the metadata associated with a given NFT i.e. a specific tokenId | Ethereum: Mainnet, Goerli, Sepolia Polygon: Mainnet, Mumbai Arbitrum: Mainnet, Goerli BETA , Sepolia BETA Optimism: Mainnet, Goerli BETA , Sepolia BETA |
getNFTMetadataBatch | Retrieve the metadata associated with several NFTs across collections in a single request | Ethereum: Mainnet, Goerli, Sepolia BETA Polygon: Mainnet, Mumbai Arbitrum: Mainnet, Goerli BETA , BETA Optimism: Mainnet, Goerli BETA , BETA | |
getContractMetadata | Retrieve the metadata associated with a given contract or collection | Ethereum: Mainnet, Goerli (Beta), Sepolia BETA Polygon: Mainnet, Mumbai BETA Arbitrum: Mainnet, Goerli BETA , Sepolia BETA Optimism: Mainnet, Goerli BETA , Sepolia BETA | |
getContractMetadataBatch | Retrieve contract metadata for several different contracts in a single request | Ethereum: Mainnet, Goerli (Beta), Sepolia BETA Polygon: Mainnet, Mumbai BETA Arbitrum: Mainnet, Goerli BETA , Sepolia BETA Optimism: Mainnet, Goerli BETA , Sepolia BETA | |
searchContractMetadataBETA | Search the metadata across contracts for specific keywords | Ethereum: Mainnet | |
reingestContract BETA | Triggers metadata refresh for an NFT collection/refreshes stale metadata after a reveal | Ethereum: Mainnet | |
Collections | getNFTsForCollection | Retrieve all the NFTs for a given contract or collection | Ethereum: Mainnet, Goerli, Sepolia BETA Polygon: Mainnet, Mumbai Arbitrum: Mainnet, Goerli BETA , Sepolia BETA Optimism: Mainnet, Goerli BETA , Sepolia BETA |
Spam Detection | getSpamContracts BETA | Retrieve a list of contracts marked as spam | Ethereum: Mainnet Polygon: Mainnet |
isSpamContract BETA | Returns whether a specific contract is marked as spam or not | Ethereum: Mainnet Polygon: Mainnet | |
reportSpamBETA | Report a contract if you think its spam | Ethereum: Mainnet, Goerli, Sepolia BETA Polygon: Mainnet, Mumbai Arbitrum: Mainnet, Goerli BETA , Sepolia BETA Optimism: Mainnet, Goerli BETA , Sepolia BETA Solana: Mainnet, Devnet BETA | |
Marketplace Data | getFloorPrice BETA | Retrieve the floor price of a NFT collection by marketplace | Ethereum: Mainnet |
getNFTSales BETA | Retrieve NFT sales data across marketplaces | Ethereum: Mainnet Polygon: Mainnet | |
Rarity | computeRarity BETA | Compute the rarity of each attribute of an NFT. | Ethereum: Mainnet Polygon: Mainnet |
summarizeNFTAttributes BETA | Generate a summary of attribute prevalence for an NFT collection. | Ethereum: Mainnet Polygon : Mainnet | |
Notifications | NFT Activity Webhook | Receiving real-time updates for NFT Transfers and NFT mints | Ethereum: Mainnet, Goerli, Sepolia BETA |
NFT Metadata Updates Webhook | Receiving real-time updates for NFT metadata changes | Ethereum: Mainnet, Goerli, Sepolia BETA Polygon: Mainnet, Mumbaid |