# Wallet Portfolio USD Value (Ethereum & Base)

> Wallet Portfolio USD Value (Ethereum & Base) is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Returns the total USD value, native and major-token balances, and per-chain totals for a 0x wallet address on Ethereum and Base, priced via Uniswap v3 pools.

## Facts

- Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-value?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wallet-portfolio-usd-value-ethereum-base-d86c61e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hQd2uRLlOvFXPAQ_wMftN

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 wallet-portfolio-usd-value-ethereum-base-d86c61e0 -d '<json body>'
```

Example prompt: What's the total USD value of the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on both Ethereum and Base — I want to know the net worth broken down by chain and which tokens are held.

## When to prefer this

Use this endpoint when you need a quick, single-call USD net worth or token balance snapshot for a 0x wallet address on Ethereum and/or Base. It is ideal for major EVM tokens priced on-chain via Uniswap v3. Prefer alternatives for Solana wallets, NFT valuations, DeFi position breakdowns, transaction history, or long-tail token pricing.

## Known failure modes

- Invalid 0x address format returns validation error
- Solana or non-EVM addresses are not supported
- Long-tail or obscure tokens are returned in the unpriced list rather than valued
- RPC or on-chain data unavailability may cause per-chain errors
- High latency (~5 s p95) may cause timeouts in low-timeout agent pipelines
- NFTs, DeFi positions, and staked assets are not included in the valuation

## How this service works

Use when you need a wallet portfolio value in USD, a wallet net worth or token balances with USD value for a 0x address. Do not use for solana wallets, transaction history, NFTs, DeFi positions or long-tail tokens. Returns JSON with a wallet's USD value on Ethereum and Base in one call: native and major-token balances priced on-chain from Uniswap v3 pools on Base, per-chain totals and the tokens left unpriced for 0.005 USDC per call. Typical response time 5000 ms (p95). Category: Trading.

## Output

Returns a JSON object with the wallet's total USD value, per-chain USD totals (Ethereum and Base), native and major ERC-20 token balances with individual USD prices sourced from Uniswap v3 on-chain pools, a list of tokens that could not be priced, any per-chain errors, a timestamp, and an optional suggested next call.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chains": {
       "type": "array",
       "items": {
        "enum": [
         "ethereum",
         "base"
        ],
        "type": "string"
       },
       "maxItems": 2,
       "minItems": 1,
       "description": "Chains to value (ethereum and base when omitted), e.g. [\"base\"]"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Wallet address (0x...) on Ethereum and Base, e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "address",
      "totalUsd",
      "chains",
      "holdings",
      "unpriced",
      "errors",
      "updatedAt",
      "note"
     ],
     "properties": {
      "next": {
       "type": "object",
       "required": [
        "service",
        "tool",
        "method",
        "url",
        "useWhen",
        "sample"
       ],
       "properties": {
        "url": {
         "type": "string",
         "description": "Paid route of the next call"
        },
        "tool": {
         "type": "string",
         "description": "MCP tool name of the same call"
        },
        "method": {
         "enum": [
          "GET",
          "POST"
         ],
         "type": "string"
        },
        "sample": {
         "type": "string",
         "description": "Free fixed sample of the whole family"
        },
        "service": {
         "type": "string",
         "description": "Service id of the suggested next paid call"
        },
        "useWhen": {
         "type": "string",
         "description": "When the next call is the right one"
        }
       },
       "description": "Suggested 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "USD values use the on-chain price of the same asset on Base: its deepest Uniswap v3 pool against USDC or WETH (USDC counts as 1 USD). Ethereum tokens are priced through their Base counterpart (same issuer or canonical bridge); tokens without one, or without a liquid pool, are listed in unpriced and left out of the totals. Balances cover the native coin and a fixed list of major tokens; values are rounded to cents.",
  "chains": {
   "base": 8.47,
   "ethereum": null
  },
  "errors": {},
  "address": "0x87DB3C25d1E8E40f8EF240D48a711B0C355CF8Cf",
  "holdings": [
   {
    "chain": "base",
    "symbol": "ETH",
    "balance": "0.002360178464231316",
    "contract": null,
    "priceUsd": 2420.0937,
    "valueUsd": 5.71
   },
   {
    "chain": "base",
    "symbol": "USDC",
    "balance": "2.756539",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "priceUsd": 1,
    "valueUsd": 2.76
   }
  ],
  "totalUsd": 8.47,
  "unpriced": [],
  "updatedAt": "2026-10-18T04:14:44.193Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wallet-portfolio-usd-value-ethereum-base-d86c61e0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway.blackwoodstate8.workers.dev](https://www.zero.xyz/host/x402-gateway.blackwoodstate8.workers.dev/llms.txt)