# AgenticFi EVM Wallet Token Balances

> AgenticFi EVM Wallet Token Balances is a paid API for AI agents from defi-api.agenticfi.wtf, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns native and ERC-20 token balances for an EVM wallet address across multiple chains, with USD pricing, asset warnings, and pagination support

## Facts

- Endpoint: GET https://defi-api.agenticfi.wtf/api/wallet/balances/:address
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenticfi-evm-wallet-token-balances-4b7672cb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VP0xt_v_FKEg5Q14Gavei

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 agenticfi-evm-wallet-token-balances-4b7672cb
```

Example prompt: What tokens does wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e hold on Base and Ethereum? Show me both native and ERC-20 balances with current USD prices, up to 100 results.

## When to prefer this

Use this endpoint when you need a comprehensive snapshot of all token holdings (native + ERC-20) for any EVM wallet across multiple chains, especially when you need USD pricing via Sim, asset risk warnings, or historical price data alongside balances. Prefer this over generic blockchain explorers when you need structured, agent-ready output with pagination and metadata in a single pay-per-call request.

## Known failure modes

- Invalid or malformed wallet address returns 400 error
- Unsupported chain_id or chain name returns 400 or empty result
- Wallet with no balances returns empty list
- Pagination cursor mismatch or expired offset returns error
- Missing required address parameter returns 422 validation error
- Payment not included or insufficient returns 402 Payment Required

## How this service works

EVM token balances for a wallet - native + ERC-20 with Sim pricing, warnings, pagination, and optional historical prices

## Output

A paginated list of token balances (native + ERC-20) held by the wallet, each with token symbol, amount, USD value via Sim pricing, asset class, optional logo/metadata, and any risk warnings. Also includes a next_offset cursor for pagination and optional historical price data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "pathParams",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "title": "address (required)",
       "description": "Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "title": "chain (optional)",
       "description": "Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum"
      },
      "limit": {
       "type": "string",
       "title": "limit (optional)",
       "description": "Optional. Maximum number of balances to return, 1-1000 Examples: 100, 500"
      },
      "offset": {
       "type": "string",
       "title": "offset (optional)",
       "description": "Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)"
      },
      "address": {
       "type": "string",
       "title": "address (required)",
       "description": "Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111"
      },
      "filters": {
       "type": "string",
       "title": "filters (optional)",
       "description": "Optional. Filter balances by asset type: 'erc20' or 'native'"
      },
      "metadata": {
       "type": "string",
       "title": "metadata (optional)",
       "description": "Optional. Comma-separated extra metadata fields: 'logo', 'url', 'pools'"
      },
      "chain_ids": {
       "type": "string",
       "title": "chain_ids (optional)",
       "description": "Optional. Sim chain IDs and/or tags, e.g. '1,8453' or 'default' Examples: 8453, 1,8453, default"
      },
      "asset_class": {
       "type": "string",
       "title": "asset_class (optional)",
       "description": "Optional. Asset class filter, e.g. 'stablecoin'"
      },
      "h
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenticfi-evm-wallet-token-balances-4b7672cb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi-api.agenticfi.wtf](https://www.zero.xyz/host/defi-api.agenticfi.wtf/llms.txt)