# Vybe Solana Batch Wallet Token Balance Time Series

> Vybe Solana Batch Wallet Token Balance Time Series is a paid API for AI agents from x402-api.vybenetwork.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-20).

Fetches historical token balance time series for multiple Solana wallets in a single batch POST request, paid per-call with USDC via x402.

## Facts

- Endpoint: POST https://x402-api.vybenetwork.xyz/v4/wallets/batch/token-balances-ts?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402, finance
- Canonical page: https://www.zero.xyz/c/vybe-solana-batch-wallet-token-balance-time-series-a516b668
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VzeFG7TZAi4ti3TI6A9E-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vybe-solana-batch-wallet-token-balance-time-series-a516b668 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Solana API endpoint for fetching historical token balance history with daily, weekly, or monthly portfolio snapshots and aggregated USD values.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vybe-solana-batch-wallet-token-balance-time-series-a516b668/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-api.vybenetwork.xyz](https://www.zero.xyz/host/x402-api.vybenetwork.xyz/llms.txt)