# DopamineDesk Wallet Portfolio Lookup

> DopamineDesk Wallet Portfolio Lookup is a paid API for AI agents from ai-data-marketplace-1042299154756.us-central1.run.app, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns token balances, prices, and net worth in USD for a given on-chain wallet address across supported EVM networks.

## Facts

- Endpoint: GET https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/wallet_portfolio
- 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/dopaminedesk-wallet-portfolio-lookup-6e1cb12e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v7ha5-kp8W6nXg-v9-a7Q

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 dopaminedesk-wallet-portfolio-lookup-6e1cb12e
```

Example prompt: Can you pull up the full token portfolio and total USD net worth for the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 across all supported chains?

## When to prefer this

Choose this endpoint when you need a quick, pay-per-use on-chain wallet portfolio snapshot with USD valuations across multiple EVM chains, especially within an agent workflow that already uses x402 USDC micropayment settlement. Prefer it over free block explorers when you need structured, machine-readable JSON output with pre-computed USD values rather than raw block data.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- ENS resolution fails if the name is unregistered or DNS lookup is unavailable
- Unsupported chain parameter returns empty or error
- Wallet with zero on-chain activity may return empty assets array
- Rate limiting or x402 payment failure results in a 402 response requiring USDC settlement

## How this service works

Run a low-cost wallet balance lookup for native ETH and official USDC on Base, Ethereum, or Arbitrum, with an estimated ETH USD value. This is not a complete token or NFT portfolio.

## Output

Returns a JSON object with the queried wallet address, an array of held assets each with symbol, balance, current price in USD, and value in USD, plus a total net_worth_usd field summing all asset values.

## 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": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Network to scan (default: all supported)."
      },
      "address": {
       "type": "string",
       "description": "Wallet address (0x format or ENS)."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "source",
      "fetched_at",
      "note",
      "wallet",
      "network",
      "assets",
      "estimated_total_usd",
      "marketplace_metadata"
     ],
     "properties": {
      "note": {
       "type": "string"
      },
      "assets": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "source": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "wallet": {
       "type": "string"
      },
      "network": {
       "type": "string"
      },
      "success": {
       "type": "boolean"
      },
      "fetched_at": {
       "type": "string"
      },
      "estimated_total_usd": {
       "type": "number"
      },
      "marketplace_metadata": {
       "type": "object",
       "required": [
        "data_mode",
        "billable",
        "availability",
        "source"
       ],
       "properties": {
        "source": {
         "type": "string"
        },
        "billable": {
         "type": "boolean"
        },
        "data_mode": {
         "type": "string"
        },
        "availability": {
         "type": "string"
        }
       },
       "additionalProperties": true
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Limited portfolio covers native ETH and official USDC only; it does not enumerat...",
  "assets": [
   "[nested detail omitted from the challenge header; see the full example in /openapi.json]"
  ],
  "source": [
   "ethereum public JSON-RPC"
  ],
  "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "network": "ethereum",
  "success": true,
  "fetched_at": "2026-08-07T07:32:32.441Z",
  "estimated_total_usd": 12666.92562175213,
  "marketplace_metadata": {
   "source": "public EVM JSON-RPC and CoinGecko",
   "billable": true,
   "data_mode": "live_source",
   "availability": "operational"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dopaminedesk-wallet-portfolio-lookup-6e1cb12e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai-data-marketplace-1042299154756.us-central1.run.app](https://www.zero.xyz/host/ai-data-marketplace-1042299154756.us-central1.run.app/llms.txt)