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
- Wallet with USDC on Base:
mp token balance list --wallet main --chain base
- Small ETH on Base for gas
- 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¤cy=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 API key at dashboard.zerion.io.
Notes
- Payments are in USDC on Base Mainnet (
--chain base)
- If the request fails (status >= 400), payment is not settled — you don't pay for errors
- ETH on Base is needed for gas (~$0.001 per tx)
- All responses follow JSON:API format with
data, links, and relationships
- Data is pre-interpreted: protocol names, token symbols, USD values included — no ABI decoding needed
- Supports 40+ EVM chains and Solana in a single query
Related skills
- moonpay-auth — Create or import a local wallet
- moonpay-check-wallet — Check USDC balance on Base before spending
- moonpay-x402 — Learn how x402 pay-per-request works
