{"uid":"cap_MHBus9qa-_SZTTjBz88jz","slug":"vybe-solana-wallet-token-balance-time-series-8d02efbb","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-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).\nAllowed values depend on the resolution:\n- For \"1d\": 1 to 30 days (default is 14 days)\n- For \"1w\": 1 to 90 days (default is 30 days)\n- For \"1mo\": 1 to 365 days (default is 90 days)"},"resolution":{"type":"string","description":"Bucketing of the data. Possible values: daily ('1d'), weekly ('1w'), monthly ('1mo'). Default is \"daily\". One data point per bucket is returned."},"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/WalletBalanceTokenResultsTimeSeries"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.018","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.018","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LzHOyiiTQGa42DfbTNaKH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.018","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a historical time series of token balances for a given Solana wallet address, bucketed by day, week, or month.","exampleAgentPrompt":"Pull the daily token balance history for Solana wallet 5FHwkrdxNtSFDBEBmSWLCWoRPHGGmkQc3KDJjFMkwRVH over the last 30 days using Vybe's on-chain analytics, and include all priced tokens not just the Vybe-filtered ones.","exampleUseCases":null,"resultDescription":"A time series array of token balance snapshots for the specified wallet, with one data point per resolution bucket (day/week/month), covering the requested lookback period. Each data point includes token holdings and their balances at that point in time.","failureModes":["Invalid or malformed ownerAddress returns 400 or empty result","Days value out of range for the selected resolution returns validation error","No historical data available for a brand-new or inactive wallet","Payment not accepted or insufficient USDC balance causes 402 Payment Required","Network congestion or RPC issues may cause timeout or 503"],"whenToPreferThis":"Use this endpoint when you need historical, time-bucketed snapshots of a Solana wallet's token balances — particularly for portfolio trend analysis, charting balance changes over days/weeks/months, or auditing historical holdings. Prefer this over a spot-balance endpoint when the user needs trend data rather than current state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-28T06:43:07.882Z","isFirstParty":false,"canonicalSlug":"vybe-solana-wallet-token-balance-time-series-8d02efbb"}