🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

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.

Versionv1.0.0
Downloads7,655
Stars⭐ 20
TERMINAL
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):

  • Set HYPERLIQUID_ADDRESS environment variable
  • No private key needed
  • For trading operations:

  • Set HYPERLIQUID_PRIVATE_KEY environment variable
  • Address derived automatically from private key
  • Testnet:

  • Set HYPERLIQUID_TESTNET=1 to use testnet
  • Core 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 45000

    Sell 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.5

    Market 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 12345

    Cancel all orders

    HYPERLIQUID_PRIVATE_KEY=0x... node scripts/hyperliquid.mjs cancel-all

    Cancel 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:

  • Show total equity, available balance
  • List positions with size, entry price, unrealized P&L
  • Summarize open orders
  • For trade execution:

  • Confirm order details before executing
  • Report order ID and status after execution
  • Show filled price if immediately executed
  • 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:

  • Warn if trade is >20% of account equity
  • Suggest appropriate sizes based on account balance
  • Price checks:

  • For limit orders, compare limit price to current market price
  • Warn if limit price is >5% away from market (likely mistake)
  • Error Handling

    Common errors:

  • "Address required" β†’ Set HYPERLIQUID_ADDRESS or HYPERLIQUID_PRIVATE_KEY
  • "Private key required" β†’ Trading needs HYPERLIQUID_PRIVATE_KEY
  • "Unknown coin" β†’ Check available coins with meta command
  • HTTP errors β†’ Check network connection and API status
  • When errors occur:

  • Show the error message to user
  • Suggest fixes (set env vars, check coin names, verify balance)
  • Don't retry trades automatically
  • 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

  • All sizes are in base currency (BTC, ETH, etc.)
  • Prices are in USD
  • Market orders use limit orders with 5% slippage protection
  • Hyperliquid uses perpetual futures, not spot trading
  • Check references/api.md for full API documentation
  • βš™οΈ Configuration

    Install dependencies once:

    cd skills/hyperliquid/scripts && npm install
    

    πŸ“‹ Tips & Best Practices

  • All sizes are in base currency (BTC, ETH, etc.)
  • Prices are in USD
  • Market orders use limit orders with 5% slippage protection
  • Hyperliquid uses perpetual futures, not spot trading
  • Check references/api.md for full API documentation