Hyperliquid

Рыночные данные Hyperliquid, история аккаунта, разбор сделок.

Метаданные навыка

Справочник: полный SKILL.md

Hyperliquid Skill

Запрашивает рыночные и аккаунтные данные Hyperliquid через публичный эндпоинт /info. Только чтение — без API-ключа, без подписи, без выставления ордеров.

12 команд: dexs, markets, spots, candles, funding, l2, state, spot-balances, fills, orders, review, export. Только стандартная библиотека (urllib, json, argparse).

---

Когда использовать

• Нужны рыночные данные Hyperliquid по perp- или спот-рынкам: свечи, фандинг, стакан L2
• Нужно проверить perp-позиции кошелька, спот-балансы, исполненные сделки или ордера
• Нужен разбор сделок: последние fills в связке с рыночным контекстом
• Нужно изучить perp-DEX-ы от билдеров или HIP-3-рынки
• Нужен нормализованный JSON-экспорт свечей и фандинга для подготовки бэктестинга

---

Требования

Только стандартная библиотека — никаких внешних пакетов, никакого API-ключа.

Скрипт читает ${HERMES_HOME:-~/.hermes}/.env для двух необязательных значений по умолчанию:

• HYPERLIQUID_API_URL — по умолчанию https://api.hyperliquid.xyz. Для тестнета укажите https://api.hyperliquid-testnet.xyz.
• HYPERLIQUID_USER_ADDRESS — адрес по умолчанию для команд state, spot-balances, fills, orders и review. Если не задан, передайте адрес первым позиционным аргументом.

Файл .env в текущей рабочей директории проекта учитывается как запасной вариант при разработке.

Вспомогательный скрипт: ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py

---

Запуск

Вызывать через инструмент terminal:

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

Добавьте --json к любой команде для машиночитаемого вывода.

---

Краткий справочник

hyperliquid_client.py dexs
hyperliquid_client.py markets [--dex DEX] [--limit N] [--sort volume|oi|funding_abs|change_abs|name]
hyperliquid_client.py spots [--limit N]
hyperliquid_client.py candles <coin> [--interval 1h] [--hours 24] [--limit N]
hyperliquid_client.py funding <coin> [--hours 72] [--limit N]
hyperliquid_client.py l2 <coin> [--levels N]
hyperliquid_client.py state [address] [--dex DEX]
hyperliquid_client.py spot-balances [address] [--limit N]
hyperliquid_client.py fills [address] [--hours N] [--limit N] [--aggregate-by-time]
hyperliquid_client.py orders [address] [--limit N]
hyperliquid_client.py review [address] [--coin COIN] [--hours N] [--fills N]
hyperliquid_client.py export <coin> [--interval 1h] [--hours N] [--output PATH]

Для команд state, spot-balances, fills, orders и review адрес необязателен, если в ${HERMES_HOME:-~/.hermes}/.env задан HYPERLIQUID_USER_ADDRESS.

---

Порядок работы

1. Обзор DEX-ов и рынков

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py dexs

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  markets --limit 15 --sort volume

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  spots --limit 15

• --dex работает только для perp-эндпоинтов; без него берётся первый perp-DEX.
• Спот-пары могут отображаться как PURR/USDC или через алиасы вида @107.
• В HIP-3-рынках монета имеет префикс DEX-а, например mydex:BTC.

2. Исторические рыночные данные

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  candles BTC --interval 1h --hours 72 --limit 48

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  funding BTC --hours 168 --limit 30

Эндпоинты с диапазоном времени поддерживают пагинацию. Для больших диапазонов повторяйте запрос с более поздним startTime или используйте команду export (см. ниже).

3. Текущий стакан

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  l2 BTC --levels 10

Подходит для вопросов о глубине стакана, краткосрочной ликвидности или влиянии крупного ордера на рынок.

4. Анализ аккаунта

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  state 0xabc...

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  spot-balances

state возвращает perp-позиции; spot-balances — спот-портфель. Используйте для ответов на вопросы «какие у меня позиции?», «что я держу?», «сколько можно вывести?».

5. Исполненные сделки и ордера

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  fills 0xabc... --hours 72 --limit 25

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  orders --limit 25

6. Разбор сделок

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  review 0xabc... --hours 72 --fills 50

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  review --coin BTC --hours 168

Отчёт показывает реализованный PnL, комиссии, соотношение прибыльных и убыточных сделок, разбивку по монетам, тренд рынка и средний фандинг для каждого торгуемого perp-а, а также эвристики: давление комиссий, концентрация позиций, убытки против тренда.

Для углублённого пост-трейд-анализа: начните с review, чтобы найти проблемные монеты или периоды → запросите fills и orders за этот период → запросите candles и funding по каждой монете → оцените качество решений отдельно от их результата.

7. Экспорт датасета

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  export BTC --interval 1h --hours 168 --output ./btc-1h-7d.json

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  export BTC --interval 15m --hours 72 --end-time-ms 1760000000000

JSON-файл содержит: версию схемы, метаданные источника, точное временно́е окно, нормализованные строки свечей, нормализованные строки фандинга, сводную статистику. Флаг --end-time-ms обеспечивает воспроизводимые временны́е окна.

---

Ограничения и подводные камни

• Публичные info-эндпоинты имеют ограничения по частоте запросов. При больших исторических запросах ответ может содержать усечённое окно — итерируйте с более поздними значениями startTime.
• fills --hours ... использует userFillsByTime, который отдаёт только скользящее окно недавних данных — не весь архив.
• historicalOrders возвращает только последние ордера; полный экспорт недоступен.
• Команда review работает на эвристиках. По одним fills она не восстановит намерение трейдера, качество выставления ордеров или реальный слиппедж.
• Команда export записывает нормализованный датасет, а не движок бэктестинга. Собственная модель слиппеджа и исполнения по-прежнему на вас.
• Спот-алиасы вида @107 — валидные идентификаторы, даже если интерфейс показывает более читаемое имя.
• l2 — снимок в момент времени, не временной ряд.

---

Проверка

python ~/.hermes/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  markets --limit 5

Должна вывести топ perp-рынки Hyperliquid по условному объёму за 24 часа.