# ERC721 Token Holdings Lookup

> ERC721 Token Holdings Lookup is a paid API for AI agents from api.axiomworks.co.uk, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-13).

Returns all ERC721 NFT token IDs held by a specific wallet address for a given collection contract on EVM chains

## Facts

- Endpoint: GET https://api.axiomworks.co.uk/chain/erc721-tokens?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc721-token-holdings-lookup-3df71b57
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sSVFixmYAFmq_1FdS_-QB

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 erc721-token-holdings-lookup-3df71b57
```

Example prompt: Can you list all the token IDs from the Bored Ape Yacht Club contract (0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D) that wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B currently holds on Ethereum?

## When to prefer this

Use this endpoint when you need to enumerate which specific token IDs from a known ERC721 collection a wallet owns, without needing full metadata like images or attributes. Prefer this over the tokenURI/metadata endpoint when you only need ownership enumeration rather than resolved metadata. Ideal for NFT gating checks, inventory snapshots, and ownership verification on Base, Ethereum, Arbitrum, Optimism, or Polygon.

## Known failure modes

- Invalid wallet or contract address format (must be 0x + 40 hex chars) returns validation error
- Contract address is not an ERC721 contract — may return empty results or error
- Unsupported chain value returns enum validation error
- Wallet holds no tokens in the collection — returns empty list
- Rate limiting or RPC node timeout for high-traffic chains
- Limit exceeding 100 is clamped or rejected

## How this service works

Company intelligence, KYB, sanctions screening and monitoring for AI agents. Pay per call with x402 and USDC on Base. No API keys. Explore free samples.

## Output

A list of ERC721 token IDs owned by the specified wallet address within the given collection contract, up to the requested limit (default 50, max 100), filtered by chain. Typically includes token IDs as an array and ownership metadata for each token.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "contract",
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
       ],
       "type": "string",
       "description": "EVM chain (default base)"
      },
      "limit": {
       "type": "string",
       "description": "Max token_ids (default 50, max 100)"
      },
      "wallet": {
       "type": "string",
       "description": "Alias for address (owner wallet)"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Owner wallet"
      },
      "network": {
       "type": "string",
       "description": "Alias for chain (onesource-compatible)"
      },
      "contract": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC721 collection"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc721-token-holdings-lookup-3df71b57/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.axiomworks.co.uk](https://www.zero.xyz/host/api.axiomworks.co.uk/llms.txt)
