# Base Wallet Token Holdings Scanner

> Base Wallet Token Holdings Scanner is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Lists all ERC20 tokens held by a wallet address on Base, including symbol, decimals, and formatted balance for each non-zero position.

## Facts

- Endpoint: GET https://api.x402node.dev/chain/wallet-tokens
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-wallet-token-holdings-scanner-118c3e55
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZGG-HxZ-yapukdTW1jr60

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 base-wallet-token-holdings-scanner-118c3e55
```

Example prompt: Can you scan the wallet 0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97 on Base and show me all the ERC20 tokens it holds with their balances?

## When to prefer this

Use this endpoint when you need a complete ERC20 token inventory for a specific wallet on the Base network. Prefer this over multi-chain portfolio endpoints when you only care about Base, or when you need per-token detail (symbol, decimals, formatted balance) rather than just USD net worth.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Address with no ERC20 holdings returns an empty list
- Network or RPC issues may cause timeout or partial data
- Non-Base chain addresses may return no results or incorrect data
- Rate limiting or payment failure returns 402 Payment Required

## How this service works

List the ERC20 tokens an address holds on Base with symbol, decimals and formatted balance for each nonzero position. wallet tokens, token holdings, wallet portfolio, what tokens does this address hold, base wallet scan Accepts payment on Base or Solana — either network works.

## Output

Returns a list of ERC20 token positions for the given wallet on Base, each entry containing the token symbol, decimal precision, and human-readable formatted balance — only non-zero positions are included.

## 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": [
      "address"
     ],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Max tokens returned, default 8, max 12"
      },
      "address": {
       "type": "string",
       "description": "Wallet address (required)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-wallet-token-holdings-scanner-118c3e55/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)