hyperliquid-trade

What This Skill Does

The hyperliquid-trade skill provides an interface for interacting with the Hyperliquid decentralized exchange directly from the OpenClaw AI agent. It is designed to handle both spot and perpetual futures trading by leveraging the WDK (Wallet Development Kit) for secure transaction signing. The skill allows users to execute market orders (Immediate-or-Cancel), place limit orders (Good-Till-Cancelled), adjust leverage, and monitor portfolio health. By integrating with the Hyperliquid L1 network, the agent performs balance checks, portfolio auditing, and order management, ensuring that users can execute their trading strategy with minimal latency and high security standards.

Installation

To begin, ensure you have the OpenClaw environment active. Install the skill by running the command clawhub install openclaw/skills/skills/aure-duncan/aurehub-hyperliquid-trade. Before the first trade, you must ensure your environment is configured. The skill requires the existence of ~/.aurehub/.wdk_vault and ~/.aurehub/.wdk_password. If these are missing, the agent will prompt you to run the onboarding procedure found in the documentation. Once the vault is ready, the system automatically handles the creation of hyperliquid.yaml and installs necessary Node.js dependencies via npm install within the script directory. Finally, ensure your system is running Node.js version 20.19.0 or higher to maintain compatibility.

Use Cases

This skill is built for active market participants who require automated or semi-automated trading.

• Portfolio Management: Use the agent to quickly check current spot balances or the status of your existing perpetual positions without manually logging into the web interface.
• Market Execution: Execute rapid market entries for ETH or BTC, perfect for taking advantage of sudden liquidity spikes or news events.
• Strategic Limit Trading: Place GTC limit orders to capture specific price levels, allowing the agent to manage your order book state continuously.
• Risk Control: Adjust leverage settings for your perps positions directly via chat, allowing for dynamic portfolio risk management.

Example Prompts

1. "What is my current balance of ETH and do I have any open perpetual positions on Hyperliquid?"
2. "Place a limit buy order for 0.5 BTC at $65,000."
3. "Open a 5x long position on ETH using my available margin."

Tips & Limitations

• Security: The skill performs all cryptographic operations in memory. Your private key is never written to disk after the initial vault creation. Always double-check the risk thresholds defined in hyperliquid.yaml to ensure they match your risk tolerance.
• Permissions: Every trade requires explicit user confirmation. Do not attempt to bypass this via scripted hacks; the safety hooks are hard-coded to prevent unauthorized capital movement.
• Network: The skill uses https://api.hyperliquid.xyz by default. If you are experiencing network latency, ensure your node-based environment has reliable access to this endpoint.