Перейти к содержимому

API-ключи Hyperliquid

Hyperliquid — это perpetual-DEX на собственной L1. Регистрация и KYC не нужны: торговля идёт от имени вашего кошелька (MetaMask, Rabby или другого). Для подключения терминал использует ту же схему, что и AsterDex:

  • Адрес основного («горячего») кошелька — того, в котором лежат ваши средства.
  • Приватный ключ API-кошелька (agent wallet) — отдельного кошелька, авторизованного торговать от вашего имени.

Прямо в форме Hyperliquid поясняет: «API wallets (also known as agent wallets) can perform actions on behalf of your account without having withdrawal permissions». То есть права на вывод средств у API-кошелька нет в принципе — это правило биржи, отключать ничего не надо.

  1. Подключите свой основной кошелёк (MetaMask или другой) на Hyperliquid и откройте раздел API по прямой ссылке app.hyperliquid.xyz/API.
  2. Имя API-кошелька — задайте любое название (например, my_api_wallet или Space Terminal).
  3. Адрес API-кошелька.
    • Если у вас уже есть отдельный кошелёк, который вы хотите использовать как API-кошелёк, — вставьте его адрес.
    • Если такого кошелька нет, нажмите «Generate» — Hyperliquid создаст новую пару адрес/приватный ключ прямо в браузере. Сразу сохраните оба значения, особенно приватный ключ — без него подписывать ордера будет нечем.
  4. Нажмите «Authorize API Wallet» и подпишите авторизацию своим основным кошельком (MetaMask покажет окно подписи). Авторизация off-chain — газа не требуется.
  5. Сохраните адрес API-кошелька и приватный ключ API-кошелька в безопасном месте.

После авторизации в списке API ниже появится запись с именем, адресом API-кошелька и Valid Until — сроком действия. Когда срок подойдёт к концу, авторизацию нужно будет продлить (создать новую запись с теми же или другими адресами).

  1. В верхней панели терминала нажмите иконку шестерёнки (Настройки) и откройте вкладку Подключения.
  2. Нажмите + Добавить подключение. Откроется список бирж, разбитый на секции CEX, DEX, FOREX и MOEX — в секции DEX нажмите плитку Hyperliquid.
  3. Поле Name уже заполнено названием биржи; при желании измените его (например, Hyperliquid · основной).
  4. Включите нужные рынки — Spot и/или Futures (перпетуалы Hyperliquid — это Futures). По умолчанию оба тумблера выключены; без хотя бы одного включённого рынка кнопка Connect останется неактивной.
  5. Введите два значения:
    • Master Wallet Address — адрес вашего основного кошелька MetaMask / Rabby (того, где лежат средства). Hyperliquid прямо подчёркивает: «You must still use your account’s public address for info requests» — то есть для запросов баланса и позиций нужен адрес основного, а не API-кошелька.
    • Agent Private Key — приватный ключ API-кошелька, который вы сохранили при авторизации. Он скрыт точками — иконка глаза справа показывает его.
  6. В списке Proxy оставьте Auto или выберите прокси; No Proxy — прямое соединение.
  7. Нажмите Connect. Терминал проверит ключи запросом к бирже: при успехе форма закроется, а подключение появится в списке Текущие подключения уже включённым. Если биржа отклонит ключи, форма останется открытой, а в углу появится уведомление с текстом ошибки.

Подписи полей формы (Name, Spot, Futures, Master Wallet Address, Agent Private Key, Proxy) и кнопка Connect всегда на английском — даже при русском интерфейсе терминала.

  • Право на вывод средств у API-кошелька Hyperliquid отсутствует by design — это даёт значительный запас прочности на случай утечки приватного ключа: атакующий не сможет вывести средства, только торговать.
  • Приватный ключ API-кошелька — это пароль доступа к торговле от вашего имени. Храните его в менеджере паролей или зашифрованной заметке, не в открытом виде.
  • Не публикуйте приватный ключ нигде: ни в скриншотах, ни на форумах, ни в чатах поддержки.
  • При подозрении на утечку — сразу нажмите «Remove» напротив записи в списке API и авторизуйте новый кошелёк.