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

Проверьте три факта#

Не меняйте несколько настроек одновременно. Сначала ответьте на три вопроса:

1. Какое действие вы только что подтвердили?
2. Что именно написано в сообщении об ошибке?
3. Появился ли ордер, перевод или хэш в истории?

Сделайте снимок экрана с названием рынка, сетью или параметрами операции. Закройте личные данные и никогда не включайте seed-фразу, приватный ключ или одноразовый email-код. После этого обновите страницу и повторите действие один раз.

Если ошибка повторяется, проверьте официальный интерфейс и объявления Hyperliquid. Локальная проблема обычно остаётся только в одном браузере, аккаунте или операции; общий инцидент затрагивает несколько действий и пользователей.

Не приходит код или не подключается кошелёк#

При email-входе откройте «Спам» и используйте самый свежий шестизначный код. Старый код перестаёт подходить после нового запроса. Проверьте, что вводите тот же email, с которым открывали аккаунт раньше.

Для кошелька выполните короткую последовательность:

1. Разблокируйте расширение или мобильный кошелёк.
2. Выберите нужный публичный адрес.
3. Обновите официальный домен app.hyperliquid.xyz.
4. Отключите старое соединение и нажмите Connect ещё раз.
5. Откройте окно кошелька и подтвердите ожидающий запрос.

Если Enable Trading не появляется, разрешите всплывающее окно для официального домена. Подробный путь показан в инструкции по регистрации.

Потерян доступ к email-входу#

Используйте тот же адрес почты и запросите новый код только один раз. Проверьте папки «Спам» и «Промоакции»: после повторного запроса вводите самое свежее письмо, потому что прежний код уже может не подойти.

Если письма Privy перестали приходить после отметки сообщений как спам, официальный support guide рекомендует обратиться в поддержку Privy и попросить проверить доставку. Hyperliquid не может открыть другой email-аккаунт с теми же позициями: доступ связан с созданным для этой почты адресом.

Когда вход восстановлен, в настройках доступен экспорт email wallet. Сохраните приватный ключ только в собственном защищённом менеджере или импортируйте его в совместимый кошелёк; не отправляйте ключ поддержке и не вставляйте его в форму из сообщения.

Реферальный код не отображается#

Откройте Referrals после входа и убедитесь, что смотрите тот же аккаунт, который использовали при переходе. Если вы ещё не завершили создание аккаунта, снова откройте партнёрскую ссылку и войдите из этой вкладки.

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

Депозит отправлен, но баланс не появился#

Найдите хэш на стороне отправителя. Затем сравните четыре значения: актив, сеть, адрес получателя и статус транзакции.

• Если хэша нет, отправляющий сервис ещё не передал операцию в сеть.
• Если статус pending, дождитесь подтверждения блокчейна.
• Если статус success, сравните адрес и выбранный маршрут Deposit.
• Если актив или сеть отличаются, сохраните все данные и обратитесь в официальную поддержку.

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

Актив отправлен через неправильную сеть#

Сначала откройте хэш отправки и зафиксируйте актив, сеть и адрес назначения. Затем сравните их с маршрутом Deposit, который был показан для вашего аккаунта. Успешный статус транзакции подтверждает доставку на адрес в выбранной сети, но не означает, что Hyperliquid поддерживает этот маршрут зачисления.

Не отправляйте вторую транзакцию «для исправления» и не доверяйте человеку, который обещает вернуть перевод за seed-фразу. Передайте официальной поддержке публичный адрес, хэш, сеть, актив, сумму и время. Возможность обработки зависит от конкретного актива и маршрута; общего автоматического восстановления нет.

HYPE не отображается в MetaMask или другом кошельке#

Сначала определите, где находится токен. HYPE на spot-балансе HyperCore не обязан отображаться как токен HyperEVM в расширении кошелька. Для просмотра EVM-баланса добавьте сеть HyperEVM с chain ID 999 и официальным RPC https://rpc.hyperliquid.xyz/evm.

Если сеть уже добавлена, откройте сведения о нужном spot-активе в официальном интерфейсе и используйте показанный там контракт для добавления токена. Не подставляйте случайный контракт из поискового объявления. Подробный маршрут будет собран в хабе кошельков Hyperliquid.

Ордер отклонён или не исполняется#

Limit-ордер может оставаться в Open Orders, пока рынок не достигнет заданной цены. Это нормальное поведение. Сравните limit price с лучшей ценой в стакане и при необходимости измените заявку.

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

Сообщение об округлении означает, что цена или количество не соответствует шагу рынка. Введите значение через торговую форму: она подсказывает допустимое число знаков.

Если вы нажали кнопку, но не увидели результат, сначала откройте Open Orders, Positions и Trades. Ордер мог исполниться до обновления визуального состояния.

Ошибка tick size, lot size или минимального объёма#

Hyperliquid проверяет допустимую точность цены и количества для каждого рынка. Сообщение tickRejected означает недопустимый шаг цены, а minTradeNtlRejected — объём ниже минимума. В торговой форме округление применяется автоматически; в API используйте szDecimals из ответа meta и правила значащих цифр цены.

Не округляйте цену и размер одним универсальным числом знаков для всех рынков. Сначала загрузите metadata конкретного рынка, затем сформируйте заявку и проверьте notional после округления.

Order timeout, после которого заявка могла быть принята#

Timeout сообщает только о том, что клиент не получил ответ вовремя. Он не доказывает отклонение ордера. До повтора запросите orderStatus по OID или client order ID, затем проверьте Open Orders и fills фактического аккаунта.

Если повторить заявку вслепую, можно создать вторую позицию. Для автоматизации задавайте уникальный client order ID и связывайте повтор именно с ним. Для ручной сделки достаточно открыть Positions, Open Orders и Trades перед следующим нажатием.

Изменилась доступная маржа или ликвидация#

Available Balance меньше общего баланса, когда часть средств уже поддерживает cross-позиции, зарезервирована открытыми ордерами или находится на spot-балансе.

Проверьте режим маржи, размер всех perpetual-позиций и плечо. В isolated можно добавить маржу именно к выбранной позиции. В cross общий perpetual-баланс поддерживает несколько позиций, поэтому новая заявка меняет доступный запас для остальных.

Цена ликвидации обновляется вместе с балансом, funding и параметрами позиции. Используйте калькулятор ликвидации для сценария, а фактическое значение смотрите в строке позиции Hyperliquid.

Вывод ещё обрабатывается#

Откройте историю Withdraw и найдите статус. Если хэш уже создан, вставьте его в обозреватель выбранной сети. Статус success означает, что блокчейн подтвердил перевод; принимающему сервису после этого может понадобиться собственное число подтверждений.

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

API возвращает 422, 429 или 5xx#

Код 422 обычно указывает на формат или параметры запроса. Проверьте type, символ рынка, округление цены и обязательные поля. Код 429 сообщает о превышении лимита: уменьшите частоту и добавьте повтор с растущей паузой.

Ответ 5xx или timeout относится к серверу либо соединению. Для чтения запрос можно повторить. Для размещения ордера сначала запросите его status, open orders и fills: timeout не доказывает, что действие не было принято.

В журнале оставляйте время, endpoint, HTTP-статус и безопасную часть ответа. Секрет API wallet, подпись и email-код в лог не записываются. Архитектура интеграции разобрана в руководстве по Hyperliquid API.

API сообщает invalid signature#

Проверьте, каким адресом подписано действие. API wallet подписывает торговые действия от имени master account, но запросы состояния должны использовать адрес самого master account или subaccount, а не адрес agent wallet. Иначе состояние может выглядеть пустым, хотя подпись относится к другому адресу.

Nonce должен быть уникальным для signer и находиться в допустимом временном окне. Не используйте один API wallet одновременно в нескольких независимых процессах: общий поток nonce создаёт коллизии. Для разных subaccounts и торговых процессов официальный guide рекомендует отдельные API wallets.

При повторной регистрации agent wallet не переиспользуйте старый приватный адрес. Проверьте chain, vault/subaccount address, срок действия agent и соответствие payload схеме Exchange endpoint.

Что отправить в поддержку#

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

Используйте канал из официальной документации. Поддержке не нужны seed-фраза, приватный ключ, пароль или код из email.

После решения сохраните рабочий маршрут в закладки. Для похожих вопросов откройте FAQ, правила безопасности или вернитесь к первой сделке.