evm_getwalletnfts
Retrieve all NFTs owned by a wallet address, including on-chain and off-chain metadata, floor prices, and rarity. Optionally filter by specific token contracts and exclude spam NFTs for precise results.
Instructions
Fetch all NFTs held by a specified wallet address. Use token_addresses to filter by one or many specific contract(s). Each NFT returned includes on-chain metadata as well as off-chain metadata, floor prices, rarity and more where available.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | The address of the wallet | |
| chain | No | The chain to query | eth |
| cursor | No | The cursor returned in the previous response (used for getting the next page). | |
| exclude_spam | No | Should spam NFTs be excluded from the result? | |
| format | No | The format of the token ID | decimal |
| include_prices | No | Should NFT last sale prices be included in the result? | |
| limit | No | The desired page size of the result. | |
| media_items | No | Should preview media data be returned? | |
| normalizeMetadata | No | Should normalized metadata be returned? | |
| token_addresses | No | The addresses to get balances for (optional) |
Input Schema (JSON Schema)
{
"properties": {
"address": {
"description": "The address of the wallet",
"type": "string"
},
"chain": {
"default": "eth",
"description": "The chain to query",
"enum": [
"eth",
"0x1",
"sepolia",
"0xaa36a7",
"polygon",
"0x89",
"bsc",
"0x38",
"bsc testnet",
"0x61",
"avalanche",
"0xa86a",
"fantom",
"0xfa",
"cronos",
"0x19",
"arbitrum",
"0xa4b1",
"chiliz",
"0x15b38",
"chiliz testnet",
"0x15b32",
"gnosis",
"0x64",
"gnosis testnet",
"0x27d8",
"base",
"0x2105",
"base sepolia",
"0x14a34",
"optimism",
"0xa",
"holesky",
"0x4268",
"polygon amoy",
"0x13882",
"linea",
"0xe708",
"moonbeam",
"0x504",
"moonriver",
"0x505",
"moonbase",
"0x507",
"linea sepolia",
"0xe705",
"flow",
"0x2eb",
"flow-testnet",
"0x221",
"ronin",
"0x7e4",
"ronin-testnet",
"0x7e5",
"lisk",
"0x46f",
"lisk-sepolia",
"0x106a",
"pulse",
"0x171"
],
"type": "string"
},
"cursor": {
"description": "The cursor returned in the previous response (used for getting the next page).",
"type": "string"
},
"exclude_spam": {
"default": false,
"description": "Should spam NFTs be excluded from the result?",
"type": "boolean"
},
"format": {
"default": "decimal",
"description": "The format of the token ID",
"enum": [
"decimal",
"hex"
],
"type": "string"
},
"include_prices": {
"default": false,
"description": "Should NFT last sale prices be included in the result?",
"type": "boolean"
},
"limit": {
"description": "The desired page size of the result.",
"minimum": 0,
"type": "number"
},
"media_items": {
"default": false,
"description": "Should preview media data be returned?",
"type": "boolean"
},
"normalizeMetadata": {
"default": true,
"description": "Should normalized metadata be returned?",
"type": "boolean"
},
"token_addresses": {
"description": "The addresses to get balances for (optional)",
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
}
},
"required": [
"address"
],
"type": "object"
}