Помилки 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.