{"uid":"cap_jH5DV1k-VPC2VU2kgdje3","slug":"vybe-solana-wallet-batch-token-accounts-balance-time-series-6dbde1f0","name":"Vybe Solana Wallet Batch Token Accounts Balance Time Series","description":"Solana API endpoint for fetching multi-wallet token account history with raw balance snapshots for custom analytics and unaggregated time-series data.","url":"https://x402-api.vybenetwork.xyz/v4/wallets/batch/token-accounts-balance-ts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["ownerAddresses"],"properties":{"days":{"type":"integer","format":"int32","minimum":0,"nullable":true,"description":"Number of previous days to include in the data (from today's date), up to 30 days (default 14)."},"page":{"type":"integer","format":"int32","minimum":0,"nullable":true,"description":"The requested page."},"limit":{"type":"integer","format":"int32","minimum":0,"nullable":true,"description":"Limit of entries to return (per day). If not passed, first 1000 entries are returned (the maximum)."},"sortByAsc":{"type":"string","nullable":true,"description":"Sort ascending based on 'amount', 'amountScaled', 'priceUsd', 'valueUsd', or 'mintAddress'. Only one of sort_by_asc or sort_by_desc can be used"},"sortByDesc":{"type":"string","nullable":true,"description":"Sort descending based on 'amount', 'amountScaled', 'priceUsd', 'valueUsd', or 'mintAddress'. 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)."},"vybeTokenFilter":{"type":"boolean","nullable":true,"description":"Whether Vybe's token filter should restrict the tokens that are returned. If false, all priced tokens are included. Default is true."}}},"responseSchema":{"type":"object","required":["ownerAddresses","data"],"properties":{"data":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","required":["snapshotBlockTime","amount","decimals","amountScaled","ownerAddress","mintAddress","priceUsd","valueUsd"],"properties":{"amount":{"type":"integer","format":"int64","minimum":0},"decimals":{"type":"integer","format":"int32","minimum":0},"priceUsd":{"type":"string"},"valueUsd":{"type":"number","format":"double"},"mintAddress":{"type":"string"},"amountScaled":{"type":"number","format":"double"},"ownerAddress":{"type":"string"},"snapshotBlockTime":{"type":"integer","format":"int64","minimum":0}}}}},"ownerAddresses":{"type":"array","items":{"type":"string","format":"pubkey"}}}},"example":null,"exampleRequest":null,"tags":["x402","finance"],"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_cadliGZH_-AI-jDJabvKy","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 historical token account balance time series for a Solana wallet address over a configurable number of past days, with per-day entry limits and sorting options.","exampleAgentPrompt":"Pull the last 30 days of token account balance history for Solana wallet 7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs — show up to 500 entries per day, sorted descending by USD value, and include all priced tokens not just Vybe-filtered ones.","exampleUseCases":null,"resultDescription":"A time-series dataset (WalletTimeSeriesRawReturn) with per-day snapshots of token account balances for the given Solana wallet, including token mint address, raw and scaled amounts, USD price per token, and total USD value. Results are paginated and sortable.","failureModes":["Missing required ownerAddress field returns 400 validation error","Invalid Solana public key format returns 400 or 422","days value exceeding 30 may be capped or rejected","Insufficient USDC payment via x402 returns 402 Payment Required","Wallet with no token accounts returns empty result set","Requesting a page beyond available data returns empty page","Conflicting sortByAsc and sortByDesc fields returns error"],"whenToPreferThis":"Use this endpoint when you need historical daily snapshots of token balances for a specific Solana wallet over days or weeks, especially for portfolio trend analysis or charting. Prefer it over single-day balance endpoints when time series data is needed. Best when you need paginated, sortable per-day balance records with USD valuations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:36:53.353Z","isFirstParty":false,"canonicalSlug":"vybe-solana-wallet-batch-token-accounts-balance-time-series-6dbde1f0"}