Hyperliquid CLI (with HIP3 Support)
Trade crypto, stocks (AAPL, NVDA, TSLA), indexes, and commodities (GOLD, SILVER) 24/7 on Hyperliquid via HIP-3. Real-time position & P&L tracking, orderbook monitoring, multi-account management, and w
Trade crypto, stocks (AAPL, NVDA, TSLA), indexes, and commodities (GOLD, SILVER) 24/7 on Hyperliquid via HIP-3. Real-time position & P&L tracking, orderbook monitoring, multi-account management, and w
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Trade crypto perpetuals and HIP3 traditional assets (stocks, commodities) on Hyperliquid DEX from the command line.
This skill enables you to:
which hl
If not found, install it:
npm install -g hyperliquid-cli
hl --version hl --help
To execute trades, you need a Hyperliquid API wallet:
0x)hl account add # Follow the interactive prompts
or set the environment variable:
export HYPERLIQUID_PRIVATE_KEY=0x...your_private_key...
For best performance, start the background server before trading:
hl server start hl server status # Verify it's running
The server provides:
Stop when done:
hl server stop
Hyperliquid's HIP3 enables trading traditional assets with crypto primitives:
# First, check available HIP3 markets and their coin values hl markets lsCheck Apple stock price (use the coin value from markets ls)
hl asset price xyz:AAPL
Long 10 units of NVIDIA perp
hl order limit long 10 xyz:NVDA 140
View order book for Gold
hl asset book xyz:GOLD
The background server dramatically improves performance:
| Operation | Without Server | With Server |
|---|---|---|
| Price Query | ~200ms | ~5ms |
| Order Placement | ~300ms | ~50ms |
| Position Fetch | ~250ms | ~10ms |
hl account add # Add new account (interactive) hl account ls # List all accounts hl account set-default # Change default account hl account remove # Remove an account
hl account positions # View positions hl account positions -w # Watch mode (real-time) hl account orders # View open orders hl account balances # View balances hl account portfolio # Combined positions + balances
Important: Before placing any order, always run
hl markets ls to identify the asset's coin value. Use this exact coin value when placing orders.
Order Directions:
buy and selllong and short# First, identify the coin value from markets hl markets lsSPOT orders (buy/sell)
hl order limit buy 0.1 @107 30 # Buy spot asset where @107 is the coin hl order limit sell 1 @107 50 --tif Gtc hl order market buy 0.001 @107 hl order market sell 0.1 @107
PERP orders (long/short)
hl order limit long 0.01 BTC 50000 # Long BTC perp hl order limit short 0.05 ETH 3500 hl order market long 0.01 BTC hl order market short 0.1 ETH --slippage 0.5
Cancel orders
hl order cancel # Interactive selection hl order cancel <oid> # Cancel specific order hl order cancel-all # Cancel all orders
Set leverage (perps only)
hl order set-leverage BTC 10
hl markets ls # List all markets hl asset price BTC # Get price hl asset price BTC -w # Watch price hl asset book ETH # Order book hl asset book ETH -w # Watch order book hl asset leverage BTC # Get leverage and margin info hl asset leverage BTC -w # Watch leverage and margin
hl server start # Start background server hl server stop # Stop server hl server status # Check server status
hl upgrade # Check for updates
| Option | Description |
|---|---|
| Output in JSON format (for scripting) |
| Use testnet instead of mainnet |
| Show help |
When a user needs to set up trading, guide them through this process:
hl account ls to see if accounts existExample prompt to user:
To trade on Hyperliquid, you'll need an API wallet. Here's how to set it up:
- Go to https://app.hyperliquid.xyz/API
- Click "Create API Wallet" (you can name it anything)
- Copy the private key (starts with 0x)
- Run
and paste it when promptedhl account addWould you like me to walk you through this?
See reference.md for complete command documentation and examples.md for workflow examples.
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.