A comprehensive read-only market data assistant for the Hyperliquid exchange that supports natural language and terminal-style command parsing.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hyperliquid
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 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 Market Data Assistant?
This skill provides a robust interface for interacting with the Hyperliquid decentralized exchange using the Openclaw Skills framework. It leverages the Hyperliquid Info HTTP endpoint to fetch real-time data for both perpetuals and spot markets, ensuring users have access to critical information like mark prices, mid prices, and funding rates. By integrating this into Openclaw Skills, developers and traders can utilize a deterministic command structure or natural language to extract market insights without manual API configuration.
The tool is designed for high-performance market monitoring, offering detailed snapshots of L2 order books, candle data, and account-specific information like positions and fills. Whether you are building a trading dashboard or a research bot, this addition to the Openclaw Skills ecosystem streamlines the process of data retrieval from one of the most liquid on-chain perpetual platforms.
Hyperliquid Market Data Assistant Use Cases
- Tracking real-time funding rates and rankings to identify arbitrage opportunities.
- Monitoring top market movers and volume leaders across the Hyperliquid ecosystem using Openclaw Skills.
- Auditing wallet positions, balances, and recent trade fills using simple account aliases.
- Analyzing market depth with top 20 levels of the L2 order book for any supported coin.
- Generating historical candle snapshots for technical analysis within a chat-based workflow.
How Hyperliquid Market Data Assistant Works
- The user inputs a command using natural language, terminal-style syntax (hl...), or slash commands (/hl...).
- The skill processes the input through a deterministic parser to identify the specific market or account intent.
- A POST request is dispatched to the Hyperliquid API Info endpoint using a specialized HTTP client.
- The skill retrieves raw JSON data including asset contexts, metadata, and order book states.
- The retrieved data is formatted into a clean, human-readable Markdown response optimized for Openclaw Skills users.
Hyperliquid Market Data Assistant Setup
To get started with this skill in the Openclaw Skills environment, ensure your local environment is configured to run the provided scripts.
# Test the quote functionality for BTC
node skills/hyperliquid/scripts/hyperliquid_chat.mjs "hl quote BTC"
# Rank top 5 market movers by 24h change
node skills/hyperliquid/scripts/hyperliquid_chat.mjs "/hl movers --top 5"
You can also add account aliases by editing the local configuration file located at ~/.clawdbot/hyperliquid/config.json.
Hyperliquid Market Data Assistant Data Schema & Taxonomy
The skill organizes its operations through a mix of local configuration and remote API responses.
| Data Type | Source / Location | Description |
|---|---|---|
| Account Aliases | ~/.clawdbot/hyperliquid/config.json |
Stores mappings of 0x addresses to human-readable labels. |
| Market Metadata | metaAndAssetCtxs |
Contains the universe of tradable assets and their current contexts. |
| Order Book | l2Book |
Provides 20 levels of depth per side for accurate spread analysis. |
| Historical Data | candleSnapshot |
Supplies OHLC data based on user-defined intervals and timeframes. |
Hyperliquid Market Data Assistant Advanced Features
- Deterministic command parsing that prioritizes
hland/hlprefixes for precision. - Integrated account alias management for tracking multiple sub-accounts with Openclaw Skills.
- Support for advanced market metrics including impact prices, premiums, and open interest.
- Automated ranking systems for funding rates and 24-hour price performance.
- Graceful handling of null or missing API fields to ensure consistent chat output.
SKILL.md
Loading
Related Openclaw Skills
Agent Workflow Enforcer
A framework to stabilize AI Agent execution by replacing soft prompts with hard-coded gate scripts and persistent style contexts.
Roundtable
A sophisticated prompting framework that simulates a multi-expert panel to provide diverse viewpoints and consensus for complex decision-making.
Humanizer
A writing editor skill designed to identify and eliminate the telltale signs of machine-generated text to restore natural human rhythm and voice.
Agent Guardrails
A mechanical enforcement suite that replaces soft markdown suggestions with hard git hooks and automated validation scripts for AI agents.
Morning (GreenInvoice) Accounting
A professional accounting automation tool to manage clients, items, and financial documents through the Morning (GreenInvoice) API.
Kazakhstan Tax Assistant (kz-tax-code)
A dual-language tax assistant designed to provide precise answers based on the official Tax Code of the Republic of Kazakhstan.
Featured*
