Hyperliquid API: руководство для новичков в 2026 году

• hyperliquid api
• руководство по hyperliquid api
• туториал Hyperliquid API
• API для ончейн-трейдинга

Если ты хочешь торговать ончейн-бессрочниками программно, Hyperliquid API — один из самых близких к CEX по ощущениям вариантов среди ончейн-DEX. Он дает доступ к рыночным данным, состоянию аккаунта, выставлению и отмене ордеров, а через WebSocket — к потоковым данным в реальном времени. Этого достаточно как для простых алертов и ботов, так и для более сложных квант-стратегий и маркет-мейкинга.

Этот материал — практический старт для разработчика, который впервые смотрит в сторону Hyperliquid API: разберем структуру API, авторизацию, базовые примеры, WebSocket, типичные ошибки и безопасность ключей.

Что можно делать через Hyperliquid API

По официальной документации Hyperliquid API условно делится на три большие части:

Info Endpoints

Публичные информационные эндпоинты. Через них можно получать:

• снапшоты стакана;
• последние сделки;
• историю funding rate;
• позиции аккаунта;
• историю ордеров;
• метаданные рынков.

Для таких запросов подпись не нужна: данные публичны и доступны без авторизации.

Exchange Endpoints

Торговые эндпоинты для действий, которые меняют состояние аккаунта:

• выставление ордера;
• отмена ордера;
• изменение плеча;
• управление маржей;
• другие операции с позицией.

Здесь уже нужна подпись кошельком. Это критичная зона: ошибка в коде или утечка приватного ключа может привести к реальным убыткам.

WebSocket

WebSocket используется для подписки на данные в реальном времени:

• изменения стакана;
• поток сделок;
• события аккаунта;
• данные по funding rate.

Если стратегия должна быстро реагировать на рынок, без WebSocket обычно не обойтись.

Базовый URL и структура запросов

REST API Hyperliquid доступен по адресу:

https://api.hyperliquid.xyz

Все REST-запросы отправляются методом POST, тело запроса — JSON.

Основные пути:

• /info — публичные информационные запросы;
• /exchange — торговые операции, требующие подписи.

Конкретные поля и форматы нужно сверять с актуальной официальной документацией Hyperliquid. Примеры ниже подходят для старта, но перед использованием в проде обязательно проверь текущую спецификацию.

Как работает авторизация

Hyperliquid не использует классическую схему API Key + Secret, как многие централизованные биржи. Вместо этого торговые запросы подписываются через EIP-712 — формат структурированной подписи в Ethereum-экосистеме.

Это значит:

• тебе нужен Ethereum-совместимый адрес кошелька;
• каждый торговый запрос подписывается соответствующим приватным ключом;
• подпись доказывает, что действие авторизовано владельцем адреса;
• отдельный API-ключ, который можно украсть, не создается.

С точки зрения архитектуры это выглядит безопаснее, чем хранение биржевого API secret на сервере. Но есть важный нюанс: вся безопасность теперь упирается в приватный ключ. Если он утечет, злоумышленник сможет формировать валидные подписи и управлять аккаунтом.

Именно здесь полезен OneKey. Аппаратный кошелек OneKey хранит приватный ключ изолированно, а подпись выполняется внутри устройства — ключ не попадает на компьютер или в сеть. Для API-трейдинга разумный подход — не использовать основной кошелек, а создать отдельный аккаунт или субаккаунт с ограниченным капиталом и понятными лимитами риска.

Если тебе не нужен собственный бот, но ты хочешь торговать бессрочниками более безопасным и понятным способом, практичный вариант — использовать OneKey Perps внутри экосистемы OneKey: так можно держать рабочий процесс ближе к кошельку и не тащить приватные ключи в самописные скрипты без необходимости.

Пример Info-запроса: Python и curl

Начнем с самого простого: запросим метаданные всех доступных торговых активов.

curl

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

Python

import requests
import json

url = "https://api.hyperliquid.xyz/info"
payload = {"type": "meta"}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)
data = response.json()

print(json.dumps(data, indent=2))

В ответе будут базовые данные по торгуемым контрактам: название актива, максимальное плечо, минимальный размер ордера и другие параметры. Такие запросы публичны, не требуют подписи и хорошо подходят для первого знакомства с API.

Как запросить позиции аккаунта

Состояние позиций конкретного адреса тоже относится к Info-запросам. Нужно передать адрес кошелька:

payload = {
    "type": "clearinghouseState",
    "user": "0xYOUR_WALLET_ADDRESS"
}

response = requests.post(url, json=payload, headers=headers)

Ответ содержит данные вроде баланса маржи, открытых позиций, нереализованного PnL и параметров по рынкам.

Важно: это публичные ончейн-данные. Любой может запросить состояние любого адреса. Если ты строишь стратегию или публично показываешь адрес, учитывай, что позиции и риск-профиль могут быть видны другим участникам рынка.

WebSocket: подписка на стакан

WebSocket endpoint:

wss://api.hyperliquid.xyz/ws

Пример подписки на L2-стакан BTC:

import asyncio
import websockets
import json

async def subscribe_orderbook():
    uri = "wss://api.hyperliquid.xyz/ws"

    async with websockets.connect(uri) as ws:
        sub_msg = {
            "method": "subscribe",
            "subscription": {
                "type": "l2Book",
                "coin": "BTC"
            }
        }

        await ws.send(json.dumps(sub_msg))

        while True:
            msg = await ws.recv()
            data = json.loads(msg)
            print(data)

asyncio.run(subscribe_orderbook())

Через WebSocket можно подписываться на разные типы данных, включая:

• l2Book — L2-стакан;
• trades — последние сделки;
• userEvents — события пользователя;
• глобальные данные по funding rate.

Для стратегий, которые зависят от скорости реакции, WebSocket обычно лучше, чем частый polling через REST.

Частые ошибки при работе с Hyperliquid API

Неверный формат JSON

Hyperliquid API достаточно строго относится к типам и названиям полей. Если поле должно быть числом, а ты передал строку, запрос может быть отклонен. Иногда текст ошибки не сразу объясняет проблему, поэтому при отладке лучше буквально сверять payload с документацией.

Ошибки в EIP-712 подписи

Подпись — одна из самых сложных частей. EIP-712 включает структуру типов, домен, порядок полей и другие детали. Реализовать это вручную можно, но легко ошибиться.

На практике лучше сначала посмотреть официальные и community SDK для Hyperliquid на Python или JavaScript. SDK обычно уже закрывает большую часть рутины: форматирование запроса, подпись и отправку.

Проблемы со временем

Торговые запросы часто завязаны на текущий timestamp и ограниченное окно валидности. Если локальные часы сильно расходятся с сетевым временем, запрос может считаться просроченным.

Для серверов с торговыми ботами стоит настроить синхронизацию времени и мониторить дрейф часов.

Обрывы WebSocket

В продакшене WebSocket-соединение не будет жить идеально вечно. Возможны сетевые сбои, реконнекты, временные ошибки сервера.

Минимальный набор для надежного клиента:

• heartbeat или ping/pong;
• автоматическое переподключение;
• повторная подписка после реконнекта;
• обработка дубликатов и пропущенных данных;
• логирование ошибок.

Слишком агрессивные ретраи

Если REST-запрос получил временную ошибку, не стоит бесконечно долбить endpoint в цикле. Нужны лимиты, backoff и понятная логика остановки стратегии. Особенно это важно для торговых операций: повторный запрос может привести к неожиданному состоянию ордеров.

Rate limits: что нужно учитывать

У Hyperliquid разные лимиты для разных типов endpoint. Конкретные значения нужно смотреть в актуальной официальной документации.

Общее правило такое:

• Info-запросы обычно менее чувствительны;
• Exchange-запросы ограничиваются строже;
• стратегии с частыми выставлениями и отменами ордеров должны особенно внимательно следить за лимитами.

Если получаешь ошибку 429, лучше сразу снизить частоту запросов и использовать экспоненциальный backoff, а не просто повторять запросы с той же скоростью.

Рекомендации по среде разработки

Перед запуском стратегии на реальные деньги стоит пройти несколько этапов.

Начни с малой позиции

Не запускай новый бот сразу на крупный депозит. Даже если код выглядит правильно, реальные рынки быстро находят ошибки в логике.

По открытым сообщениям, у Hyperliquid нет отдельной полноценной тестовой сети для тестирования торговли бессрочниками в условиях, полностью аналогичных продакшену. Поэтому первые реальные тесты стоит проводить с минимальным размером позиции и заранее заданным лимитом убытка.

Изолируй ключи

Не используй основной кошелек для API-торговли. Лучше создать отдельный адрес или субаккаунт, перевести туда ограниченную сумму и работать только с ней.

OneKey удобен для такой схемы: можно управлять несколькими аккаунтами, разделять основной капитал и торговый аккаунт, а подписи выполнять через аппаратный кошелек. Это не отменяет риск стратегии, но снижает риск компрометации основного приватного ключа.

Если не нужен код — используй OneKey Perps

Не всем нужен собственный API-бот. Если твоя задача — просто торговать перпами, контролировать плечо и не усложнять себе жизнь инфраструктурой, проще начать с OneKey Perps. Это более практичный workflow для большинства пользователей, чем хранить ключи на сервере и поддерживать самописную торговую систему.

Попробуй OneKey: скачай приложение с официального сайта OneKey, настрой отдельный аккаунт для торговли и используй OneKey Perps с понятным размером позиции и контролем риска.

Следи за открытыми ордерами

У автоматических стратегий часто возникают «зависшие» ордера: бот перезапустился, сеть оборвалась, локальное состояние не совпало с биржевым. Поэтому полезно регулярно сверять:

• открытые ордера;
• размер позиции;
• маржу;
• ликвидационную цену;
• историю ошибок.

FAQ

Q1: Для Hyperliquid API нужно регистрировать аккаунт?

Нет, классическая регистрация не нужна. Тебе нужен Ethereum-совместимый кошелек. После первого взаимодействия с Hyperliquid, например пополнения, адрес можно использовать для API-операций. Обычно не требуется email-регистрация или KYC, но всегда проверяй актуальные условия сервиса.

Q2: Есть ли SDK для Python?

Да, доступны официальные и community SDK. Лучше искать актуальную версию в официальных репозиториях Hyperliquid и проверять, поддерживается ли она сейчас. SDK помогает не писать вручную EIP-712 подписи и снижает риск ошибок в формате запросов.

Q3: Как правильно делать reconnect для WebSocket?

Добавь heartbeat, обработку исключений и автоматический reconnect. После разрыва соединения подожди короткую паузу, например 1–5 секунд, затем подключись заново и повторно подпишись на нужные каналы. Для серии ошибок лучше использовать экспоненциальный backoff, чтобы не создавать лишнюю нагрузку.

Q4: Как защитить средства при API-трейдинге?

Главное — защита приватного ключа и ограничение риска. Используй отдельный торговый аккаунт, не держи на нем весь капитал, регулярно проверяй позиции и открытые ордера. Аппаратный кошелек OneKey помогает изолировать приватный ключ от компьютера и сети, но он не защищает от ошибок стратегии, неверного плеча или резких движений рынка.

Q5: Hyperliquid API поддерживает стопы и условные ордера?

Hyperliquid поддерживает trigger orders, включая логику стоп-лосса и тейк-профита. Конкретные параметры, типы ордеров и условия срабатывания нужно смотреть в официальной документации в разделе про order types. Более сложную условную логику можно реализовать на уровне стратегии, отслеживая позиции и рынок через API.

Итоги

Hyperliquid API дает разработчику полноценный набор инструментов для ончейн-трейдинга: публичные данные через Info endpoints, торговые операции через Exchange endpoints и потоковые обновления через WebSocket. На этой базе можно строить мониторинг, алерты, простых торговых ботов и более сложные стратегии.

Но API-трейдинг — это не только код. EIP-712 подписи делают модель авторизации более крипто-нативной, но одновременно повышают требования к хранению приватного ключа. Отдельный торговый аккаунт, ограниченный капитал, контроль плеча и аппаратное хранение ключей — базовые элементы безопасного workflow.

Если ты хочешь разрабатывать собственную интеграцию, начни с Info endpoints, затем переходи к WebSocket и только после этого тестируй торговые операции на малом размере позиции. Если же тебе нужен практичный способ торговать бессрочниками без поддержки собственного бота, скачай OneKey, настрой кошелек и попробуй OneKey Perps с осторожным управлением риском.

Дисклеймер

Материал предназначен только для технического ознакомления и не является инвестиционной, финансовой или юридической рекомендацией. API-трейдинг связан с рисками автоматизации: ошибка в стратегии или коде может привести к неожиданным крупным убыткам. Торговля бессрочными контрактами с плечом крайне рискованна. Участвуй только после того, как понимаешь технические и рыночные риски. Прошлые результаты стратегий не гарантируют будущую доходность.