Agent skill

Zerion Wallet Data

by moonpay in moonpay/skills

A skill your agent uses when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs.

MITAuto-check passedBusiness, Finance & HR

Install Zerion Wallet Data

skills CLI
$ npx skills add moonpay/skills --skill zerion-wallet-data -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install moonpay/skills zerion-wallet-data --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/moonpay/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/zerion-wallet-data .claude/skills/zerion-wallet-data && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
zerion-wallet-data
GitHub stars
113
Token cost
~1.7k tokens
SKILL.md length
506 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs.

  • Works in 3 steps: Wallet with USDC on Base: mp token… → Small ETH on Base for gas → If no USDC: bridge from Ethereum or swap…
  • The user asks to check a wallets portfolio
  • SKILL.md covers Goal, Prerequisites, Core command and Endpoint Reference, plus 10 more sections
  • Calls npm; reaches api.zerion.io; needs ZERION_API_KEY

What it does

Zerion Wallet Data is an agent skill from moonpay/skills. 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.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Crypto and DeFi analysis and Smart contracts. It works with Solana, x402 and Circle USDC. The repository describes itself as: Skills for AI agents to move money — on-ramps, swaps, wallets, deposits, and more via the MoonPay CLI. The licence is MIT.

When your agent uses it

  • The user asks to check a wallets portfolio
  • Transaction history

Example prompts

  • “/zerion-wallet-data”

Requirements

  • Node.js
  • A credential in ZERION_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  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

What it can do on your machine

Read from SKILL.md and the folder at commit aa672ab. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.zerion.io

    Also links to:

    • dashboard.zerion.io
    • jsonapi.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ZERION_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Zerion Wallet Data loads about 1.7k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 506 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from moonpay/skills at commit aa672ab, republished under its MIT licence (© moonpay). 506 words, ~1,686 tokens.

Download SKILL.mdSave it as .claude/skills/zerion-wallet-data/SKILL.md (or your agent's skills folder).
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

bash
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
EndpointCostDescription
/v1/wallets/{address}/portfolio$0.01Aggregated portfolio value with total USD balance
/v1/wallets/{address}/positions/$0.01Token balances and DeFi positions (staked, deposited, etc.)
/v1/wallets/{address}/transactions/$0.01Interpreted transaction history with labels and types
/v1/wallets/{address}/pnl$0.01Profit and Loss — unrealized PnL, realized PnL, net invested
/v1/wallets/{address}/charts/{period}$0.01Portfolio balance chart over time (1d, 1w, 1m, 3m, 1y, max)
/v1/wallets/{address}/nft-positions/$0.01NFTs held by the wallet
/v1/wallets/{address}/nft-collections/$0.01NFT collections with floor prices
/v1/wallets/{address}/nft-portfolio$0.01Aggregated NFT portfolio value
Token (Fungible) Endpoints
EndpointCostDescription
/v1/fungibles/$0.01Search and list tokens
/v1/fungibles/{id}$0.01Token details — price, market cap, volume, implementations
/v1/fungibles/{id}/charts/{period}$0.01Token price chart
/v1/fungibles/by-implementation$0.01Look up token by chain:address pair
/v1/fungibles/by-implementation/charts/{period}$0.01Price chart by implementation
Chain Endpoints
EndpointCostDescription
/v1/chains/$0.01List all supported chains (40+ EVM + Solana)
/v1/chains/{id}$0.01Chain details — RPC, explorer, native token
Swap Endpoints
EndpointCostDescription
/v1/swap/fungibles/$0.01List swappable tokens
/v1/swap/offers/$0.01Get swap/bridge quotes
Gas Endpoints
EndpointCostDescription
/v1/gas-prices/$0.01Current gas prices by chain
NFT Endpoints
EndpointCostDescription
/v1/nfts/$0.01Search NFTs
/v1/nfts/{id}$0.01NFT details with metadata and traits
DApp Endpoints
EndpointCostDescription
/v1/dapps$0.01List DeFi protocols
/v1/dapps/{id}$0.01Protocol details — TVL, chains, categories

Show full SKILL.md (212 more words)Show less

Common query parameters

ParameterValuesPurpose
currencyusd, eur, eth, btcFiat/crypto currency for values
filter[chain_ids]ethereum, base, solanaFilter by chain (comma-separated)
filter[positions]only_simple, only_complex, no_filteronly_simple = wallet tokens, only_complex = DeFi, no_filter = both
filter[trash]only_non_trash, only_trash, no_filterFilter spam tokens
sortvalue, -valueSort by USD value
page[size]integerResults per page (max 100)
page[after]stringCursor for next page

Example: Full wallet analysis

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

Example: DeFi positions

bash
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

bash
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

bash
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

bash
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

bash
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:

bash
npm install -g zerion-cli
bash
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
  • 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

© moonpay, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/zerion-wallet-data of moonpay/skills.

Open the folder on GitHubat commit aa672ab

Compare with similar skills

Zerion Wallet Data next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Zerion Wallet Data compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Zerion Wallet Data this skillmoonpay/skills113—~1.7kAutomated safety check: PassMIT
SurfBlockRunAI/ClawRouter6.6k—~4kAutomated safety check: PassMIT
BlockrunBlockRunAI/blockrun-mcp392—~2.7kAutomated safety check: PassMIT
Bridge Stablecoincirclefin/skills155—~3.4kAutomated safety check: NotesApache-2.0
Crypto DataBlockRunAI/blockrun-mcp392—~2.8kAutomated safety check: PassMIT
ZerionBankrBot/skills1.2k—~3.6kAutomated safety check: PassNone

Similar skills

  • Surf

    BlockRunAI/ClawRouter

    Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls.

    6.6k GitHub stars~4k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed
  • Blockrun

    BlockRunAI/blockrun-mcp

    Pay-per-call access to AI models, real-time data, media generation and multi-chain RPC over x402 micropayments (USDC on Base or Solana), or a BlockRun account API key.

    392 GitHub stars~2.7k tokensUpdated today
    Media & CreativeAuto-check passed
  • Bridge Stablecoin

    circlefin/skills

    Build browser or server USDC bridging with Circle App Kit or standalone Bridge Kit and CCTP.

    155 GitHub stars~3.4k tokensUpdated 22 days ago
    Business, Finance & HRAuto-check: notes
  • Crypto Data

    BlockRunAI/blockrun-mcp

    A skill your agent uses for any crypto data question — token/coin prices, FX, commodities, stocks, OHLC history, DEX pairs and liquidity, DeFi TVL, yield/APY pools, or raw JSON-RPC against a chain…

    392 GitHub stars~2.8k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Zerion

    BankrBot/skills

    Interpreted crypto wallet data for AI agents. An agent skill from BankrBot/skills.

    1.2k GitHub stars~3.6k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed
  • Agent Soul

    LeoYeAI/openclaw-master-skills

    Create AI art, mint NFTs, and trade on the Agent Soul marketplace.

    2.2k GitHub stars~5.2k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed

More from moonpay/skills

All 39 skills in this repo
  • A skill your agent uses when accessing Alchemy APIs for RPC calls, token balances, NFT metadata, asset transfers, transaction simulation, or Alchemy-specific features.

    113 GitHub stars~2.1k tokensUpdated 28 days ago
    Auto-check: notes
  • Alchemy API

    moonpay/skills

    Integrates Alchemy blockchain APIs using an API key. An agent skill from moonpay/skills.

    113 GitHub stars~2.1k tokensUpdated 28 days ago
    Auto-check passed
  • Allium Onchain Data

    moonpay/skills

    Query blockchain data via Allium APIs. An agent skill from moonpay/skills.

    113 GitHub stars~1.9k tokensUpdated 28 days ago
    Auto-check passed
  • Corbits Marketplace

    moonpay/skills

    Paid API marketplace for AI agents via Corbits. An agent skill from moonpay/skills.

    113 GitHub stars~1.5k tokensUpdated 28 days ago
    Auto-check passed
  • Dune Analytics

    moonpay/skills

    Blockchain analytics via Dune REST API — execute DuneSQL queries against live on-chain data, discover decoded contract tables, and monitor credit usage.

    113 GitHub stars~1.3k tokensUpdated 28 days ago
    Auto-check passed
  • Moonpay Auth

    moonpay/skills

    Set up the MoonPay CLI, authenticate, and manage local wallets.

    113 GitHub stars~1.2k tokensUpdated 28 days ago
    Auto-check passed

Questions about Zerion Wallet Data

What does Zerion Wallet Data do?

A skill your agent uses when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs. Zerion Wallet Data is an agent skill from moonpay/skills. Use when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs.

When should I use Zerion Wallet Data?

Zerion Wallet Data fits situations like: the user asks to check a wallets portfolio; transaction history.

How do I install Zerion Wallet Data in Claude Code?

Run `npx skills add moonpay/skills --skill zerion-wallet-data -a claude-code`. Or copy the skill folder (skills/zerion-wallet-data in moonpay/skills) into .claude/skills/zerion-wallet-data in your project. Claude Code loads it when a task matches its description.

How do I install Zerion Wallet Data in Codex?

Run `npx skills add moonpay/skills --skill zerion-wallet-data -a codex`. Or copy the skill folder (skills/zerion-wallet-data in moonpay/skills) into .agents/skills/zerion-wallet-data in your project. Codex loads it when a task matches its description.

Can I use Zerion Wallet Data in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add moonpay/skills --skill zerion-wallet-data -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/zerion-wallet-data, .gemini/skills/zerion-wallet-data, .github/skills/zerion-wallet-data and .opencode/skills/zerion-wallet-data in your project.

What does Zerion Wallet Data need to run?

Going by SKILL.md and its folder, Zerion Wallet Data needs the command-line tools its instructions call (npm) and credentials named ZERION_API_KEY. Our summary lists: Node.js; A credential in ZERION_API_KEY.

Does Zerion Wallet Data access the network?

SKILL.md names 3 domains. In commands or code: api.zerion.io; the agent is likely to contact it when it follows the instructions. As links in the text: dashboard.zerion.io and jsonapi.org. This is read from the text; nothing was executed.

Is Zerion Wallet Data safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Zerion Wallet Data use?

Zerion Wallet Data is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Zerion Wallet Data use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Zerion Wallet Data?

Skills that share tags, products or a category with Zerion Wallet Data: Surf (BlockRunAI/ClawRouter, 6.6k stars), Blockrun (BlockRunAI/blockrun-mcp, 392 stars), Bridge Stablecoin (circlefin/skills, 155 stars) and Crypto Data (BlockRunAI/blockrun-mcp, 392 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Zerion Wallet Data?

moonpay (a GitHub organization) maintains it in moonpay/skills, which has 113 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on September 10, 2026.

Source: moonpay/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.