# Blockscout NFT Token Instance Lookup

> Blockscout NFT Token Instance Lookup 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 detailed metadata and media information for a specific NFT token instance (by token ID) on a given blockchain network via Blockscout's multichain explorer API

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/tokens/%7Baddress_hash_param%7D/instances/%7Btoken_id_param%7D
- 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-token-instance-lookup-f5b8789f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_22cMIAJbTJ_YYIvGUb4f0

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-instance-lookup-f5b8789f
```

Example prompt: Can you pull up the full NFT details for token ID 42 on the contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum (chain ID 1) using Blockscout? I want to see the image, owner, media type, and any animation.

## When to prefer this

Use this endpoint when you need rich, structured metadata for a specific NFT token instance — including media URLs, thumbnails, owner, and animation — across any EVM-compatible chain supported by Blockscout. Prefer it over generic blockchain RPC calls when you want parsed, human-readable NFT data without decoding raw on-chain responses. Best when you know both the contract address and the specific token ID and want multichain support in a single API surface.

## Known failure modes

- Invalid or unsupported chain_id returns 404 or empty response
- Non-existent token ID for a given contract returns 404 not found
- Invalid contract address format returns 400 bad request
- Contract address is not an NFT contract — returns error or empty data
- Token has no on-chain metadata — returns partial response with null fields
- Rate limiting or payment failure (x402) blocks the request

## 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 JSON object for the specific NFT token instance including: token ID, owner details, parent token metadata, value, full metadata object, image URL, image media type, media URL, media type, thumbnail URLs at multiple resolutions (60x60, 250x250, 500x500, original), token type, animation URL, animation media type, and external app URL.

## 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"
      },
      "token_id_param": {
       "type": "string"
      },
      "address_hash_param": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "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": {},
  "animation_url": "string",
  "external_app_url": "string",
  "image_media_type": "string",
  "animation_media_type": "string"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-nft-token-instance-lookup-f5b8789f/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)