# Phantom API — Base NFT by Owner

> Phantom API — Base NFT by Owner 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-14).

Retrieves all NFTs owned by a specific wallet address on the Base blockchain network

## Facts

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

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-by-owner-9eb49a54 -d '<json body>'
```

Example prompt: Can you pull up all the NFTs owned by the Base wallet 0x1234abcd...efgh — show me up to 50 at a time?

## When to prefer this

Use this endpoint when you need to enumerate all NFTs held by a specific wallet on the Base blockchain. Prefer this over generic NFT APIs when you specifically need Base network data and want pay-per-call pricing via x402 with no subscription overhead. Best for on-demand lookups in agent workflows where you need to verify ownership or audit a portfolio.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Unrecognized pageKey causes pagination failure
- Missing required 'owner' field results in a 400-level error
- Rate limits or payment failures return a 402 response
- Network downtime or Base indexer lag may cause stale or incomplete results

## 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 a paginated list of NFTs owned by the specified wallet address on the Base network, including token metadata such as contract address, token ID, name, image, and a pagination key for fetching subsequent pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number"
  },
  "owner": {
   "type": "string"
  },
  "pageKey": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/phantom-api-base-nft-by-owner-9eb49a54/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)