# Phantom API – Optimism NFT Metadata

> Phantom API – Optimism NFT Metadata is a paid API for AI agents from phantom-api-omega.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Fetches on-chain NFT metadata (name, description, image, attributes) for a given contract and token ID on the Optimism network.

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/optimism/nft/metadata
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phantom-api-optimism-nft-metadata-5efb6f3d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tAVBdBsJpEVYyN8S_tp6n

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 phantom-api-optimism-nft-metadata-5efb6f3d -d '<json body>'
```

Example prompt: Can you pull up the metadata for token ID 1234 from the Optimism NFT contract at 0x4200000000000000000000000000000000000042 — I want to see its name, image, and traits?

## When to prefer this

Choose this endpoint when you need fast, pay-per-call NFT metadata retrieval specifically on the Optimism (OP Mainnet) network. It is ideal for agents that need to enrich NFT data on demand without managing RPC infrastructure. Prefer this over generic blockchain RPC calls when you need a simple POST interface and don't want to handle raw contract ABI decoding. Best suited for single-token lookups rather than bulk indexing.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty response
- Token ID not found in the contract returns a null or error result
- Contract does not implement standard metadata URI methods — metadata unavailable
- Optimism RPC node temporarily unavailable — request times out
- Malformed contractAddress or tokenId inputs cause a 400-level error
- IPFS or off-chain metadata URI unreachable — image/attributes may be missing

## How this service works

Lightning-fast access to blockchain data, smart contract insights, and Web3 infrastructure across 57+ networks. Pay-per-call via x402.

## Output

Returns the on-chain NFT metadata for the specified token on Optimism, typically including token name, description, image URI, and an array of trait/attribute key-value pairs as defined in the token's contract metadata standard (ERC-721/ERC-1155).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tokenId": {
   "type": "string"
  },
  "contractAddress": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/phantom-api-optimism-nft-metadata-5efb6f3d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from phantom-api-omega.vercel.app](https://www.zero.xyz/host/phantom-api-omega.vercel.app/llms.txt)