# Vybe Solana Wallet Batch Token Accounts Balance Time Series

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

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.

## Facts

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

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-wallet-batch-token-accounts-balance-time-series-6dbde1f0 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Solana API endpoint for fetching multi-wallet token account history with raw balance snapshots for custom analytics and unaggregated time-series data.

## Output

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.

## 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), 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."
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vybe-solana-wallet-batch-token-accounts-balance-time-series-6dbde1f0/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)