Stats
Actions
Tags
From zerion-agent
Crypto wallet API + CLI for AI agents: wallet analysis (portfolio, positions, history, PnL), on-chain trading (swap, bridge, send), off-chain signing (EIP-191, EIP-712), wallet management, and agent tokens with policies for autonomous trading.
How this skill is triggered — by the user, by Claude, or both
Slash command
/zerion-agent:zerionThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Unified API + CLI for crypto wallets across 14 EVM chains and Solana. The `zerion` binary ships from npm; this skill is the entry point for **all** Zerion capabilities. Capability and partner docs live in nested files and are **loaded on demand**.
capabilities/agent-management.mdcapabilities/analyze.mdcapabilities/sign.mdcapabilities/swap-0x.mdcapabilities/trading.mdcapabilities/wallet.mdpartner-skill-creator.mdpartners/bankr.mdpartners/consolidate.mdpartners/lifi-earn.mdpartners/monad-addresses.mdpartners/moonpay-iron.mdpartners/moonpay-onramp.mdpartners/moonpay-predict.mdpartners/sendai-ideas.LICENSEpartners/sendai-ideas.mdpartners/somnia-blockchain.mdpartners/somnia-reactivity.mdpartners/trails-crosschainswap.mdpartners/trails-deposit.mdUnified API + CLI for crypto wallets across 14 EVM chains and Solana. The zerion binary ships from npm; this skill is the entry point for all Zerion capabilities. Capability and partner docs live in nested files and are loaded on demand.
Skills shell out to the zerion binary. Don't pre-install — try the command first. If a zerion invocation fails with command not found, install once:
npm install -g zerion-cli
Requires Node.js ≥ 20. The npm package is zerion-cli; the installed binary is zerion.
Three modes. Pick one for analytics; trading always uses an API key.
export ZERION_API_KEY="zk_dev_..."
Get yours at dashboard.zerion.io. Dev keys begin with zk_dev_. Limits: 120 req/min, 5K req/day.
Pays $0.01 USDC per request via the x402 protocol. EVM (Base) or Solana.
export WALLET_PRIVATE_KEY="0x..." # EVM (Base) — 0x-prefixed hex
export WALLET_PRIVATE_KEY="5C1y..." # Solana — base58 keypair
zerion portfolio <address> --x402
# Or enable globally
export ZERION_X402=true
Both chains at once:
export EVM_PRIVATE_KEY="0x..."
export SOLANA_PRIVATE_KEY="5C1y..."
export ZERION_X402_PREFER_SOLANA=true # optional
Pays $0.01 USDC per request via MPP on Tempo.
export TEMPO_PRIVATE_KEY="0x..." # or reuse WALLET_PRIVATE_KEY
zerion portfolio <address> --mpp
# Or enable globally
export ZERION_MPP=true
Trading commands (
swap,bridge,send) always use the API key + an agent token, regardless ofZERION_X402/ZERION_MPP.
Before executing any capability below, Read the matching file for the full command surface, flags, edge cases, and examples.
| Task | Read |
|---|---|
| Wallet analysis: portfolio, positions, history, PnL, watchlist | capabilities/analyze.md |
| On-chain trading: swap, bridge, send | capabilities/trading.md |
| Off-chain signing: EIP-191 messages, EIP-712 typed data | capabilities/sign.md |
| Wallet management: create, import, list, fund, backup, export-key, delete | capabilities/wallet.md |
| Agent tokens + security policies for autonomous trading | capabilities/agent-management.md |
| 0x Swap API v2 (direct integration, Permit2/AllowanceHolder, gasless) | capabilities/swap-0x.md |
Pairing rules:
capabilities/agent-management.md first if user has none.These cover specialized flows on top of the core CLI. User must name the partner (or describe a flow that maps to one). Then Read partners/<name>.md.
| Partner | What it does | Read |
|---|---|---|
| Bankr | Twitter/X-native trading bot patterns | partners/bankr.md |
| Li.Fi Earn | Cross-chain yield routing | partners/lifi-earn.md |
| Monad addresses | Monad chain address tooling | partners/monad-addresses.md |
| Moonpay (onramp) | Fiat → crypto onramp | partners/moonpay-onramp.md |
| Moonpay (Iron) | Iron stablecoin flows | partners/moonpay-iron.md |
| Moonpay (Predict) | Prediction market integration | partners/moonpay-predict.md |
| Sendai ideas | Crypto idea discovery + validation, competitor mapping, DeFi TVL research | partners/sendai-ideas.md |
| Somnia (blockchain) | Somnia L1 ops | partners/somnia-blockchain.md |
| Somnia (reactivity) | Somnia reactive smart contracts | partners/somnia-reactivity.md |
| Trails (cross-chain swap) | Cross-chain swap routing | partners/trails-crosschainswap.md |
| Trails (deposit) | Cross-chain deposit flows | partners/trails-deposit.md |
| Umbra | Private (stealth-address) transfers | partners/umbra-privatetxn.md |
| Uniswap LP | Liquidity position management | partners/uniswap-lp.md |
| Uniswap x402 | Swap with x402 pay-per-call | partners/uniswap-x402.md |
| Vaults.fyi (deposit) | Vault deposits | partners/vaultsfyi-deposit.md |
| Vaults.fyi (market intel) | Yield market intelligence | partners/vaultsfyi-market-intel.md |
| Vaults.fyi (rebalance) | Auto-rebalance positions | partners/vaultsfyi-rebalance.md |
| Vaults.fyi (risk monitor) | Risk dashboards | partners/vaultsfyi-risk-monitor.md |
| Vaults.fyi (strategist) | Multi-strategy yield agent | partners/vaultsfyi-strategist.md |
| Vaults.fyi (watchlist) | Vault watchlists | partners/vaultsfyi-watchlist.md |
| Vaults.fyi (yield optimizer) | Yield optimization | partners/vaultsfyi-yield-optimizer.md |
| Consolidate | Sweep all tokens on a chain into one target | partners/consolidate.md |
Rule: never preload partner docs. Only Read when the user explicitly invokes the partner or asks for a flow that uniquely maps to it.
For authoring new partner integrations, Read partner-skill-creator.md.
All commands emit JSON to stdout (default — agent-friendly). Errors emit structured JSON to stderr:
{ "error": { "code": "missing_api_key", "message": "..." } }
Flags: --json (default), --pretty (auto-enabled for TTY), --quiet.
ethereum, base, arbitrum, optimism, polygon, binance-smart-chain, avalanche, gnosis, scroll, linea, zksync-era, zora, blast, solana.
Solana supports same-chain swaps and bidirectional bridging to/from EVM chains. Cross-format bridges (Solana ↔ EVM) require an explicit destination via --to-wallet <name> or --to-address <addr> matching the target chain's format.
Command shapes:
zerion swap <chain> <amount> <from-token> <to-token>zerion bridge <from-chain> <from-token> <amount> <to-chain> <to-token>See capabilities/trading.md for the full flag reference.
Use zerion chains for the live catalog with metadata.
| Code | Cause | Fix |
|---|---|---|
missing_api_key | No ZERION_API_KEY set | Set env var or use --x402 for analytics |
no_agent_token | No agent token for trading/signing | See capabilities/agent-management.md |
no_wallet | No wallet specified, no default | --wallet <name> or set defaultWallet config |
wallet_not_found | Wallet not in local vault | zerion wallet list to check |
unsupported_chain | Invalid --chain value | zerion chains for valid IDs |
api_error 401 | Invalid API key | Check key at dashboard.zerion.io |
api_error 429 | Rate limited | Wait, lower frequency, or switch to x402 |
Wallets are encrypted with AES-256-GCM via the Open Wallet Standard (OWS) vault at ~/.ows/. Private keys never leave the device; signing happens locally. The Zerion API never sees keys.
~/.zerion/config.json (mode 0o600) stores agent tokens, default wallet, default chain, and slippage.
npx claudepluginhub zeriontech/zerion-ai --plugin zerion-agentQueries interpreted on-chain wallet data across 40+ EVM chains and Solana — portfolio, token balances, DeFi positions, PnL, transactions, and NFTs. Each request costs $0.01 USDC on Base via x402.
Manages crypto wallets across 7 blockchains via EmblemAI Agent Hustle API. Supports balance checks, token swaps, portfolio analysis, and transaction execution for Solana, Ethereum, Base, BSC, Polygon, Hedera, and Bitcoin.
Analyzes crypto wallet holdings, P&L, win rate, and developer tokens on Solana/BSC/Base/Ethereum via GMGN API. Useful for wallet evaluation and copy-trade decisions.