# Heurist Mesh: Zerion Wallet Token Holdings Fetcher

> Heurist Mesh: Zerion Wallet Token Holdings Fetcher is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Fetches the full token portfolio of an EVM wallet address, including token amounts, USD values, 1-day price changes, contract addresses, and chain information.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/ZerionWalletAnalysisAgent/fetch_wallet_tokens
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-mesh-zerion-wallet-token-holdings-fetcher-c721601f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zS1nifrpisZq_-SyB95PJ

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 heurist-mesh-zerion-wallet-token-holdings-fetcher-c721601f -d '<json body>'
```

Example prompt: What tokens does the wallet 0x742d35Cc6634C0532925a3b8D4C9E5E3F1e2b7A4 hold right now, including their USD values and how each has changed in the last day?

## When to prefer this

Use this endpoint when you need a comprehensive, multi-chain EVM token portfolio snapshot for a specific wallet address, including USD valuations and recent price movement. Prefer this over transaction-history endpoints when the goal is current holdings rather than activity. Best suited for portfolio analysis, DeFi user profiling, and counterparty research on EVM-compatible chains.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Wallet address with no token holdings returns an empty list
- Unsupported EVM chain may result in incomplete data
- Rate limiting or upstream Zerion API unavailability causes request failure
- Non-EVM addresses (e.g. Solana, Bitcoin) are not supported and will error

## How this service works

Fetch token holdings of an EVM wallet. The result includes the amount, USD value, 1-day price change, token contract address and the chain of all tokens held by the wallet. Use this tool if you want to know the token portfolio of the wallet or understand a user's onchain behavior.

## Output

Returns a list of token holdings for the specified EVM wallet, each entry containing: token name/symbol, amount held, current USD value, 1-day price change percentage, token contract address, and the blockchain network (chain) on which the token is held.

## 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": [
      "wallet_address"
     ],
     "properties": {
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "wallet_address": {
       "type": "string",
       "description": "The EVM wallet address (starting with 0x and 42-character long) to analyze. You can also use 'SELF' for wallet_address to use the user's own wallet address."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "object",
       "additionalProperties": true
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-zerion-wallet-token-holdings-fetcher-c721601f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)