# Zerion Wallet Positions

> Zerion Wallet Positions is a paid API for AI agents from api.zerion.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Fetches all DeFi and token positions held by a given wallet address across 40+ chains

## Facts

- Endpoint: GET https://api.zerion.io/v1/wallets/:address/positions?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zerion-wallet-positions-9ab42245
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HK_3352AJ-G5OuaBr-6v_

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 zerion-wallet-positions-9ab42245
```

Example prompt: What are all the DeFi positions and token holdings for wallet address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e across all chains on Zerion?

## When to prefer this

Use this endpoint when you need a comprehensive, interpreted snapshot of all positions (tokens and DeFi) held by a specific wallet across 40+ EVM chains and Solana. Prefer this over raw RPC calls or single-chain explorers when you need multi-chain aggregation with DeFi protocol attribution. It is ideal for portfolio dashboards, risk analysis, and on-chain due diligence where breadth of coverage matters.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty data array
- Unsupported chain or address format may return no results
- Rate limiting or payment failure (x402) if the $0.01 USDC per call fee is not satisfied
- Wallet with no on-chain positions returns an empty data array
- Network timeout if upstream chain indexers are slow

## Output

Returns a JSON:API-formatted array of position resource objects, each containing an ID, resource type, and attributes describing the token or DeFi position (asset, protocol, balance, value, chain). Also includes pagination links for iterating over large portfolios.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Wallet address (EVM 0x or Solana base58)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string",
          "description": "Resource ID."
         },
         "type": {
          "type": "string",
          "description": "Resource type."
         },
         "attributes": {
          "type": "object",
          "description": "Resource attributes; see https://developers.zerion.io"
         }
        }
       },
       "description": "Array of JSON:API resource objects."
      },
      "links": {
       "type": "object",
       "description": "Self and pagination links."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zerion-wallet-positions-9ab42245/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zerion.io](https://www.zero.xyz/host/api.zerion.io/llms.txt)