# xx402 Base Wallet Portfolio Exposure API

> xx402 Base Wallet Portfolio Exposure API is a paid API for AI agents from x402.xx402.icu, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

Returns a ranked portfolio exposure snapshot, risk breakdown, and wallet safety analysis for a given Base/EVM wallet address across core Base ERC20 tokens.

## Facts

- Endpoint: GET https://x402.xx402.icu/api/base-wallet-portfolio-exposure?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xx402-base-wallet-portfolio-exposure-api-50721d5a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fERMXxbGzr56iTwWb_q2s

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 xx402-base-wallet-portfolio-exposure-api-50721d5a
```

Example prompt: Check the portfolio exposure and risk breakdown for Base wallet 0xba76c7ECa175f67cFcE475c09498f840176bf497, looking at up to 6 token positions including USDC, WETH, and USDbC, with USD price hints included.

## When to prefer this

Choose this endpoint when you need a fast, ranked portfolio exposure and risk assessment for a specific Base/EVM wallet, especially when you want pre-scored risk buckets, wallet safety context, and token-level exposure ranking in a single call. Prefer it over generic on-chain data tools when you need DeFi risk framing (review/avoid queues, priority queue) rather than raw balances, and when you are operating on the Base chain specifically.

## Known failure modes

- Invalid wallet address format (not a valid 0x EVM address) returns validation error
- Token address list exceeds allowed maximum or contains invalid addresses
- Block window out of allowed range (100–5000) causes parameter rejection
- Rate limiting or payment failure via x402 protocol results in 402 Payment Required
- Upstream Base chain data source unavailable causes partial or failed response
- No token balances found for the wallet on the specified tokens returns empty positions array

## How this service works

Paid Base token, wallet, DeFi, chain-read, x402 buyer/seller discovery, and specialized Bitcoin 15-minute Up/Down prediction-market data packets for autonomous agents and risk tools.

## Output

Returns a JSON object with keys including summary, portfolio_exposure_decision, portfolio_snapshot, positions (ranked token balances with optional USD price hints), priority_queue, best_next_products, risk_breakdown, wallet_safety score, review_queue (tokens to watch), avoid_queue (tokens to avoid), bucket_counts, source_status, and sources used.

## Response schema (JSON Schema)

```json
{
 "keys": [
  "summary",
  "portfolio_exposure_decision",
  "portfolio_snapshot",
  "positions",
  "priority_queue",
  "best_next_products",
  "risk_breakdown",
  "wallet_safety",
  "review_queue",
  "avoid_queue",
  "bucket_counts",
  "source_status",
  "sources"
 ],
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xx402-base-wallet-portfolio-exposure-api-50721d5a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.xx402.icu](https://www.zero.xyz/host/x402.xx402.icu/llms.txt)