Hyperliquid

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

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


Источник	Опционально — установка через `vibeos skills install official/blockchain/hyperliquid`
Путь	`optional-skills/blockchain/hyperliquid`
Версия	`0.1.0`
Автор	Hugo Sequier (Hugo-SEQUIER), VibeOS
Лицензия	MIT
Платформы	linux, macos, windows
Теги	`Hyperliquid`, `Blockchain`, `Crypto`, `Trading`, `Perpetuals`, `Spot`, `DeFi`

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

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

Навык Hyperliquid

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

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

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

Пользователь запрашивает данные по перпетуалам или спотовым рынкам Hyperliquid, свечи, funding или L2 стакан
Пользователь хочет просмотреть перп-позиции, спотовые балансы, сделки или ордера кошелька
Пользователь хочет получить послеторговый анализ, объединяющий недавние сделки с рыночным контекстом
Пользователь хочет просмотреть развернутые билдерами перп DEX или рынки HIP-3
Пользователь хочет получить нормализованный JSON-экспорт свечей и funding для подготовки к бэктестингу

Предварительные требования

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

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

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

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

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

Как запускать

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

python3 ~/.vibeos/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py <команда> [аргументы]

Добавьте --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 <монета> [--interval 1h] [--hours 24] [--limit N]
hyperliquid_client.py funding <монета> [--hours 72] [--limit N]
hyperliquid_client.py l2 <монета> [--levels N]
hyperliquid_client.py state [адрес] [--dex DEX]
hyperliquid_client.py spot-balances [адрес] [--limit N]
hyperliquid_client.py fills [адрес] [--hours N] [--limit N] [--aggregate-by-time]
hyperliquid_client.py orders [адрес] [--limit N]
hyperliquid_client.py review [адрес] [--coin МОНЕТА] [--hours N] [--fills N]
hyperliquid_client.py export <монета> [--interval 1h] [--hours N] [--output ПУТЬ]

Для state, spot-balances, fills, orders и review адрес опционален, если HYPERLIQUID_USER_ADDRESS задан в ${VIBEOS_HOME:-~/.vibeos}/.env.

Процедура

1. Обнаружение DEX и рынков

python3 ~/.vibeos/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py dexs

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

python3 ~/.vibeos/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  spots --limit 15

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

2. Получение исторических рыночных данных

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

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

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

3. Просмотр книги ордеров в реальном времени

python3 ~/.vibeos/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  l2 BTC --levels 10

Используйте, когда запрашивают глубину книги, краткосрочную ликвидность или потенциальное влияние на рынок крупного ордера.

4. Просмотр аккаунта

python3 ~/.vibeos/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  state 0xabc...

python3 ~/.vibeos/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  spot-balances

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

5. Просмотр сделок и ордеров

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

python3 ~/.vibeos/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  orders --limit 25

6. Генерация анализа сделок

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

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

Сообщает реализованную PnL, комиссии, количество прибыльных/убыточных сделок, разбивку по монетам, рыночный тренд и средний funding для каждой торгуемой перп-позиции, а также эвристики (проскальзывание от комиссий, концентрация, убытки против тренда).

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

7. Экспорт набора данных для повторного использования

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

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

Выходной JSON содержит: версию схемы, метаданные источника, точное временное окно, нормализованные строки свечей, нормализованные строки funding, сводную статистику. Используйте --end-time-ms для воспроизводимых окон.

Подводные камни

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

Проверка

python3 ~/.vibeos/skills/blockchain/hyperliquid/scripts/hyperliquid_client.py \
  markets --limit 5

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

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

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

Навык Hyperliquid

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

Предварительные требования​

Как запускать​

Краткая справка​

Процедура​

1. Обнаружение DEX и рынков​

2. Получение исторических рыночных данных​

3. Просмотр книги ордеров в реальном времени​

4. Просмотр аккаунта​

5. Просмотр сделок и ордеров​

6. Генерация анализа сделок​

7. Экспорт набора данных для повторного использования​

Подводные камни​

Проверка​