# NFT Metadata Reader

> NFT Metadata Reader is a paid API for AI agents from llmrt-companion.manhliemcn4euwlu.workers.dev, paid per call via x402, $0.000639/call, status unknown (last checked 2026-11-13).

Returns ERC721 or ERC1155 NFT metadata including collection name, symbol, and tokenURI for a given contract address and token ID.

## Facts

- Endpoint: GET https://llmrt-companion.manhliemcn4euwlu.workers.dev/nft-metadata-402?utm_source=zero.xyz
- Price: $0.000639/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nft-metadata-reader-2f76491a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GNziXEGd7SfgqgCGfyW9e

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 nft-metadata-reader-2f76491a
```

Example prompt: Can you look up the collection name, symbol, and tokenURI for the NFT at contract address 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D with token ID 1234?

## When to prefer this

Use this endpoint when you need on-chain NFT metadata (collection name, symbol, tokenURI) for ERC721 or ERC1155 tokens without requiring an API key or signup. Prefer it over indexing services like OpenSea or Alchemy APIs when you want raw, trustless on-chain data with a cryptographic sha256 proof and no authentication overhead. It is ideal for lightweight agents that need read-only NFT metadata in a pay-per-call model.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty result
- Token ID not minted yet causes a revert or not-found response
- Contract does not implement ERC721/ERC1155 metadata extension, so name/symbol/tokenURI may be absent
- Network or RPC node unavailability causes a timeout or upstream error
- Malformed contract or token_id parameters return a validation error

## How this service works

Free LLM agent security review: paste your system prompt, get a ~35s report with live jailbreak/injection/extraction probes plus a static audit of which guardrails your spec is missing. No signup.

## Output

Returns a JSON object with ok status, the NFT standard (ERC721 or ERC1155), collection name, symbol, tokenURI, a sha256 hash of the artifact, an on-chain nano block hash as proof, and a download URL for the result payload.

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "sha256": "<artifact sha256>",
  "block_hash": "<nano block hash on-chain proof>",
  "download_url": "https://llmrt-companion.manhliemcn4euwlu.workers.dev/nft-metadata-402/dl/<token>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nft-metadata-reader-2f76491a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from llmrt-companion.manhliemcn4euwlu.workers.dev](https://www.zero.xyz/host/llmrt-companion.manhliemcn4euwlu.workers.dev/llms.txt)
