| name | web3-trader |
| version | 1.0.5 |
| description | DEX swap trading skill. Activates on swap/exchange/sell/buy/convert/DEX/trade token keywords. Queries prices via Antalpha AI DEX aggregator, finds optimal routes, generates transaction data. Supports MetaMask/OKX/Trust/TokenPocket. Zero custody — private keys never leave the user's wallet. |
| metadata | {"openclaw":{"requires":{"bins":"[Truncated]"},"mcp":{"antalpha-swap":"[Truncated]"},"persistence":{"path":"~/.web3-trader/"},"security_notes":["Only generates transaction data, never touches private keys","Users must review and sign in their own wallet","Trading involves risk — only trade with funds you can afford to lose"]}} |
Web3 Trader
DEX aggregator trading for AI agents. Zero custody, multi-wallet, cyberpunk UI.
Modes
| Mode | Description | Use Case |
|---|
| 🌐 MCP Remote (recommended) | Antalpha MCP Server handles quotes + page hosting | Production |
| 🖥️ Local CLI | Python CLI calls 0x API locally | Dev/offline, see references/local-cli.md |
MCP Mode
Server: https://mcp-skills.ai.antalpha.com/mcp
| Tool | Description |
|---|
swap-full | One-shot: quote + page + host (recommended) |
swap-quote | DEX aggregated quote |
swap-create-page | Generate + host cyberpunk swap page |
swap-tokens | List supported tokens |
swap-gas | Current gas price |
For detailed MCP workflow and examples, see references/mcp-mode.md.
Agent Workflow
User: "Swap 0.1 ETH to USDT"
→ Agent calls swap-full(sell_token=ETH, buy_token=USDT, sell_amount=0.1, taker=0xWallet)
→ Agent sends: trade preview + QR code image (one message)
→ User clicks link / scans QR → wallet signs → on-chain
Agent Behavior Rules
- No filler text — Only show the trade preview result, no procedural narration
- Generate QR code — From
preview_url, generate QR PNG with qrcode library, send as attachment
- One message — Trade preview text + QR code image in the same message
Message Template
⚡ <FROM> -> <TO> Swap Preview
📊 <from_amount> <from_token> -> ~<to_amount> <to_token>
💰 Price: 1 <from_token> ≈ $<price>
🛡️ Min Receive: <min_buy_amount> <to_token>
⛓️ Network: Ethereum Mainnet
🛣️ Route: <route_source> (<proportion>)
👛 Wallet: <wallet_short>
🔥 Supported Wallets: MetaMask | OKX Web3 | Trust Wallet | TokenPocket
📱 Click the link or scan QR code to confirm:
🔗 <preview_url>
🤖 Powered by Antalpha AI
Required: Last line 🤖 Powered by Antalpha AI must be included.
Quick Start
cp references/config.example.yaml ~/.web3-trader/config.yaml
pip install requests web3 qrcode pillow pyyaml
python3 scripts/trader_cli.py price --from ETH --to USDT --amount 0.001
python3 scripts/trader_cli.py swap-page --from ETH --to USDT --amount 0.001 \
--wallet 0xYourWallet -o /tmp/swap.html --json
CLI Commands
| Command | Description |
|---|
price --from <t> --to <t> --amount <n> | Query price |
route --from <t> --to <t> --amount <n> | Get optimal route |
build-tx --from <t> --to <t> --amount <n> --wallet <addr> | Build transaction |
export --from <t> --to <t> --amount <n> --wallet <addr> | Export EIP-681 link |
swap-page --from <t> --to <t> --amount <n> --wallet <addr> -o <file> | Generate swap page |
gas | Gas price |
tokens | List tokens |
All commands support --json.
Supported Assets
Tokens: USDT, USDC, DAI, ETH, WETH, WBTC, LINK, UNI (Ethereum Mainnet)
Wallets: MetaMask, OKX Web3, Trust Wallet, TokenPocket
Security
| Layer | Protection |
|---|
| Private Keys | Zero contact — never held, transmitted, or stored |
| Transaction Data | 0x Protocol with MEV protection |
| Slippage | Configurable max (default 0.5%), minBuyAmount on-chain enforced |
| Review | User sees full details in wallet before signing |
| Hosted Page | Self-contained HTML, no backend, no cookies, no tracking |
