# Hyperliquid Data

Read Hyperliquid market data, account history and trades for review.

- Repository: https://github.com/NousResearch/hermes-agent (259479 stars)
- Category: Data and ML
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add NousResearch/hermes-agent --skill hyperliquid -g -a claude-code -y`
Codex: `npx skills add NousResearch/hermes-agent --skill hyperliquid -g -a codex -y`
Cursor: `npx skills add NousResearch/hermes-agent --skill hyperliquid -g -a cursor -y`
Gemini CLI: `npx skills add NousResearch/hermes-agent --skill hyperliquid -g -a gemini-cli -y`

## Description

Hyperliquid market data, account history, trade review.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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:

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

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

---

## Quick Reference

The rest: https://github.com/NousResearch/hermes-agent/blob/HEAD/optional-skills/blockchain/hyperliquid/SKILL.md