{"uid":"cap_GSP0PCpoEoOXrqiGAu_kY","slug":"vybe-solana-wallet-token-balance-time-series-91c1bb96","name":"Vybe Solana Wallet Token Balance Time Series","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-accounts-balance-ts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["ownerAddress"],"properties":{"days":{"type":"integer","description":"Number of previous days to include in the data (from today's date), up to 30 days (default 14)."},"page":{"type":"integer","description":"The requested page."},"limit":{"type":"integer","description":"Limit of entries to return (per day). If not passed, first 1000 entries are returned (the maximum)."},"sortByAsc":{"type":"string","description":"Sort ascending based on 'amount', 'amountScaled', 'ownerAddress', 'priceUsd', 'valueUsd', or 'mintAddress'. Only one of sort_by_asc or sort_by_desc can be used"},"sortByDesc":{"type":"string","description":"Sort descending based on 'amount', 'amountScaled', 'ownerAddress', 'priceUsd', 'valueUsd', or 'mintAddress'. 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."},"vybeTokenFilter":{"type":"boolean","description":"Whether Vybe's token filter should restrict the tokens that are returned. If false, all priced tokens are included. Default is true."}}},"responseSchema":{"$ref":"#/components/schemas/WalletTimeSeriesRawReturn"},"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_uaiXf_aV5s8VMdNecRRG5","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 a paginated time-series history of token account balances (with USD values) for a given Solana wallet address, covering up to 30 days of daily snapshots.","exampleAgentPrompt":"Pull the last 30 days of daily token balance history for Solana wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM, showing up to 100 entries per day sorted by USD value descending, and include all priced tokens not just Vybe-filtered ones.","exampleUseCases":null,"resultDescription":"A paginated time-series dataset (WalletTimeSeriesRawReturn) containing daily snapshots of each token account held by the specified wallet, including raw and scaled token amounts, mint addresses, USD prices, and USD portfolio values — suitable for charting balance trends, detecting inflows/outflows, or computing historical PnL.","failureModes":["Invalid or non-existent ownerAddress returns an error or empty dataset","days > 30 may be rejected or clamped to maximum allowed window","Insufficient USDC payment (x402) causes 402 Payment Required response","Conflicting sortByAsc and sortByDesc parameters result in a validation error","Requesting a page beyond available data returns empty results","Rate limiting or network issues at the x402 facilitator layer cause request failure"],"whenToPreferThis":"Use this endpoint when you need historical, day-by-day token balance snapshots for a specific Solana wallet — especially for portfolio trend analysis, PnL computation, or charting token holding changes over time. Prefer this over spot-balance endpoints when temporal context matters. The x402 micropayment model means no API key friction, making it ideal for agent-driven, per-query workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-28T00:41:34.785Z","isFirstParty":false,"canonicalSlug":"vybe-solana-wallet-token-balance-time-series-8d02efbb"}