{"uid":"cap_VzeFG7TZAi4ti3TI6A9E-","slug":"vybe-solana-batch-wallet-token-balance-time-series-a516b668","name":"Vybe Solana Batch Wallet Token Balance Time Series","description":"Solana API endpoint for fetching historical token balance history with daily, weekly, or monthly portfolio snapshots and aggregated USD values.","url":"https://x402-api.vybenetwork.xyz/v4/wallets/batch/token-balances-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).\nIf time provided does not include the start of the resolution time block (e.g: the 1st of the month for \"1mo\"), the time block is not included in the results.\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":{"allOf":[{"enum":["1d","1w","1mo"],"type":"string"}],"nullable":true},"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":["ownerAddress","data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["blockTime","tokenValue","stakeValue","systemValue","stakeValueSol"],"properties":{"blockTime":{"type":"integer","format":"int32","minimum":0,"description":"The timestamp, rounded to the day, of which this account snapshot was taken"},"stakeValue":{"type":"string","description":"The value of staked SOL in USD"},"tokenValue":{"type":"string","description":"Combined value of valid SPL tokens in USD."},"systemValue":{"type":"string","description":"The value of held System SOL in USD"},"stakeValueSol":{"type":"string","description":"The value of staked SOL in SOL"}}}},"ownerAddress":{"type":"string","format":"pubkey"}}},"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":"unknown","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_hqs9SoQHBVdj3ncUNP3Yj","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 historical token balance time series for multiple Solana wallets in a single batch POST request, paid per-call with USDC via x402.","exampleAgentPrompt":"Pull the token balance history over the last 30 days for these three Solana wallets — 7xKX...abc1, 9mPQ...def2, and 3nRT...ghi3 — and show me how their USDC and SOL holdings changed over time.","exampleUseCases":[{"title":"DeFi dashboard portfolio trend tracking","prompt":"I'm building a DeFi dashboard for our users — can you pull weekly token balance snapshots over the past 6 months for these five wallets and show me how their SOL, USDC, and BONK holdings have trended over time?"},{"title":"Multi-wallet audit for compliance review","prompt":"We need to audit token holdings for these eight Solana addresses going back 90 days — grab the daily balance history for USDC and USDT across all of them so we can verify there weren't any suspicious spikes or drops."},{"title":"Compare investor wallet balance changes","prompt":"I want to compare how these three early investor wallets have changed their SOL and JTO positions over the last quarter — fetch the monthly balance time series for all of them so I can see who's been accumulating versus selling."}],"resultDescription":"A batch response containing time-series arrays of token balances for each requested wallet address, showing balance values at successive timestamps for each token mint queried, enabling portfolio trend analysis across multiple wallets.","failureModes":["Payment not included or insufficient USDC — returns HTTP 402 with x-payment-info header describing required payment","Invalid or malformed wallet addresses — returns 400 with validation error","Wallet address not found on Solana — returns empty time series or 404","Too many wallets in batch exceeding limit — returns 400 or 413","Time range out of bounds or unsupported — returns 400","Network or RPC latency causes timeout — returns 504","x402 facilitator unavailable — payment cannot be processed, returns 402 or 503"],"whenToPreferThis":"Use this endpoint when you need historical token balance data for multiple Solana wallets simultaneously and want to avoid making individual per-wallet calls. Ideal for portfolio analytics, multi-address auditing, or DeFi dashboards tracking balance changes over time. Prefer this over single-wallet endpoints when processing 2+ addresses to minimize cost and round-trips.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T18:36:15.047Z","isFirstParty":false,"canonicalSlug":"vybe-solana-batch-wallet-token-balance-time-series-a516b668"}