# x402-gateway Wallet Portfolio Tool

> x402-gateway Wallet Portfolio Tool is a paid API for AI agents from x402.freeq.one, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns the token holdings and balances across a wallet address on Base and other chains, paid per-call via x402 micropayment.

## Facts

- Endpoint: POST https://x402.freeq.one/tools/wallet_portfolio
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-gateway-wallet-portfolio-tool-a12457e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wf-_5Ya1paYG2B0_6U9gl

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-gateway-wallet-portfolio-tool-a12457e8 -d '<json body>'
```

Example prompt: Can you pull up the full token portfolio for wallet address 0xAbc123...def456 and show me all its holdings?

## When to prefer this

Choose this endpoint when you need a fast, pay-per-call wallet portfolio lookup without committing to a subscription. Especially useful in agentic pipelines that only occasionally need portfolio data, or when building on Base with x402 micropayment infrastructure already in place. Prefer over free alternatives when you need reliable uptime backed by Coinbase CDP infrastructure.

## Known failure modes

- Invalid wallet address format returns an error
- Wallet address with no on-chain activity returns empty portfolio
- Payment failure via x402 if insufficient USDC balance causes request rejection
- Unsupported chain or token may be omitted from results
- Network timeout if blockchain RPC is slow

## How this service works

Pay-per-call MCP gateway: 12 tools (markdown, token_price, wallet_portfolio, whale_alerts, cross_chain_balance, changelog_openapi, changelog_git, mermaid, html_to_markdown, qr_generator, og_image_generator, jobs). Per-tool prices on Base via the Coinbase CDP x402 facilitator: markdown=$0.001, token_price=$0.0005, wallet_portfolio=$0.002, whale_alerts=$0.002, cross_chain_balance=$0.002, changelog_openapi=$0.005, changelog_git=$0.005, mermaid=$0.005, html_to_markdown=$0.001, qr_generator=$0.001, og_image_generator=$0.001, jobs=$0.002. MCP flat rate $0.001.

## Output

A structured breakdown of all token holdings in the specified wallet address, including token names, symbols, quantities, and potentially USD values or chain-specific metadata for assets held on Base and other supported chains.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain key: eth, arb, base, polygon, opt"
  },
  "address": {
   "type": "string",
   "description": "Ethereum address (0x-prefixed, 42 chars)"
  },
  "include_nfts": {
   "type": "boolean",
   "description": "Include NFT holdings (default false)"
  },
  "include_tokens": {
   "type": "boolean",
   "description": "Include ERC-20 balances (default true)"
  },
  "transfer_limit": {
   "type": "integer",
   "description": "Max transfers (1-100, default 20)"
  },
  "include_transfers": {
   "type": "boolean",
   "description": "Include recent transfers (default false)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-gateway-wallet-portfolio-tool-a12457e8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.freeq.one](https://www.zero.xyz/host/x402.freeq.one/llms.txt)