# Vybe Solana Wallet Token Balance Time Series

> Vybe Solana Wallet Token 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-09-28).

Returns a paginated time-series history of token account balances (with USD values) for a given Solana wallet address, covering up to 30 days of daily snapshots.

## Facts

- Endpoint: POST https://x402-api.vybenetwork.xyz/v4/wallets/%7BownerAddress%7D/token-accounts-balance-ts?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vybe-solana-wallet-token-balance-time-series-91c1bb96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GSP0PCpoEoOXrqiGAu_kY

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-token-balance-time-series-91c1bb96 -d '<json body>'
```

Example prompt: Pull the last 30 days of daily token balance history for Solana wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM, showing up to 100 entries per day sorted by USD value descending, and include all priced tokens not just Vybe-filtered ones.

## When to prefer this

Use this endpoint when you need historical, day-by-day token balance snapshots for a specific Solana wallet — especially for portfolio trend analysis, PnL computation, or charting token holding changes over time. Prefer this over spot-balance endpoints when temporal context matters. The x402 micropayment model means no API key friction, making it ideal for agent-driven, per-query workflows.

## Known failure modes

- Invalid or non-existent ownerAddress returns an error or empty dataset
- days > 30 may be rejected or clamped to maximum allowed window
- Insufficient USDC payment (x402) causes 402 Payment Required response
- Conflicting sortByAsc and sortByDesc parameters result in a validation error
- Requesting a page beyond available data returns empty results
- Rate limiting or network issues at the x402 facilitator layer cause request failure

## How this service works

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.

## Output

A paginated time-series dataset (WalletTimeSeriesRawReturn) containing daily snapshots of each token account held by the specified wallet, including raw and scaled token amounts, mint addresses, USD prices, and USD portfolio values — suitable for charting balance trends, detecting inflows/outflows, or computing historical PnL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ownerAddress"
 ],
 "properties": {
  "days": {
   "type": "integer",
   "description": "Number of previous days to include in the data (from today's date), up to 30 days (default 14)."
  },
  "page": {
   "type": "integer",
   "description": "The requested page."
  },
  "limit": {
   "type": "integer",
   "description": "Limit of entries to return (per day). If not passed, first 1000 entries are returned (the maximum)."
  },
  "sortByAsc": {
   "type": "string",
   "description": "Sort ascending based on 'amount', 'amountScaled', 'ownerAddress', 'priceUsd', 'valueUsd', or 'mintAddress'. Only one of sort_by_asc or sort_by_desc can be used"
  },
  "sortByDesc": {
   "type": "string",
   "description": "Sort descending based on 'amount', 'amountScaled', 'ownerAddress', 'priceUsd', 'valueUsd', or 'mintAddress'. Only one of sort_by_asc or sort_by_desc can be used"
  },
  "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "$ref": "#/components/schemas/WalletTimeSeriesRawReturn"
}
```

## More

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