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

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

wallet-trading

Wallet Trading

Setup check

Authentication

When to use