Agent skill · data analytics · nousresearch
hyperliquid
Hyperliquid market data, account history, trade review.
Why this skill is useful
Provides specific commands and patterns for querying Hyperliquid market data that the AI wouldn't reliably generate on its own.
What it needs
About 3k tokens when loaded. Last updated 2026-08-07. 226,679 stars on the source repository.
What this skill does
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 ${HERMESHOME:-~/.hermes}/.env for two optional defaults: HYPERLIQUIDAPIURL — defaults to https://api.hyperliquid.xyz. Set to https://api.hyperliquid-testnet.xyz for testnet. HYPERLIQUIDUSERADDRESS — 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/hyperliquidclient.py --- How to Run Invoke through the terminal tool: Add --json to any command for machine-readable output. --- Quick Reference For state, spot-balances, fills, orders, and review, the address is optional when HYPERLIQUIDUSERADDRESS is set in ${HERMESHOME:-~/.hermes}/.env. --- Procedure 1. Discover DEXs and Markets --dex only applies to perp endpoints; omit for the first perp dex. Spot pairs may show as PURR/USDC or aliases like @107. HIP-3 markets prefix the coin with the dex, e.g. mydex:BTC. 2. Pull Historical Market Data Time-range endpoints paginate. For larger windows, repeat with a later startTime or use export (below). 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/hyperliquid