Hyperliquid API: Документация, Agent Keys и Интеграции

В отличие от большинства DEX, использующих офф-чейн движки или L2-решения, Hyperliquid функционирует как специализированный Layer-1 блокчейн. Все ордера сводятся on-chain в движке HyperCore со скоростью до 200,000 ордеров в секунду и медианной задержкой менее 0.2 секунд. Главное преимущество архитектуры — полное отсутствие комиссий за газ (Zero Gas Fees) при размещении, модификации или отмене ордеров.

Безопасность API: Делегирование через Agent Wallets

Благодаря сверхнизким комиссиям (Base Tier: 0.015% maker / 0.045% taker) и обеспечению в нативном USDC, API Hyperliquid идеально подходит для ресурсоемких алгоритмических стратегий:

• Маркетмейкинг и HLP: Поддержание ликвидности в стакане ордеров (предоставление лимитных заявок по краям спреда). Поскольку отмена ордеров не стоит газа, HFT-боты могут корректировать котировки сотни раз в минуту. VIP-тиры позволяют достичь отрицательных maker-комиссий (ребейтов).
• Арбитраж ставки финансирования (Funding Arbitrage): Высокочастотные дельта-нейтральные стратегии между бессрочными фьючерсами Hyperliquid (Perps) и централизованными биржами.
• Торговля Pre-Launch маркетами: Использование API для быстрого скальпинга на эксклюзивных HIP-3 рынках и рынках предсказаний, недоступных на традиционных CEX.

→ Актуальные объемы и метрики ликвидности Hyperliquid

Процесс инициализации для разработчиков включает создание изолированного агента:

1. Подключение L1 Wallet (Master Account): Подключите ваш EVM-кошелек (MetaMask, Rabby) в интерфейсе платформы. Ваш публичный адрес (0x...) — это идентификатор вашего аккаунта.
2. Создание Agent Wallet: В интерфейсе биржи перейдите в раздел API (или More -> API). Нажмите «Generate API Wallet».
3. Сохранение Private Key: Система сгенерирует криптографическую пару. Обязательно скопируйте Private Key этого Agent Wallet. Это ваш эквивалент "API Secret".
4. Авторизация (Approve): Подпишите on-chain транзакцию в вашем Master Wallet, чтобы авторизовать Agent Wallet. По умолчанию срок делегирования прав составляет 90 дней, но его можно увеличить вплоть до максимальных 180 дней (параметр valid_until в коде или выбор опции MAX в интерфейсе платформы).

Важно: В вашем торговом скрипте вы будете указывать публичный адрес Master Account как цель для торговли, и Private Key Agent Wallet для криптографического подписания payload-а.

В отличие от классического REST, Hyperliquid группирует запросы в два глобальных эндпоинта. Практически все запросы (даже на чтение) отправляются методом POST с JSON-телом, указывающим тип действия.

• Чтение данных (/info): Эндпоинт https://api.hyperliquid.xyz/info. Используется для получения стакана ордеров (l2Book), свечей (candleSnapshot), истории сделок и информации о пользователе. Не требует авторизации.
• Торговые операции (/exchange): Эндпоинт https://api.hyperliquid.xyz/exchange. Используется для размещения/отмены ордеров и переводов. Требует локальной EIP-712 подписи с использованием вашего Agent Private Key.

Справочник сред (Environments)

• Mainnet REST: https://api.hyperliquid.xyz
• Mainnet WebSocket: wss://api.hyperliquid.xyz/ws
• Testnet REST: https://api.hyperliquid-testnet.xyz

Для создания стабильного торгового клиента важно обрабатывать ошибки на уровне L1:

Поскольку формирование EIP-712 подписей "с нуля" может быть сложной задачей, рекомендуется использовать готовые клиентские библиотеки:

• Python SDK (Official): hyperliquid-python-sdk — включает примеры подключения API Wallet и подписи ордеров.
• Rust SDK: hypersdk — высокопроизводительный клиент для HFT-стратегий от комьюнити.
• TypeScript/Node.js: Различные комьюнити-реализации или библиотека CCXT.

Проверка доступности и получение метаданных (Public API)

Используйте метод POST к эндпоинту /info для получения списка торговых пар:

curl -X POST https://api.hyperliquid.xyz/info \
  -H "Content-Type: application/json" \
  -d '{"type": "meta"}'

Node.js: Получение книги ордеров L2 (Axios)

Пример получения L2 Orderbook по паре BTC (все пары котируются к нативному USDC):

const axios = require('axios');

async function getOrderbook() {
  try {
    const response = await axios.post('https://api.hyperliquid.xyz/info', {
      type: 'l2Book',
      coin: 'BTC'
    });
    console.log("Ask ордера (верх стакана):", response.data.levels[1].slice(0, 5));
    console.log("Bid ордера (низ стакана):", response.data.levels[0].slice(0, 5));
  } catch (error) {
    console.error("Ошибка API:", error.response ? error.response.data : error.message);
  }
}

getOrderbook();

Алгоритмическая торговля через CCXT

Hyperliquid официально поддерживается глобальной крипто-библиотекой CCXT. Это позволяет разработчикам использовать стандартизированный синтаксис (например, createOrder, fetchBalance) на Python, JavaScript и PHP. Достаточно передать walletAddress и privateKey (вашего Agent-кошелька) при инициализации класса биржи в CCXT.

Терминалы и Конструкторы ботов

Такие платформы, как Tealstreet, Gainium и FMZ Quant, имеют нативную интеграцию с Hyperliquid. Для подключения вам потребуется скопировать ваш EVM-адрес аккаунта и сгенерированный в интерфейсе Hyperliquid закрытый ключ API-агента, вставив их в настройки стороннего терминала. Это избавит вас от необходимости разворачивать собственную серверную инфраструктуру.