# Vextorium ERC-721 Wallet Token IDs Lookup

> Vextorium ERC-721 Wallet Token IDs Lookup 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-29).

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

## Facts

- Endpoint: POST https://api.vextorium.com/nft-de-wallet-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-erc-721-wallet-token-ids-lookup-dd68cf6e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BRh9IXLwGeEnxsMgVLk8E

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-erc-721-wallet-token-ids-lookup-dd68cf6e -d '<json body>'
```

Example prompt: Can you tell me which token IDs from the BAYC collection (0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D) are held by the wallet 0x46EFbAedc92067E6d60E84ED6395099723252496 on Ethereum, and how many total does it own?

## When to prefer this

Use this endpoint when you need to enumerate specific token IDs from a known ERC-721 collection owned by a wallet, especially on enumerable collections across any of the 12 supported EVM chains (Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic, Unichain). Prefer this over generic blockchain explorers when you need structured, agent-ready JSON output with both the count and full token ID list in a single call.

## Known failure modes

- Collection contract is not enumerable (does not implement ERC-721Enumerable), causing the tokenOfOwnerByIndex calls to fail
- Invalid wallet or contract address format returns an error
- Unsupported chain specified outside the 12 supported networks
- Wallet holds no tokens from the collection — returns cantidad: 0 and empty token_ids array
- Network RPC timeout or congestion causing delayed or failed response
- Payment failure via x402 protocol if USDC balance is insufficient

## How this service works

Token ids of an ERC-721 collection held by a wallet (tokenOfOwnerByIndex on enumerable collections) and the total count. Works on Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic and Unichain.

## Output

Returns a JSON object containing the blockchain name, the queried wallet address, the NFT collection contract address, the total count of tokens owned (cantidad), and an array of token ID strings (token_ids) held by that wallet in that collection.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "red": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon",
    "bnb",
    "avalanche",
    "gnosis",
    "linea",
    "scroll",
    "sonic",
    "unichain"
   ],
   "type": "string",
   "description": "Chain (default base)"
  },
  "limite": {
   "type": "integer"
  },
  "contrato": {
   "type": "string"
  },
  "direccion": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "red": "ethereum",
  "wallet": "0x46EFbAedc92067E6d60E84ED6395099723252496",
  "cantidad": 1,
  "coleccion": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
  "token_ids": [
   "1"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-erc-721-wallet-token-ids-lookup-dd68cf6e/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)