# x402 Bazaar — ERC-20 Wallet Portfolio (Base)

> x402 Bazaar — ERC-20 Wallet Portfolio (Base) is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns a complete ERC-20 token portfolio for a Base wallet address, including balances, metadata, and live USD values for every non-zero token, plus a total USD value.

## Facts

- Endpoint: POST https://api.relai.fi/relay/1782567677091/api/x402/wallet-portfolio?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-bazaar-erc-20-wallet-portfolio-base-717b75b3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NoJ7Yj7DTQ83cN28NrUF-

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 x402-bazaar-erc-20-wallet-portfolio-base-717b75b3 -d '<json body>'
```

Example prompt: Show me the full ERC-20 portfolio for Base wallet 0x1234...abcd — every token with its current balance and USD value, and give me the total.

## When to prefer this

Choose this endpoint when you need a comprehensive, live ERC-20 token portfolio for a Base (eip155:8453) wallet address — especially when you need coverage beyond common curated token lists (powered by Alchemy). Ideal for DeFi portfolio tracking, wallet auditing, or any agent workflow that needs current USD valuations of all holdings on Base. Prefer this over manual token-by-token lookups or Ethereum mainnet portfolio APIs when the user is specifically on Base.

## Known failure modes

- 402 Payment Required — must pay $0.01 USDC on Base to 0x973a31858f4d2125f48c880542da11a2796f12d6 before retrying
- Invalid or malformed Base wallet address returns an error
- Address with no ERC-20 holdings returns an empty token list
- Alchemy upstream timeout or outage may cause delayed or failed responses
- Non-Base chain addresses (e.g. Ethereum mainnet) may return empty or incorrect results

## How this service works

Complete ERC-20 portfolio for a Base address — every non-zero token with balance, metadata and live USD value, plus a total. Powered by Alchemy (beyond the curated wallet-tokens list). Paid via x402: $0.01 in USDC on Base (eip155:8453) to 0x973a31858f4d2125f48c880542da11a2796f12d6. Returns 402 with payment requirements; pay and retry.

## Output

A list of every non-zero ERC-20 token held by the specified Base address, each with token symbol, name, balance, decimals, contract address, and live USD value, plus a summed total portfolio USD value. Powered by Alchemy for comprehensive coverage beyond curated token lists.

## 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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Wallet address"
      }
     }
    }
   },
   "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/x402-bazaar-erc-20-wallet-portfolio-base-717b75b3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relai.fi](https://www.zero.xyz/host/api.relai.fi/llms.txt)