> For the complete documentation index, see [llms.txt](https://docs.ispecalgo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ispecalgo.com/isa-terminal/birzhi-i-podklyucheniya/hyperliquid.md).

# Hyperliquid

В ISA Terminal доступна торговля фьючерсами Hyperliquid с расчётами в **USDC**. Spot не поддерживается. Для знакомства можно использовать демо-режим — тестовую сеть Hyperliquid.

## Что подготовить

Для подключения нужны два разных значения:

| Поле в терминале                | Что указать                                                                  |
| ------------------------------- | ---------------------------------------------------------------------------- |
| **Адрес кошелька**              | Публичный адрес основного счёта или субаккаунта, на котором будете торговать |
| **Приватный ключ API-кошелька** | Ключ отдельного API-кошелька, созданного и одобренного на Hyperliquid        |

**Не вставляйте приватный ключ основного кошелька или секретную фразу восстановления.** Терминалу нужен ключ отдельного API-кошелька.

Адрес API-кошелька не подходит для поля **Адрес кошелька**: в нём должен быть адрес счёта с вашим балансом. Разницу между этими адресами объясняет [документация Hyperliquid](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets).

## 1. Создайте API-кошелёк

1. Откройте [раздел API на Hyperliquid](https://app.hyperliquid.xyz/API) и подключите основной кошелёк.
2. Создайте отдельный API-кошелёк для ISA Terminal.
3. Подтвердите его использование на бирже.
4. Сохраните его приватный ключ: он понадобится в форме подключения терминала.

Для каждого терминала используйте свой API-кошелёк. Не передавайте его ключ в чатах, на скриншотах или ИИ-помощнику.

## 2. Добавьте подключение

1. В ISA Terminal откройте **Подключения → Добавление подключения**.
2. Выберите **Hyperliquid — Futures USDC**.
3. Придумайте имя подключения.
4. Вставьте адрес торгового счёта и приватный ключ API-кошелька.
5. Для тестовой сети включите **Демо-режим**. API-кошелёк должен быть одобрен именно в этой сети.
6. Нажмите **Сохранить**.
7. Включите новое подключение в таблице и дождитесь появления баланса.

Баланс этого подключения и денежные суммы в настройках его ботов указаны в USDC.

## 3. Дайте разрешение на комиссию терминала

На Hyperliquid комиссия терминала взимается сверх комиссии биржи. Размер комиссии показан при добавлении подключения и в его настройках. Её удерживает сама биржа с исполненных сделок после вашего разрешения.

1. Откройте настройки подключения.
2. Найдите блок **Комиссия терминала**.
3. Нажмите **Дать разрешение** — откроется страница iSpecAlgo в браузере.
4. Подключите основной кошелёк счёта в MetaMask или Rabby. Для субаккаунта используйте его основной кошелёк.
5. Проверьте счёт, сеть и ставку, затем подпишите разрешение.
6. Вернитесь в терминал и нажмите **Проверить**.
7. Дождитесь сообщения **Разрешение есть**.

Подпись выполняется в вашем кошельке. Вводить приватный ключ основного кошелька на странице разрешения не нужно. Такой порядок подтверждения комиссии описан и в [документации Hyperliquid](https://hyperliquid.gitbook.io/hyperliquid-docs/trading/builder-codes).

Без разрешения бот без позиции не запустится. Если разрешение отозвать во время работы, терминал продолжит сопровождение уже открытой позиции, но после её закрытия новый вход не выполнит.

## Перед запуском бота

* Проверьте, что подключение включено и баланс отображается в USDC.
* Убедитесь, что разрешение на комиссию получено.
* Проверьте объём сделки и остальные настройки риска.
* Учитывайте, что на Hyperliquid доступен только **односторонний режим**: один бот на пару в рамках подключения. Хедж-режима нет.

Дальше следуйте инструкции [Создание бота](https://docs.ispecalgo.com/isa-terminal/kak-sozdat-i-zapustit-torgovogo-bota/kak-sozdat-bota.md).

## Если подключение не работает

### Нет баланса или показан другой счёт

Проверьте поле **Адрес кошелька**. Там должен быть адрес нужного торгового счёта, а не API-кошелька. Также проверьте, совпадает ли выбранная сеть: реальная или демо.

### Бот не запускается из-за комиссии терминала

Откройте настройки подключения, дайте разрешение и нажмите **Проверить**. Если уже подписывали его, убедитесь, что выбрали нужный основной кошелёк и сеть.

### API-кошелёк истёк, удалён или не одобрен

Создайте и одобрите новый API-кошелёк на Hyperliquid. В настройках подключения вставьте его ключ в поле **Новый приватный ключ API-кошелька** и сохраните изменения. Пустое поле оставляет прежний ключ.

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

Если ошибка остаётся, откройте [логи](https://docs.ispecalgo.com/isa-terminal/baza-znanii/logirovanie-v-isa.md) или отправьте [баг-репорт](https://docs.ispecalgo.com/isa-terminal/baza-znanii/kak-otpravit-bag-report.md).
