---
name: yex-trader
description: Autonomous Hyperliquid trading — 14 strategies (MM, momentum, arbitrage, LLM) with APEX multi-slot orchestrator, REFLECT performance review, DSL trailing stops, and builder fee revenue collection.
user-invocable: true
argument-hint: "<strategy> [options]"
allowed-tools:
  - Bash
metadata:
  openclaw:
    requires:
      env:
        - HL_PRIVATE_KEY
      bins:
        - python3
    primaryEnv: HL_PRIVATE_KEY
---

# YEX Trader

Autonomous Hyperliquid trading via agent-cli. 14 strategies across market making, momentum, arbitrage, and LLM-powered trading. APEX multi-slot orchestrator. REFLECT nightly performance review. Builder fee revenue collection.

## Quick Start (Agent-Friendly)

```bash
cd ~/agent-cli
bash scripts/bootstrap.sh           # Creates venv, installs, validates
hl wallet auto --save-env             # Creates wallet, saves creds to ~/.hl-agent/env
hl setup claim-usdyp                 # Claim testnet USDyP
hl builder approve                   # Approve builder fee (one-time)
hl run avellaneda_mm --mock --max-ticks 3  # Validate
hl run engine_mm -i ETH-PERP --tick 15 --max-ticks 5  # First live trade
```

For full step-by-step onboarding, see `skills/onboard/SKILL.md`.

## Setup (Manual)

```bash
cd ~/agent-cli && pip install -e .
hl setup check  # Validate environment
```

### Getting Started — YEX Testnet

1. Set your private key (or use `hl wallet auto`):
```bash
export HL_PRIVATE_KEY=0x...
export HL_TESTNET=true  # default
```

2. Claim testnet USDyP (required for YEX markets):
```bash
hl setup claim-usdyp
```

3. Approve builder fee (one-time):
```bash
hl builder approve
```

4. Start trading:
```bash
hl run avellaneda_mm -i VXX-USDYP --tick 15          # YEX yield market
hl run engine_mm -i ETH-PERP --tick 10                # Standard perp
hl apex run --mock --max-ticks 5                       # APEX multi-slot
```

### Getting Started — Mainnet

1. Set your private key and network:
```bash
export HL_PRIVATE_KEY=0x...
export HL_TESTNET=false
```

2. Approve builder fee (one-time):
```bash
hl builder approve --mainnet
```

3. Start trading:
```bash
hl run engine_mm -i ETH-PERP --tick 10 --mainnet      # ETH perp
hl run avellaneda_mm -i BTC-PERP --tick 10 --mainnet   # BTC perp
hl apex run --mainnet                                   # APEX multi-slot
```

### Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `HL_PRIVATE_KEY` | Yes* | Hyperliquid private key |
| `HL_KEYSTORE_PASSWORD` | Alt* | Password for encrypted keystore |
| `HL_TESTNET` | No | `true` (default) or `false` for mainnet |
| `BUILDER_ADDRESS` | No | Override builder fee address (default: hardcoded) |
| `BUILDER_FEE_TENTHS_BPS` | No | Override fee rate (default: 100 = 10 bps) |
| `ANTHROPIC_API_KEY` | No | For `claude_agent` strategy |
| `GEMINI_API_KEY` | No | For `claude_agent` with Gemini |

\* Either `HL_PRIVATE_KEY` or a keystore with `HL_KEYSTORE_PASSWORD` is required.

## Commands

### Core Trading

```bash
# Start autonomous trading
hl run <strategy> [-i INSTRUMENT] [-t TICK] [--config FILE] [--mainnet] [--dry-run] [--mock] [--max-ticks N]

# Single manual order
hl trade <instrument> <side> <size>

# Account info
hl account [--mainnet]

# Check positions and PnL
hl status [--watch] [--interval 5]

# List all strategies
hl strategies
```

### APEX Multi-Slot Orchestrator

```bash
hl apex run [-t 60] [--preset conservative|default|aggressive] [--mock] [--budget 1000] [--slots 5]
hl apex once [--mock]
hl apex status
hl apex presets
```

### REFLECT Performance Review

```bash
hl reflect run [--since 2026-03-01] [--data-dir data/cli]
hl reflect report [--date 2026-03-03]
hl reflect history [-n 10]
```

### Dynamic Stop Loss (DSL)

```bash
hl dsl start <instrument> [--entry-price 2500] [--direction long] [--preset tight|standard|wide]
hl dsl check <instrument>
hl dsl status
hl dsl presets
```

### Radar & Movers

```bash
hl radar run [--top 10] [--min-score 7.0]
hl radar history [-n 5]
hl movers run [--top 10]
```

### Builder Fee

```bash
hl builder status
hl builder approve [--mainnet]
```

### Wallet (Encrypted Keystore)

```bash
hl wallet auto                       # Non-interactive wallet creation (agent-friendly)
hl wallet create                     # Interactive wallet creation
hl wallet import --key <hex>
hl wallet list
hl wallet export [--address 0x...]
```

### Environment Setup

```bash
hl setup check                       # Validate environment
hl setup bootstrap                   # Auto-create venv and install
hl setup claim-usdyp                 # Claim testnet USDyP tokens
```

### MCP Server (24 Tools)

```bash
hl mcp serve                         # Start MCP server (stdio transport)
hl mcp serve --transport sse         # Start MCP server (SSE transport)
```

Tools: `strategies`, `builder_status`, `wallet_list`, `wallet_auto`, `setup_check`, `funding_hedge_info`, `funding_hedge_propose`, `funding_hedge_backtest`, `account`, `status`, `trade`, `run_strategy`, `radar_run`, `apex_status`, `apex_run`, `reflect_run`, `schedule_cancel`, `emergency_close_all`, `order_status`, `funding_rates`, `agent_memory`, `trade_journal`, `judge_report`, `obsidian_context`

## Strategies (14)

| Name | Type | Description |
|------|------|-------------|
| simple_mm | MM | Symmetric bid/ask quoting around mid |
| avellaneda_mm | MM | Inventory-aware Avellaneda-Stoikov model |
| engine_mm | MM | Production quoting engine — composite FV, dynamic spreads, multi-level ladder |
| regime_mm | MM | Vol-regime adaptive — switches behavior by volatility regime (calm/normal/volatile/extreme) |
| grid_mm | MM | Fixed-interval grid levels above and below mid |
| liquidation_mm | MM | Provides liquidity during cascade/liquidation events |
| funding_arb | Arb | Cross-venue funding rate arbitrage |
| basis_arb | Arb | Trades implied basis from funding rate (contango/backwardation) |
| mean_reversion | Signal | Trades when price deviates from SMA |
| momentum_breakout | Signal | Enters on volume + price breakout above/below N-period range |
| aggressive_taker | Taker | Directional spread crossing with bias |
| hedge_agent | Risk | Inventory exposure reducer; BTCSWP funding hedge lives under `hl hedge` |
| rfq_agent | RFQ | Block-size dark RFQ liquidity |
| claude_agent | LLM | Claude/Gemini-powered autonomous trading agent |

## Instruments

- **Standard perps**: ETH-PERP, BTC-PERP, SOL-PERP, etc.
- **YEX yield markets**: VXX-USDYP (yex:VXX), US3M-USDYP (yex:US3M)

## Workflow

1. **Setup**: `hl setup check`
2. **Claim USDyP** (testnet only): `hl setup claim-usdyp`
3. **Approve builder fee**: `hl builder approve` (testnet) or `hl builder approve --mainnet`
4. **Mock test**: `hl run avellaneda_mm --mock --max-ticks 5`
5. **Dry run**: `hl run engine_mm --dry-run --max-ticks 10`
6. **Live testnet**: `hl run engine_mm -i ETH-PERP --tick 10`
7. **Live mainnet**: `hl run engine_mm -i ETH-PERP --tick 10 --mainnet`
8. **APEX mode**: `hl apex run --mainnet` or `hl apex run --mock --max-ticks 5`
9. **Monitor**: `hl status --watch`
10. **Review**: `hl reflect run`

## Builder Fee Revenue

Set `BUILDER_ADDRESS` and `BUILDER_FEE_TENTHS_BPS` to collect fees on every trade. Users must approve once via `hl builder approve`. Fee is collected natively by Hyperliquid — no extra gas, no contract calls.

## REFLECT Self-Improvement

Run `hl reflect run` after a trading session. REFLECT computes win rate, fee drag ratio (FDR), direction analysis, holding period buckets, monster trade dependency, and generates actionable recommendations. Reports saved to `data/reflect/`.