Skip to content

SKILL.md

Latest commit

 

History

History
149 lines (111 loc) · 4.68 KB

SKILL.md

File metadata and controls

149 lines (111 loc) · 4.68 KB
Raw
name wallet-trading
description Trade crypto tokens: swap, bridge across 14 chains. Manage wallets, agent tokens, and security policies.
compatibility Requires zerion (`npx zerion` or `npm install -g zerion`). Set ZERION_API_KEY. Trading requires OWS wallet setup.
license MIT
allowed-tools Bash
metadata
openclaw
requires install homepage
bins
zerion
kind package bins
node
zerion
zerion

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