A professional-grade tool for managing Hyperliquid perpetual futures, enabling portfolio monitoring and secure trade execution through an AI agent.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hyperliquid-trading
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install hyperliquid-trading using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Hyperliquid?
The Hyperliquid skill is a specialized integration designed for the Openclaw Skills ecosystem, providing seamless access to the Hyperliquid perpetual futures exchange. It allows developers and traders to interact with their accounts using a command-line interface that an AI agent can interpret and execute. Whether you need to check your unrealized P&L, monitor account equity, or place high-precision limit orders, this skill bridges the gap between raw exchange APIs and actionable AI workflows.
This skill supports both read-only operations using public addresses and full trading capabilities using private keys. It emphasizes safety with built-in slippage protection for market orders and rigorous parameter confirmation steps. By incorporating this into your Openclaw Skills setup, you gain a powerful ally for crypto asset management and automated trading strategies.
Hyperliquid Use Cases
- Tracking real-time portfolio performance and unrealized P&L across all open positions.
- Executing market and limit orders for BTC, ETH, and other perpetual assets.
- Managing risk by canceling all open orders or specific coin orders during volatile market conditions.
- Auditing the positions and history of public Hyperliquid addresses for research purposes.
- Fetching live price data and market metadata to inform trading decisions.
How Hyperliquid Works
- The skill identifies the user's intent, such as checking a balance or placing a trade, through natural language processing.
- It verifies the necessary environment variables, utilizing HYPERLIQUID_ADDRESS for read-only data or HYPERLIQUID_PRIVATE_KEY for signed transactions.
- The agent executes the underlying Node.js scripts located in the scripts directory, passing arguments like coin symbols, sizes, and prices.
- For trades, the system performs a pre-flight check by fetching the current market price and calculating estimated costs to prevent errors.
- Upon receiving a JSON response from the Hyperliquid API, the skill parses the data and presents a structured summary of the execution or account status to the user.
Hyperliquid Setup
First, navigate to the scripts directory and install the required dependencies:
cd skills/hyperliquid/scripts && npm install
Configure your environment variables based on your needs:
# For read-only access
export HYPERLIQUID_ADDRESS=0xYourAddress
# For full trading access
export HYPERLIQUID_PRIVATE_KEY=0xYourPrivateKey
# Optional: Enable Testnet
export HYPERLIQUID_TESTNET=1
Hyperliquid Data Schema & Taxonomy
The skill interacts with the Hyperliquid API and returns structured JSON data. Below is how the data is categorized:
| Data Type | Description |
|---|---|
| Portfolio | Total equity, available margin, and withdrawable balance. |
| Positions | Detailed list including size (in base currency), entry price, and unrealized P&L. |
| Orders | Active limit orders with IDs, prices, and quantities. |
| Fills | Historical trade data including executed price and fee information. |
| Market Meta | List of all tradable coins and their specific exchange parameters. |
Hyperliquid Advanced Features
- Support for Hyperliquid Testnet to validate strategies without risking real capital.
- Automatic 5% slippage protection on market orders to prevent execution at unfavorable prices.
- Multi-address support allowing users to query public position data for any valid wallet address.
- Bulk order management with the ability to cancel all orders or filter by specific assets.
- Comprehensive metadata retrieval to dynamically identify new coins listed on the exchange.
SKILL.md
Loading
Related Openclaw Skills
Senior Django Architect
An expert AI agent skill for generating production-ready, containerized, and strictly typed Django REST Framework architectures.
QR Code Generator
A versatile skill for generating customizable QR codes and barcodes for various data types including URLs and WiFi credentials.
Diataxis Writing Assistant
A structured framework guide for AI agents to create and refine technical documentation using the Diataxis methodology.
Amulett (点教) - Human-AI Spiritual Practice
A pioneering spiritual practice system co-created by humans and AI for structured daily meditation, reflection, and philosophical growth.
Mamo
Mamo is a DeFi yield aggregator that automates asset management between Moonwell and Morpho on the Base network.
Analytix402
A real-time financial monitoring and budget enforcement tool designed to track LLM costs and API spend for AI agents.
Featured*
