Дополнительные материалы

Быстрый поиск по статье

Подключение к бирже Hyperliquid

Ссылка для регистрации на DEX-бирже Hyperliquid: 🔗https://app.hyperliquid.xyz/join/MOONBOT.


Если регистрация выполнена без использования данной ссылки, терминал Moonbot автоматически укажет свой код при первом запуске.


Использование реферальной ссылки или кода предоставляет небольшую скидку на комиссию и позволяет активировать PRO-версию Moonbot.


Для торговли на DEX-бирже Hyperliquid используется обычный DeFi-кошелёк с поддержкой EVM (Ethereum Virtual Machine). EVM-кошелёк — это цифровой кошелёк для взаимодействия с блокчейном Ethereum и другими сетями, совместимыми с EVM.


Если у Вас ещё нет EVM-кошелька (например, Rabby, MetaMask, WalletConnect, Coinbase Wallet), Вы можете создать его на сайте 🔗https://rabby.io/ или установить соответствующее расширение для браузера Google Chrome. Дополнительную информацию о способах подключения к Hyperliquid можно получить по ссылке: 🔗https://hyperliquid.gitbook.io/hyperliquid-docs/onboarding/how-to-start-trading.


После установки расширения кошелька:


  1. Создайте новый кошелёк;

  2. Установите пароль;

  3. Сохраните уникальную секретную фразу (seed-фразу) для восстановления доступа.


⚠️ Внимание! Любой, кто получит доступ к паролю кошелька или секретной фразе, сможет управлять Вашими средствами; не передавайте эти данные третьим лицам; рекомендуется сохранить их на отдельном носителе (например, флешке) или записать на бумаге и хранить в надёжном месте.


Далее выполните следующие действия:


  1. Переведите на созданный кошелёк ETH в сети Arbitrum;

  2. Внутри кошелька обменяйте ETH на USDC в сети Arbitrum;

  3. Оставьте небольшое количество ETH (примерно эквивалент 10 USD) для оплаты комиссии (газа) при внесении депозита USDC на биржу Hyperliquid;

  4. Откройте страницу торговли 🔗https://app.hyperliquid.xyz/trade;

  5. Нажмите кнопку Connect для подключения браузерного кошелька.


Далее будут приводиться примеры с подключением к MetaMask; аналогичные шаги применимы и к другим удобным для Вас кошелькам.


Пополнение баланса через MetaMask



1) В окне Connect выберите MetaMask;


2) В открывшемся окне браузерного кошелька при необходимости введите пароль и нажмите кнопку Разблокировать;


3) Если в окне Connect отсутствует пункт с Вашим кошельком, выберите WalletConnect и выполните авторизацию с помощью QR-кода.



4) Создайте новый аккаунт в кошельке (при необходимости);


5) Выберите аккаунт, который будет подключён к бирже Hyperliquid и нажмите кнопку Подключиться.



После успешного подключения на сайте Hyperliquid отобразится кнопка Deposit, а справа будет указан Ваш торговый адрес на бирже.



6) Нажмите кнопку Deposit и в окне Deposit USDC from Arbitrum сделайте следующее:


  • В меню Assets выберите USDC;

  • В меню Deposit Chain выберите Arbitrum;

  • В нижнем поле укажите сумму в USDC, которую планируете отправить с кошелька на биржу Hyperliquid; минимальная сумма депозита — 5 USDC; при нажатии кнопки MAX будет автоматически указана максимально доступная сумма USDC в кошельке;

  • Нажмите кнопку Deposit.



После нажатия кнопки Deposit откроется окно кошелька; для подтверждения транзакции нажмите кнопку Подтвердить.


💡 Обратите внимание, что на балансе кошелька должно быть достаточное количество ETH для оплаты комиссии (газа) при выполнении данной транзакции.



После завершения транзакции в кошельке нажмите кнопку Закрыть расширение.



После подтверждения транзакции на бирже Hyperliquid указанная сумма USDC отобразится на фьючерсном балансе (Perps).


Для перевода средств с фьючерсного баланса на спотовый выполните следующие действия:


  1. Нажмите кнопку Perps-Spot;

  2. Подтвердите операцию через подключённый кошелёк.


В этом же разделе Вы можете:


  • Пополнить депозит с помощью кнопки Deposit;

  • Вывести средства обратно на подключённый кошелёк с помощью кнопки Withdraw; комиссия за вывод составляет 1 USDC.



Создание API-ключей для биржи HyperLiquid


После пополнения баланса на сайте Hyperliquid выполните следующие действия:


1) Перейдите на вкладку More и выберите пункт API, чтобы открыть страницу создания API-ключей;



2) В поле 1 укажите произвольное имя для API-ключа (не более 16 символов) и нажмите кнопку Generate;



3) В поле 3 будет сгенерирован API Wallet Address; нажмите кнопку Authorize API Wallet;



В открывшемся окне Authorize API Wallet:


4) Проверьте значение API Wallet Name (имя, заданное ранее);
5) Скопируйте или сохраните API Wallet Address — он потребуется для ввода в терминале Moonbot;
6) При необходимости укажите срок действия API-ключа; при нажатии MAX будет установлен максимальный срок — 180 дней;
7) В красном поле скопируйте или сохраните Private Key — он потребуется для ввода в терминале Moonbot;
8) Нажмите кнопку Authorize;



После этого откроется кошелек, в котором с помощью кнопки Подтвердить нужно подтвердить запрос подписи для создания API-ключей для биржи Hyperliquid.



После успешного подтверждения на странице API появится запись с созданным API-ключом и датой его окончания. Ниже автоматически будет создан дополнительный технический API с именем "app.hyperliquid.xyz"; данный ключ не используется в терминале, однако удалять его не требуется.


Чтобы удалить ненужный API-ключ, нажмите красную ссылку Remove.



Активация API-ключей в терминале Moonbot для биржи Hyperliquid


  1. Создайте на сайте биржи Hyperliquid API-ключи для основного аккаунта или субаккаунта;

  2. Скопируйте папку с Вашим основным PRO-терминалом для другой биржи в новую папку и запустите терминал;

  3. Перейдите в раздел Настройки → Логин, в поле Биржа выберите Hyper (спот) или Hyper Futures (фьючерсы) и нажмите кнопку Применить;

  4. В разделе Настройки → Логин выполните следующие действия;

    1. В поле API Key введите API Wallet Address, полученный ранее на бирже Hyperliquid;

    2. В поле API Secret введите Private Key, полученный ранее на бирже Hyperliquid;

    3. Зарегистрируйте введённые API-ключи для основного аккаунта или субаккаунта;

  5. В правом нижнем углу главного окна терминала Moonbot нажмите на надпись PRO version, чтобы открыть окно Moon Credits с активациями платных модулей (см. рисунок ниже);

  6. В окне Moon Credits в нижней части отображается баланс Ваших Moon Credits; для активации основного аккаунта или одного субаккаунта биржи Hyperliquid требуется 1000 Moon Credits; если баланс достаточен, в блоке Activate API Key нажмите кнопку Activate for 1000 Credits; после этого API-ключи будут активированы в данном терминале;

  7. Если необходимо активировать дополнительные субаккаунты этой же биржи, повторите процедуру требуемое количество раз;

  8. Если после подключения в терминале отсутствуют трейды или не отображается книга ордеров, нажмите Меню → Обновить подключение или перезапустите терминал Moonbot несколько раз до появления данных.



Технические детали при работе с биржей HyperLiquid


1. Комиссия на бирже Hyperliquid может взиматься как в USDC, так и в торгуемых монетах; актуальные ставки и способы их снижения указаны на странице 🔗https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees; дополнительно взимается небольшая комиссия разработчика терминала Moonbot, которая активируется при первом запуске терминала, подключённого к Hyperliquid; при первом запуске может появиться ошибка API-ключей и автоматически откроется страница 🔗https://api.moon-bot.com/files/HLsign.html с окном Approve Builder Fee; нажмите кнопку Connect & Approve, затем подтвердите операцию в браузерном кошельке; после появления статуса Done перезапустите терминал Moonbot от имени администратора; данную процедуру необходимо выполнить один раз для каждого аккаунта;



2. Строго соблюдайте правило "Один API-ключ = Один терминал = Один запуск"; нарушение приведёт к сбоям в работе терминалов, запущенных на одном API; биржа использует принцип монотонной индексации команд, поэтому два терминала с одинаковым API нарушают цепочку запросов; для каждого одновременно работающего терминала необходим отдельный API-ключ;


3. Лимиты биржи составляют 1200 запросов в минуту на все операции; дополнительно действует Fill Ratio — 1 запрос на каждый 1 USDC совокупного торгового объёма; стартовый буфер — 10 000 ордеров; при его исчерпании необходимо совершить сделку для обновления лимита; подробности доступны на странице 🔗https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/rate-limits-and-user-limits;


4. На DEX-бирже Hyperliquid ввод и вывод средств осуществляется только в USDC; вывод других токенов возможен через сторонний сервис;


5. Задержки (ping) на Hyperliquid могут составлять 1–2 секунды; это связано с особенностями DEX и обработкой транзакций в блокчейне;


6. Возможны "потерянные" позиции и остатки монет после закрытия сделок; регулярно проверяйте балансы в окне Меню → Assets; частичное исполнение ордера может приводить к зависанию остатка;


7. Загрузка данных по монетам при старте ускорена при использовании модуля Подгрузка графиков и включённой опции Настройки → Основные → Анализ монет при запуске;


8. Поддерживаются режимы Cross и Isolated маржи;


9. Автоторговля может быть затруднена из-за задержек 1–2 секунды и ограничений API; возможны потери ордеров и отсутствие некоторых индикаторов;


10. В папке терминала используется файл secp256k1.dll для подписания запросов в блокчейне; не удаляйте его при копировании папки;


11. В FREE-версии Moonbot ордера не выставляются;


12. Подгрузка графиков поддерживается только на фьючерсах;


13. В окне Меню → Assets отображаются балансы спота и фьючерсов; перевод средств между ними выполняется только на сайте Hyperliquid с подтверждением через кошелёк;


14. Биржа не передаёт данные PNL по API; значение PNL на графике отображается как 0$; фактические результаты можно проверить на странице 🔗https://app.hyperliquid.xyz/portfolio;


15. На фьючерсах отображается линия ликвидации при открытии позиции; после закрытия позиции линия исчезает;


16. Индикатор загрузки API является расчётным; биржа не предоставляет точные данные по использованию API; обновление маркпрайса выполняется раз в 6 секунд;


17. При включённой опции Настройки → Специальные → Настройка движка → Ignore Replacing bug возможна более быстрая перестановка ордеров; ⚠️ Внимание! При частичном исполнении ордера на DEX вероятность возникновения ошибки "replacing bug" крайне высокая; перестановка ордера может привести к зависанию остатка;


18. Команда LogEveryRequest в поле ввода монеты выводит в журнал все запросы; используется для диагностики блокировок;


19. При получении ошибки 429 во время выставления тейк-ордера выполняется ещё 5 попыток с увеличенными паузами;


20. На фьючерсах ордера автоматически выставляются в режиме ReduceOnly, что предотвращает переворот позиции при закрытии лонга;


21. Ускорено обновление балансов и увеличена глубина книги ордеров по сравнению с ранними версиями;


22. На бирже возможно создание до 50 субаккаунтов при торговом объёме более 100 000 USD; они работают только через веб-интерфейс и не поддерживаются в терминале Moonbot; для работы через API требуется создание нового кошелька и повторная активация в терминале;


23. При подключении терминала Moonbot к бирже Hyperliquid возможна торговля через API на маркетах HIP-3.



Эти маркеты считаются как отдельные и требуют особого подключения в Moonbot из расчета по одному маркету на 1 Moonbot.


Чтобы подключить один из нужных маркетов нужно закрыть терминал Moonbot, открыть файл MoonBot.ini и в конец списка записать одну строчку, которая будет запускать маркет HIP-3 с нужным индексом.


Например, в файле MoonBot.ini можно указать строчку HIP3_DexIndex=1 для xyz (XYZ).


Если нужно торговать на маркете с другим индексом, то нужно закрыть терминал сделать копию его папки, в ней открыть файл MoonBot.ini и заменить строчку на другую, например, HIP3_DexIndex=2 для flx (Felix Exchange) и так далее.


Внимание!


  • При создании копии папок и далее запуска нескольких терминалов Moonbot одновременно следите, чтобы в каждом из них был свой API и они не пересекались. То есть нужно создавать и активировать в Moonbot отдельные ключи API для каждого HIP-3 маркета, поскольку на бирже Hyperliquid действует принцип монотонной индексации команд, а два и более запущенных терминала Moonbot с одинаковыми ключами API нарушат при этом цепочку команд, что приведет к ошибкам.

  • В режиме Moon Kernel - клиент-серверного подключения Moonbot, когда на локальном компьютере размещается Moonbot Client (Клиент), а на VPS сервере размещается Moonbot Kernel (Ядро), то при торговле на маркетах HIP-3 строчку в файле MoonBot.ini с индексом маркета следует прописывать как в Moonbot Client, так и в Moonbot Kernel.

  • При подключении HIP3_DexIndex=5 для торговли требуется USDH, при подключении HIP3_DexIndex=7 для торговли требуется USDT, а не USDC как для остальных HIP-3 маркетов. При отсутствии баланса в USDT и USDT в терминале Moonbot ордера на этих маркетах выставляться не будут, а в логе будет ошибка "отсутствие средств".

  • На сайте биржи Hyperliquid в своём аккаунте для торговли на HIP-3 нужно в настройках:

    • Disable HIP-3 Dex Abstraction (галочку снять)

    • Disable Unified Account Mode (галочку установить)


Чтобы узнать, какие актуальные маркеты HIP-3 доступны в настоящее время, и под какими номерами они записаны, нужно запустить терминал Moonbot, например, с первым индексом HIP3_DexIndex=1 для xyz (XYZ) в MoonBot.ini и в логе посмотреть список с текущими индексами.


На данный момент в логе будут отражены следующие маркеты:


DEX[1]: xyz (XYZ)
DEX[2]: flx (Felix Exchange)
DEX[3]: vntl (Ventuals)
DEX[4]: hyna (HyENA)
DEX[5]: km (Markets by Kinetiq)
DEX[6]: abcd (ABCDEx)
(*сейчас маркет не обслуживается)
DEX[7]: cash (dreamcash)


В настоящее время для разных маркетов доступны следующие тикеры монет:


  • HIP3_DexIndex=1
    AAPL,AMD,AMZN,BABA,CL,COIN,COPPER,CRCL,CRWV,EUR,GOLD,GOOGL,HOOD,
    HYUNDAI,INTC,JPY,META,MSFT,MSTR,MU,NATGAS,NFLX,NVDA,ORCL,PLATINUM,
    PLTR,RIVN,SILVER,SKHX,SMSN,SNDK,TSLA,TSM,URNM,USAR,XYZ100

  • HIP3_DexIndex=2
    COIN,COPPER,CRCL,GOLD,NVDA,OIL,PALLADIUM,PLATINUM,SILVER,TSLA,USDE,XMR

  • HIP3_DexIndex=3
    ANTHROPIC,BIOTECH,DEFENSE,ENERGY,INFOTECH,MAG7,NUCLEAR,OPENAI,ROBOT,SEMIS,SPACEX

  • HIP3_DexIndex=4
    1000PEPE,ADA,BCH,BNB,BTC,DOGE,ENA,ETH,FARTCOIN,HYPE,IP,LIGHTER,LINK,LTC,PUMP,SOL,SUI,XMR,XPL,XRP,ZEC

  • HIP3_DexIndex=5
    AAPL,BABA,GLDMINE,GOLD,GOOGL,MU,NVDA,PLTR,SEMI,SILVER,SMALL2000,TSLA,US500,USBOND,USENERGY,USOIL,USTECH

  • HIP3_DexIndex=6
    Ошибка при подключении (*сейчас маркет не обслуживается)

  • HIP3_DexIndex=7
    AMZN,GOLD,GOOGL,HOOD,INTC,META,MSFT,NVDA,SILVER,TSLA,USA500


24. Общая статистика Hyperliquid доступна на странице 🔗https://stats.hyperliquid.xyz/;


25. Официальная документация биржи доступна по ссылке 🔗https://hyperliquid.gitbook.io/hyperliquid-docs.