# Heurist Mesh: Fetch Wallet NFT Collections

> Heurist Mesh: Fetch Wallet NFT Collections is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the NFT portfolio of an EVM wallet address, including collection names, descriptions, and NFT counts.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/ZerionWalletAnalysisAgent/fetch_wallet_nfts
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-mesh-fetch-wallet-nft-collections-5000b995
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jjUBm8Zj8zfbXo3QMYhDa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability heurist-mesh-fetch-wallet-nft-collections-5000b995 -d '<json body>'
```

Example prompt: Can you pull up all the NFT collections held by the wallet 0x742d35Cc6634C0532925a3b8D4C9E2C4B1f3b9Ab and tell me how many NFTs are in each collection?

## When to prefer this

Use this endpoint when you need to inspect the NFT holdings of any EVM-compatible wallet address. It is backed by Zerion's wallet analysis and is ideal for portfolio checks, due diligence on counterparties, or building NFT dashboards. Prefer this over generic blockchain explorers when you need structured, LLM-ready NFT collection data with descriptions rather than raw on-chain data.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Wallet with no NFTs returns an empty collection list
- Non-EVM (e.g. Solana) wallet addresses are not supported
- Network timeout or Zerion API unavailability returns a service error
- Rate limiting or insufficient payment returns a 402 error

## How this service works

Fetch NFT collections held by an EVM wallet. The result includes the number of NFTs, the collection name and description of the NFTs. Use this tool if you want to know the NFT portfolio of the wallet.

## Output

Returns a structured list of NFT collections held by the specified EVM wallet, including each collection's name, description, and the number of NFTs owned within that collection.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "wallet_address"
     ],
     "properties": {
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "wallet_address": {
       "type": "string",
       "description": "The EVM wallet address (starting with 0x and 42-character long) to analyze. You can also use 'SELF' for wallet_address to use the user's own wallet address."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "object",
       "additionalProperties": true
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-fetch-wallet-nft-collections-5000b995/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)
