Yex Trader

What it does

When your agent uses it

• Tasks that involve Trading and backtesting
• Tasks that involve Performance reviews

Example prompts

• “/yex-trader”

Requirements

• Python 3
• A credential in HL_PRIVATE_KEY
• A credential in ANTHROPIC_API_KEY
• Pre-approved tools (allowed-tools): Bash

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1Set your private key (or use hl wallet auto)
2. 2Claim testnet USDyP (required for YEX markets)
3. 3Approve builder fee (one-time)
4. 4Start trading

What it can do on your machine

Read from SKILL.md and the folder at commit 58619a2. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships script files (Python, from the files we listed), which the agent can run.

  Shell commands in SKILL.md call:

  • bash
  • pip

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • HL_PRIVATE_KEY
  • HL_KEYSTORE_PASSWORD
  • ANTHROPIC_API_KEY
  • GEMINI_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Yex Trader loads about 1.9k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 488 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~52

When it runs · the whole SKILL.md, loaded when a task matches

~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Nunchi-trade/agent-cli at commit 58619a2, republished under its MIT licence (© Nunchi-trade). 488 words, ~1,910 tokens.

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.

allowed-tools

Bash

user-invocable

true

argument-hint

<strategy> [options]

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

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

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

hl setup claim-usdyp

hl builder approve

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

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

hl builder approve --mainnet

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

# 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

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

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

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

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

hl builder status
hl builder approve [--mainnet]

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

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

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

© Nunchi-trade, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 59 other files in cli of Nunchi-trade/agent-cli.

• SKILL.md
• __init__.py
• api/__init__.py
• api/status_reader.py
• builder_fee.py
• commands/__init__.py
• commands/account.py
• commands/apex.py
• commands/builder.py
• commands/emergency.py
• commands/funding.py
• commands/guard.py
• commands/hedge.py
• commands/house.py
• commands/journal.py
• commands/keys.py
• commands/margin.py
• commands/mcp.py
• commands/order_status.py
• … and 41 more

Open the folder on GitHubat commit 58619a2