Таблица ошибок Hyperliquid

HTTP Errors

Код	Название ошибки	Перевод	Действие
400	BAD_REQUEST	Плохой запрос — Неверный тип HTTP запроса (например, использование GET вместо POST) или недопустимые символы.	Проверьте тип HTTP запроса (GET/POST) и убедитесь, что в запросе нет некорректных символов.
401	UNAUTHORIZED	Неавторизован — Требования безопасности не выполнены (неверная токен-авторизация, IP не в белом списке, недействительный JWT).	Проверьте корректность API ключа, JWT токена и убедитесь, что ваш IP добавлен в белый список.
403	FORBIDDEN_ENDPOINT	Запрещено — Эндпоинт отключен (например, из-за просроченного платежа).	Проверьте статус вашей подписки/аккаунта и убедитесь, что нет просроченных платежей.
403	FORBIDDEN_TRACE	Запрещено — пользовательский trace не найден (код trace не в белом списке).	Запросите добавление custom trace в белый список через поддержку или используйте стандартные методы.
404	NOT_FOUND	Не найдено — Неверный URL или неверный метод.	Проверьте правильность URL эндпоинта и соответствие документации API.
413	CONTENT_TOO_LARGE	Контент слишком большой — Тело запроса слишком велико (например, eth_getLogs ограничен диапазоном в 10,000 блоков).	Уменьшите размер запроса, например, сократите диапазон запрашиваемых блоков.
429	TOO_MANY_REQUESTS	Слишком много запросов — Количество запросов в секунду (RPS) превышает лимиты вашего тарифного плана.	Снизьте частоту запросов или перейдите на тарифный план с более высокими лимитами RPS.
500	INTERNAL_SERVER_ERROR	Внутренняя ошибка сервера — Отправьте тикет, чтобы команда поддержки изучила проблему.	Повторите запрос позже. Если ошибка повторяется, отправьте тикет в службу поддержки.
503	SERVICE_UNAVAILABLE	Сервис недоступен — Отправьте тикет, чтобы команда поддержки изучила проблему.	Повторите запрос позже. Если ошибка повторяется, отправьте тикет в службу поддержки.

Ошибки при обращении к серверам данных

Код	Название ошибки	Перевод	Действие
-32000	BLOCK_NOT_FOUND	Заголовок/блок не найден	Проверьте правильность номера блока или подождите, пока нода синхронизируется.
-32000	STACK_LIMIT_REACHED	Достигнут лимит стека — Обычно ошибка/баг смарт-контракта.	Проверьте логику вызываемого смарт-контракта или обратитесь к его разработчикам.
-32000	METHOD_HANDLER_CRASHED	Обработчик метода упал — Внутренняя ошибка блокчейн-клиента.	Повторите запрос позже. Если ошибка повторяется, обратитесь в поддержку провайдера.
-32000	EXECUTION_TIMEOUT	Таймаут выполнения — Рассмотрите возможность добавления параметра timeout в ваш запрос.	Добавьте параметр timeout в запрос или оптимизируйте его (например, уменьшите диапазон данных).
-32000	NONCE_TOO_LOW	Nonce слишком низкий — Значение nonce меньше следующего допустимого nonce для аккаунта отправителя.	Увеличьте значение nonce до следующего ожидаемого для аккаунта.
-32000	FILTER_NOT_FOUND	Фильтр не найден — Фильтр превысил таймаут; необходимо создать его заново.	Создайте новый фильтр заново.
-32001	RESOURCE_NOT_FOUND	Ресурс не найден — Запрашиваемый ресурс не существует или недоступен.	Проверьте правильность идентификатора ресурса (хэша транзакции, адреса контракта).
-32002	RESOURCE_UNAVAILABLE	Ресурс недоступен — Запрашиваемый ресурс временно или постоянно недоступен.	Повторите запрос позже или проверьте статус ресурса.
-32003	TRANSACTION_REJECTED	Транзакция отклонена — Ошибка валидации или недостаточно ресурсов.	Проверьте параметры транзакции, баланс аккаунта и лимит газа.
-32004	METHOD_NOT_SUPPORTED	Метод не поддерживается — Метод не реализован или не поддерживается сервером.	Проверьте список поддерживаемых методов у вашего провайдера.
-32005	LIMIT_EXCEEDED	Превышен лимит — Запрос превышает допустимый лимит или квоту.	Уменьшите параметры запроса (например, лимит возвращаемых записей).
-32006	JSONRPC_VERSION_NOT_SUPPORTED	Версия JSON-RPC не поддерживается.	Убедитесь, что используете JSON-RPC версии 2.0.
-32009	TRACE_REQUESTS_LIMITED	Трассировочные запросы ограничены — Debug и trace методы ограничены по RPS.	Снизьте частоту вызовов debug/trace методов или запросите увеличение лимитов у провайдера.
-32010	GAS_LIMIT_EXCEEDED	Стоимость транзакции превышает лимит газа — Лимит газа установлен слишком низко.	Увеличьте лимит газа в транзакции.
-32011	NETWORK_ERROR	Сетевая ошибка — Проблема с соединением между клиентом и сервером.	Проверьте сетевое соединение и доступность RPC-эндпоинта.
-32015	VM_EXECUTION_ERROR	Ошибка выполнения VM — Ошибка выполнения смарт-контракта.	Проверьте логику контракта, параметры вызова и достаточность газа.
-32600	INVALID_REQUEST	Недействительный запрос — JSON запрос сформирован неверно или отсутствуют обязательные поля.	Проверьте формат JSON-запроса и наличие всех обязательных полей.
-32601	METHOD_NOT_FOUND	Метод не найден — Обычно опечатка в названии метода.	Проверьте правильность написания названия метода.
-32601	PARSE_REQUEST_FAILED	Не удалось разобрать запрос — Неверное тело запроса.	Проверьте синтаксис JSON в теле запроса.
-32602	MISSING_0X_PREFIX	Неверные параметры - отсутствует префикс 0x — В hex-адресе отсутствует 0x.	Добавьте префикс '0x' к адресу.
-32602	BLOCK_RANGE_EXCEEDED	Превышен лимит диапазона блоков — eth_getLogs и eth_newFilter ограничены диапазоном в 10,000 блоков.	Уменьшите диапазон запрашиваемых блоков.
-32603	INTERNAL_JSONRPC_ERROR	Внутренняя JSON-RPC ошибка — Обычно из-за некорректной или недействительной полезной нагрузки.	Проверьте корректность передаваемых данных и повторите запрос.
-32612	CUSTOM_TRACES_BLOCKED	Пользовательские трассировки заблокированы — Отправьте запрос на включение custom traces.	Отправьте запрос в поддержку провайдера для включения custom traces.
-32613	CUSTOM_TRACE_NOT_ALLOWED	Пользовательская трассировка не разрешена — Custom trace не найден в списке разрешенных.	Запросите добавление конкретного custom trace в белый список.
-32700	PARSE_ERROR	Ошибка парсинга — Получен недействительный JSON.	Проверьте синтаксис JSON на наличие ошибок.

Ошибки исполнения ордеров и транзакций

Название ошибки	Категория API	Перевод	Действие
USER_WALLET_NOT_EXIST	Authorization	Пользователь или API кошелек не существует	Проверьте порядок полей в action, используйте нижний регистр для адреса, авторизуйте agent wallet через approve_agent()
INVALID_SIGNATURE_SCHEME	Authorization	Недействительная подпись	Убедитесь, что используете правильный chainId для типа подписываемого действия
CHAIN_ID_MISMATCH	Authorization	Указанный chainId должен соответствовать...	Используйте agent wallet для подписи, чтобы избежать конфликта сетей
INVALID_NONCE	Transaction	Недействительный или истекший nonce	Используйте get_timestamp_ms() или Date.now() для генерации nonce
DESERIALIZATION_FAILED	Request Format	Не удалось десериализовать запрос	Проверьте структуру JSON-запроса на соответствие документации API
AGENT_NOT_APPROVED	Authorization	Агент не авторизован	Вызовите approve_agent() для авторизации agent wallet
AGENT_ALREADY_EXISTS	Authorization	Агент уже существует	Используйте уникальные имена для каждого agent wallet
PRICE_TOO_FAR_FROM_REF	Order Validation	Цена ордера не может отклоняться более чем на 80% от референсной цены	Проверьте правильность идентификатора актива и текущую рыночную цену
TICK_SIZE_VIOLATION	Order Validation	Нарушение минимального шага цены	Округлите цену в соответствии с требованиями инструмента
INVALID_ORDER_SIZE	Order Validation	Недействительный размер ордера	Запросите метаданные инструмента динамически и округлите размер
BELOW_MINIMUM_NOTIONAL	Order Validation	Стоимость ордера ниже минимальной ноциональной стоимости	Увеличьте размер ордера или цену для достижения минимальной стоимости
INVALID_TX_ENVELOPE	Transaction	Недействительный тип конверта транзакции	Используйте правильные поля для EIP-1559 транзакций или переключите кошелек на Legacy режим
ACCOUNT_ZERO_BALANCE_FEE	Authorization	Ошибка активации. Баланс счета равен нулю. Пожалуйста, пополните баланс Hyperliquid на бирже.	Пополните баланс мастер-аккаунта на бирже Hyperliquid.
ACCOUNT_NOT_ACTIVE_ORDER	Order Execution	Ошибка ордера. Счет не активен (баланс нулевой). Пожалуйста, пополните баланс Hyperliquid на бирже.	Пополните баланс мастер-аккаунта на бирже Hyperliquid.

Статусы отмены ордеров (Order Processing Status)

Название ошибки	Перевод	Действие
ORDER_REJECTED	Ордер отклонен	Проверьте параметры ордера: цену, размер, наличие средств и соответствие правилам торговой системы.
MARGIN_CANCELED	Отменен по марже	На вашем счете недостаточно средств для поддержания позиции или выставления ордера.
VAULT_WITHDRAWAL_CANCELED	Отменен из-за вывода из хранилища	Произошел вывод средств из vault, что повлияло на доступный баланс и привело к отмене ордера.
OPEN_INTEREST_CAP_CANCELED	Отменен из-за лимита открытого интереса	Открытый интерес по данному инструменту достиг максимально допустимого значения, и ваш агрессивный ордер был отклонен.
SELF_TRADE_CANCELED	Отменен из-за самоторговли	Система предотвратила сделку между вашими собственными ордерами (buy и sell от одного аккаунта).
REDUCE_ONLY_CANCELED	Отменен как reduce-only	Выставлен reduce-only ордер, который не приводит к уменьшению текущей позиции (например, ордер на продажу при отсутствии длинной позиции).
SIBLING_FILLED_CANCELED	Отменен из-за исполнения связанного ордера	В группе связанных ордеров (например, TP/SL) один из ордеров исполнился, что привело к автоматической отмене другого.
DELISTED_CANCELED	Отменен из-за делистинга	Торговый инструмент был исключен из листинга биржи, все связанные с ним ордера автоматически отменены.
LIQUIDATED_CANCELED	Отменен из-за ликвидации	Ваша позиция была ликвидирована, что привело к автоматической отмене всех связанных ордеров.
SCHEDULED_CANCEL	Отменен по расписанию	Сработал механизм автоматической отмены ордеров по истечении заданного времени (dead man's switch).