/zerion-wallet-data

name: zerion-wallet-data
description: Use when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs. Provides interpreted on-chain data across 40+ EVM chains and Solana via x402 pay-per-request or API key — no raw RPC decoding needed.
tags: [zerion, x402, wallet, portfolio, defi, pnl, transactions, nfts, positions]

Zerion Wallet Data

Goal

Query interpreted wallet data — portfolios, token positions, DeFi positions, PnL, transactions, NFTs, and chain/token metadata — via x402 pay-per-request on Base or API key auth. All data is pre-enriched with protocol labels, token names, and USD values.

Prerequisites

1. Wallet with USDC on Base: `mp token balance list --wallet main --chain base` 2. Small ETH on Base for gas 3. If no USDC: bridge from Ethereum or swap via `mp token swap --chain base`

Core command

mp x402 request \
  --method GET \
  --url "https://api.zerion.io/v1/<endpoint>" \
  --wallet main \
  --chain base

All endpoints are GET requests. Cost is $0.01 USDC per request on Base.

---

Endpoint Reference

Wallet Endpoints

| Endpoint | Cost | Description | |----------|------|-------------| | `/v1/wallets/{address}/portfolio` | $0.01 | Aggregated portfolio value with total USD balance | | `/v1/wallets/{address}/positions/` | $0.01 | Token balances and DeFi positions (staked, deposited, etc.) | | `/v1/wallets/{address}/transactions/` | $0.01 | Interpreted transaction history with labels and types | | `/v1/wallets/{address}/pnl` | $0.01 | Profit and Loss — unrealized PnL, realized PnL, net invested | | `/v1/wallets/{address}/charts/{period}` | $0.01 | Portfolio balance chart over time (1d, 1w, 1m, 3m, 1y, max) | | `/v1/wallets/{address}/nft-positions/` | $0.01 | NFTs held by the wallet | | `/v1/wallets/{address}/nft-collections/` | $0.01 | NFT collections with floor prices | | `/v1/wallets/{address}/nft-portfolio` | $0.01 | Aggregated NFT portfolio value |

Token (Fungible) Endpoints

| Endpoint | Cost | Description | |----------|------|-------------| | `/v1/fungibles/` | $0.01 | Search and list tokens | | `/v1/fungibles/{id}` | $0.01 | Token details — price, market cap, volume, implementations | | `/v1/fungibles/{id}/charts/{period}` | $0.01 | Token price chart | | `/v1/fungibles/by-implementation` | $0.01 | Look up token by chain:address pair | | `/v1/fungibles/by-implementation/charts/{period}` | $0.01 | Price chart by implementation |

Chain Endpoints

| Endpoint | Cost | Description | |----------|------|-------------| | `/v1/chains/` | $0.01 | List all supported chains (40+ EVM + Solana) | | `/v1/chains/{id}` | $0.01 | Chain details — RPC, explorer, native token |

Swap Endpoints

| Endpoint | Cost | Description | |----------|------|-------------| | `/v1/swap/fungibles/` | $0.01 | List swappable tokens | | `/v1/swap/offers/` | $0.01 | Get swap/bridge quotes |

Gas Endpoints

| Endpoint | Cost | Description | |----------|------|-------------| | `/v1/gas-prices/` | $0.01 | Current gas prices by chain |

NFT Endpoints

| Endpoint | Cost | Description | |----------|------|-------------| | `/v1/nfts/` | $0.01 | Search NFTs | | `/v1/nfts/{id}` | $0.01 | NFT details with metadata and traits |

DApp Endpoints

| Endpoint | Cost | Description | |----------|------|-------------| | `/v1/dapps` | $0.01 | List DeFi protocols | | `/v1/dapps/{id}` | $0.01 | Protocol details — TVL, chains, categories |

---

Common query parameters

| Parameter | Values | Purpose | |-----------|--------|---------| | `currency` | `usd`, `eur`, `eth`, `btc` | Fiat/crypto currency for values | | `filter[chain_ids]` | `ethereum`, `base`, `solana` | Filter by chain (comma-separated) | | `filter[positions]` | `only_simple`, `only_complex`, `no_filter` | `only_simple` = wallet tokens, `only_complex` = DeFi, `no_filter` = both | | `filter[trash]` | `only_non_trash`, `only_trash`, `no_filter` | Filter spam tokens | | `sort` | `value`, `-value` | Sort by USD value | | `page[size]` | integer | Results per page (max 100) | | `page[after]` | string | Cursor for next page |

---

Example: Full wallet analysis

mp x402 request \
  --method GET \
  --url "https://api.zerion.io/v1/wallets/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/portfolio?currency=usd" \
  --wallet main \
  --chain base

Example: DeFi positions

mp x402 request \
  --method GET \
  --url "https://api.zerion.io/v1/wallets/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/positions/?filter[positions]=only_complex&currency=usd" \
  --wallet main \
  --chain base

Example: Profit and loss

mp x402 request \
  --method GET \
  --url "https://api.zerion.io/v1/wallets/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/pnl?currency=usd" \
  --wallet main \
  --chain base

Example: Token lookup by contract address

mp x402 request \
  --method GET \
  --url "https://api.zerion.io/v1/fungibles/by-implementation?filter[implementation_address]=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&filter[implementation_chain_id]=ethereum" \
  --wallet main \
  --chain base

Example: Recent transactions

mp x402 request \
  --method GET \
  --url "https://api.zerion.io/v1/wallets/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions/?currency=usd&page[size]=10" \
  --wallet main \
  --chain base

Discover all endpoints

mp x402 request \
  --method GET \
  --url "https://api.zerion.io/.well-known/x402" \
  --wallet main \
  --chain base

---

Alternative: Zerion CLI

You can also query Zerion data directly via the Zerion CLI:

npm install -g zerion-cli

zerion-cli wallet portfolio <address>
zerion-cli wallet positions <address> --positions all
zerion-cli wallet transactions <address>
zerion-cli wallet pnl <address>
zerion-cli chains list

Auth via API key (`ZERION_API_KEY` env var) or x402 pay-per-call (`ZERION_X402=true` env var, or `--x402` flag). Get an A