# Phantom API — Ethereum NFT Metadata Lookup

> Phantom API — Ethereum NFT Metadata Lookup 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-10-17).

Fetches on-chain metadata for a specific Ethereum NFT given its contract address and token ID

## Facts

- Endpoint: POST https://phantom-api-omega.vercel.app/api/ethereum/nft/metadata?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phantom-api-ethereum-nft-metadata-lookup-19f88756
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9xKz-ZXIG4cG8Mha2WLYb

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-ethereum-nft-metadata-lookup-19f88756 -d '<json body>'
```

Example prompt: Can you pull up the metadata for Ethereum NFT token ID 4821 from contract address 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D — I want to see its traits and image.

## When to prefer this

Choose this endpoint when you need fast, pay-per-call NFT metadata resolution on Ethereum without managing your own RPC node or indexer subscription. It is ideal for agents that only occasionally need NFT data (avoiding monthly subscription costs), or when building lightweight pipelines that enrich portfolio data, verify NFT traits before a transaction, or display NFT assets in a UI.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty response
- Token ID not minted or out of range results in a not-found error
- Token URI points to unreachable IPFS or off-chain metadata server causing timeout
- Contract is not an NFT standard (ERC-721/ERC-1155) and does not expose metadata
- Network congestion may delay on-chain resolution
- Payment failure via x402 protocol results in 402 response and no data returned

## 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 on-chain or off-chain metadata associated with the specified Ethereum NFT, typically including the token name, description, image URL, external URL, and an array of traits/attributes (trait_type and value pairs). May also include animation URL, background color, or other ERC-721/ERC-1155 metadata standard fields.

## 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-ethereum-nft-metadata-lookup-19f88756/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)