Back to Browse
ERC-721 Tokens Owned by Address
x402
ERC-721 Tokens Owned by Address is a paid API for AI agents from ari001.tailb4ac3a.ts.net, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-02).
Returns all token IDs owned by a specific address for a given ERC-721 Enumerable contract on Ethereum mainnet
Price / call$0.008
Success—
StatusUnknown
How this service works
Returns an array of token IDs owned by a specific address for an ERC721 contract. Input: contract address (string), owner address (string). Output: array of token IDs (string[]). Query: token (ERC-721 contract (Enumerable), 0x + 40 hex), owner (0x + 40 hex).
Output
An array of up to 50 token ID strings owned by the specified address in the given ERC-721 contract, along with the owner address, token contract address, total balance count, and a truncated flag indicating whether more than 50 tokens exist. Returns ok:false with an error message if the contract is not Enumerable, the address is invalid, or the call fails.
Example use cases
NFT portfolio audit for a wallet
“Show me all the Bored Ape token IDs that wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B holds — the BAYC contract is 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13d.”
Verify NFT ownership before gating access
“Does 0x1234567890123456789012345678901234567890 actually own any tokens in the NFT contract 0xa7d8d9ef8D8Ce8992Df33D8b8CF4Aebabd5bD270? List the token IDs.”
Track NFT holdings for an airdrop eligibility check
“I need to know every token ID that 0xdEAD000000000000000042069420694206942069 holds in ERC-721 collection 0x60E4d786628Fea6478F785A6d7e704777c86a7c6 — please enumerate them all.”
Technical details
Endpoint
GEThttps://ari001.tailb4ac3a.ts.net/v1/ventures/ethereum_contract_abi_service/erc721_tokensof?utm_source=zero.xyzWhen to prefer
Use this endpoint when you need to enumerate the specific token IDs held by a wallet in a known ERC-721 Enumerable contract on Ethereum mainnet. It is the right choice when you need the full list of owned token IDs, not just a balance count. Prefer this over a raw balanceOf call when you need actionable token IDs for downstream operations like metadata fetching, transfer checks, or airdrop eligibility. Not suitable for ERC-1155 tokens or contracts that do not implement the Enumerable extension.
Side effects
- Contract is not ERC-721 Enumerable — returns ok:false with an error
- Invalid contract or owner address format (not 0x + 40 hex) — schema validation error
- Contract address is an EOA or non-NFT contract — call reverts
- Owner holds more than 50 tokens — result is truncated and truncated flag is true
- Network timeout or RPC node unavailability — service error response
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"