# EVM Address Token Portfolio Lookup

> EVM Address Token Portfolio Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-20).

Returns every ERC-20 token held by an EVM address with balances, USD prices, total portfolio value, native balance, holder counts, and reputation filtering (scam tokens hidden by default).

## Facts

- Endpoint: POST https://api.vextorium.com/evm-tokens-cartera-pago?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/evm-address-token-portfolio-lookup-1d6bc6d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3R8_AHCBb3XuZnGGa5VUZ

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 evm-address-token-portfolio-lookup-1d6bc6d2 -d '<json body>'
```

Example prompt: Can you pull up every ERC-20 token held by the Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet and show me the USD value of each one, hiding any scam tokens?

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-token portfolio snapshot for any EVM address across major chains, including USD valuations and scam filtering. It covers all ERC-20s (not just majors), includes native balance, holder counts, and reputation — making it ideal for full wallet audits, portfolio tracking, and on-chain due diligence. Prefer this over chain-specific block explorers when you want a single normalized response across Ethereum, Base, Arbitrum, Optimism, Polygon, or zkSync.

## Known failure modes

- Invalid or malformed EVM address returns an error
- Unsupported network string outside the allowed enum returns a validation error
- Address with no token holdings returns an empty token list
- Price data unavailable for obscure tokens may result in null USD values
- Rate limiting or payment failure returns a 402 or 429 error
- Newly deployed tokens may not yet have holder count or reputation data

## How this service works

Every ERC-20 token held by an EVM address (not just the majors) with amount, price and USD value when quoted, token holder count and reputation (scam-flagged tokens hidden by default), plus native balance and total USD.

## Output

Returns a structured object containing the queried address, optional ENS name, network, the data source, a list of ERC-20 tokens (each with contract address, name, symbol, quantity, USD price, USD value, holder count, and reputation label), native token balance and its USD value, total portfolio USD value, total token count, whether more tokens exist beyond the returned set, and a count of tokens hidden due to bad reputation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "red": {
   "enum": [
    "ethereum",
    "base",
    "arbitrum",
    "optimism",
    "polygon",
    "zksync"
   ],
   "type": "string"
  },
  "direccion": {
   "type": "string"
  },
  "incluir_estafas": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/evm-address-token-portfolio-lookup-1d6bc6d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)