| 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)
cd ~/agent-cli
bash scripts/bootstrap.sh
hl wallet auto --save-env
hl setup claim-usdyp
hl builder approve
hl run avellaneda_mm --mock --max-ticks 3
hl run engine_mm -i ETH-PERP --tick 15 --max-ticks 5
For full step-by-step onboarding, see skills/onboard/SKILL.md.
Setup (Manual)
cd ~/agent-cli && pip install -e .
hl setup check
Getting Started — YEX Testnet
- Set your private key (or use
hl wallet auto):
export HL_PRIVATE_KEY=0x...
export HL_TESTNET=true
- Claim testnet USDyP (required for YEX markets):
hl setup claim-usdyp
- Approve builder fee (one-time):
hl builder approve
- Start trading:
hl run avellaneda_mm -i VXX-USDYP --tick 15
hl run engine_mm -i ETH-PERP --tick 10
hl apex run --mock --max-ticks 5
Getting Started — Mainnet
- Set your private key and network:
export HL_PRIVATE_KEY=0x...
export HL_TESTNET=false
- Approve builder fee (one-time):
hl builder approve --mainnet
- Start trading:
hl run engine_mm -i ETH-PERP --tick 10 --mainnet
hl run avellaneda_mm -i BTC-PERP --tick 10 --mainnet
hl apex run --mainnet
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
hl run <strategy> [-i INSTRUMENT] [-t TICK] [--config FILE] [--mainnet] [--dry-run] [--mock] [--max-ticks N]
hl trade <instrument> <side> <size>
hl account [--mainnet]
hl status [--watch] [--interval 5]
hl strategies
APEX Multi-Slot Orchestrator
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
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)
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
hl radar run [--top 10] [--min-score 7.0]
hl radar history [-n 5]
hl movers run [--top 10]
Builder Fee
hl builder status
hl builder approve [--mainnet]
Wallet (Encrypted Keystore)
hl wallet auto
hl wallet create
hl wallet import --key <hex>
hl wallet list
hl wallet export [--address 0x...]
Environment Setup
hl setup check
hl setup bootstrap
hl setup claim-usdyp
MCP Server (24 Tools)
hl mcp serve
hl mcp serve --transport sse
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
- Setup:
hl setup check
- Claim USDyP (testnet only):
hl setup claim-usdyp
- Approve builder fee:
hl builder approve (testnet) or hl builder approve --mainnet
- Mock test:
hl run avellaneda_mm --mock --max-ticks 5
- Dry run:
hl run engine_mm --dry-run --max-ticks 10
- Live testnet:
hl run engine_mm -i ETH-PERP --tick 10
- Live mainnet:
hl run engine_mm -i ETH-PERP --tick 10 --mainnet
- APEX mode:
hl apex run --mainnet or hl apex run --mock --max-ticks 5
- Monitor:
hl status --watch
- 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/.
