# AgenticFi Wallet NFT Holdings Lookup

> AgenticFi Wallet NFT Holdings Lookup is a paid API for AI agents from defi-api.agenticfi.wtf, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the NFT holdings for a given wallet address on a specified blockchain network

## Facts

- Endpoint: GET https://defi-api.agenticfi.wtf/api/wallet/nfts/%7Baddress%7D
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenticfi-wallet-nft-holdings-lookup-7112c3ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kb0iWb0hThboR4NLOLA71

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 agenticfi-wallet-nft-holdings-lookup-7112c3ca
```

Example prompt: What NFTs does wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e hold on Base? List all collections and token IDs.

## When to prefer this

Use this endpoint when you need to enumerate or audit the NFT holdings of a specific wallet address on Base, Ethereum, or Arbitrum. Prefer this over generic blockchain explorers when you need structured, machine-readable NFT data for an AI agent workflow and are willing to pay per call via x402 on Base.

## Known failure modes

- Invalid wallet address format returns 400 error
- Unsupported chain key returns 400 or empty result
- Wallet has no NFTs returns empty array
- Payment of 0.001 USDC via x402 not provided returns 402 Payment Required
- Upstream indexer unavailable returns 503 or timeout
- Address with very large NFT holdings may time out or be paginated

## How this service works

NFTs held by a wallet - collection, floor price, metadata

## Output

A list of NFTs owned by the specified wallet address, including collection names, token IDs, and associated metadata such as images and traits, filtered by the requested chain (e.g. base, ethereum, arbitrum).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "pathParams",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "title": "address (required)",
       "description": "Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "title": "chain (optional)",
       "description": "Optional. Chain key Examples: base, ethereum, arbitrum"
      },
      "address": {
       "type": "string",
       "title": "address (required)",
       "description": "Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenticfi-wallet-nft-holdings-lookup-7112c3ca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi-api.agenticfi.wtf](https://www.zero.xyz/host/defi-api.agenticfi.wtf/llms.txt)