get_nft_balance
Retrieve the total number of NFTs owned by a specific wallet address within a given collection on EVM-compatible blockchains.
Instructions
Get the total number of NFTs owned by an address from a specific collection. This returns the count of NFTs, not individual token IDs.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| network | No | Network name (e.g., 'ethereum', 'optimism', 'arbitrum', 'base', 'polygon') or chain ID. Most NFTs are on Ethereum mainnet, which is the default. | |
| ownerAddress | Yes | The wallet address to check the NFT balance for (e.g., '0x1234...') | |
| tokenAddress | Yes | The contract address of the NFT collection (e.g., '0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D' for Bored Ape Yacht Club) |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"network": {
"description": "Network name (e.g., 'ethereum', 'optimism', 'arbitrum', 'base', 'polygon') or chain ID. Most NFTs are on Ethereum mainnet, which is the default.",
"type": "string"
},
"ownerAddress": {
"description": "The wallet address to check the NFT balance for (e.g., '0x1234...')",
"type": "string"
},
"tokenAddress": {
"description": "The contract address of the NFT collection (e.g., '0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D' for Bored Ape Yacht Club)",
"type": "string"
}
},
"required": [
"tokenAddress",
"ownerAddress"
],
"type": "object"
}