Wallet Trading

Trade crypto tokens, manage wallets, and configure agent security policies using zerion.

Setup check

which zerion || npm install -g zerion

Authentication

export ZERION_API_KEY="zk_dev_..."

Get yours at dashboard.zerion.io.

When to use

Use this skill when the user asks about:

• Swapping or trading tokens
• Bridging tokens across chains
• Checking wallet balances before trading
• Searching for tokens or listing available swap pairs

For wallet creation, agent token setup, and policy configuration, tell the user to run those commands manually — they require interactive passphrase input.

Agent operations — use these freely

All commands below are fully automated. No passphrase or interactive input needed.

Check wallets & policies before trading

zerion wallet list                       # Shows wallets, active policies, and addresses
zerion agent list-tokens                 # Shows tokens with attached policies
zerion agent list-policies               # List all policies with rules summary

Swap tokens

zerion swap ETH USDC 0.1
zerion swap ETH USDC 0.1 --chain base                    # Specify chain
zerion swap ETH USDC 0.1 --to-chain arbitrum              # Cross-chain swap
zerion swap ETH USDC 0.1 --to-chain arbitrum --timeout 300  # Slow bridge timeout
zerion swap ETH USDC 0.1 --slippage 1                     # Custom slippage
zerion swap ETH USDC 0.1 --wallet <name>                  # Use specific wallet

Bridge tokens

zerion bridge ETH arbitrum 0.1 --from-chain base
zerion bridge ETH arbitrum 0.1 --from-chain base --to-token USDC  # Bridge + swap

Send / transfer tokens

zerion send ETH 0.01 --to 0x... --chain base
zerion send USDC 10 --to 0x... --chain ethereum

Search & discover

zerion search PEPE
zerion search "uniswap" --chain ethereum
zerion swap tokens ethereum               # List swap-available tokens
zerion chains                             # List supported chains

Watchlist & analysis

zerion watch list                         # List watched wallets
zerion analyze <name|address>             # Analyze wallet trading activity
zerion analyze <name|address> --period 7d

Manual operations — human must run these

These commands require passphrase, confirmation, or interactive input. Agents should tell the user to run them directly.

Wallet setup

zerion wallet create --name <name>                        # Requires passphrase
zerion wallet import --name <name> --evm-key              # Interactive key input
zerion wallet import --name <name> --sol-key              # Interactive key input
zerion wallet import --name <name> --mnemonic             # Interactive mnemonic prompt
zerion wallet backup --wallet <name>                      # Requires passphrase
zerion wallet delete <name>                               # Requires passphrase + confirmation
zerion wallet sync --wallet <name>                        # Interactive QR code flow

Agent token & policy creation

zerion agent create-token --name <bot> --wallet <wallet>  # Requires passphrase + policy picker
zerion agent create-policy --name <policy> --chains base,arbitrum --deny-transfers --expires 7d
zerion agent revoke-token --name <bot>
zerion agent delete-policy <id>

Config changes

zerion config set defaultWallet <name>
zerion config set defaultChain <chain>
zerion config set slippage <percent>

Output modes

• --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.

Best practices

1. Create an agent token — required for all trading; zerion agent create-token saves it to config
2. Apply security policies — chain locks + allowlists prevent accidental trades
3. Set defaults — config set defaultWallet and config set defaultChain reduce flag typing
4. Use --timeout for bridges — cross-chain operations can be slow; default is 120s