Imported from zerosky1221/zerion-ai (skills/zerion/SKILL.md). Install upstream with npx skills add zerosky1221/zerion-ai --skill zerion. Copyright stays with the author (MIT).

Zerion CLI

Unified CLI for wallet analysis and autonomous trading across 14 chains.

Deep-dive skills:

• wallet-analysis — portfolio, positions, transactions, PnL queries
• wallet-trading — swap, bridge, buy/sell, agent tokens, security policies

Installation

# Run without installing
npx zerion --help

# Or install globally
npm install -g zerion

Requires Node.js 20 or later.

Quick start: AI agent wallet setup

End-to-end flow to get an AI agent trading autonomously:

# 1. Set API key
export ZERION_API_KEY="zk_dev_..."

# 2. Create wallet (prompts for passphrase, confirms backup, offers agent token)
zerion wallet create --name agent-bot

# 3. Fund the wallet
zerion wallet fund --wallet agent-bot
# → shows the EVM and Solana deposit addresses

# 4. Apply security policies (optional but recommended)
zerion agent create-policy --name safe-trading \
  --chains base,arbitrum --deny-transfers --expires 7d

# 5. Trade — agent token is read from config automatically
zerion swap ETH USDC 0.01 --chain base
zerion send ETH 0.01 --to 0x... --chain base

Authentication

Three modes, from simplest to most secure:

API key (recommended start)

export ZERION_API_KEY="zk_dev_..."

Get yours at dashboard.zerion.io. Dev keys start with zk_dev_. Rate limits: 120 req/min, 5K req/day.

x402 pay-per-call (no signup, read-only)

Pay $0.01 USDC per request on Base. No API key needed.

export WALLET_PRIVATE_KEY="0x..."
zerion analyze <address> --x402

# Or enable globally
export ZERION_X402=true

Agent tokens (required for trading)

Agent tokens are required for swap, bridge, and send commands. They are saved to ~/.zerion/config.json automatically on creation.

# Create and auto-save to config
zerion agent create-token --name my-bot --wallet my-wallet

# Or create wallet (offers token setup at the end)
zerion wallet create --name my-bot

Environment variables

Config (~/.zerion/config.json)

All commands

Commands are split into two categories:

• Agent operations — fully automated, no interactive input. Agents should use these freely.
• Manual operations — require passphrase, confirmation, or interactive input. Humans must run these directly.

Agent operations — trading

All trading commands require an agent token (set up once via manual commands below). No passphrase prompts.

zerion swap <from> <to> <amount>                          # Swap tokens
zerion swap <from> <to> <amount> --chain <chain>          # Specify source chain
zerion swap <from> <to> <amount> --to-chain <chain>       # Cross-chain swap
zerion swap <from> <to> <amount> --slippage <percent>     # Custom slippage tolerance
zerion swap <from> <to> <amount> --wallet <name>          # Use specific wallet
zerion swap tokens                                        # List swap-available tokens (all chains)
zerion swap tokens <chain>                                # List swap-available tokens for chain
zerion bridge <token> <chain> <amount> --from-chain <chain>  # Bridge tokens cross-chain
zerion bridge <token> <chain> <amount> --from-chain <chain> --to-token <tok>  # Bridge + swap
zerion send <token> <amount> --to <address> --chain <chain>  # Send native or ERC-20 transfer
zerion search <query>                                     # Search for tokens by name, symbol, or address
zerion search <query> --chain <chain>                     # Search within a specific chain
zerion search <query> --limit <n>                         # Limit results (default: 10)
zerion chains                                             # List all supported chains

Agent operations — analysis (read-only, supports --x402)

Accepts 0x... address, ENS name, or local wallet name. Uses --wallet or default wallet if no argument given.

zerion analyze <address|name>                             # Full analysis (portfolio, positions, txs, PnL in parallel)
zerion analyze <address|name> --chain <chain>             # Filter by chain
zerion analyze <address|name> --positions all|simple|defi # Filter position type
zerion analyze <address|name> --limit <n>                 # Limit transactions (default: 10)
zerion analyze <address|name> --x402                      # Use x402 pay-per-call
zerion portfolio <address|name>                           # Portfolio value + top positions
zerion portfolio --wallet <name>                          # Specific wallet
zerion portfolio --watch <name>                           # Watched wallet by name
zerion positions <address|name>                           # Token + DeFi positions
zerion positions <address|name> --positions all|simple|defi  # Filter: all (default), simple, defi
zerion positions <address|name> --chain <chain>           # Filter by chain
zerion history <address|name>                             # Transaction history
zerion history <address|name> --limit <n>                 # Number of txs (default: 10)
zerion history <address|name> --chain <chain>             # Filter by chain
zerion pnl <address|name>                                 # Profit & loss (realized, unrealized, fees)

Agent operations — wallet info & config (read-only)

zerion wallet list                                        # List all wallets (shows active policies)
zerion wallet list --search <query>                       # Filter by name or address
zerion wallet fund --wallet <name>                        # Show deposit addresses
zerion watch list                                         # List watched wallets
zerion agent list-tokens                                  # List agent tokens (shows policies + active status)
zerion agent list-policies                                # List all policies
zerion agent show-policy <id>                             # Show policy details
zerion agent use-token --wallet <wallet>                  # Switch active agent token by wallet
zerion config get <key>                                   # Get a single config value
zerion config list                                        # Show current configuration

Manual operations — wallet setup (requires passphrase/confirmation)

These commands require interactive input and must be run by a human directly. Agents should never call these.

zerion wallet create --name <name>                        # Create encrypted wallet (EVM + Solana)
zerion wallet import --name <name> --evm-key              # Import from EVM private key (interactive)
zerion wallet import --name <name> --sol-key              # Import from Solana private key (interactive)
zerion wallet import --name <name> --mnemonic             # Import from seed phrase (interactive prompt)
zerion wallet backup --wallet <name>                      # Export recovery phrase (mnemonic backup)
zerion wallet delete <name>                               # Permanently delete a wallet (requires passphrase)
zerion wallet sync --wallet <name>                        # Sync wallet to Zerion app via QR code
zerion wallet sync --all                                  # Sync all wallets to Zerion app

Manual operations — agent token & policy creation

zerion agent create-token --name <bot> --wallet <wallet>  # Interactive policy setup
zerion agent create-token --name <bot> --wallet <wallet> --policy <id>  # With existing policy
zerion agent create-token --name <bot> --wallet <wallet> --policy <id1>,<id2>  # Multiple policies
zerion agent revoke-token --name <bot>                    # Revoke by name
zerion agent revoke-token --id <id>                       # Revoke by ID
zerion agent create-policy --name <policy>                # Create policy (at least one rule required)
zerion agent create-policy --name <policy> --chains base,arbitrum  # Chain lock
zerion agent create-policy --name <policy> --expires 24h  # Expiry (e.g. 24h, 7d)
zerion agent create-policy --name <policy> --deny-transfers  # Block raw ETH/native transfers
zerion agent create-policy --name <policy> --deny-approvals  # Block ERC-20 approval calls
zerion agent create-policy --name <policy> --allowlist 0xAddr1,0xAddr2  # Allowlist-only
zerion agent create-policy --name strict \
  --chains base --expires 7d --deny-transfers --deny-approvals  # Combined rules
zerion agent delete-policy <id>                           # Delete a policy

Manual operations — watchlist & config changes

zerion watch <address> --name <label>                     # Add wallet to watchlist (supports ENS)
zerion watch remove <name>                                # Remove from watchlist
zerion config set apiKey <key>                            # Set API key
zerion config set defaultWallet <name>                    # Set default wallet
zerion config set defaultChain <chain>                    # Set default chain
zerion config set slippage <percent>                      # Set slippage tolerance (default: 2%)
zerion config unset <key>                                 # Remove a config value (resets to default)

Other

zerion --help                                             # Show full usage
zerion --version                                          # Show version

Global flags

Output modes

All commands print JSON to stdout; errors are JSON on stderr with non-zero exit.

• --json — JSON output (default, agent-friendly)
• --pretty — Human-readable tables (auto-enabled for TTY)
• --quiet — Minimal output

Supported chains

ethereum, base, arbitrum, optimism, polygon, binance-smart-chain, avalanche, gnosis, scroll, linea, zksync-era, zora, blast, solana.

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, and the Zerion API never sees your keys.

• Agent operations (trading + analysis): fully automated, no passphrase. Agents use these freely.
• Manual operations (wallet setup, token/policy creation): require passphrase or interactive input. Humans must run these.
• Agent tokens: Required for all trading (swap, bridge, send). Auto-saved to config on creation.
• Config security: ~/.zerion/config.json is created with mode 0o600
• Interactive key input: --key prompts securely without exposing keys in shell history

Troubleshooting

Resources

• API docs: developers.zerion.io
• Dashboard: dashboard.zerion.io
• x402 protocol: x402.org
• Source: github.com/zeriontech/zerion-ai