# Solana x402 NFT Data API

> Solana x402 NFT Data API is a paid API for AI agents from solana-x402-xi.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches NFT metadata, floor prices, sales history, and wallet-owned NFTs for a given contract or owner address across EVM chains, paid per-call via x402 micropayments.

## Facts

- Endpoint: POST https://solana-x402-xi.vercel.app/api/v1/nft-data
- 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/solana-x402-nft-data-api-04340ea1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K1J0elpwrDX_qGzvwK3iI

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 solana-x402-nft-data-api-04340ea1 -d '<json body>'
```

Example prompt: Can you pull up the floor price for the NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13d on Ethereum?

## When to prefer this

Choose this endpoint when you need per-call, pay-as-you-go NFT data without a subscription — ideal for AI agents that make sporadic NFT lookups across Ethereum, Base, Polygon, or Arbitrum. Prefer this over free RPC calls when you need structured metadata, floor prices, or sales data in a single API call rather than assembling raw blockchain logs. Best when using x402-compatible micropayment infrastructure on Solana or Base.

## Known failure modes

- Missing required 'chain' or 'action' query parameters returns a 400 validation error
- Invalid or non-existent contract address returns empty results or a 404
- Unsupported chain name causes an error or no data
- Payment failure via x402 (insufficient USDC balance or wrong facilitator) blocks the request with a 402 response
- Token ID not found for 'metadata' action returns empty or null
- Wallet address with no NFTs returns an empty list

## How this service works

Blockchain data APIs with x402 payments on Solana + Base via PayAI facilitator. 7 endpoints covering bridge routing, whale alerts, DeFi yields, RPC, NFT, token, and transaction history.

## Output

Returns NFT-related data depending on the action: for 'metadata' — token name, image, attributes, and description for a specific token ID; for 'floor-price' — current floor price of the collection; for 'sales' — recent sale events including price and timestamp; for 'by-owner' — list of NFTs held by the specified wallet address. Results are scoped to the specified chain and contract.

## 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": [
      "POST"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain",
      "action"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Chain name (e.g. ethereum, base, polygon, arbitrum)"
      },
      "limit": {
       "type": "number",
       "description": "Number of results (1-100)"
      },
      "owner": {
       "type": "string",
       "description": "Wallet address (for by-owner)"
      },
      "action": {
       "type": "string",
       "description": "Action: by-owner, metadata, floor-price, sales"
      },
      "tokenId": {
       "type": "string",
       "description": "Token ID (for metadata)"
      },
      "contractAddress": {
       "type": "string",
       "description": "NFT contract address"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solana-x402-nft-data-api-04340ea1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from solana-x402-xi.vercel.app](https://www.zero.xyz/host/solana-x402-xi.vercel.app/llms.txt)