hyperliquid

What This Skill Does

The Hyperliquid skill for OpenClaw provides a powerful command-line and programmatic interface to the Hyperliquid decentralized exchange. It enables users to trade a wide variety of assets—including crypto perpetuals, traditional stocks like NVDA and TSLA, and commodities such as GOLD and SILVER—directly from their agent interface. Beyond basic execution, the skill facilitates advanced trading workflows including real-time orderbook monitoring, persistent websocket connections for low-latency market data, and multi-account management. By leveraging the HIP3 protocol, this skill bridges the gap between traditional market assets and the efficiency of decentralized perpetual exchanges.

Installation

To begin using the Hyperliquid skill, ensure you have the OpenClaw environment active. Install the skill via the command line with: clawhub install openclaw/skills/skills/chrisling-dev/hyperliquid-cli. Once installed, you must configure your Hyperliquid API wallet. You can store your private key securely using hl account add or set the HYPERLIQUID_PRIVATE_KEY environment variable. For production or high-frequency trading scenarios, we highly recommend launching the background server using hl server start to maintain persistent websocket connections, which reduces latency from ~200ms to under 5ms, ensuring your orders reach the liquidity providers faster.

Use Cases

• Automated Algorithmic Trading: Deploy trading bots that react to market shifts in under 5ms.
• Portfolio Diversification: Hedge crypto exposure by taking positions in traditional stocks or commodities within the same interface.
• Real-Time Portfolio Monitoring: Track PnL across multiple accounts simultaneously with live, color-coded updates.
• High-Frequency Market Analysis: Stream real-time order book data for quantitative modeling and signal generation.

Example Prompts

1. "Check the current order book for AAPL and tell me if there is a significant buy wall near the current price."
2. "Open a long position for 5 units of NVDA at the current market price using my main trading account."
3. "Show me the total PnL across all my connected accounts and list my current open positions for SOL and GOLD."

Tips & Limitations

• Latency: Always run the background server (hl server start) before executing trades to achieve optimal execution speeds.
• Security: Never share your private keys. Use the hl account command to manage keys locally rather than hardcoding them in scripts.
• HIP3 Markets: Ensure you reference the correct market strings (e.g., xyz:GOLD) as HIP3 assets are distinct from standard crypto pairs.
• Risk: Trading with leverage involves significant risk; ensure your account margin is sufficient before executing large orders.