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           # 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)

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):

export HL_PRIVATE_KEY=0x...
export HL_TESTNET=true  # default

2. Claim testnet USDyP (required for YEX markets):

hl setup claim-usdyp

3. Approve builder fee (one-time):

hl builder approve

4. Start trading:

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:

export HL_PRIVATE_KEY=0x...
export HL_TESTNET=false

2. Approve builder fee (one-time):

hl builder approve --mainnet

3. Start trading:

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

* Either HL_PRIVATE_KEY or a keystore with HL_KEYSTORE_PASSWORD is required.

Commands

Core Trading

# 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

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                       # 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

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)

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)

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/.