# Beggar Bot Wallet Portfolio Enrichment

> Beggar Bot Wallet Portfolio Enrichment is a paid API for AI agents from beggar-bot-demand.beggarbot.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Returns native ETH balance plus USD-priced holdings across 24 curated Base tokens (stables, LSTs, cbBTC, AERO, VIRTUAL, memes) and optional custom tokens for any wallet address, with account type classification.

## Facts

- Endpoint: GET https://beggar-bot-demand.beggarbot.workers.dev/v1/portfolio?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beggar-bot-wallet-portfolio-enrichment-b4ac43be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hFZjeVjTIeqsiC2-ZvN_k

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 beggar-bot-wallet-portfolio-enrichment-b4ac43be
```

Example prompt: What's the full portfolio breakdown for wallet 0xAbc1234567890abcdef1234567890abcdef123456 on Base — show me all token balances and their USD values, plus the total?

## When to prefer this

Use this endpoint when you need a fast, on-chain priced snapshot of a wallet's portfolio on Base (or Ethereum) without needing to manage your own RPC keys. It is ideal for agents that need to assess DeFi wallet value, check exposure to specific Base ecosystem tokens (stables, LSTs, cbBTC, AERO, VIRTUAL, memes), or enrich wallet data with USD valuations. Prefer this over generic block explorer APIs when you need live USD pricing sourced directly from Uniswap v3/Aerodrome rather than off-chain price feeds.

## Known failure modes

- Invalid wallet address format (must be 0x + 40 hex chars) returns an error
- Token address not found or illiquid on Uniswap v3/Aerodrome results in that token being silently skipped (soft fail)
- More than 20 custom tokens passed via tokens= parameter may be rejected or truncated
- Unsupported chain value returns an error
- Temporary RPC unavailability may result in partial or empty results

## How this service works

Paid: /v1/verify, /v1/risk, /v1/receipt cost $0.01 USDC per call on Base mainnet via x402 (payTo 0x719227f384b66BFEF00093D6d8d32fA9dC2B40e7); utilities analyze Base mainnet (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) by default, network=base-sepolia optional; /v1/receipt/verify and discovery files are free. Operator: Beggar Bot.

## Output

A JSON object containing: native ETH balance, a list of token holdings (each with token name/address, raw balance, and USD value), a total portfolio USD value, and an account type classification (EOA, contract, smart-EOA, etc.). Pricing is sourced on-chain via Uniswap v3 or Aerodrome. The endpoint fails soft — tokens that can't be priced are omitted rather than causing an error.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "base (default) or ethereum (needs tokens)"
      },
      "tokens": {
       "type": "string",
       "description": "optional extra token addresses (≤20)"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "wallet address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beggar-bot-wallet-portfolio-enrichment-b4ac43be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from beggar-bot-demand.beggarbot.workers.dev](https://www.zero.xyz/host/beggar-bot-demand.beggarbot.workers.dev/llms.txt)