Hyperliquid Skill

Query Hyperliquid market and account data through the public /info endpoint. Read-only, no API key, no signing, no order placement.

12 commands: dexs, markets, spots, candles, funding, l2, state, spot-balances, fills, orders, review, export. Stdlib only (urllib, json, argparse).

---

When to Use

• User asks for Hyperliquid perp or spot market data, candles, funding, or L2 book
• User wants to inspect a wallet's perp positions, spot balances, fills, or orders
• User wants a post-trade review combining recent fills with market context
• User wants to inspect builder-deployed perp dexs or HIP-3 markets
• User wants a normalized JSON export of candles + funding for backtesting prep

---

Prerequisites

Stdlib only, no external packages, no API key.

The script reads ${HERMES_HOME:-~/.hermes}/.env for two optional defaults:

• HYPERLIQUID_API_URL, defaults to https://api.hyperliquid.xyz. Set to https://api.hyperliquid-testnet.xyz for testnet.
• HYPERLIQUID_USER_ADDRESS, default address for state, spot-balances, fills, orders, and review. If unset, pass the address as the first positional argument.

A project .env in the current working directory is honored as a dev fallback.

Helper script: ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py

---

How to Run

Invoke through the terminal tool:

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py <command> [args]

Add --json to any command for machine-readable output.

---

Quick Reference