Hyperliquid Trading & Analysis
by @anajuliabit
Trade and monitor Hyperliquid perpetual futures. Check balances, view positions with P&L, place/cancel orders, execute market trades. Use when the user asks about Hyperliquid trading, portfolio status, crypto positions, or wants to execute trades on Hyperliquid.
clawhub install hyperliquid-tradingπ About This Skill
name: hyperliquid description: Trade and monitor Hyperliquid perpetual futures. Check balances, view positions with P&L, place/cancel orders, execute market trades. Use when the user asks about Hyperliquid trading, portfolio status, crypto positions, or wants to execute trades on Hyperliquid.
Hyperliquid Trading Skill
Full trading and portfolio management for Hyperliquid perpetual futures exchange.
Prerequisites
Install dependencies once:
cd skills/hyperliquid/scripts && npm install
Authentication
For read-only operations (balance, positions, prices):
HYPERLIQUID_ADDRESS environment variableFor trading operations:
HYPERLIQUID_PRIVATE_KEY environment variableTestnet:
HYPERLIQUID_TESTNET=1 to use testnetCore Operations
Portfolio Monitoring
Check balance:
HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs balance
View positions with P&L:
HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs positions
Check open orders:
HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs orders
View trade history:
HYPERLIQUID_ADDRESS=0x... node scripts/hyperliquid.mjs fills
Get price for a coin:
node scripts/hyperliquid.mjs price BTC
Trading Operations
All trading commands require HYPERLIQUID_PRIVATE_KEY.
Place limit orders:
# Buy 0.1 BTC at $45,000
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs buy BTC 0.1 45000Sell 1 ETH at $3,000
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs sell ETH 1 3000
Market orders (with 5% slippage protection):
# Market buy 0.5 BTC
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs market-buy BTC 0.5Market sell 2 ETH
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs market-sell ETH 2
Cancel orders:
# Cancel specific order
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel BTC 12345Cancel all orders
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel-allCancel all orders for specific coin
HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel-all BTC
Output Formatting
All commands output JSON. Parse and format for chat display:
For balance/portfolio:
For trade execution:
Safety Guidelines
Before executing trades: 1. Confirm trade parameters with user (coin, size, direction, price) 2. Show current price and position for context 3. Calculate estimated cost/proceeds
Position sizing:
Price checks:
Error Handling
Common errors:
meta commandWhen errors occur:
Workflow Examples
"How's my Hyperliquid portfolio?"
1. Run balance to get total equity
2. Run positions to get open positions
3. Format summary: equity, positions with P&L, total unrealized P&L
"Buy 0.5 BTC on Hyperliquid"
1. Run price BTC to get current price
2. Run balance to verify sufficient funds
3. Confirm with user: "Buy 0.5 BTC at market? Current price: $X. Estimated cost: $Y"
4. Execute market-buy BTC 0.5
5. Report order result
"What's the current BTC price on Hyperliquid?"
1. Run price BTC
2. Format response: "BTC: $X on Hyperliquid"
"Close my ETH position"
1. Run positions to get current ETH position size
2. If long β market-sell, if short β market-buy
3. Execute with position size
4. Report result
Advanced Features
List all available coins:
node scripts/hyperliquid.mjs meta
Query other addresses:
# Check someone else's positions (read-only, public data)
node scripts/hyperliquid.mjs positions 0x1234...
Notes
βοΈ Configuration
Install dependencies once:
cd skills/hyperliquid/scripts && npm install