{"uid":"cap_yk3Ky24BupLLt3uANAwh1","slug":"vybe-solana-analytics-api-wallet-token-balance-37e1ed47","name":"Vybe Solana Analytics API – Wallet Token Balance","description":"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.","url":"https://x402-api.vybenetwork.xyz/v4/wallets/%7BownerAddress%7D/token-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"},"onlyVerified":{"type":"boolean","description":"Whether tokens returned should be restricted to verified tokens only. Default is false."},"ownerAddress":{"type":"string","description":"The public key (pubKey) associated with the Solana account."},"maxAssetValue":{"type":"string","description":"The maximum amount of total value in USD for an asset to be considered in the results. Overrides `includeNoPriceBalance`. Defaults to no limit."},"minAssetValue":{"type":"string","description":"The minimum amount of total value in USD for an asset to be considered in the results. Overrides `includeNoPriceBalance`. Defaults to no limit."},"mintAddresses":{"type":"array","description":"The allowable mints, if any, to filter the results by."},"vybeTokenFilter":{"type":"boolean","description":"Whether Vybe's token filter should restrict the tokens that are returned. Default is true."},"includeNoPriceBalance":{"type":"boolean","description":"Whether or not we should include tokens we do not track prices for. Filtering is applied after limiting."}}},"responseSchema":{"$ref":"#/components/schemas/WalletBalanceTokenResults"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BxLakrqOFfxWnTAdnUH7g","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the token balances held by a given Solana wallet address, with optional filtering by mint, value range, verification status, and sorting.","exampleAgentPrompt":"Show me all verified token balances for the Solana wallet address 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU, sorted by value descending and only include positions worth at least $1 USD.","exampleUseCases":null,"resultDescription":"A paginated list of token positions held by the specified Solana wallet, each including the token mint address, amount, and USD value. Results can be filtered to verified tokens only, bounded by min/max asset value, and sorted ascending or descending by amount or value.","failureModes":["Invalid or non-existent ownerAddress returns empty results or 404","Payment not provided or insufficient USDC via x402 returns 402 Payment Required","Conflicting sort parameters (sortByAsc and sortByDesc both set) returns 400 Bad Request","mintAddresses filter with no matching holdings returns empty list","Rate limiting or network congestion may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need the current SPL token portfolio of a specific Solana wallet, especially with filtering by verified tokens, USD value thresholds, or specific mint addresses. Prefer this over general blockchain explorers when you need structured, filterable data ready for analysis or display. Ideal for portfolio dashboards, wallet screening, or DeFi analytics workflows that pay per request without requiring API key signup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-28T00:42:19.350Z","isFirstParty":false,"canonicalSlug":"vybe-solana-analytics-api-wallet-token-balance-37e1ed47"}