SKILL.md
Full skill instructions
Hyperliquid
Full integration with the dominant perpetual futures DEX. 130+ perp markets, spot trading, HLP vault, TWAP orders.
Quick Start
# Set credentials
export HYPERLIQUID_WALLET="0x..."
export HYPERLIQUID_PRIVATE_KEY="0x..."
# Check balance
/hl balance
# Open a position
/hl long BTC 0.1
/hl short ETH 1 3000
# Close position
/hl close BTC
Commands
Market Data
| Command | Description |
|---|---|
/hl stats | HLP TVL, APR, top funding rates |
/hl markets [query] | List perp/spot markets |
/hl price <coin> | Get current price |
/hl book <coin> | Show orderbook depth |
/hl candles <coin> [1m|5m|15m|1h|4h|1d] | OHLCV candle data |
/hl funding [coin] | Funding rates (current + predicted) |
Account
| Command | Description |
|---|---|
/hl balance | Positions, balances, margin |
/hl portfolio | PnL breakdown (day/week/month/all) |
/hl orders | List open orders |
/hl orders cancel <coin> [orderId] | Cancel orders |
/hl orders cancelall | Cancel all orders |
/hl fills [coin] | Recent trade fills |
/hl history | Order history |
Trading
| Command | Description |
|---|---|
/hl long <coin> <size> [price] | Open long position |
/hl short <coin> <size> [price] | Open short position |
/hl close <coin> | Close position at market |
/hl closeall | Close all positions |
/hl leverage <coin> <1-50> | Set leverage |
/hl margin <coin> <amount> | Add/remove isolated margin |
Examples:
/hl long BTC 0.1 # Market long 0.1 BTC
/hl long BTC 0.1 45000 # Limit long at $45,000
/hl short ETH 1 # Market short 1 ETH
/hl close BTC # Close BTC position
/hl leverage BTC 10 # Set 10x leverage
TWAP Orders
Execute large orders over time to minimize slippage.
| Command | Description |
|---|---|
/hl twap buy <coin> <size> <minutes> | Start TWAP buy |
/hl twap sell <coin> <size> <minutes> | Start TWAP sell |
/hl twap cancel <coin> <twapId> | Cancel TWAP |
/hl twap status | Show active TWAP fills |
Example:
/hl twap buy BTC 1 60 # Buy 1 BTC over 60 minutes
/hl twap sell ETH 10 30 # Sell 10 ETH over 30 minutes
Spot Trading
| Command | Description |
|---|---|
/hl spot markets | List spot markets |
/hl spot book <coin> | Spot orderbook |
/hl spot buy <coin> <amount> [price] | Buy spot |
/hl spot sell <coin> <amount> [price] | Sell spot |
HLP Vault
Earn yield by providing liquidity to the HLP vault.
| Command | Description |
|---|---|
/hl hlp | Show vault stats (TVL, APR) |
/hl hlp deposit <amount> | Deposit USDC to vault |
/hl hlp withdraw <amount> | Withdraw from vault |
/hl vaults | Your vault positions |
Transfers
| Command | Description |
|---|---|
/hl transfer spot2perp <amount> | Move USDC to perps |
/hl transfer perp2spot <amount> | Move USDC to spot |
/hl transfer send <address> <amount> | Send USDC on Hyperliquid |
/hl transfer withdraw <address> <amount> | Withdraw to L1 (Arbitrum) |
Account Info
| Command | Description |
|---|---|
/hl fees | Your fee tier & rate limits |
/hl points | Points balance |
/hl referral | Referral info & rewards |
/hl claim | Claim referral rewards |
/hl leaderboard [day|week|month|allTime] | Top traders |
/hl sub | List subaccounts |
/hl sub create <name> | Create subaccount |
/hl lend | Borrow/lend rates |
Shortcuts
Most commands have short aliases:
| Full | Short |
|---|---|
/hl balance | /hl b |
/hl markets | /hl m |
/hl price | /hl p |
/hl book | /hl ob |
/hl candles | /hl c |
/hl funding | /hl f |
/hl orders | /hl o |
/hl history | /hl h |
/hl long | /hl l |
/hl short | /hl s |
/hl leverage | /hl lev |
/hl portfolio | /hl pf |
/hl leaderboard | /hl lb |
/hl referral | /hl ref |
Configuration
# Required for trading
export HYPERLIQUID_WALLET="0x..."
export HYPERLIQUID_PRIVATE_KEY="0x..."
# Optional: dry run mode (no real trades)
export DRY_RUN=true
Features
- 130+ Perp Markets with up to 50x leverage
- Spot Trading with native HYPE token
- HLP Vault - Earn yield providing liquidity
- TWAP Orders - Execute large orders over time
- Points System - Earn rewards for activity
- Subaccounts - Manage multiple strategies
- Real-time WebSocket - Live orderbook and fills
Database/History
All trades are automatically logged to SQLite for tracking.
| Command | Description |
|---|---|
/hl trades [coin] [limit] | Trade history from database |
/hl dbstats [coin] [period] | Win rate, PnL, profit factor |
/hl dbfunding [coin] | Funding payments history |
/hl dbpositions [all] | Position history |
Stats periods: day, week, month
Example:
/hl trades BTC 10 # Last 10 BTC trades
/hl dbstats week # This week's performance
/hl dbstats ETH month # ETH stats for the month