Zerion Wallet Data

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/" \
  --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 
zerion-cli wallet positions  --positions all
zerion-cli wallet transactions 
zerion-cli wallet pnl 
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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: moonpay
• Source: moonpay/skills
• License: MIT
• Homepage: https://www.moonpay.com/agents

Install and usage instructions live in the source repository linked above.