Перехід на портфельну маржу

Портфельна маржа (PM) працює в продакшені й доступна для всіх рахунків. Вона маржинує ваші опціони та безстрокові контракти Hyperliquid разом, виходячи з ризику портфеля за найгіршого сценарію, тому для захеджованого портфеля потрібно значно менше забезпечення, ніж за стандартної маржі. На цій сторінці описано, як на неї перейти. Як розраховується сама маржа, дивіться в розділі Портфельна маржа.

Коротко: використайте новий гаманець-менеджер, створіть для нього рахунок Hypercall, увімкніть режим уніфікованого рахунку HyperCore, перемкніться в режим Portfolio і лише після цього вносьте депозит.

Чому ви починаєте з нового гаманця

Рахунок зі стандартною маржею (SM), на якому є баланс або відкриті позиції, не можна перемкнути на портфельну маржу на місці. Hypercall приймає перемикання в режим Portfolio, лише якщо для гаманця-менеджера виконуються всі ці умови:

Вимога	Що це означає
Рівно один рахунок Hypercall	Менеджер контролює один контракт Account. Відсутність рахунку або більше одного рахунку призводить до відхилення.
Нульовий стандартний баланс	Грошовий баланс гаманця в стандартній маржі дорівнює нулю. Будь-який баланс, доступний для виведення, блокує перемикання.
Без позицій	Немає відкритих позицій і відкритих заявок ні на гаманці-менеджері, ні на його Account.

Ці правила існують тому, що два режими є різними типами рахунків, а не одним рахунком із налаштуванням:

• Ваше забезпечення зберігається по-різному. Перехід зі стандартної маржі на портфельну означає переміщення ваших коштів, а не натискання перемикача.
• Позиції маржинуються за різними правилами. Відкриту позицію довелося б перемаржинувати з одного набору правил на інший.
• Тому перемикання відбувається з порожнього рахунку. Безпечне виконання обох дій за один крок не підтримується, тому рахунок спочатку має бути без позицій і порожнім.

Режим маржі встановлюється для кожного гаманця-менеджера окремо, тому один гаманець не може працювати в обох режимах. Найпростіший шлях: новий гаманець-менеджер для PM, завдяки якому ваш наявний рахунок SM може продовжувати котирувати, поки ви налаштовуєте новий. Ви також можете спорожнити наявний гаманець (закрити все, скасувати всі заявки, вивести всі стандартні кошти) і перемкнути його, але тоді ваш портфель SM не зможе працювати в цей час.

Перш ніж почати

• Новий гаманець-менеджер (EOA, яким ви керуєте, бажано на апаратному або іншим чином захищеному ключі).
• HYPE на HyperEVM у цьому гаманці для депозиту за створення рахунку та газу.
• USDC, які ви плануєте використовувати як забезпечення.

Кроки налаштування

Виконуйте їх по порядку. Крок 4 має йти перед кроком 5.

1. Створіть новий гаманець-менеджер. Не використовуйте повторно свій менеджер SM, API-гаманець або ключ агента.

2. Створіть свій рахунок Hypercall. З гаманця-менеджера викличте createAccount(salt) у контракті Factory з депозитом HYPE за створення. Це розгортає ваш контракт Account і активує його на HyperCore. Дивіться Онбординг (контракти). Створіть лише один рахунок для цього менеджера.

3. Увімкніть для Account режим уніфікованого рахунку HyperCore. Надішліть дію hl_set_abstraction, підписану гаманцем-менеджером, де user дорівнює адресі вашого Account, а abstraction дорівнює 2 (уніфікований рахунок). POST /v1/actions/hl_set_abstraction/typed-data повертає точні типізовані дані для підпису, а POST /v1/actions/hl_set_abstraction надсилає їх. Зачекайте, доки HyperCore не покаже Account як unifiedAccount. Інші режими рахунків Hyperliquid, зокрема його власний режим портфельної маржі, не підтримуються.

4. Перемкніться в режим Portfolio. Надішліть POST /margin-mode, де wallet дорівнює адресі вашого менеджера, а margin_mode дорівнює portfolio, підписаний гаманцем-менеджером (дивіться Автентифікація). У відповіді повертається адреса вашого Account як гаманця PM. Зробіть це перед внесенням депозиту: поки гаманець перебуває в режимі Standard, депозит Hypercall зараховується як стандартні кошти, і цей баланс блокує перемикання, доки ви знову його не виведете.

5. Внесіть USDC на свій Account. Вносьте депозит через застосунок, який маршрутизує його відповідно до режиму маржі, або надішліть USDC на HyperCore на адресу вашого Account. Кошти враховуються в маржі, щойно їх покаже наступний знімок HyperCore у Hypercall.

6. Налаштуйте ключі для підпису. Дозволи на вашому старому гаманці SM не переносяться.

   • Опціони (REST): схваліть свій торговий ключ для нового гаманця-менеджера через POST /approve-agent. Дивіться Авторизація агентів.
   • Перпи (ончейн-директиви): зареєструйте API-гаманець на своєму Account за допомогою дії hc_update_api_wallet, підписаної менеджером. API-гаманець може бути активним лише на одному Account. Дивіться Підписи EIP-712.

7. Торгуйте. Продовжуйте надсилати адресу свого менеджера як wallet у запитах щодо опціонів; Hypercall спрямовує їх на ваш рахунок PM. Типи заявок, API заявок і підписи такі самі, як і для стандартної маржі. Про безстрокові контракти Hyperliquid у застосунку дивіться Перпи в Hypercall.

У застосунку вибір Portfolio у Settings > Margin Mode виконує кроки з 2 по 4 за вас: створює рахунок, якщо його немає, вмикає режим уніфікованого рахунку та перемикає режим.

Якщо ви пропустите режим уніфікованого рахунку

Hypercall оцінює рахунок PM за його капіталом на HyperCore, який HyperCore публікує лише для Account у режимі уніфікованого рахунку. Якщо Account не перебуває в цьому режимі, крок 4 відхиляється з 400 pm_account_not_unified. Виконайте крок 3, зачекайте, поки HyperCore підтвердить режим, і повторіть спробу.

Якщо Account згодом вийде з режиму уніфікованого рахунку, запити до портфеля повертатимуть 503 pm_account_equity_pending (або 409 pm_account_not_unified, якщо HyperCore ніколи не публікував для нього капітал), а заявки завершуватимуться помилкою на кшталт missing HyperCore account equity for PM wallet 0x.... Щоб це виправити, знову увімкніть режим уніфікованого рахунку. Дивіться Помилки та причини відхилення.

FAQ

Чи можу я залишити свій рахунок зі стандартною маржею працюючим? Так. Підключіть PM на новому гаманці-менеджері, а свій рахунок SM залиште як є.

Чому моє перемикання режиму маржі відхилили? Помилка вказує на правило: у гаманця немає Account (або їх більше одного), на ньому є стандартний баланс, є відкриті позиції або заявки, або Account ще не перебуває в режимі уніфікованого рахунку HyperCore (pm_account_not_unified). Дивіться Чому ви починаєте з нового гаманця.

Я вніс депозит до перемикання. Що тепер? Депозит зараховано як стандартні кошти. Виведіть його, потім перемкніться в режим Portfolio і внесіть депозит на свій Account.

Чи потрібні мені нові API-ключі? Вам потрібні нові дозволи. Дозволи агентів для опціонів прив'язані до гаманця-менеджера, тому схваліть свій ключ знову для нового гаманця. API-гаманець для перпів може бути активним лише на одному Account, тому використайте новий ключ або спочатку видаліть його зі старого Account (крок 6).

Де дізнатися, як працюють маржа PM, ліквідація та розрахунок? Дивіться Портфельна маржа, Приклади розрахунку маржі PM, Мінімальний рівень маржі, Ліквідація і Розрахунок.