# Blockscout NFT Token Instances by Contract

> Blockscout NFT Token Instances by Contract 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-10).

Returns paginated NFT instances (with metadata, media URLs, and ownership) for a given token contract address on a specified blockchain network

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/tokens/%7Baddress_hash_param%7D/instances
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-nft-token-instances-by-contract-5389eaa5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kyEUnGkmZ8FDSLFfc4IO5

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-token-instances-by-contract-5389eaa5
```

Example prompt: Show me all NFT instances minted under the token contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum mainnet, including their images and metadata.

## When to prefer this

Use this endpoint when you need to enumerate all NFT instances (ERC-721 or ERC-1155) minted under a specific contract on a supported blockchain, especially when you need rich metadata including images, animations, and ownership. Prefer this over generic blockchain explorers when you need Blockscout's cross-chain support and structured NFT-specific response format with thumbnails. Best for agents building NFT galleries, portfolio trackers, or collection analytics.

## Known failure modes

- Invalid or non-existent chain_id returns 404 or empty response
- Invalid address_hash_param format returns 422 validation error
- Contract address is not an NFT contract — returns empty items array
- Pagination cursor mismatch leads to duplicate or missing items
- Rate limiting or payment failure returns 402 Payment Required
- Non-NFT (fungible) token address returns empty or malformed 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

A paginated list of NFT token instances for the specified contract, each including: instance ID, owner details, value, metadata object, image URL, media URL, media type, thumbnail URLs (60x60, 250x250, 500x500, original), token type, animation URL, external app URL, image media type, animation media type, and next_page_params 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": {
      "items_count": {
       "type": "integer"
      },
      "unique_token": {
       "type": "string"
      },
      "holder_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": [
   {
    "id": "string",
    "owner": {},
    "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-token-instances-by-contract-5389eaa5/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)