SkillHub

dex-agent

v1.1.0

在 Base 链通过 Uniswap V3 执行零手续费直接代币兑换，管理止损止盈与投资组合追踪，实现自托管安全。

Sourced from ClawHub, Authored by Elway Botty

Installation

Please help me install the skill `dex-agent` from SkillHub official store. npx skills add avmw2025/dex-agent

DEX Agent — Direct DeFi Trading Skill

Zero-fee DeFi trading for OpenClaw agents. Bankr alternative.

Description

Direct DEX swap execution on Base chain via Uniswap V3. Self-custodial, open-source, zero middleman fees. Includes real-time price feeds, swap quotes, stop-loss, take-profit, portfolio tracking, and configurable risk management.

When to Use

  • User asks to trade crypto, swap tokens, or execute DeFi trades
  • User wants to check token prices on Base chain
  • User needs stop-loss or take-profit orders
  • User wants to manage a trading wallet
  • User is looking for a Bankr alternative with lower fees
  • User needs configurable risk limits (daily trades, position caps, drawdown protection)

Setup

  1. Install dependencies: pip3 install web3 eth-abi
  2. Generate a wallet: python3 agent.py wallet generate
  3. Fund the wallet with ETH (gas) and USDC (trading) on Base chain
  4. (Optional) Create trading-config.json to override risk defaults
  5. Start trading!

Commands

Price Check

cd <skill_dir>/scripts && python3 agent.py price WETH
cd <skill_dir>/scripts && python3 agent.py price BRETT

Get Quote

cd <skill_dir>/scripts && python3 agent.py quote USDC WETH 10.0

Execute Swap

cd <skill_dir>/scripts && python3 agent.py swap USDC WETH 5.0
cd <skill_dir>/scripts && python3 agent.py swap ETH USDC 0.01

Stop-Loss & Take-Profit

cd <skill_dir>/scripts && python3 agent.py stop WETH 2000 8.0 0.005
cd <skill_dir>/scripts && python3 agent.py tp WETH 2000 5.0 0.005
cd <skill_dir>/scripts && python3 agent.py monitor

Portfolio

cd <skill_dir>/scripts && python3 agent.py balances
cd <skill_dir>/scripts && python3 agent.py wallet

Risk Management

Configurable risk parameters in config.py (override via trading-config.json):

Parameter Default Description
max_daily_trades 8 Max new trades per 24h window
max_active_positions 8 Max concurrent open positions
trade_size_usd 20 Trade size in USD
take_profit_pct 5.0 Auto take-profit trigger
stop_loss_pct 8.0 Auto stop-loss trigger
max_drawdown_pct 20.0 Portfolio-wide drawdown halt
cooldown_minutes 60 Cooldown between same-token trades
min_liquidity 50000 Minimum pool liquidity (USD)
min_volume_24h 100000 Minimum 24h volume filter

Key design decision: max_daily_trades should match max_active_positions. A mismatch (e.g., 4 daily trades but 8 position slots) means the bot hits its daily cap before filling available positions — leaving capital idle while signals pass. Align both limits for maximum capital efficiency.

Supported Chains

  • Base (Chain ID 8453)

Supported DEXes

  • Uniswap V3

Key Advantages Over Bankr

  • Zero swap fees (just gas costs)
  • Free stop-loss and take-profit (no subscription needed)
  • Self-custodial (you hold your private keys)
  • Faster execution (~3s vs ~20s)
  • Configurable risk management (daily limits, position caps, drawdown protection)
  • Open source and customizable

Safety Notes

  • Private keys are stored locally and never transmitted
  • Always use slippage protection (default: 1%)
  • Start with small amounts to test
  • Risk parameters prevent overexposure — don't disable them
  • This is NOT financial advice