Imported from zerosky1221/zerion-ai (
skills/wallet-trading/SKILL.md). Install upstream withnpx skills add zerosky1221/zerion-ai --skill wallet-trading. Copyright stays with the author (MIT).
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
- Create an agent token — required for all trading;
zerion agent create-tokensaves it to config - Apply security policies — chain locks + allowlists prevent accidental trades
- Set defaults —
config set defaultWalletandconfig set defaultChainreduce flag typing - Use
--timeoutfor bridges — cross-chain operations can be slow; default is 120s
