# Crypto Wallet Holdings Lookup

> Crypto Wallet Holdings Lookup is a paid API for AI agents from store.agentexchange.work, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns token holdings, USD values, and portfolio breakdown for a given on-chain wallet address across multiple EVM chains

## Facts

- Endpoint: GET https://store.agentexchange.work/crypto/wallet
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-wallet-holdings-lookup-875c7e54
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f2MDA-kkEClyU8OH17A9O

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 crypto-wallet-holdings-lookup-875c7e54
```

Example prompt: What tokens does wallet 0x1234...abcd hold on Base, and what's the total USD value of the portfolio?

## When to prefer this

Use this endpoint when you need fast, pay-per-call on-chain wallet portfolio data across EVM chains (Base, Ethereum, Optimism, Arbitrum, Polygon) without requiring API key signup. Ideal for AI agents that need to read live wallet balances and token allocations in a single call.

## Known failure modes

- Invalid wallet address format returns an error
- Unsupported chain identifier causes a bad request
- Wallet with no holdings returns empty array
- Payment failure (402) if USDC balance is insufficient
- Rate limiting or upstream RPC errors returning 5xx

## How this service works

Look up any wallet's token holdings with live USD values: every ERC-20 position with amount, price, USD value and portfolio %, total portfolio value, top-position concentration, and spam/unpriced filtering. The 'bagcheck' call for copy-trading, risk, research and portfolio agents. Across Base, Ethereum, Optimism, Arbitrum, Polygon. Free upstream (Blockscout).

## Output

Returns a JSON object containing an array of token holdings (each with symbol and USD value), total portfolio USD value, number of tokens held, and the top position by percentage allocation.

## 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": [
      "wallet"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "base|ethereum|optimism|arbitrum|polygon (default base)"
      },
      "wallet": {
       "type": "string",
       "description": "Wallet address (0x...)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "holdings": {
       "type": "array"
      },
      "total_usd_value": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-wallet-holdings-lookup-875c7e54/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from store.agentexchange.work](https://www.zero.xyz/host/store.agentexchange.work/llms.txt)