# Phantom API — Base NFT Metadata Lookup

> Phantom API — Base 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-09-16).

Fetches on-chain NFT metadata for a given contract address and token ID on the Base network

## Facts

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

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-base-nft-metadata-lookup-b0be8d7b -d '<json body>'
```

Example prompt: Can you pull up the metadata for token ID 42 from the NFT contract at 0x1234...abcd on the Base network — I want to see its name, image, and traits.

## When to prefer this

Choose this endpoint when you need fast, pay-per-call access to NFT metadata on the Base network without managing your own RPC infrastructure. It is especially useful for agents that occasionally need NFT metadata without committing to a subscription-based provider. Prefer this over general-purpose blockchain RPCs when you want a simple POST interface with structured output rather than raw contract calls.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty response
- Token ID not found on the contract returns a not-found or null metadata response
- Contract does not implement a standard metadata URI interface, resulting in missing fields
- Network congestion or RPC issues may cause timeouts
- Payment failure via x402 may block access before the call is made

## 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 metadata for the specified NFT token on the Base network, typically including the token name, description, image URI, and an array of attributes or traits as defined in the token's metadata standard (ERC-721 or ERC-1155 metadata JSON schema).

## 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-base-nft-metadata-lookup-b0be8d7b/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)