{"uid":"cap_2fk889Q5bRBXgsScj2ik9","slug":"vybe-solana-analytics-api-batch-nft-balances-c76a22e9","name":"Vybe Solana Analytics API — Batch NFT Balances","description":"Solana API endpoint for fetching multi-wallet NFT balances with collection metadata, floor prices, and aggregated portfolio values across multiple wallets.","url":"https://x402-api.vybenetwork.xyz/v4/wallets/batch/nft-balances?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["ownerAddresses"],"properties":{"page":{"type":"integer","format":"int32","minimum":0,"nullable":true,"description":"The requested page."},"limit":{"type":"integer","format":"int32","minimum":0,"nullable":true,"description":"The limit of entries to return (per wallet). If not passed, first 1000 entries are returned (the maximum)."},"sortByAsc":{"type":"string","nullable":true,"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","nullable":true,"description":"Sort descending based on amount or value of positions. Only one of sort_by_asc or sort_by_desc can be used"},"ownerAddresses":{"type":"array","items":{"type":"string","format":"pubkey"},"description":"Wallets to include in the returned results (max 10)."},"includeNoPriceBalance":{"type":"boolean","nullable":true,"description":"Whether or not we should include NFTs we do not track prices for."}}},"responseSchema":{"type":"object","required":["date","ownerAddresses","totalSol","totalUsd","totalNftCollectionCount","data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["collectionAddress","totalItems","valueSol","priceSol","valueUsd","priceUsd","slot"],"properties":{"name":{"type":"string","nullable":true,"description":"Symbol for the NFT"},"slot":{"type":"integer","format":"int64","description":"Slot for the most recent update to the NFT balance"},"logoUrl":{"type":"string","nullable":true,"description":"Logo URL for the NFT"},"priceSol":{"type":"string","description":"Price of the NFT in SOL"},"priceUsd":{"type":"string","description":"Price of the NFT in USD"},"valueSol":{"type":"string","description":"Value of the held NFT in SOL"},"valueUsd":{"type":"string","description":"Value of the held NFT in USD"},"totalItems":{"type":"integer","format":"int32","description":"Amount of the NFT"},"collectionAddress":{"type":"string","description":"Public key of the NFT collection"}}},"description":"NFTs in the wallet (up to limit)"},"date":{"type":"integer","minimum":0,"description":"Datetime of the report as a Unix timestamp"},"totalSol":{"type":"string","description":"Value of the wallet in SOL"},"totalUsd":{"type":"string","description":"Value of the wallet in USD"},"ownerAddresses":{"type":"array","items":{"type":"string","format":"pubkey"},"description":"Owners of the wallets"},"totalNftCollectionCount":{"type":"integer","format":"int64","minimum":0,"description":"Total number of nft collections in the wallet"}}},"example":null,"exampleRequest":null,"tags":["x402","finance"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XQm3KUMwFK5djXd3o6zeW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches NFT balances for multiple Solana wallet addresses in a single batch request, returning on-chain NFT holdings per wallet.","exampleAgentPrompt":"Pull the NFT balances for these Solana wallets all at once: GsK9...Abc, 7xPq...Def, and BnRt...Xyz — I want to see what NFTs each one holds on-chain.","exampleUseCases":null,"resultDescription":"Returns a structured list of NFT balances per wallet address, including NFT collection details, token counts, and on-chain holdings for each queried Solana public key.","failureModes":["Invalid or malformed Solana wallet addresses return a 400 error","Payment not provided or insufficient USDC causes a 402 Payment Required response with x-payment-info header","Too many wallet addresses in a single batch may return a 413 or rate-limit error","Network or RPC issues may cause partial data or 503 responses","Non-existent wallets return empty NFT balance arrays rather than errors"],"whenToPreferThis":"Use this endpoint when you need to retrieve NFT balances for multiple Solana wallets simultaneously without polling individual wallet endpoints. It is the right choice for portfolio dashboards, airdrop eligibility checks, or any scenario involving bulk NFT ownership lookups on Solana. Prefer this over single-wallet lookups when you have 2 or more addresses to check.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-25T15:26:09.095Z","isFirstParty":false,"canonicalSlug":"vybe-solana-analytics-api-batch-nft-balances-c76a22e9"}