hyperliquid-cliTrade 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 websocket client for sub-5ms low-latency high-frequency trading.
Install via ClawdBot CLI:
clawdbot install chrisling-dev/hyperliquid-cliTrade 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 ls
# Check 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 ls
# SPOT 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 |
| ------------ | ------------------------------------- |
| --json | Output in JSON format (for scripting) |
| --testnet | Use testnet instead of mainnet |
| -h, --help | 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:
>
1. Go to https://app.hyperliquid.xyz/API
2. Click "Create API Wallet" (you can name it anything)
3. Copy the private key (starts with 0x)
4. Run hl account add and paste it when prompted
>
Would you like me to walk you through this?
See reference.md for complete command documentation and examples.md for workflow examples.
Generated Mar 1, 2026
Traders can use the skill to execute high-frequency trades on crypto perpetuals like BTC and ETH with up to 50x leverage, leveraging the server mode for sub-5ms latency to capitalize on market movements. Real-time position tracking and WebSocket updates enable quick decision-making and risk management in volatile markets.
Investors can trade traditional assets such as AAPL, NVDA, and GOLD outside regular market hours using HIP3, applying crypto-style leverage and the same interface as crypto trading. This allows for continuous portfolio adjustments and hedging strategies based on global news or events.
Fund managers or individual traders can manage multiple trading accounts simultaneously, switching between them to execute different strategies or segregate assets. The skill provides tools to view balances, positions, and portfolio summaries in real-time for efficient oversight.
Developers can integrate the CLI into custom scripts or bots using JSON output and server mode for low-latency data feeds, enabling automated order placement and market monitoring. This supports algorithmic strategies for both crypto and HIP3 assets with high performance.
Analysts can use the skill to monitor order books, price trends, and leverage data for assets like SOL or SILVER in real-time, aiding in research and reporting. The watch mode and server capabilities provide fast access to market insights for data-driven decisions.
Offer premium features like advanced analytics, custom indicators, or priority server access through a monthly subscription, targeting active traders who need enhanced tools for crypto and HIP3 markets. Revenue is generated from recurring fees based on tiered plans.
Partner with Hyperliquid or other platforms to refer users, earning commissions on trading volume or account sign-ups facilitated through the skill. This leverages the user base of traders seeking efficient CLI tools for decentralized trading.
Provide consulting services to help firms integrate the skill into their trading workflows, offering setup assistance, strategy development, and custom scripting for automated systems. Revenue comes from one-time project fees or ongoing support contracts.
💬 Integration Tip
Always start the server before trading to achieve sub-5ms latency and verify the HYPERLIQUID_PRIVATE_KEY environment variable is set for secure account access.
Connect Claude to Clawdbot instantly and keep it connected 24/7. Run after setup to link your subscription, then auto-refreshes tokens forever.
ERC-8004 Trustless Agents - Register, discover, and build reputation for AI agents on Ethereum. Use when registering agents on-chain, querying agent registries, giving/receiving reputation feedback, or interacting with the AI agent trust layer.
Autonomous crypto trading on Base via Bankr. Use for trading tokens, monitoring launches, executing strategies, or managing a trading portfolio. Triggers on "trade", "buy", "sell", "launch", "snipe", "profit", "PnL", "portfolio balance", or any crypto trading task on Base.
Deploy ERC20 tokens on Base using Clanker SDK. Create tokens with built-in Uniswap V4 liquidity pools. Supports Base mainnet and Sepolia testnet. Requires PRIVATE_KEY in config.
Query DeFi portfolio data across 50+ chains via Zapper's GraphQL API. Use when the user wants to check wallet balances, DeFi positions, NFT holdings, token prices, or transaction history. Supports Base, Ethereum, Polygon, Arbitrum, Optimism, and more. Requires ZAPPER_API_KEY.
Interact with Solana blockchain via Helius APIs. Create/manage wallets, check balances (SOL + tokens), send transactions, swap tokens via Jupiter, and monitor addresses. Use for any Solana blockchain operation, crypto wallet management, token transfers, DeFi swaps, or portfolio tracking.