hyperliquid

What This Skill Does

The Hyperliquid DEX skill provides a secure, read-only interface to track your decentralized perpetuals portfolio directly through OpenClaw. By acting as a specialized client for the Hyperliquid API, this skill translates raw blockchain data into a human-readable dashboard of your financial status. It retrieves comprehensive account metrics, including your total account value, free collateral, and margin utilization. Beyond simple balances, the skill excels at granular position tracking—providing real-time snapshots of every open trade, including entry price, current position value, and unrealized PnL (profit and loss). It is designed for traders who need quick, on-demand insights into their risk profile, specifically offering visibility into liquidation prices and active leverage settings. Because it utilizes ClawdBot as a proxy, the skill benefits from standardized error handling and connection pooling, ensuring that your queries are delivered reliably even during periods of high network congestion.

Installation

To integrate this capability into your agent, run the following command in your terminal:

clawhub install openclaw/skills/skills/chipagosfinest/hyperliquid-dex

Ensure that you have set the TRADING_WALLET_ADDRESS environment variable if you wish to query your primary wallet without explicitly specifying the address in every prompt.

Use Cases

This skill is indispensable for active traders managing complex perp portfolios. Use it to monitor your collateral ratios during high market volatility to prevent unexpected liquidations. Institutional and retail traders alike can use it to maintain "at-a-glance" awareness of their net exposure, making it easy to decide whether to add margin or hedge existing positions. It is also an excellent tool for post-trade analysis, allowing you to quickly verify realized results against your expectations without needing to constantly open the web-based exchange interface.

Example Prompts

1. "What is my current account value and how much free collateral do I have left on Hyperliquid?"
2. "Show me all my open positions on Hyperliquid, including the unrealized PnL for each."
3. "Am I at risk of liquidation on any of my ETH or BTC positions right now?"

Tips & Limitations

This skill is strictly limited to read-only access. It cannot execute trades, modify leverage, or sign transactions, ensuring that your assets remain secure from accidental or malicious trades. The data is fetched in real-time, but users should note the 15-second timeout protection; if network conditions are poor, the agent may report a request timeout. Since it relies on the public Hyperliquid info API, you do not need to provide private keys, ensuring your funds stay strictly in your custody. If you manage multiple accounts, simply provide the wallet address in your request to switch contexts seamlessly.