nft_check_ownership
Verify whether a wallet owns NFTs from a specific ERC-721 or ERC-1155 collection, returning ownership status and matching tokens. Supports optional filtering by traits.
Instructions
Commonly used to verify ownership of NFTs (including ERC-721 and ERC-1155) within a collection. Required: chainName (blockchain network), walletAddress (wallet address), collectionContract (NFT collection). Optional: traitsFilter (filter by trait types), valuesFilter (filter by trait values). Returns ownership status and matching NFTs if owned.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chainName | Yes | The blockchain network to query (e.g., 'eth-mainnet', 'matic-mainnet', 'bsc-mainnet'). | |
| walletAddress | Yes | The wallet address to check NFT ownership for. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically. | |
| collectionContract | Yes | The NFT collection contract address to check ownership in. Must be a valid ERC-721 or ERC-1155 contract address. | |
| traitsFilter | No | Filter by specific trait types (comma-separated list of trait names to filter by). | |
| valuesFilter | No | Filter by specific trait values (comma-separated list of trait values to match). |