Actions10
Get User NFTs
AI-generatedOverview
This node operation retrieves NFTs owned by a specified user within a given NFT collection on the Ethereum blockchain. It supports filtering options to fetch all owned NFTs, only those currently listed for sale, or those owned but not listed. This is useful for users who want to analyze or display a user's NFT holdings or active marketplace listings in a specific collection.
Use Case Examples
- Fetch all NFTs owned by a user in a particular NFT collection to display in a portfolio.
- Retrieve only NFTs currently listed by a user to monitor active sales on the marketplace.
- Get NFTs owned by a user excluding those currently listed to analyze holdings not for sale.
Properties
| Name | Meaning |
|---|---|
| User Address | Ethereum address of the user whose NFTs are to be retrieved. |
| Filter Mode | Determines which NFTs to retrieve: all owned, currently listed for sale, or owned but not listed. |
| Collection Address | Ethereum address of the NFT collection contract to filter NFTs by. |
| Number to Fetch | Number of NFTs to fetch, with a maximum limit of 1000. |
| Order Direction | Order direction for retrieving NFTs, either ascending or descending. |
| Options | Additional options such as simplifying the output to essential fields only. |
Output
JSON
json- The JSON output contains the retrieved NFTs data based on the filter mode and collection address. It may include detailed NFT metadata or a simplified version depending on the options.
Dependencies
- Requires an Ethereum JSON RPC provider URL and optionally an API key credential for blockchain interaction.
Troubleshooting
- Common issues include invalid Ethereum addresses, unsupported filter modes, or exceeding the maximum number of NFTs to fetch.
- Errors may occur if the collection address is incorrect or if the blockchain provider is unreachable.
- Ensure the user address and collection address are valid Ethereum addresses to avoid errors.