# WickedAPI Wallet Portfolio

> WickedAPI Wallet Portfolio is a paid API for AI agents from api.wickedapi.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Returns native token balance plus major ERC-20 holdings with live USD prices and total portfolio value for an Ethereum-compatible wallet address or ENS name across Ethereum, Base, Arbitrum, Optimism, and Polygon.

## Facts

- Endpoint: GET https://api.wickedapi.com/v1/wallet-portfolio?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wickedapi-wallet-portfolio-825b2850
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IHOsjvzxcq7ry7kbMs69G

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 wickedapi-wallet-portfolio-825b2850
```

Example prompt: What tokens does the wallet vitalik.eth hold right now, and what's the total USD value across Ethereum, Base, and Arbitrum?

## When to prefer this

Use this endpoint when you need a quick, aggregated multi-chain portfolio snapshot for a specific Ethereum-compatible wallet address or ENS name, covering the most common and liquid assets (stablecoins, wrapped assets, major caps). It reads directly from the chain so data is live. Prefer this over block explorers when you want a single structured response with USD values and cross-chain totals. Not suitable if you need obscure long-tail tokens, NFTs, or full transaction history.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- ENS name that cannot be resolved returns a resolution failure
- Tokens held by the wallet that are outside the curated list are silently omitted and the response notes this limitation
- Chain RPC downtime may result in missing or stale data for specific networks
- Empty wallet returns zero balances with no token entries

## How this service works

What a wallet holds: native balance plus major ERC-20 tokens (stablecoins, wrapped assets, large caps) across Ethereum, Base, Arbitrum, Optimism and Polygon, with live USD prices, per-chain and total value. Address or ENS name. Reads the chain directly; tokens outside the curated list are not shown (the response states this).

## Output

A structured response listing all curated token balances (native coin plus major ERC-20s such as USDC, USDT, WETH, WBTC, and large-cap tokens) for the given address on each supported chain (Ethereum, Base, Arbitrum, Optimism, Polygon), with live USD prices per token, per-chain subtotals, and a grand total USD portfolio value. Tokens outside the curated list are explicitly noted as not shown.

## 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",
     "properties": {}
    }
   },
   "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/wickedapi-wallet-portfolio-825b2850/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.wickedapi.com](https://www.zero.xyz/host/api.wickedapi.com/llms.txt)