# Blockscout NFT Collections by Address

> Blockscout NFT Collections by Address is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-11).

Retrieves all NFT collections held by a specific blockchain address on a given chain, including token metadata and individual NFT instances

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/addresses/%7Baddress_hash_param%7D/nft/collections
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-nft-collections-by-address-a7d5d734
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qddyTufXC5Ftrrz-unEIp

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 blockscout-nft-collections-by-address-a7d5d734
```

Example prompt: Using Blockscout, show me all NFT collections held by wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet (chain ID 1), filtering for ERC-721 tokens.

## When to prefer this

Use this endpoint when you need to enumerate the specific NFT collections and individual token instances held by a known wallet address on a specific blockchain. Prefer this over generic token balance endpoints when NFT-specific metadata (images, media, thumbnails, animation URLs) is required. It is ideal for building NFT portfolio viewers, verifying NFT ownership, or auditing wallet contents across multiple EVM-compatible chains supported by Blockscout.

## Known failure modes

- Invalid chain_id returns 404 or empty result
- Malformed address_hash_param returns 422 or error response
- Address with no NFTs returns empty items array
- Unsupported token_type filter value may return 400
- Rate limiting or payment failure returns 402 Payment Required
- Chain not supported by Blockscout returns error or empty response

## How this service works

Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data

## Output

Returns a paginated list of NFT collections held by the specified address, each containing the token's metadata (name, symbol, type, icon URL, total supply, exchange rate, holders count) and an array of individual NFT instances with their ID, image URL, media URL, thumbnail sizes (60x60, 250x250, 500x500), animation URL, metadata, and external app URL. A next_page_params object is included for pagination.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "properties": {
      "chain_id": {
       "type": "string"
      },
      "address_hash_param": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "type": {
       "type": "string"
      },
      "token_type": {
       "type": "string"
      },
      "items_count": {
       "type": "integer"
      },
      "token_contract_address_hash": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "token": {
     "name": "string",
     "type": {},
     "symbol": "string",
     "decimals": "string",
     "icon_url": "string",
     "reputation": "string",
     "volume_24h": "string",
     "bridge_type": "string",
     "address_hash": "string",
     "total_supply": "string",
     "exchange_rate": "string",
     "holders_count": "string",
     "foreign_address": "string",
     "origin_chain_id": "string",
     "circulating_supply": "string",
     "circulating_market_cap": "string"
    },
    "amount": "string",
    "token_instances": [
     {
      "id": "string",
      "owner": {},
      "token": {},
      "value": "string",
      "metadata": {},
      "image_url": "string",
      "is_unique": true,
      "media_url": "string",
      "media_type": "string",
      "thumbnails": {
       "60x60": "string",
       "250x250": "string",
       "500x500": "string",
       "original": "string"
      },
      "token_type": "string",
      "animation_url": "string",
      "external_app_url": "string",
      "image_media_type": "string",
      "animation_media_type": "string"
     }
    ]
   }
  ],
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-nft-collections-by-address-a7d5d734/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)