Помилки Hyperliquid
Відмови Hyperliquid у LootX: ключ гаманця та API-гаманця, комісія білдера, єдиний рахунок і баланс, мінімальна сума заявки, ліміт запитів адреси та ринки HIP-3.
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 не дасть — якщо плече не змінюється, прочитайте текст у плашці «Плече … ×… не змінено: …».