NFT APINFT API EndpointsNft Ownership Endpoints

Collections By Owner

Retrieves all NFT collections held by a specified owner address. <Note>This endpoint is only supported on Ethereum. Use `getContractsForOwner` for support across all other chains we support!</Note>

Path parameters

apiKeystringRequiredDefaults to docs-demo

Query parameters

ownerstringRequiredDefaults to 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

String - Address for NFT owner (can be in ENS format for Eth Mainnet).

pageKeystringOptional

String - key for pagination. If more results are available, a pageKey will be returned in the response. Pass back the pageKey as a param to fetch the next page of results.

pageSizeintegerOptionalDefaults to 100
Number of NFTs to be returned per page. Defaults to 100. Max is 100.
withMetadatabooleanOptionalDefaults to true

Boolean - if set to true, returns NFT metadata. Setting this to false will reduce payload size and may result in a faster API call. Defaults to true.

includeFilters[]list of enumsOptional
Array of filters (as ENUMS) that will be applied to the query. Only NFTs that match one or more of these filters will be included in the response. May not be used in conjunction with excludeFilters[]. Filter Options: - SPAM: NFTs that have been classified as spam. Spam classification has a wide range of criteria that includes but is not limited to emitting fake events and copying other well-known NFTs. Please note that this filter is currently supported on Mainnet for Base, Arbitrum, Optimism, Ethereum, Polygon, Worldchain, Avax, Gnosis, Zksync, and Blast, and is **available exclusively on paid tiers**. - AIRDROPS: NFTs that have were airdropped to the user. Airdrops are defined as NFTs that were minted to a user address in a transaction sent by a different address. NOTE: this filter is currently supported on Ethereum Mainnet, Ethereum Goerli, and Matic Mainnet only. - To learn more about spam, you can refer to this: <span class="custom-style"><a href="https://www.alchemy.com/overviews/spam-nfts" target="_blank">Spam NFTs and how to fix them</a></span>
Allowed values:
excludeFilters[]list of enumsOptional
Array of filters (as ENUMS) that will be applied to the query. NFTs that match one or more of these filters will be excluded from the response. May not be used in conjunction with includeFilters[]. Filter Options: - SPAM: NFTs that have been classified as spam. Spam classification has a wide range of criteria that includes but is not limited to emitting fake events and copying other well-known NFTs. Please note that this filter is currently supported on Mainnet for Base, Arbitrum, Optimism, Ethereum, Polygon, Worldchain, Avax, Gnosis, Zksync, and Blast, and is **available exclusively on paid tiers**. - AIRDROPS: NFTs that have were airdropped to the user. Airdrops are defined as NFTs that were minted to a user address in a transaction sent by a different address. NOTE: this filter is currently supported on Ethereum Mainnet, Ethereum Goerli, and Matic Mainnet only. - To learn more about spam, you can refer to this: <span class="custom-style"><a href="https://www.alchemy.com/overviews/spam-nfts" target="_blank">Spam NFTs and how to fix them</a></span>
Allowed values:

Response

Returns a list of NFT collections held by the specified owner address.
collectionslist of objects or null
pageKeystring or null
totalCountstring or null

String - Total number of NFT collections held by the given address.