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

## ![spider web](https://pf-emoji-service--cdn.us-east-1.prod.public.atl-paas.net/standard/ef8b0642-7523-4e13-9fd3-01b65648acf6/32x32/1f578.png)HTTP Errors <a href="#http-errors" id="http-errors"></a>

<table data-header-hidden data-full-width="true"><thead><tr><th width="62"></th><th width="171"></th><th width="259"></th><th></th></tr></thead><tbody><tr><td><strong>Код</strong></td><td><strong>Название ошибки</strong></td><td><strong>Перевод</strong></td><td><strong>Действие</strong></td></tr><tr><td>400</td><td>BAD_REQUEST</td><td>Плохой запрос — Неверный тип HTTP запроса (например, использование GET вместо POST) или недопустимые символы.</td><td>Проверьте тип HTTP запроса (GET/POST) и убедитесь, что в запросе нет некорректных символов.</td></tr><tr><td>401</td><td>UNAUTHORIZED</td><td>Неавторизован — Требования безопасности не выполнены (неверная токен-авторизация, IP не в белом списке, недействительный JWT).</td><td>Проверьте корректность API ключа, JWT токена и убедитесь, что ваш IP добавлен в белый список.</td></tr><tr><td>403</td><td>FORBIDDEN_ENDPOINT</td><td>Запрещено — Эндпоинт отключен (например, из-за просроченного платежа).</td><td>Проверьте статус вашей подписки/аккаунта и убедитесь, что нет просроченных платежей.</td></tr><tr><td>403</td><td>FORBIDDEN_TRACE</td><td>Запрещено — пользовательский trace не найден (код trace не в белом списке).</td><td>Запросите добавление custom trace в белый список через поддержку или используйте стандартные методы.</td></tr><tr><td>404</td><td>NOT_FOUND</td><td>Не найдено — Неверный URL или неверный метод.</td><td>Проверьте правильность URL эндпоинта и соответствие документации API.</td></tr><tr><td>413</td><td>CONTENT_TOO_LARGE</td><td>Контент слишком большой — Тело запроса слишком велико (например, <code>eth_getLogs</code> ограничен диапазоном в 10,000 блоков).</td><td>Уменьшите размер запроса, например, сократите диапазон запрашиваемых блоков.</td></tr><tr><td>429</td><td>TOO_MANY_REQUESTS</td><td>Слишком много запросов — Количество запросов в секунду (RPS) превышает лимиты вашего тарифного плана.</td><td>Снизьте частоту запросов или перейдите на тарифный план с более высокими лимитами RPS.</td></tr><tr><td>500</td><td>INTERNAL_SERVER_ERROR</td><td>Внутренняя ошибка сервера — Отправьте тикет, чтобы команда поддержки изучила проблему.</td><td>Повторите запрос позже. Если ошибка повторяется, отправьте тикет в службу поддержки.</td></tr><tr><td>503</td><td>SERVICE_UNAVAILABLE</td><td>Сервис недоступен — Отправьте тикет, чтобы команда поддержки изучила проблему.</td><td>Повторите запрос позже. Если ошибка повторяется, отправьте тикет в службу поддержки.</td></tr></tbody></table>

## ![computer disk](https://pf-emoji-service--cdn.us-east-1.prod.public.atl-paas.net/standard/ef8b0642-7523-4e13-9fd3-01b65648acf6/32x32/1f4bd.png) Ошибки при обращении к серверам данных <a href="#oshibki-pri-obrashenii-k-serveram-dannykh" id="oshibki-pri-obrashenii-k-serveram-dannykh"></a>

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

## ![credit card](https://pf-emoji-service--cdn.us-east-1.prod.public.atl-paas.net/standard/ef8b0642-7523-4e13-9fd3-01b65648acf6/32x32/1f4b3.png) Ошибки исполнения ордеров и транзакций <a href="#oshibki-ispolneniya-orderov-i-tranzakcii" id="oshibki-ispolneniya-orderov-i-tranzakcii"></a>

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

## ![money with wings](https://pf-emoji-service--cdn.us-east-1.prod.public.atl-paas.net/standard/ef8b0642-7523-4e13-9fd3-01b65648acf6/32x32/1f4b8.png) Статусы отмены ордеров (Order Processing Status) <a href="#statusy-otmeny-orderov-order-processing-status" id="statusy-otmeny-orderov-order-processing-status"></a>

<table data-header-hidden><thead><tr><th width="172"></th><th width="136"></th><th></th></tr></thead><tbody><tr><td><strong>Название ошибки</strong></td><td><strong>Перевод</strong></td><td><strong>Действие</strong></td></tr><tr><td>ORDER_REJECTED</td><td>Ордер отклонен</td><td>Проверьте параметры ордера: цену, размер, наличие средств и соответствие правилам торговой системы.</td></tr><tr><td>MARGIN_CANCELED</td><td>Отменен по марже</td><td>На вашем счете недостаточно средств для поддержания позиции или выставления ордера.</td></tr><tr><td>VAULT_WITHDRAWAL_CANCELED</td><td>Отменен из-за вывода из хранилища</td><td>Произошел вывод средств из vault, что повлияло на доступный баланс и привело к отмене ордера.</td></tr><tr><td>OPEN_INTEREST_CAP_CANCELED</td><td>Отменен из-за лимита открытого интереса</td><td>Открытый интерес по данному инструменту достиг максимально допустимого значения, и ваш агрессивный ордер был отклонен.</td></tr><tr><td>SELF_TRADE_CANCELED</td><td>Отменен из-за самоторговли</td><td>Система предотвратила сделку между вашими собственными ордерами (buy и sell от одного аккаунта).</td></tr><tr><td>REDUCE_ONLY_CANCELED</td><td>Отменен как reduce-only</td><td>Выставлен reduce-only ордер, который не приводит к уменьшению текущей позиции (например, ордер на продажу при отсутствии длинной позиции).</td></tr><tr><td>SIBLING_FILLED_CANCELED</td><td>Отменен из-за исполнения связанного ордера</td><td>В группе связанных ордеров (например, TP/SL) один из ордеров исполнился, что привело к автоматической отмене другого.</td></tr><tr><td>DELISTED_CANCELED</td><td>Отменен из-за делистинга</td><td>Торговый инструмент был исключен из листинга биржи, все связанные с ним ордера автоматически отменены.</td></tr><tr><td>LIQUIDATED_CANCELED</td><td>Отменен из-за ликвидации</td><td>Ваша позиция была ликвидирована, что привело к автоматической отмене всех связанных ордеров.</td></tr><tr><td>SCHEDULED_CANCEL</td><td>Отменен по расписанию</td><td>Сработал механизм автоматической отмены ордеров по истечении заданного времени (dead man's switch).</td></tr></tbody></table>

&#x20;