# Tanod chainpeek Portfolio Read

> Tanod chainpeek Portfolio Read is a paid API for AI agents from tanod.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-11).

Retrieves the native balance and up to 20 ERC-20 token balances for an Ethereum or Base address in a single call

## Facts

- Endpoint: POST https://tanod.dev/v1/chain/portfolio?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-chainpeek-portfolio-read-e4d64f9a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m9iGVzfSGGguaSKI6DreO

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 tanod-chainpeek-portfolio-read-e4d64f9a -d '<json body>'
```

Example prompt: What's the ETH balance and how much USDC, WETH, and DAI does the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 hold on Ethereum?

## When to prefer this

Use this endpoint when you need a combined native + multi-token balance snapshot for a single wallet address on Ethereum or Base in one round-trip. It is ideal for portfolio dashboards, eligibility checks, and wallet audits where you need up to 20 ERC-20 balances alongside the native balance without making multiple separate RPC calls. Prefer alternatives if you need transaction history, NFT holdings, cross-chain aggregation beyond Ethereum/Base, or real-time streaming data.

## Known failure modes

- Invalid wallet address format (not 0x + 40 hex) returns a validation error
- Invalid or non-ERC-20 contract address in tokens array may return zero balance or an error
- More than 20 token addresses provided exceeds the maxItems limit and will be rejected
- Unsupported chain value (not 'ethereum' or 'base') returns an enum validation error
- Network congestion or RPC unavailability may cause timeouts or partial results
- On-chain token metadata (names, symbols) may be attacker-controlled and should not be trusted blindly

## How this service works

One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.

## Output

Returns the native coin balance (ETH on Ethereum/Base) and balances for each requested ERC-20 token contract address for the specified wallet, all consolidated in a single response. Token balances are fetched on-chain so values reflect the actual state at query time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "robinhood"
   ],
   "type": "string",
   "description": "Chain to read."
  },
  "tokens": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^0x[0-9a-fA-F]{40}$",
    "maxLength": 42
   },
   "maxItems": 20,
   "description": "Up to 20 ERC-20 contract addresses (0x + 40 hex); empty for the native balance only."
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "maxLength": 42,
   "description": "Account address (0x + 40 hex)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "block": 52290472,
  "chain": "base",
  "native": {
   "wei": "3128821803472537280",
   "symbol": "ETH",
   "formatted": "3.12882180347253728"
  },
  "tokens": [
   {
    "ok": true,
    "raw": "44633666",
    "error": null,
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "symbol": "USDC",
    "decimals": 6,
    "formatted": "44.633666"
   }
  ],
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "symbols_note": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-chainpeek-portfolio-read-e4d64f9a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)