# Agent Data Bench – Wallet Token Holdings

> Agent Data Bench – Wallet Token Holdings is a paid API for AI agents from x402.deepsense.stream, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-28).

Returns all tokens held in a wallet on Solana, Base, or Ethereum with balance, symbol, decimals, and traded volume — without USD price estimates.

## Facts

- Endpoint: GET https://x402.deepsense.stream/api/v1/wallet/holdings?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-bench-wallet-token-holdings-378eadf0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__zCJuCK5t9ynXOfqj-hB_

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 agent-data-bench-wallet-token-holdings-378eadf0
```

Example prompt: Can you pull up all the token holdings for Solana wallet 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU and show me the top 50 by balance?

## When to prefer this

Use this endpoint when you need a raw, comprehensive token inventory for a wallet across Solana, Ethereum, or Base — especially when you want volume and balance data without relying on potentially fabricated price feeds from spam tokens. Prefer it over wallet-overview endpoints when you need per-token detail (decimals, trade volumes) rather than just a summary. Pair it with a DEX pricing route if USD valuations are needed.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- Unsupported chain value (not sol/eth/base) returns a validation error
- Wallet with no on-chain history returns an empty holdings list
- Limit outside 1–100 range is rejected
- Payment failure or expired x402 token results in a 402 or 401 error
- Upstream indexer lag may cause stale or incomplete holdings for recently active wallets

## How this service works

Every token a wallet holds on Solana, Base or Ethereum, with balance, symbol, decimals, bought/sold volume and last update. No USD valuation is claimed: spam tokens carry fabricated prices upstream, so price a holding with the market routes. Sorted by balance and capped by limit.

## Output

A list of token records for the wallet, sorted by balance descending and capped at the requested limit (default 50, max 100). Each record includes the token symbol, raw balance, decimal precision, total bought volume, total sold volume, and last update timestamp. No USD prices are included — use a market/DEX route for valuation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain",
      "wallet"
     ],
     "properties": {
      "chain": {
       "enum": [
        "sol",
        "eth",
        "base"
       ],
       "type": "string",
       "description": "Chain id: sol (Solana), eth (Ethereum), base (Base)"
      },
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 100,
       "minimum": 1
      },
      "wallet": {
       "type": "string",
       "description": "Wallet address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-bench-wallet-token-holdings-378eadf0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.deepsense.stream](https://www.zero.xyz/host/x402.deepsense.stream/llms.txt)