# Zerion API - Wallet NFT Positions

> Zerion API - Wallet NFT Positions is a paid API for AI agents from api.zerion.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Fetches all NFT positions held by a given EVM or Solana wallet address across 40+ chains

## Facts

- Endpoint: GET https://api.zerion.io/v1/wallets/%7Baddress%7D/nft-positions?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zerion-api-wallet-nft-positions-00f7ae19
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mo7MiPieku2Flecqf4mxo

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 zerion-api-wallet-nft-positions-00f7ae19
```

Example prompt: Can you pull up all the NFTs held by the wallet 0x1234abcd...5678 across all chains using Zerion?

## When to prefer this

Use this endpoint when you need a comprehensive, interpreted list of NFT holdings for any EVM-compatible or Solana wallet across 40+ chains in a single call. Prefer this over raw RPC or on-chain queries when you want normalized, human-readable NFT data without managing multiple chain connections. It is especially useful for agents that need to check NFT ownership, gate access, or audit a portfolio with minimal integration effort and pay-per-call x402 pricing.

## Known failure modes

- Invalid or malformed wallet address returns a 400 error
- Wallet address with no NFT positions returns an empty data array
- Unsupported chain or address format may return no results or an error
- Payment not included or insufficient USDC balance causes 402 Payment Required
- Rate limiting or network issues may cause transient 429 or 5xx errors
- Pagination not followed may result in incomplete NFT lists for large wallets

## How this service works

Interpreted wallet data for more than 40 chains and Solana: portfolios, DeFi positions, PnL, transactions and NFTs. REST for apps, x402 pay-per-call for agents.

## Output

A JSON:API-formatted array of NFT position resource objects for the given wallet, including resource IDs, types, and attributes (such as collection name, token ID, chain, and metadata), plus self and pagination links for traversing large result sets.

## 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": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Wallet address (EVM 0x or Solana base58)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string",
          "description": "Resource ID."
         },
         "type": {
          "type": "string",
          "description": "Resource type."
         },
         "attributes": {
          "type": "object",
          "description": "Resource attributes; see https://developers.zerion.io"
         }
        }
       },
       "description": "Array of JSON:API resource objects."
      },
      "links": {
       "type": "object",
       "description": "Self and pagination links."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "<resource id>",
    "type": "<resource type>",
    "attributes": {}
   }
  ],
  "links": {
   "self": "https://api.zerion.io/v1/..."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zerion-api-wallet-nft-positions-00f7ae19/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zerion.io](https://www.zero.xyz/host/api.zerion.io/llms.txt)