# Vextorium NFTs of Wallet

> Vextorium NFTs of Wallet is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Returns all ERC-721 token IDs held by a wallet address for a given NFT collection contract, plus the total count, across 12 supported EVM chains.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/nfts-of-wallet?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-nfts-of-wallet-dd616a0f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uqd2POgKlVTGNv4CwOC1F

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 vextorium-nfts-of-wallet-dd616a0f -d '<json body>'
```

Example prompt: Which Bored Ape Yacht Club token IDs does the wallet 0x46EFbAedc92067E6d60E84ED6395099723252496 own on Ethereum? Pull the full list from the BAYC contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D.

## When to prefer this

Use this endpoint when you need to enumerate specific ERC-721 token IDs held by a wallet for a known collection contract, especially on EVM chains beyond Ethereum (Base, Arbitrum, Optimism, Polygon, BNB, Avalanche, Gnosis, Linea, Scroll, Sonic, Unichain). It's ideal for NFT-gating, portfolio audits, or snapshot tooling where you need the actual token IDs rather than just balances. Prefer this over general NFT indexers when you need lightweight per-collection lookups with pay-per-call pricing.

## Known failure modes

- Wallet owns no tokens from the specified contract — returns empty token_ids array with amount 0
- Contract is not enumerable (does not implement ERC-721Enumerable) — lookup via tokenOfOwnerByIndex fails or returns error
- Invalid wallet or contract address format — request rejected with validation error
- Unsupported network specified — returns error; only the 12 listed chains are supported
- Rate limiting or payment failure via x402 — call rejected before execution

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

A JSON object containing the wallet address, collection contract address, network name, an array of token ID strings owned by that wallet, and a numeric count of the total tokens held.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "address": {
   "type": "string"
  },
  "network": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon",
    "bnb",
    "avalanche",
    "gnosis",
    "line",
    "scroll",
    "sonic",
    "unichain"
   ],
   "type": "string",
   "description": "Chain (default base)"
  },
  "contract": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "amount": 1,
  "wallet": "0x46EFbAedc92067E6d60E84ED6395099723252496",
  "network": "ethereum",
  "token_ids": [
   "1"
  ],
  "collection": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-nfts-of-wallet-dd616a0f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)