Ошибки Hyperliquid

Hyperliquid — децентрализованная биржа, и ошибки у неё устроены иначе, чем у остальных. Числовых кодов нет: на отказ биржа отвечает английской фразой, например Order must have minimum value of $10. Ключей API в привычном виде тоже нет — подключение подписывает заявки приватным ключом кошелька или API-кошелька, а лимит запросов считается на адрес кошелька, а не на IP.

Если терминал не узнал отказ, во всплывающем сообщении после «Order:» будет ответ биржи в виде HL exchange error: Order must have minimum value of $10. asset=0. Отказ отмены выглядит как «Отмена отклонена: Hyperliquid cancel …». Общий порядок разбора — на странице Сообщения об ошибках: как читать, настройка подключения — в Подключение бирж и API-ключи.

Что терминал объясняет сам

Ситуация	Ответ биржи	Что вы увидите
Биржа не знает кошелька с этим ключом	«User or API Wallet 0x… does not exist.»	Плашка «…: биржа отвергла API-ключ или secret — проверьте их в настройках подключения», у подключения в Настройки → Подключения подсказка «Биржа отвергла API-ключ или secret»
Ключ API-кошелька, когда их поддержка отключена	—	«…: этот тип ключа не поддерживается. Для Hyperliquid нужен приватный ключ самого кошелька, а не API-кошелька (agent)»
Лимит запросов адреса исчерпан на вашем действии	HTTP 429	«Hyperliquid: лимит запросов (429), пауза ~… с — до … UTC. Бюджет запросов адреса восполняется торговым объёмом (1 запрос за 1 USDC).»
То же на фоновом опросе	HTTP 429	Ничего: терминал молча выдерживает паузу
Комиссия билдера LootX не одобрена	«Builder fee has not been approved»	Ничего: терминал сразу переотправляет ту же заявку без комиссии билдера
Баланс лежит на спотовой части единого счёта	—	Терминал показывает этот баланс как маржу фьючерсов. Подробнее — ниже
Стоп в шорт без открытой позиции	—	Запись в логе «Hyperliquid: стоп в шорт без открытой позиции биржа исполнит как reduce-only и отклонит». Заявка всё равно отправляется

Частые коды

Кодов у Hyperliquid нет — причину называет фраза биржи, поэтому в таблице вместо кода стоит она. Все эти фразы видны как текст биржи в сообщении заявки.

Ответ биржи	Причина	Что делать
«Order must have minimum value of $10.»	Сумма фьючерсной заявки меньше 10 USDC	Увеличьте объём
«Order must have minimum value of 10 …»	То же на споте: сумма меньше 10 единиц котируемой монеты	Увеличьте объём
«Insufficient margin to place order.»	Не хватает маржи с учётом плеча и открытых позиций	Уменьшите объём или плечо, пополните счёт — см. Баланс ноль или маржа не та
«(Spot-only) Order has insufficient spot balance to trade»	На споте не хватает монет или USDC	Уменьшите объём, снимите лишние заявки
«Reduce only order would increase position.»	Заявка на закрытие увеличила бы позицию: позиции нет или она в другую сторону	Проверьте позицию. Стоп в шорт без позиции Hyperliquid считает закрывающим — см. Что терминал объясняет сам
«Price must be divisible by tick size.»	Цена не по шагу цены монеты	Выставьте цену по сетке стакана
«Order price too far from oracle»	Цена слишком далеко от цены оракула	Поставьте заявку ближе к рынку
«Post only order would have immediately matched, bbo was …»	Заявка «только мейкер» исполнилась бы сразу	Отодвиньте цену от лучшей встречной
«Order could not immediately match against any resting orders.»	Заявка «исполнить сразу» не нашла встречных заявок	Повторите или поставьте лимитную заявку
«No liquidity available for market order.»	В стакане нет ликвидности под рыночную заявку	Используйте лимитную заявку
«Invalid TP/SL price.»	Цена срабатывания стопа не с той стороны от рынка	Проверьте цену стопа
«Order would cause position to exceed margin tier limit at current leverage»	Позиция превысит лимит для текущего плеча	Уменьшите объём или плечо
«Order would increase open interest while open interest is capped»	По монете достигнут предел открытого интереса	Дождитесь, пока предел освободится, или только закрывайте позицию

Как исправить частые проблемы

Биржа отвергла ключ

У подключения Hyperliquid одно поле — Private Key / Seed: приватный ключ 0x… или сид-фраза. Отказ «User or API Wallet 0x… does not exist.» значит, что Hyperliquid не нашёл счёта по адресу, который получился из вашего ключа.

Проверьте ключ

Вставьте ключ заново целиком, без пробелов по краям. Ошибка в одном символе даёт другой адрес — чужой и пустой.

Проверьте, что у кошелька есть счёт на Hyperliquid

Если это ключ основного кошелька, на него должен быть сделан депозит на Hyperliquid — без него счёта у биржи нет.

Если это API-кошелёк — проверьте, что он жив

Откройте раздел API на сайте Hyperliquid и убедитесь, что API-кошелёк не удалён. Если удалён — создайте новый и вставьте его приватный ключ.

Ключ API-кошелька (agent)

На сайте Hyperliquid можно создать API-кошелёк — отдельный ключ, который торгует от имени основного кошелька, но не может выводить деньги. Такой ключ можно вставить в Private Key / Seed: терминал сам спросит у биржи, какому основному кошельку он принадлежит, и покажет баланс, позиции и заявки этого кошелька.

Пока биржа не ответила, чей это ключ, терминал не показывает позицию и баланс, а повторяет вопрос — иначе он прочитал бы пустой счёт самого API-кошелька и показал нули.

Сообщение «этот тип ключа не поддерживается» появляется, только если приём ключей API-кошельков временно отключён на стороне LootX. Тогда вставьте приватный ключ основного кошелька. Подробнее — в Сообщениях терминала.

Комиссия билдера

К заявкам Hyperliquid терминал добавляет комиссию билдера LootX. Её один раз одобряет подписью основной кошелёк; с ключом основного кошелька терминал делает это сам.

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

Баланс ноль или маржа не та

По умолчанию счёт Hyperliquid — единый: деньги спота и фьючерсов лежат вместе, и биржа показывает их на спотовой части. Терминал это учитывает: если маржа фьючерсов равна нулю, а на споте есть USDC, он берёт баланс со спота.

Если на Hyperliquid у вас включён ручной режим с раздельными балансами, это даёт одну неточность: при пустой фьючерсной части терминал покажет спотовые USDC как доступную маржу, а биржа отклонит заявку с «Insufficient margin to place order.». Переведите USDC со спота на фьючерсы на сайте Hyperliquid.

Лимит запросов адреса

У Hyperliquid запас запросов считается на адрес кошелька и пополняется не временем, а торговым объёмом — 1 запрос за 1 USDC оборота, как и сказано в плашке. Когда запас исчерпан, биржа отвечает 429. Терминал показывает плашку, только когда ограничение помешало вашему действию — выставлению или отмене заявки; фоновые опросы он в таком случае просто притормаживает.

Спот и фьючерсы одного кошелька тратят общий запас. Смена IP или прокси здесь обычно не помогает — лимит привязан к адресу. Дождитесь конца паузы; запас пополняется по мере торговли.

Рынки HIP-3

Кроме основных фьючерсов, на Hyperliquid есть рынки HIP-3 — контракты, которые запускают сторонние биржи-деплоеры, с названиями вида xyz:AAPL. Они торгуются через подключение с включённым Фьючерс. Многие такие рынки допускают только изолированную маржу. При смене плеча терминал не меняет режим маржи монеты сам по себе: на рынке «только изолированная» ставит изолированную, если режим известен — сохраняет его, а если прочитать режим не удалось — для HIP-3 выбирает изолированную. Сменить режим маржи при открытой позиции Hyperliquid не даст — если плечо не меняется, прочитайте текст в плашке «Плечо … ×… не изменено: …».

Дальше

Сообщения об ошибках

Где терминал показывает ошибки и как их читать.

Подключение бирж

Как добавить подключение и вставить ключ кошелька.

Ошибки Aster

Два способа подписи, кошелёк и Account Id, бан по IP.