# Vextorium Wallet Balances

> Vextorium Wallet Balances is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-28).

Returns all token balances and approximate USD values for a wallet address on Base or Ethereum networks

## Facts

- Endpoint: POST https://api.vextorium.com/v1/wallet-balances?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/vextorium-wallet-balances-1f2c215d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CjCnwJMi6BIapbagnm4ao

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 vextorium-wallet-balances-1f2c215d -d '<json body>'
```

Example prompt: What are the current token balances and total USD value for the Ethereum wallet 0x742d35Cc6634C0532925a3b8D4C9A6C8dE3F1A2 on the base network?

## When to prefer this

Use this endpoint when you need to quickly look up all token balances and their approximate USD values for a single EVM wallet address on Base or Ethereum. Prefer this over block explorer APIs when you want a structured, aggregated portfolio view with USD conversion in a single call. Best suited for DeFi agents, portfolio trackers, and any workflow that needs a fast on-chain balance snapshot.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty balances
- Network not specified defaults may vary; unsupported networks return an error
- Unrecognized or low-liquidity ERC-20 token contract may return null USD value
- Address with zero activity returns empty balances array
- Rate limiting or payment failure returns HTTP 402 or 429

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a list of token balances where each entry includes the asset symbol, the token amount held, and an approximate USD value. Also returns the total portfolio value in USD across all detected tokens.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string",
   "description": "Optional extra ERC-20 contract"
  },
  "address": {
   "type": "string",
   "description": "Wallet address"
  },
  "network": {
   "enum": [
    "base",
    "ethereum"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "balances": [
   {
    "asset": "ETH",
    "amount": 0.002,
    "value_usd_approx": 5.38
   },
   {
    "asset": "USDC",
    "amount": 0.211,
    "value_usd_approx": 0.21
   }
  ],
  "total_value_usd_approx": 5.59
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-wallet-balances-1f2c215d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)