# Vybe Solana Analytics API – Wallet NFT Balance

> Vybe Solana Analytics API – Wallet NFT Balance is a paid API for AI agents from x402-api.vybenetwork.xyz, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Returns the NFT holdings (balance) for a given Solana wallet address, with optional pagination, sorting, and price filtering.

## Facts

- Endpoint: POST https://x402-api.vybenetwork.xyz/v4/wallets/%7BownerAddress%7D/nft-balance?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vybe-solana-analytics-api-wallet-nft-balance-0a4753fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Luw6oD_nYijkU5lOsJ_EG

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 vybe-solana-analytics-api-wallet-nft-balance-0a4753fa -d '<json body>'
```

Example prompt: What NFTs does the Solana wallet 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU hold? Show me up to 50, sorted by value descending, and include NFTs without price data.

## When to prefer this

Use this endpoint when you need a complete NFT inventory for a specific Solana wallet, especially when you want pagination, value-based sorting, or the option to include NFTs without tracked prices. Prefer this over token-balance endpoints when the focus is specifically on NFT holdings rather than fungible tokens.

## Known failure modes

- Invalid or malformed ownerAddress returns a 400 or validation error
- Wallet address not found on-chain returns empty results or 404
- Insufficient USDC payment via x402 protocol results in 402 Payment Required
- Both sortByAsc and sortByDesc specified simultaneously causes a 400 error
- Requesting a page beyond available results returns empty data
- Network or upstream Solana RPC issues may cause 500 errors or timeouts

## How this service works

Read access to Solana on-chain data — tokens, wallets, markets, prices, trades, transfers. No API key, no signup. Pay in USDC per request with the x402 protocol; the per-route price is declared in `x-payment-info`. WebSocket streaming uses prepaid credits.

## Output

A paginated list of NFT positions held by the specified Solana wallet, including collection identifiers, token amounts, and where available, USD values. Optionally includes NFTs for which Vybe does not track prices.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ownerAddress"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "description": "The requested page."
  },
  "limit": {
   "type": "integer",
   "description": "The limit of entries to return. If not passed, first 1000 entries are returned (the maximum)."
  },
  "sortByAsc": {
   "type": "string",
   "description": "Sort ascending based on amount or value of positions. Only one of sort_by_asc or sort_by_desc can be used"
  },
  "sortByDesc": {
   "type": "string",
   "description": "Sort descending based on amount or value of positions. Only one of sort_by_asc or sort_by_desc can be used"
  },
  "ownerAddress": {
   "type": "string",
   "description": "The public key (pubKey) associated with the Solana account."
  },
  "includeNoPriceBalance": {
   "type": "boolean",
   "description": "Whether or not we should include NFTs we do not track prices for."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "$ref": "#/components/schemas/WalletBalanceNftResults"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vybe-solana-analytics-api-wallet-nft-balance-0a4753fa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-api.vybenetwork.xyz](https://www.zero.xyz/host/x402-api.vybenetwork.xyz/llms.txt)