zerion

Zerion

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 install, authentication, and routing to specific capability skills.

Setup

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.

Authentication

Three modes. Pick one for analytics; trading always uses an API key.

A) API key (recommended)

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.

B) x402 pay-per-call (no signup, analytics only)

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

C) MPP pay-per-call (analytics only, EVM Tempo)

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 of ZERION_X402 / ZERION_MPP.

Which skill for which task

Intent	Skill
What's in this wallet? portfolio, positions, history, PnL, watchlist	zerion-analyze
Swap / bridge / send tokens	zerion-trading
Sign a message or EIP-712 typed data (no broadcast)	zerion-sign
Create / import / list / backup / delete wallets	zerion-wallet
Set up agent tokens + policies for autonomous trading	zerion-agent-management
Discover / validate a crypto idea, map competitors, DeFi TVL research	zerion-sendai-ideas (partner skill, adapted from sendaifun/solana-new)

Output contract

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.

Supported chains

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:

• Same-chain swap: zerion swap <chain> <amount> <from-token> <to-token>
• Cross-chain bridge: zerion bridge <from-chain> <from-token> <amount> <to-chain> <to-token>

See zerion-trading for the full flag reference.

Use zerion chains for the live catalog with metadata.

Common error codes

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 zerion-agent-management skill
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

Key management

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.

Resources

• API docs: developers.zerion.io
• Dashboard: dashboard.zerion.io
• x402 protocol: x402.org
• CLI source: github.com/zeriontech/zerion-cli