Підключення біржі HYPERLIQUID

Hyperliquid — ончейн-біржа: ви входите через криптогаманець або електронну пошту, а ваш акаунт прив’язаний до адреси гаманця. Bybot торгує на вашому акаунті Hyperliquid через API Wallet — окремий ключ, який може виставляти й скасовувати ордери для вашого гаманця. Гроші залишаються на вашому акаунті Hyperliquid, а API Wallet не може виводити чи переказувати кошти. Налаштування займає близько 10 хвилин.

У Bybot ви додаєте дві речі: адресу основного гаманця та приватний ключ API Wallet. Ніколи не вставляйте приватний ключ чи сід-фразу основного гаманця — Bybot вони не потрібні, і він їх відхиляє.

1. Увійдіть на Hyperliquid

Відкрийте app.hyperliquid.xyz і натисніть “Connect”. Увійдіть через криптогаманець або електронну пошту. Якщо ви використовуєте гаманець, натисніть “Enable Trading” і підпишіть запит у ньому — газ за це не стягується.

2. Поповніть рахунок USDC

Натисніть “Deposit”, оберіть USDC в Arbitrum і дотримуйтеся інструкцій на екрані.

3. Зробіть USDC доступними для спотової торгівлі

Bybot торгує на спотовому ринку Hyperliquid. Зробіть одне з двох:

• переведіть акаунт у режим “Unified account” — тоді один баланс USDC обслуговує і спот, і безстрокові ф’ючерси, і переказ не потрібен;
• або в стандартному режимі переведіть USDC з “Perps” на “Spot”: у цьому режимі поповнення надходять на баланс Perps.

Режим “Portfolio margin” не підтримується: у ньому Hyperliquid автоматично позичає кошти, коли балансу не вистачає, тож бот міг би купувати в кредит. Bybot відмовляється працювати з таким акаунтом.

4. Відкрийте сторінку API

У верхньому меню відкрийте “More” й оберіть “API”.

5. Створіть іменований API Wallet

1. Введіть назву API Wallet, наприклад bybot, і натисніть “Generate”.
2. Натисніть “Authorize API Wallet”.

3. У вікні “Authorize API Wallet” натисніть “MAX” у полі “Days Valid” — API Wallet працюватиме максимальний строк, до 180 днів.
4. Скопіюйте “Private Key” кнопкою копіювання й збережіть його в надійному місці.
5. Натисніть “Authorize”. Якщо ви входили через гаманець, підтвердьте дію в ньому.

6. Скопіюйте адресу гаманця

Натисніть кнопку свого акаунта у верхньому правому куті й скопіюйте адресу кнопкою копіювання. Це адреса вашого основного гаманця — саме вона потрібна Bybot. Не використовуйте адресу API Wallet із кроку 5.

7. Додайте ключ у Bybot

У Bybot відкрийте Налаштування (“Settings”) → API-ключі (“API Keys”) і натисніть Додати ключ (“Add key”). Оберіть HYPERLIQUID і заповніть два поля:

Натисніть Зберегти (“Save”). Bybot перевіряє ключ через публічні дані Hyperliquid: API Wallet має належати цьому гаманцю й мати назву, а режим акаунта має підтримуватися.

8. Перевірте ключ

У списку ключів натисніть ”⋯” на картці Hyperliquid й оберіть Перевірити ключ (“Check key”). Bybot підтвердить, що API Wallet досі підключений до вашого гаманця. У стовпці Термін дії API Wallet (“API Wallet expiry”) видно, коли він спливає.

9. Перш ніж створювати бота

• Bybot торгує 5 парами з USDC: BTC, ETH, SOL, ZEC і HYPE. BTC, ETH, SOL і ZEC на Hyperliquid — це обгорнуті монети Unit (UBTC, UETH, USOL, UZEC).
• На Hyperliquid можна запустити одного DCA-бота на пару.
• Мінімальний ордер — 10 USDC.

Далі скористайтеся посібником Створення бота.

Термін дії API Wallet

Строк роботи API Wallet ви обираєте під час його створення — до 180 днів. Bybot нагадає вам про це до завершення строку. Коли строк спливе, бот перестане торгувати. Щоб продовжити, створіть новий іменований API Wallet на Hyperliquid, потім видаліть старий ключ у Bybot і додайте новий.

Ліміт дій Hyperliquid

Hyperliquid обмежує кількість дій — виставлення та скасування ордерів — на гаманець: спершу 10,000, плюс 1 дія за кожен $1 торгового обсягу гаманця. Коли ліміт вичерпано, торгівля не зупиняється, але сповільнюється.

Bybot не може докупити дії: Hyperliquid приймає таку покупку лише з підписом вашого основного гаманця й списує оплату з основного гаманця. Якщо ліміт вичерпано, дочекайтеся зростання торгового обсягу або докупіть дії самостійно з основного гаманця.

Комісії та залишки

• Спотова комісія Hyperliquid на базовому рівні — 0.07% для тейкер-ордерів і 0.04% для мейкер-ордерів.
• Під час купівлі комісія стягується в монеті, яку ви купуєте (для BTC — в UBTC), під час продажу — в USDC. Тому ви отримуєте трохи менше монет, ніж купили.
• Залишок вартістю менше за мінімальний ордер 10 USDC продати не можна — він лишається на акаунті як «пил».

Ручна торгівля на тому самому гаманці

Не торгуйте вручну на парі, де працює бот. Hyperliquid не дозволяє гаманцю торгувати із самим собою: коли ваш ручний ордер зустрічається з ордером бота, Hyperliquid скасовує ордер, який уже був у книзі ордерів, — часто це ордер бота. Бот сприймає це як скасування.

Безпека ключа

• Виведення коштів неможливе. API Wallet може виставляти й скасовувати ордери, але не може виводити чи переказувати кошти — Hyperliquid відхиляє такі запити, навіть якщо ключ потрапив до сторонніх осіб.
• Ніколи не вставляйте приватний ключ чи сід-фразу основного гаманця. Bybot потрібен лише ключ API Wallet, і він ніколи не попросить вашу сід-фразу.
• Використовуйте окремий гаманець для бота. API Wallet може торгувати всім вашим акаунтом Hyperliquid, зокрема безстроковими ф’ючерсами.
• Один гаманець — один акаунт Bybot. Адресу гаманця можна підключити лише до одного акаунта Bybot.
• Якщо ви перестали користуватися ботом, зупиніть своїх ботів на Hyperliquid, видаліть ключ у Bybot, а потім відкличте API Wallet на app.hyperliquid.xyz → “API”. Доки ви його не відкличете, API Wallet може торгувати вашим акаунтом.

Поширені проблеми

“Hyperliquid did not confirm the key” (Hyperliquid не підтвердила ключ). Перевірте адресу гаманця й приватний ключ API Wallet, а також чи не сплив строк дії API Wallet.

“This is your main wallet private key” (це приватний ключ вашого основного гаманця). Ви вставили ключ основного гаманця. Створіть іменований API Wallet (крок 5) і вставте його приватний ключ.

“The API Wallet must be a named one” (API Wallet має бути з назвою). Створіть API Wallet з назвою на сторінці API і вставте його ключ.

“This Hyperliquid account mode is not supported” (цей режим акаунта Hyperliquid не підтримується). Акаунт працює в режимі Portfolio margin. Перейдіть на Unified account або стандартний режим.

“This Hyperliquid wallet is already connected to another account” (цей гаманець Hyperliquid уже підключено до іншого акаунта). Один гаманець можна підключити лише до одного акаунта Bybot.

Не вдається видалити ключ. Спершу зупиніть своїх ботів на Hyperliquid, потім видаліть ключ.

Бот не купує, хоча ви поповнили USDC. У стандартному режимі поповнення надходить на баланс Perps. Переведіть USDC на Spot або перейдіть на Unified account.

Бот став повільним. Можливо, гаманець вичерпав ліміт дій Hyperliquid — див. розділ «Ліміт дій Hyperliquid» вище.

Офіційна документація біржі: Hyperliquid Docs.