nunchi-trade/agent-cli/cli

Name: cli
Author: nunchi-trade

Claude Code and agent skill by nunchi-trade/agent-cli

Trust tier 3

community

By nunchi-trade
Coding
nunchi-trade/agent-cli
cli/skill.md
Updated 15 Sep 2026
Version 1.0.01 version recorded

Source check pending

Checking that the SKILL.md file is still in the repository.

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.

Install

npx vskill@latest install nunchi-trade/agent-cli/cli

SKILL.md

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

Set your private key (or use hl wallet auto):

bash

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

Claim testnet USDyP (required for YEX markets):

bash

hl setup claim-usdyp

Approve builder fee (one-time):

bash

hl builder approve

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

Set your private key and network:

bash

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

Approve builder fee (one-time):

bash

hl builder approve --mainnet

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

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

Security

Security scanPassed, 95 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingcli/skill.md

Popularity

Repository stars: 521
Repository forks: 141
7-day trend score: 31

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/nunchi-trade/agent-cli/cli/badge)](https://verified-skill.com/skills/nunchi-trade/agent-cli/cli)

Something wrong with this skill or its page? Tell us.