A read-only integration to monitor Hyperliquid DEX perpetual positions, account balances, and margin risk data.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hyperliquid-dex
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-dex 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 DEX Integration?
The hyperliquid skill provides developers and traders with a seamless way to query the Hyperliquid decentralized exchange (DEX). By integrating this into your workflow, you can access real-time data regarding account value, free collateral, and margin usage without needing to sign transactions or share private keys. This tool is a core part of the Openclaw Skills ecosystem, offering a secure proxy architecture to fetch data directly from the Hyperliquid public API via a dedicated gateway.
Designed for speed and reliability, this skill allows users to maintain a bird's-eye view of their DeFi derivatives portfolio. Whether you are managing cross-margin positions or tracking liquidation risks, this addition to the Openclaw Skills library ensures you have actionable data at your fingertips without the complexity of manual API calls.
Hyperliquid DEX Integration Use Cases
- Monitoring unrealized PnL and return on equity (ROE) for active perpetual positions across various crypto assets.
- Checking account health metrics such as liquidation prices and leverage ratios to prevent forced liquidations.
- Tracking multiple wallet addresses or a primary trading wallet to see total collateral and margin availability.
- Automating portfolio reporting and risk assessment for Hyperliquid traders via agentic workflows.
How Hyperliquid DEX Integration Works
- The user triggers the skill using natural language or a specific wallet address query.
- The request is sent to the ClawdBot gateway which acts as a secure intermediary.
- The gateway forwards the request to the API server which communicates with the official Hyperliquid public info endpoint.
- The API server parses raw data into a human-readable format, calculating return on equity and position notional values.
- The processed account and position data is returned to the agent with built-in 15-second timeout protection.
Hyperliquid DEX Integration Setup
To get started with this entry in the Openclaw Skills registry, you simply need to configure your environment variables if you wish to use a default wallet.
# Optional: Set a default wallet to query when no address is provided
export TRADING_WALLET_ADDRESS="0xYourWalletAddressHere"
No private keys or signing permissions are required, as the skill only interacts with public blockchain data via read-only endpoints.
Hyperliquid DEX Integration Data Schema & Taxonomy
The skill returns a structured JSON object containing comprehensive account and position metadata. This data is part of the standard output for Openclaw Skills in the finance category:
| Section | Description |
|---|---|
| account | Contains accountValue, freeCollateral, and totalMarginUsed. |
| positions | A list of active trades including coin name, size, entry price, and direction. |
| metrics | Real-time calculation of unrealizedPnl and returnOnEquity. |
| risk | Vital data points like liquidationPrice and leverage type (e.g., cross). |
Hyperliquid DEX Integration Advanced Features
- Multi-wallet support enables querying any valid 0x wallet address dynamically through the agent interface.
- Automatic timeout protection ensures that the Openclaw Skills integration remains responsive by cutting off hanging requests after 15 seconds.
- Read-only security architecture ensures that your funds remain safe as no trading or signing capabilities are exposed.
- Seamless interoperability with other Openclaw Skills such as Ichimoku cloud signals or general crypto trackers for a complete trading terminal experience.
SKILL.md
Loading
Related Openclaw Skills
Gamification & XP System
A comprehensive XP and achievement system that transforms daily productivity into a rewarding game-like experience.
Neo App Mode
A high-speed full-stack application generator that scaffolds production-ready MERN stack projects using clean MVC architecture.
Warehouse Chart Reports
A visual reporting toolkit that transforms warehouse database records into professional charts, table images, and KPI summaries.
Skill Creator
A comprehensive framework and toolkit for developing modular extensions that equip AI agents with specialized procedural knowledge and automated workflows.
Just Fucking Cancel
A privacy-first subscription auditor that identifies recurring charges from bank transactions and provides direct links to cancel unwanted services.
Language Learning Tutor
Transform your AI agent into a polyglot language tutor with customizable lessons, flashcards, and real-world conversation practice.
Featured*
